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 modify (Objeto group)

Método modify (Objeto group)

Descripción

Reemplaza la descripción de un grupo local o pertenencia.

Sintaxis

/api/v1/group/modify?group=group&add_principal=add_principal&remove_principal=remove_principal&vdc=controller-name 

Argumentos

grupo

Nombre del grupo

add_principal

Lista de elementos principales separados por "/" de una URL codificada que se deben agregar al grupo.

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

Por ejemplo, local:user:api@3tera.com /local:user:test@3tera.com se debería pasar como local%3Auser%3Aapi%403tera.com%2Flocal%3Auser%3Atest%403tera.com.

remove_principal

Lista de elementos principales separados por "/" de una URL codificada que se deben eliminar del grupo.

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

Por ejemplo, local:user:api@3tera.com /local:user:test@3tera.com se debería pasar como local%3Auser%3Aapi%403tera.com%2Flocal%3Auser%3Atest%403tera.com.

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Sustituya toda la descripción por "API GROUP", pero no cambie la pertenencia.

                                                                                                                                   
GET
http://192.168.123.200/api/v1/group/modify?group=mygroup&description=API%20Group&add_principal=&remove_principal=&vdc=mygrid

Sustituya toda la descripción por "API GROUP" y agregue local:user:api@3tera.com a la pertenencia y elimine local:user:test@3tera.com de mygroup.

GET
http://192.168.123.200/api/v1/group/put?group=mygroup&description=API%20Group&add_principal=local%3Auser%3Aapi%403tera.com&remove_principal=local%3Auser%3Atest%403tera.com&vdc=mygrid

Sustituya toda la descripción por "API GROUP" y elimine local:user:api@3tera.com and local:user:test@3tera.com de mygroup.

GET
http://192.168.123.200/api/v1/group/put?group=mygroup&description=API%20Group&remove_principal=local%3Auser%3Aapi%403tera.com%2Flocal%3Auser%3Atest%403tera.com&add_principal=&vdc=mygrid

Ejemplo de salida

JSON:

{
   "message" : ""
} 

XML:

<message></message>

Códigos de error de HTTP

400

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

400.4

Faltan argumentos obligatorios (group)

- Falta el argumento group=group

Faltan argumentos obligatorios (add_principal)

- Argumento add_principal=add_principal

Faltan argumentos obligatorios (add_principal=add_principal)

- Falta el argumento remove_principal=remove_principal

404.1

Entidad no encontrada: el grupo "mygroup" no existe.

- Se ha especificado un grupo que no existe en mygrid.

Entidad no encontrada: no se pudo lanzar la ACL de la aplicación; datos del elemento principal no válidos, no existe 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.