HomeAboutSet or change acl rules on assets.

Set or change acl rules on assets.

22Aug2011 Posted by admin

This call will change the acl rules to assets. 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/mediafile/acl [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
asset_id[] (ALPHA_NUM)The asset_ids.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)Alias of acl_group. If both are set, acl_group has priority.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)Alias of acl_user. If both are set, acl_user has priority.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/mediafile/acl
user_id=entree004&asset_id[]=7pAkDsceysAZPo0q3PhjtBE1&asset_id[]=HnRUfbdUWjPWVWJktsuH4IKp
acl_app[]=5

Example Response

<items>
  <item id="1">
    <asset_id>7pAkDsceysAZPo0q3PhjtBE1</asset_id>
    <mediafile_id>7hkjCCq3CxSXNrGy2vgVnorI</mediafile_id>
    <result>success</result>
    <result_id>601</result_id>
    <result_description></result_description>
    <acl_app>
      <value>1</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_app>
  </item>
  <item id="2">
    <asset_id>7pAkDsceysAZPo0q3PhjtBE1</asset_id>
    <mediafile_id>GqrqS9UYfyKAsrW73mPVAyRH</mediafile_id>
    <result>success</result>
    <result_id>601</result_id>
    <result_description></result_description>
    <acl_app>
      <value>1</value>
      <result>success</result>
      <result_id>601</result_id>
      <result_description></result_description>
    </acl_app>
  </item>
</items>