Integrationshandbücher › Webservice-API-Referenzhandbuch › Gültige Objekte › quota-Objekt › info-Methode (quota-Objekt)

info-Methode (quota-Objekt)

Description

Kontingentinformationen für einen angegebenen Benutzer oder eine Gruppe anzeigen.

Syntax

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

Argument

vdc

Name des virtuellen Rechenzentrums (Virtual Data Center), welches das Ziel darstellt

principal

Benutzer oder Gruppe, für den bzw. für die Kontingentinformationen angezeigt werden. Eine Prinzipalangabe ist Folgendes:

<name>

Lokaler Benutzer oder lokale Gruppe.

/<name>

Globale Benutzer oder Gruppen.

<scope>:<type>:<name>

Ein vollständig qualifizierter Prinzipalname

Erläuterung:

• <scope> ist global oder local
• <type> ist group oder user
• <name> ist der Name der Gruppe oder des Benutzers.

Transaktionsart

synchron

Anfragetyp

GET

Beispiele

Informationen für einen Benutzer mit dem Namen "john@CA.com" anzeigen.

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

Beispielausgabe

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"
      }
   }
}

HTTP-Fehlercodes

404

Entität vdc mygrid nicht gefunden - Es wurde ein VDC-Name angegeben, der in der WS_API-Anwendung nicht konfiguriert worden ist.

404.1

Entität nicht gefunden - Es ist keine Übereinstimmung zwischen Prinzipal und Name für "principal" vorhanden

400.4

Ungültige Anforderungssyntax (URL) - fehlendes erforderliches Argument (Prinzipal).