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

Metodo informazioni (oggetto quota)

Description

Visualizzazione delle informazioni di quota per un utente o gruppo specificato.

Sintassi

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

Argomenti

vdc

Nome del data center virtuale di destinazione

principal

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

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Visualizzazione delle informazioni per un utente denominato john@CA.com.

GET http://192.168.123.200/api/v2/quota/info?principal=local:user:john@ca.com

Output di esempio

XML:

<quota>
  <burst>90</burst>
  <principal>
    <name>laura@ca.com</name>
    <scope>local</scope>
    <type>user</type>
  </principal>
  <resources allowed>
    <bw>1900000000</bw>
    <cpu>11</cpu>
    <disk>95000000000</disk>
    <mem>19000000000</mem>
  </resources allowed>
  <resources assigned>
    <bw>1000000000</bw>
    <cpu>6</cpu>
    <disk>50000000000</disk>
    <mem>10000000000</mem>
  </resources assigned>
  <warn>80</warn>
</quota>

JSON:

{
   "quota" : {
      "warn" : "80",
      "burst" : "90",
      "principal" : {
         "name" : "laura@ca.com",
         "type" : "user",
         "scope" : "local"
      },
      "resources assigned" : {
         "bw" : "1000000000",
         "cpu" : "6",
         "disk" : "50000000000",
         "mem" : "10000000000"
      },
      "resources allowed" : {
         "bw" : "1900000000",
         "cpu" : "11",
         "disk" : "95000000000",
         "mem" : "19000000000"
      }
   }
}

Codici di errore HTTP

404

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

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).