Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto app › Metodo get_acl (oggetto app)

Metodo get_acl (oggetto app)

Description

Recupera l'ACL dell'applicazione o la parte dell'ACL dell'applicazione correlata a un'entità particolare principale.

Sintassi

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

Argomenti

app

Nome dell'applicazione

principal

Entità principale codificata URL. Ad esempio: local:user:api@3tera.com dovrebbe essere utilizzato come local%3Auser%3Aapi%403tera.com

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempio: recupera l'ACL dell'applicazione

Recupera l'ACL dell'applicazione per l'applicazione test

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

Output di esempio

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>

Esempio: recupera i dati dell'ACL per l'entità principale

Recupera i dati dell'ACL per l'entità principale local:user:api@3tera.com per la verifica dell'applicazione.

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

Output di esempio

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>

Codici di errore HTTP

404

Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

400.4

Argomenti necessari mancanti (app). 
- Argomento app=app mancante nella richiesta.

Argomenti necessari mancanti (principal)
- Argomento principal=principal mancante

404.1

Entità non trovata - Il test dell'applicazione non esiste.

- È stata specificata un'applicazione che non esiste in mygrid.

Entità non trovata - Impossibile recuperare l'applicazione ACL - ACL non contiene l'entità principale dell'utente locale 'test@3tera.com'.

- È stata specificata un'entità principale non valida.

Nota: questa API è disponibile con WS_API_r6-1.0.6-1 e versioni successive.