Import settings [VC 21.3.1 GEN]

Import settings profiles can be used to add access controls to items that are being imported.

Managing import settings

Create an import profile

POST /import/settings

Creates a new settings profile with the given settings.

Accepts:	application/xml, application/json – An ImportSettingsDocument containing the settings profile.
Produces:	application/xml, application/json – An ImportSettingsDocument containing the the settings profile together with its id.
Role:	_import

Example

POST /import/settings
Content-Type: application/xml

<ImportSettingsDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <access>
      <permission>READ</permission>
      <user>myuser</user>
   </access>
</ImportSettingsDocument>

<ImportSettingsDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <id>VX-4</id>
   <access>
      <permission>READ</permission>
      <user>myuser</user>
   </access>
</ImportSettingsDocument>

List all import profiles

GET /import/settings

Retrieves a list of all profiles.

Produces:	application/xml, application/json – A URIListDocument containing the ids of all profiles. text/plain – CRLF-delimited list of ids
Role:	_import

Example

GET /import/settings

<URIListDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <uri>VX-1</uri>
   <uri>VX-2</uri>
   <uri>VX-3</uri>
   <uri>VX-4</uri>
</URIListDocument>

Retrieve an import profile

GET /import/settings/(settings-id)

Retrieves the settings specified by a certain profile.

Produces:	application/xml, application/json – An ImportSettingsDocument containing the settings of the profile.
Role:	_import

Example

GET /import/settings/VX-4

<ImportSettingsDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <id>VX-4</id>
   <access>
      <permission>READ</permission>
      <user>myuser</user>
   </access>
</ImportSettingsDocument>

Update an import profile

PUT /import/settings/(settings-id)

Changes the settings of the specified profile.

Accepts:	application/xml, application/json – An ImportSettingsDocument with the new settings.
Role:	_import

Example

PUT /import/settings/VX-4
Content-Type: application/xml

<ImportSettingsDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <access>
      <permission>WRITE</permission>
      <user>myuser</user>
   </access>
</ImportSettingsDocument>

200 OK

Delete an import profile

DELETE /import/settings/(settings-id)

Deletes the profile with specified id.

Role:

_import

Example

DELETE /import/settings/VX-4

200 OK