Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › group-Objekt › get_newobj_acl-Methode (group-Objekt)

get_newobj_acl-Methode (group-Objekt)

Description

Anzeigen der Definition der neuen Objekt-ACL, die einer Gruppe zugeordnet ist, oder Anzeigen des Teils der Definition der neuen Objekt-ACL, der sich auf einen bestimmten Prinzipal bezieht.

Syntax

/api/v2/group/get_newobj_acl?group=group&principal=principal&vdc=vdc 

Argument

Gruppe

Name der Gruppe. Stellen Sie dem Gruppennamen ein / voran, um eine globale Gruppe anzuzeigen.

principal

Name eines Prinzipals. <principal> liegt in folgender Form vor:

URL

Kodierter Prinzipal liegt in folgender Form vor:

<name> - Lokale Benutzer oder Gruppen.

/<name> - Globale Benutzer oder Gruppen.

<scope>:<type>:<name> Ein voll qualifizierter Prinzipalname, wobei <scope> "global" oder "lokal", <type> die "Gruppe" oder der "Benutzer" und <name> der Gruppen- oder Benutzername ist.

local:user:api@3tera.com=full sollte z. B. als local%3Auser%3Aapi%403tera.com%3Dfull übergeben werden.

Wenn der Prinzipal eine leere Zeichenfolge ist, wird die vollständige Definition der neuen Objekt-ACL angezeigt, die einer Gruppe zugeordnet ist. Andernfalls wird nur der Teil der Definition der neuen Objekt-ACL angezeigt, der sich auf einen bestimmten Prinzipal bezieht.

vdc

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

Transaktionsart

synchron

Anfragetyp

GET

Beispiele

GET http://192.168.123.200/api/v2/group/get_newobj_acl?group=apigroup&principal=&vdc=mygrid

Beispielausgabe

XML:

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63",
            "full" : 1
         }
      ]
   }
}

HTTP-Fehlercodes

404

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

404.1

Entität nicht gefunden - Es ist keine Übereinstimmung zwischen Prinzipal und Name für "principal" vorhanden

400.4

Erforderliche Argumente fehlen (group). - Argument group=group ist in der Anfrage nicht vorhanden.

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