Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos para la API de CA AppLogic › Objeto vdc › Método get_acl (Objeto vdc)

Método get_acl (Objeto vdc)

Descripción

Permite mostrar la ACL del grid o una parte de la ACL del grid referida a un elemento principal concreto.

Sintaxis

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

Argumentos

<principal>

Un tipo de argumento habitual.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplo: Presentación de la ACL para vdc mygrid.

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

Ejemplo de salida

JSON:

{
   "acl" : {
      "owner" : {
         "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63"
      },
      "entries" : {
         "entries[0]" : {
            "app_developer" : 1,
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7"
         },
         "entries[2]" : {
            "grid_administrator" : 1,
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63"
         },
         "entries[1]" : {
            "app_developer" : 1,
            "id" : "e1a5357f-204b-4cd3-9ca8-9e09f45b21c6"
         }
      }
   }
}

XML:

<acl>
  <entries>
    <name>entries[0]</name>
    <app_developer>1</app_developer>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
  </entries>
  <entries>
    <name>entries[1]</name>
    <app_developer>1</app_developer>
    <id>e1a5357f-204b-4cd3-9ca8-9e09f45b21c6</id>
  </entries>
  <entries>
    <name>entries[2]</name>
    <grid_administrator>1</grid_administrator>
    <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
  </entries>
  <owner>
    <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
  </owner>
</acl>

Ejemplo: Presentación de los datos de ACL para local:user:api@3tera.com elemento principal para vdc mygrid.

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

Ejemplo de salida

JSON

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

XML:

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

Códigos de error de HTTP

400

Entidad mygrid de vdc no encontrada: se ha especificado un nombre de VDC que no está configurado en la aplicación WS_API.

400.4

Faltan argumentos obligatorios (principal)

- Falta el argumento principal=principal

404.1

Entidad no encontrada: no se pudo recuperar la ACL de la aplicación; ACL no contiene el usuario local principal "test@3tera.com".

- Se ha especificado un elemento principal no válido

Notes

Esta API está disponible con WS_API_r6-1.0.6-1 y superior.