Vorheriges Thema: get_acl-Methode (app-Objekt)Nächstes Thema: modify_acl-Methode (app-Objekt)


put_acl-Methode (app-Objekt)
Description

Die gesamte Anwendungs-ACL ersetzen.

Syntax
/api/v2/app/put_acl?app=application&owner=<owner>&acl=<ACLs>&vdc=controller-name
Argument
app

Name der Anwendung

Eigentümer

URL-kodiertes Eigentümerattribut der Anwendungs-ACL für den angegebenen Prinzipal. local:user:api@3tera.com sollte z. B. als local%3Auser%3Aapi%403tera.com übergeben werden.

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

vdc

Name des virtuellen Rechenzentrums (Virtual Data Center), welches das Ziel darstellt

Transaktionsart

Synchron

Anfragetyp

GET

Beispiele

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

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

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

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

Gesamte ACL für den Anwendungstest 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/app/put_acl?app=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
404

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 (app). 
- Argument app=app ist in der Anfrage nicht vorhanden.

Erforderliche Argumente fehlen (owner).

- Argument owner=owner.

Erforderliche Argumente fehlen (acl).

- Argument acl=acl nicht vorhanden.

404.1

Entität nicht gefunden - Anwendungstest ist nicht vorhanden.

- Eine Anwendung wurde angegeben, die nicht auf mygrid vorhanden ist.

Entität nicht gefunden - Anwendungs-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.

Hinweise

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