HomeAboutSet or change acl rules on asset.

Set or change acl rules on asset.

22Aug2011 Posted by admin

This call will change the acl rules to an asset. All of the existing ACL rules in this asset will be replaced by the sent rules. Using 'replace' setting with value FALSE to result in not replace the existing rules.

Request URL

/asset/$asset_id/acl [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
asset_id (ALPHA_NUM)The asset_id.Required-
user_id (ALPHA_NUM)User ID, owner of the asset.Required-
acl_app[] (INT)Application(s) that get acces to the asset.Optional-
acl_domain[] (STRING)Domain(s) that get acces to the asset.Optional-
acl_group[] (ALPHA_NUM)Group(s) that get acces to the asset.Optional-
acl_group_id[] (ALPHA_NUM)Same as acl_group.Optional-
acl_realm[] (STRING)Realm(s) that get acces to the asset.Optional-
acl_user[] (ALPHA_NUM)User(s) that get acces to the asset.Optional-
acl_user_id[] (ALPHA_NUM)Same as acl_user.Optional-
mediamosa_version (MEDIAMOSA_VERSION)Provide the version to get the REST call returned in the format of the specified MediaMosa version. Keep empty or skip to retrieve in current (latest) version. Provide '2' to retrieve the REST call in 2.x format. Or be more specific by providing up to 3 digits; '2.3.0'. This setting will override any setting used by client application or the default setting in MediaMosa.Optional-
replace (BOOL)'TRUE' or 'FALSE'. Is the rest call overwrite the existing rules? Default is TRUE. Defined as 'FALSE' means the old rules will not be overwritten.OptionalTRUE-

Example Request

/asset/IuQahqi9ATcSAw2QMFAXeC2N/acl
user_id=entree004
acl_app[]=5

Example Response

<items>
  <item id="1">
    <acl_app>
      <value>5</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_app>
  </item>
</items>