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

put_acl-Methode (cat-Objekt)

Description

Gesamte Katalog-ACL ersetzen.

Syntax

/api/v2/cat/put_acl?cat=catlog&owner=<owner>&acl=<ACLs>&vdc=controller-name

Argument

cat

Name des Katalogs

Eigentümer

URL-kodiertes Eigentümerattribut der Grid-ACL für den angegebenen Prinzipal.

acl

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

Transaktionsart

synchron

Anfragetyp

GET

Beispiele

Gesamte ACL für den Katalogtest durch den Eigentümer api@3tera.com ersetzen.

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

Gesamte ACL für den Katalogtest durch den Eigentümer api@3tera.com und den Prinzipal local:user:api@3tera.com=full ersetzen.

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

Gesamte ACL für den Katalogtest durch den Eigentümer api@3tera.com und den Prinzipal local:user:api@3tera.com=full/local:user:test@3tera.com=configure ersetzen.

GET
http://192.168.123.200/api/v2/cat/put_acl?cat=/test&owner=local%3Auser%3Aapi%403tera.com&acl=local%3Auser%3Aapi%403tera.com%3Dfull%2Flocal%3Auser%3Atest%403tera.com%3Dconfigure&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 (owner).

- Argument owner=owner.

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.