put-Methode (quota-Objekt)

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

put-Methode (quota-Objekt)

Description

Legt Kontingentinformationen für einen Benutzer oder eine Gruppe fest.

Syntax

/api/v2/quota/put?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 festgelegt 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.

description

Willkürliche druckbare ASCII-Zeichenfolge. Ersetzen Sie Zeichen, wie beispielsweise Leerzeichen, durch ihre hexadezimale Darstellung (%hh) entsprechend der URL-Syntax.

tags=tag1,tag2,…,tagN

Eine durch Kommas getrennte Liste mit Tags wird manchmal für Abrechnungszwecke verwendet.

parent=group-name

Verweis auf das Kontingent der übergeordneten Gruppe. Da Benutzer ihre übergeordnete Gruppe als primäre Gruppe festgelegt haben, können Sie nur dieses Argument für eine Gruppe festlegen.

cpu=value

Einschränkungen hinsichtlich der Ressourcenverwendung für Prozessoren.

mem=value

Einschränkungen hinsichtlich der Ressourcenverwendung für den Speicher (Byte).

bw=value

Einschränkungen hinsichtlich der Ressourcenverwendung für die Bandbreite (Byte pro Sekunde).

disk=value

Einschränkungen hinsichtlich der Ressourcenverwendung für den Festplattenspeicher (Byte).

warn=percentage

Warnverbrauchs-Schwellenwert (Prozentsatz der insgesamt zur Verfügung stehenden Ressourcen) für den entsprechenden Prinzipal.

burst=percentage

Schwellenwert für den Burst-Ressourcenverbrauch (Prozentsatz der insgesamt zur Verfügung stehenden Ressourcen) für den entsprechenden Prinzipal.

Transaktionsart

synchron

Anfragetyp

GET

Beispiele

Kontingentwerte für einen lokalen Benutzer des Grid "mygrid" mit dem Namen "john" festlegen:

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

Beispielausgabe

XML:

Bei Erfolg:

<message></message>
Bei überschrittenem Kontingent:

<opt>
  <error>404.1</error>
  <message>Entität nicht gefunden - Fehler: Benutzer "Daniel" hat sein Bandbreitenkontingent von 100,00 Mbit/s erreicht.</message>
</opt>

JSON:

{
   "message": "",
}

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.
400.7: Ungültiger angegebener Wert für Ressourcenparameter. Der dem Warn- oder Burstparameter zugewiesene Wert liegt außerhalb des Bereichs.
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).