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

Metodo modifica (oggetto quota)

Description

Modifica le informazioni di quota esistenti per un utente o un gruppo.

Sintassi

/api/v2/quota/modify?principal=a-principal&vdc=controller-name 

Argomenti

vdc

Nome del data center virtuale di destinazione

principal

Utente o gruppo per cui aggiornare le informazioni di quota. Una specifica dell'entità principale è una delle seguenti:

<name>

Utente o gruppo locale

/<name>

Utente o gruppo globale

<scope>:<type>:<name>

Un nome principale completamente qualificato

dove:

• <scope> è globale o locale
• <type> è gruppo o utente
• <name> è il gruppo o il nome utente

description

Stringa di carattere ASCII stampabile arbitraria. Sostituire i caratteri come gli spazi con la loro rappresentazione esadecimale (%hh), secondo la sintassi dell'URL.

tags=tag1,tag2,…,tagN

Elenco separato da virgola di tag a volte utilizzato per scopi di fatturazione.

parent=group-name

Riferimento alla quota del gruppo padre. Poiché il gruppo padre degli utenti è impostato sul loro gruppo primario, è possibile solo impostare questo argomento per un gruppo.

cpu=value

Limiti di uso della risorsa per processori.

mem=value

Limiti di uso della risorsa per memoria (byte).

bw=value

Limiti di uso della risorsa per larghezza di banda (byte per secondo).

disk=value

Limiti di uso della risorsa per spazio su disco (byte).

warn=percentage

Soglia di consumo di avviso (come percentuale delle risorse totali disponibili), per l'entità principale presa in considerazione.

burst=percentage

Soglia di consumo burst (come percentuale delle risorse totali disponibili), per l'entità principale presa in considerazione.

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Modifica i valori di quota esistenti per un utente locale della griglia mygrid denominato john:

Get http://192.168.123.200/api/v2/quota/modify?principal=local:user:john&vdc=mygrid&cpu=5&mem=50000000&bw=2000&disk=50000000000&warn=85&burst=90

Output di esempio

XML:

In caso di completamento corretto dell'operazione:

<message></message>
In caso di superamento della quota:

<opt>
  <error>404.1</error>
  <message>Entità non trovata - Errore: l'utente Laura ha raggiunto la sua quota di larghezza di banda di 953,67 MB.</message>
</opt>

JSON:

{
   "message" : ""
}

Codici di errore HTTP

404

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

400.7

Valore specificato non valido per il parametro risorsa. Il valore assegnato al parametro di avviso o burst è al di fuori dell'intervallo.

404.1

Entità non trovata. Nessuna corrispondenza trovata con il nome dell'entità principale per entità principale.

400.4

Sintassi di richiesta errata (URL) - argomento obbligatorio mancante (entità principale).