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

Método get_acl (Objeto template)

Descripción

Permite recuperar la ACL de la plantilla o una parte de la ACL de la plantilla referida a un elemento principal concreto.

Sintaxis

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

Argumentos

template

Nombre de la plantilla

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: Recuperación de la ACL de una aplicación

Permite recuperar la ACL de la aplicación para la plantilla VDS_CentOS.

GET http://192.168.123.200/api/v2/template/get_acl?template=VDS_CentOS&principal=&vdc=mygrid 

Ejemplo de salida

XML:

<acl>
  <entries>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
         }
      ]
   }
}

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

Muestre los datos de la ACL para el principal local:user:api@3tera.com de la plantilla VDS_CentOS.

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

Ejemplo de salida

XML:

<acl>
  <entries>
    <entry>
      <configure>1</configure>
      <id>778fee4e-9b83-4160-8b79-8bb0e1a87af8</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON:

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "configure" : 1,
            "id" : "778fee4e-9b83-4160-8b79-8bb0e1a87af8"
         }
      ]
   }
}

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 (template)

- Falta el argumento app=app

Faltan argumentos obligatorios (principal)

- Falta el argumento principal=principal

404.1

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

- Se ha especificado una plantilla 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.