Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto group › Metodo put (oggetto group)

Metodo put (oggetto group)

Description

Sostituisce la descrizione e l'intera appartenenza di un gruppo locale.

Sintassi

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

Argomenti

group

Nome del gruppo

description

Descrizione del titolare codificata URL del gruppo

principal

Elenco codificato URL delimitato da ‘/’ delle entità principali.

Ad esempio: local:user:api@3tera.com should be passed as local%3Auser%3Aapi%403tera.com

Ad esempio, local:user:api@3tera.com /local:user:test@3tera.com should be passed as local%3Auser%3Aapi%403tera.com%2Flocal%3Auser%3Atest%403tera.com

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Sostituzione dell'intera descrizione con "API GROUP" e dell'appartenenza con la singola entità principale local:user:api@3tera.com per mygroup

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

Sostituzione dell'intera descrizione con “API GROUP” e dell'appartenenza con le entità principali local:user:api@3tera.com e local:user:test@3tera.com per 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

Output di esempio

JSON:

{
   "message" : ""
} 

XML:

<message></message>

Codici di errore HTTP

400

Entità vdc mygrid non trovata
- È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

400.4

Argomenti obbligatori mancanti (group)

- Argomento gruppo=gruppo mancante

Argomenti necessari mancanti (description)

- Argomento description=description

Argomenti necessari mancanti (principal)

- Argomento principal=principal mancante

404.1

Entità non trovata - Il gruppo mygroup non esiste.

- È stato specificato un gruppo che non esiste in mygrid.

Entità non trovata - Impossibile applicare l'ACL dell'applicazione - Dati principali non validi - L'utente principale locale 'test@3tera.com' non esiste.

- È stata specificata un'entità principale non valida.

Nota: questa API è disponibile con WS_API_r6-1.0.6-1 e versioni successive.