Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides › Objet quota › Méthode info (objet quota)

Méthode info (objet quota)

Description

Afficher les informations de quota pour un utilisateur ou un groupe spécifié

Syntaxe

/api/v2/quota/info?principal=a-principal&vdc=nom_contrôleur 

Arguments

vdc

Nom du centre de données virtuel cible

principal

Utilisateur ou groupe pour lequel les informations de quota doivent être affichées. Les spécifications principales sont les suivantes :

<name>

Utilisateur ou groupe local

/<name>

Utilisateur ou groupe global.

<scope>:<type>:<name>

Nom complet de principal

où :

• <scope> a la valeur global ou local.
• <type> correspond à group ou user.
• <name> est le nom du groupe ou de l'utilisateur.

Type de transaction

Synchrone

Type de requête

GET

Exemples

Pour afficher les informations relatives à un utilisateur nommé john@CA.com :

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

Exemple de sortie

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

Codes d'erreur HTTP

404

L'entité vdc mygrid est introuvable - Le nom de VDC spécifié n'est pas configuré dans l'application WS_API.

404.1

Entité introuvable. Aucune correspondance de nom de principal n'a été trouvée pour principal.

400.4

Syntaxe de demande incorrecte (URL) : argument requis manquant (principal).