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

Método put (Objeto group)

Descripción

Reemplaza la descripción de un grupo local y la pertenencia a entera.

Sintaxis

/api/v2/group/put?group=group&description=description&principal=principal&vdc=controller-name 

Argumentos

grupo

Nombre del grupo

Descripción

Descripción de propietario de URL codificada del grupo.

principal

Lista de elementos principales separados por "/" de una URL codificada.

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 GROPU" y la pertenencia por el elemento principal único local:user:api@3tera.com para mygroup.

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

Sustituya toda la descripción por "API GROPU" y la pertenencia por los elementos principales local:user:api@3tera.com y local:user:test@3tera.com para mygroup.

GET
http://192.168.123.200/api/v2/group/put?group=mygroup&description=API%20Group&principal=local%3Auser%3Aapi%403tera.com%2Flocal%3Auser%3Atest%403tera.com&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 (description)

- Argumento description=description

Faltan argumentos obligatorios (principal)

- Falta el argumento principal=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.