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

modify_acl-Methode (vdc-Objekt)

Description

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

Syntax

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

Argument

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

Den Teil der Grid-ACL ersetzen, der sich auf den lokalen Benutzer "api@3tera.com" bezieht, und dem Benutzer so die Zugriffsebenenberechtigungen für "grid_administrator" gewähren.

GET
http://192.168.123.200/api/v2/vdc/modify_acl?acl=local%3Auser%3Aapi%403tera.com%3Dgrid_administrator&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 (acl).

- Argument acl=acl nicht vorhanden.

404.1

Entität nicht gefunden - ACL kann nicht geändert werden - ungültige Prinzipaldaten - lokaler Prinzipalbenutzer "test@3tera.com" ist nicht vorhanden.

- Ein ungültige ACL wurde angegeben.

Beispielausgabe

JSON:

{
   "message": "",
} 

XML:

<message></message>

Hinweise

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