Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › app-Objekt › get_acl-Methode (app-Objekt)

get_acl-Methode (app-Objekt)

Description

Anwendungs-ACL abrufen oder den Teil der Anwendungs-ACL abrufen, der sich auf einen bestimmten Prinzipal bezieht.

Syntax

/api/v2/app/get_acl?app=application&principal=<principal>&vdc=controller-name

Argument

app

Name der Anwendung

principal

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

vdc

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

Transaktionsart

synchron

Anfragetyp

GET

Beispiel: Anwendungs-ACL abrufen

Anwendungs-ACL für die Anwendung "test" abrufen

GET http://192.168.123.200/api/v2/app/get_acl?app=test&principal=&vdc=mygrid 

Beispielausgabe

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
         }
      ]
   }
}

XML:

<acl>
  <entries>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

Beispiel: ACL-Daten für Prinzipal abrufen

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

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

Beispielausgabe

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "f9939715-e340-4e09-b179-f61e3b031338",
            "full" : 1
         },
         {
            "id" : "932b639b-2f78-4415-9c3b-22a2a98ce9fe",
            "full" : 1
         },
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
}         
      ]
  } 
}

XML:

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>f9939715-e340-4e09-b179-f61e3b031338</id>
    </entry>
    <entry>
      <full>1</full>
      <id>932b639b-2f78-4415-9c3b-22a2a98ce9fe</id>
    </entry>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

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 (principal).
- Argument principal=principal 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 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.