Site rules [VC 21.3 GEN]

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:	application/xml, application/json – SiteRuleListDocument
Role:	_site_rule_read

Example

NONE

GET /item/VX-62/site-rule

HTML/XML

<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>

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:	application/xml, application/json – SiteRuleDocument
Produces:	application/xml, application/json – SiteRuleDocument
Role:	_site_rule_write

Example

NONE

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>

Set the site rule for users.

NONE

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

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

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

NONE

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

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

Retrieve a site rule

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

Retrieves a specific site rule.

Produces:	application/xml, application/json – SiteRuleDocument
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:	application/xml, application/json – SiteRuleDocument
Produces:	application/xml, application/json – SiteRuleDocument
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