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

Método get_acl (Objeto cat)

Descripción

Permite recuperar la ACL del catálogo global o una parte de la ACL del catálogo global referida a un elemento principal concreto.

Sintaxis

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

Argumentos

cat

Nombre del catálogo

principal

Elemento principal de una URL codificada.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplo: Elemento principal con codificación URL

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

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

Ejemplo de salida

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>

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

Muestre los datos de la ACL del elemento principal local:user:api@3tera.com para el catálogo "test".

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

Ejemplo de salida

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>

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 (cat)
- Falta el argumento cat=cat

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

404.1

Entidad no encontrada: el catálogo "test" no existe.

- Se ha especificado un catálogo 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.