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

Método get_newobj_acl (Objeto group)

Descripción

Muestra la definición de la ACL del nuevo objeto asociada a un grupo, o la parte de la definición de la ACL del nuevo objeto que se relaciona con un elemento principal en particular.

Sintaxis

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

Argumentos

grupo

Nombre del grupo. Anteponga el carácter / al nombre del grupo para indicar que es un grupo global.

principal

Nombre del elemento principal. <principal> está con el formato siguiente:

URL

El elemento principal codificado está en el formato:

<name>: usuario o grupo local.

/<name>: usuario o grupo global.

<scope>:<type>:<name>: Un nombre completo del elemento principal donde <scope> sea global o local, <type> sea group o user y <name> sea el nombre de grupo o nombre de usuario.

Por ejemplo, local:user:api@3tera.com=full se debería pasar como local%3Auser%3Aapi%403tera.com%3Dfull.

Si el elemento principal es una cadena vacía, se muestra toda definición de la ACL del nuevo objeto asociada a un grupo; en caso contrario, sólo se muestra la parte de la definición de la ACL del nuevo objeto que se refiere a un elemento principal en particular.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

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

Ejemplo de salida

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
         }
      }
   }
}

Códigos de error de HTTP

404

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

404.1

Entidad no encontrada: no hay ninguna coincidencia de nombre del elemento principal para "'principal".

400.4

Faltan argumentos obligatorios (principal). - El argumento principal=principal falta en la solicitud.

400.4

Faltan argumentos obligatorios (group). - El argumento group=group falta en la solicitud.

Nota: Esta API está disponible con WS_API_r10-1.0.10-1 y versiones superiores.