Integrationshandbücher › Webservice-API-Referenzhandbuch › Zulässige Objekte für CA AppLogic-API › cat-Objekt › get_acl-Methode (cat-Objekt)

get_acl-Methode (cat-Objekt)

Beschreibung

Globale Katalog-ACL abrufen oder den Teil der globalen Katalog-ACL anzeigen, der sich auf einen bestimmten Prinzipal bezieht.

Syntax

/api/v1/cat/get_acl?cat=catalog&principal=<principal>&vdc=controller-name

Argument

cat

Name des Katalogs

principal

Ein URL-kodierter Prinzipal.

vdc

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

Transaktionsart

synchron

Anfragetyp

GET

Beispiel: URL-kodierter Prinzipal

Ein URL-kodierter Prinzipal. local:user:api@3tera.com sollte z. B. als local%3Auser%3Aapi%403tera.com übergeben werden.

GET http://192.168.123.200/api/v1/cat/get_acl?cat=/test&principal=&vdc=mygrid 

Beispielausgabe

JSON:

{
   "acl" : {
      "owner" : {
         "id" : "b543eff7-db88-4d79-a11c-4de22d5e6d3b"
      },
      "entries" : {
         "entries[0]" : {
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7",
            "full" : 1
         },
         "entries[1]" : {
            "id" : "b543eff7-db88-4d79-a11c-4de22d5e6d3b",
            "full" : 1
         }
      }
   }
}

XML:

<acl>
  <entries>
    <name>entries[0]</name>
    <full>1</full>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
  </entries>
  <entries>
    <name>entries[1]</name>
    <configure>1</configure>
    <id>b543eff7-db88-4d79-a11c-4de22d5e6d3b</id>
  </entries>
  <owner>
    <id>b543eff7-db88-4d79-a11c-4de22d5e6d3b</id>
  </owner>
</acl>

Beispiel: ACL-Daten für Prinzipal anzeigen

ACL-Daten für Prinzipal local:user:api@3tera.com für den Katalogtest anzeigen.

GET
http://192.168.123.200/api/v1/cat/get_acl?cat=/test&principal=local%3Auser%3Aapi%403tera.com&vdc=mygrid

Beispielausgabe

JSON:

{
   "acl" : {
      "entries" : {
         "entries[0]" : {
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7",
            "full" : 1
         }
      }
   }

XML:

<acl>
  <entries>
    <name>entries[0]</name>
    <full>1</full>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
  </entries>
</acl>

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 (principal).
- Argument principal=principal 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 - Anwendungs-ACL konnte nicht abgerufen werden - ACL enthält nicht den lokalen Prinzipal-Benutzer "test@3tera.com".

- Ein ungültiger Prinzipal wurde angegeben

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