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

Metodo get_newobj_acl (oggetto group)

Description

Visualizzare la definizione dell'ACL di un nuovo oggetto associato a un gruppo o visualizzare quella porzione della definizione dell'ACL di un nuovo oggetto che si riferisce a un'entità particolare.

Sintassi

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

Argomenti

group

Nome del gruppo. Anteporre / al nome del gruppo per indicare un gruppo globale.

principal

Nome dell'entità principale. <principal> è nel modulo:

URL

Entità principale codificata nel modulo:

<name>: utente o gruppo locale.

/<name>: utente o gruppo globale.

<scope>:<type>:<name>: nome completo dell'entità principale in cui <scope> corrisponde a globale o locale, <type> all'utente o al gruppo e <name> al gruppo o al nome utente.

Ad esempio, local:user:api@3tera.com=full dovrebbe essere utilizzato come local%3Auser%3Aapi%403tera.com%3Dfull

Se l'entità è una stringa vuota, verrà visualizzata la definizione completa dell'ACL del nuovo oggetto associata a un gruppo. In caso contrario, verrà visualizzata solo la porzione di definizione dell'ACL del nuovo oggetto relativa a un'entità particolare.

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

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

Output di esempio

XML:

<acl>
  <entries>
    <name>entries0</name>
    <full>1</full>
    <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : {
         "entries0" : {
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8",
            "full" : 1
         }
      }
   }
}

Codici di errore HTTP

404

Entità vdc non trovata: è stato specificato un nome di VDC non configurato nell'applicazione WS_API.

404.1

Entità non trovata. Nessuna corrispondenza trovata con i nomi di entità per "principal"

400.4

Argomenti obbligatori mancanti (principal). - Argomento principal=principal mancante nella richiesta.

400.4

Argomenti obbligatori mancanti (group). - Argomento group=group mancante nella richiesta.

Nota: questa API è disponibile con WS_API_r10-1.0.10-1 e versioni successive.