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

modify-Methode (quota-Objekt)

Description

Ändert vorhandene Kontingentinformationen für einen Benutzer oder eine Gruppe.

Syntax

/api/v2/quota/modify?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 aktualisiert 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

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

Get http://192.168.123.200/api/v2/quota/modify?principal=local:user:john&vdc=mygrid&cpu=5&mem=50000000&bw=2000&disk=50000000000&warn=85&burst=90

Beispielausgabe

XML:

Bei Erfolg:

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

<opt>
  <error>404.1</error>
  <message>Entität nicht gefunden - Fehler: Benutzerin "Laura" hat ihr Bandbreitenkontingent von 953,67 MB 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).