Managing site rules

Site rules control the content that is synced with a remote site.

In the following reference, {site-rule-entity} is one of the following:

  • /item

  • /item/{item-id}

  • /collection

  • /collection/{collection-id}

  • /library

  • /library/{library-id}

  • /user

  • /user/{username}

  • /group

  • /group/{group-name}

List all site rules for an entity

GET {site-rule-entity}/site-rule

Retrieves all site rules for the given entity/entities.

Produces:
Role:

_site_rule_read

Example

GET /item/VX-62/site-rule
NONE
<SiteRuleListDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <siteRule>
    <site>VY</site>
    <metadata>true</metadata>
    <access>true</access>
    <shape>original</shape>
  </siteRule>
  <siteRule>
    <site>VZ</site>
    <metadata>true</metadata>
    <access>true</access>
    <shape>lowres</shape>
    <shape>original</shape>
  </siteRule>
</SiteRuleListDocument>
HTML/XML

Create a site rule

POST {site-rule-entity}/site-rule

Creates a new site rule for an entity.

Status Codes:
  • 200 OK – Rule set successfully.

  • 400 Bad request – The request was malformed.

  • 404 Not found – Could not find the specified entity.

Accepts:
Produces:
Role:

_site_rule_write

Example

POST /item/VX-67/site-rule/
Content-Type: application/xml

<SiteRuleDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <site>VY</site>
  <metadata>true</metadata>
  <access>true</access>
  <shape>original</shape>
  <shape>lowres</shape>
</SiteRuleDocument>
NONE

Set the site rule for users.

POST /user/site-rule/
Content-Type: application/xml

<SiteRuleDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <site>VY</site>
</SiteRuleDocument>
NONE

Set the site rule for groups. Setting a generic site rule for groups will also enable syncing of all users.

POST /group/site-rule/
Content-Type: application/xml

<SiteRuleDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <site>VY</site>
</SiteRuleDocument>
NONE

Retrieve a site rule

GET {site-rule-entity}/site-rule/(id)

Retrieves a specific site rule.

Produces:
Role:

_site_rule_read

Update a site rule

PUT {site-rule-entity}/site-rule/(id)

Updates a site rule.

Status Codes:
  • 200 OK – Rule set successfully.

  • 400 Bad request – The request was malformed.

  • 404 Not found – Could not find the specified rule.

Accepts:
Produces:
Role:

_site_rule_write

Delete a site rule

DELETE {site-rule-entity}/site-rule/(id)

Deletes a site rule.

Status Codes:
  • 200 OK – Rule deleted successfully.

  • 400 Bad request – The request was malformed.

  • 404 Not found – Could not find the specified rule.

Role:

_site_rule_write