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

modify_acl-Methode (template-Objekt)

Description

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

Syntax

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

Argument

Vorlage

Name der Vorlage.

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

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

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

Ändern Sie die ACL für die Vorlagenanwendung VDS_CentOS, indem Sie den Eigentümer api@3tera.com und den Prinzipal local:user:api@3tera.com=full ersetzen.

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

Ändern Sie die ACL für die Vorlagenanwendung VDS_CentOS, indem Sie die 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 ersetzen.

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

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 (template).

- Argument template=template nicht vorhanden.

Erforderliche Argumente fehlen (acl).

- Argument acl=acl nicht vorhanden.

404.1

Entität nicht gefunden - Vorlage VDS_CentOS ist nicht vorhanden.

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

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

Beispielausgabe

JSON:

{
   "message": "",
} 

XML:

<message></message>

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