Site rules

Managing site rules

In the following reference, {site-rule-entity} can be either of the following:

  • item
  • item/{item-id}
  • collection/{collection-id}
  • library/{library-id}
  • user
  • user/{username}
  • group
  • group/{groupname}

Retrieve site rules for a specific 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
<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>

Set a site rule

PUT {site-rule-entity}/site-rule/

Sets a 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:
Role:

_site_rule_write

Example

PUT /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.

PUT /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.

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

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

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