Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi per l'API di CA AppLogic › Oggetto cat › Metodo get_acl (oggetto cat)

Metodo get_acl (oggetto cat)

Description

Recupera l'ACL del catalogo globale o visualizza la parte dell'ACL del catalogo globale correlata a un'entità particolare principale.

Sintassi

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

Argomenti

cat

Nome del catalogo

principal

Entità principale codificata URL

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempio: entità principale codificata URL

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

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

Output di esempio

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>

Esempio: visualizzazione di dati dell'ACL per l'entità principale

Visualizzazione di dati dell'ACL per l'entità principale local:user:api@3tera.com per la verifica del catalogo.

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

Output di esempio

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>

Codici di errore HTTP

400

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

400.4

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

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

404.1

Entità non trovata - La verifica del catalogo non esiste.

- È stato specificato un catalogo 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.