Metodo put (oggetto quota)

Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi per l'API di CA AppLogic › Oggetto quota › Metodo put (oggetto quota)

Metodo put (oggetto quota)

Description

Impostazione delle informazioni di quota per un utente o gruppo.

Sintassi

/api/v1/quota/put?principal=a-principal&vdc=controller-name

Argomenti

vdc

Nome del data center virtuale di destinazione

principal

Utente o gruppo per cui impostare 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

Imposta valori di quota per un utente locale della griglia mygrid denominato john:

Get http://192.168.123.200/api/v1/quota/put?principal=local:user:john&vdc=mygrid&cpu=4&mem=200000000&bw=1000&disk=100000000000

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 Daniel ha raggiunto la sua quota di larghezza di banda di 100,00 Mbps.</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.8: L'utente entità principale ha raggiunto la sua quota di risorsa di valore.
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).