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

Método get_acl (Objeto app)

Descripción

Permite recuperar la ACL de la aplicación o una parte de la ACL de la aplicación referida a un elemento principal concreto.

Sintaxis

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

Argumentos

app

Nombre de la aplicación

principal

Elemento principal de una URL codificada. Por ejemplo, se debería pasar local:user:api@3tera.com como local%3Auser%3Aapi%403tera.com.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplo: Recuperación de la ACL de una aplicación

Recuperación de la ACL de la aplicación para la aplicación test

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

Ejemplo de salida

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>

Ejemplo: Recuperación de los datos de la ACL para el elemento principal

Permite recuperar los datos de la ACL del elemento principal local:user:api@3tera.com para la aplicación test.

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

Ejemplo de salida

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>

Códigos de error de HTTP

404

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 (app): 
el argumento app=app falta en la solicitud.

Faltan argumentos obligatorios (principal)
- Falta el argumento principal=principal

404.1

Entidad no encontrada: la aplicación "test" no existe.

- Se ha especificado una aplicación que no existe en mygrid.

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

Nota: Esta API está disponible con WS_API_r6-1.0.6-1 y versiones superiores.