Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › cat-Objekt › modify_acl-Methode (cat-Objekt)

modify_acl-Methode (cat-Objekt)

Description

Den Teil der Katalog-ACL ersetzen, der sich auf den Eigentümer oder einen Prinzipal bezieht.

Syntax

/api/v2/cat/modify_acl?cat=catalog&acl=<ACLs>&vdc=controller-name

Argument

cat

Name des Katalogs

acl

URL-verschlüsselte Liste von durch einen Schrägstrich (/) getrennten Prinzipalen

Transaktionsart

synchron

Anfragetyp

GET

Beispiele

ACL für den Katalogtest ändern, indem Sie den Eigentümer durch api@3tera.com ersetzen.

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Downer&vdc=mygrid

Ändern Sie die ACL für den Anwendungstest durch das Ersetzen des Eigentümers api@3tera.com und Prinzipals local:user:api@3tera.com=full.

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Downer%2Flocal%3Auser%3Aapi%403tera.com%3Dfull&vdc=mygrid

Ändern Sie die ACL für die Anwendung durch das Ersetzen der Zugriffsebenen für test@3tera.com und api@3tera.com und den Prinzipal local:user:api@3tera.com=configure/local:user:test@3tera.com=read.

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Dconfigure%2Flocal%3Auser%3Atest%403tera.com%3Dread&vdc=mygrid

Beispielausgabe

JSON:

{
   "message": "",
} 

XML:

<message></message>

HTTP-Fehlercodes

400

Entität vdc mygrid nicht gefunden - Es wurde ein VDC-Name angegeben, der in der WS_API-Anwendung nicht konfiguriert worden ist.

400.4

Erforderliche Argumente fehlen (cat).
- Argument cat=cat nicht vorhanden.

Erforderliche Argumente fehlen (acl).

- Argument acl=acl nicht vorhanden.

404.1

Entität nicht gefunden - Katalogtest ist nicht vorhanden.

- Ein Katalog wurde angegeben, der nicht auf mygrid vorhanden ist.

Entität nicht gefunden - Katalog-ACL kann nicht erstellt werden - ungültige Prinzipal-Daten - lokaler Prinzipal-Benutzer "test@3tera.com" ist nicht vorhanden.

- Ein ungültiger Eigentümer oder eine ungültige ACL wurde angegeben.

Hinweis: Diese API ist verfügbar mit WS_API_r6-1.0.6-1 und höher.