Método put (objeto quota)

Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos para la API de CA AppLogic › quota Object › Método put (objeto quota)

Método put (objeto quota)

Descripción

Permite definir información un usuario o grupo.

Sintaxis

/api/v1/quota/put?principal=a-principal&vdc=controller-name

Argumentos

vdc

Nombre del centro de datos virtual de destino

principal

Usuario o grupo sobre el cual se debe definir información de cuota. Una especificación de elemento principal es una de las siguientes:

<nombre>: Grupo o usuario local
/<name>: Usuario o grupo global.
<scope>:<type>:<name>: Un nombre principal completo

donde:

<scope> es global o local.
<type> es group o user.
<name> es el nombre del grupo o del usuario.

Descripción

Cadena arbitraria de caracteres ASCII que se pueden mostrar en pantalla. Reemplaza los caracteres, como los espacios, por su representación hexadecimal (%hh), según la sintaxis de URL.

tags=tag1,tag2,…,tagN

Lista de etiquetas separada por comas que a veces se utiliza para propósitos de facturación.

parent=group-name

Hace referencia a la cuota de grupo principal. Como los usuarios tienen su grupo principal configurado como su grupo primario, solamente se puede establecer este argumento para un grupo.

cpu=value

Límites de uso de los recursos para los procesadores.

mem=value

Límites de uso de los recursos para la memoria (bytes).

bw=value

Límites de uso de los recursos para el ancho de banda (bytes por segundo).

disk=value

Límites de uso de los recursos para espacio en disco (bytes).

warn=percentage

Umbral de consumo de advertencia (por ejemplo, un porcentaje de los recursos totales disponibles), para el elemento principal en cuestión.

burst=percentage

Umbral de consumo de recursos de fragmentación (por ejemplo, un porcentaje de los recursos totales disponibles), para el elemento principal en cuestión.

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Definición de valores de cuota para un usuario local del grid mygrid llamado john:

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

Ejemplo de salida

XML:

Resultado correcto:

<message></message>
Cuota excedida:

<opt>
  <error>404.1</error>
  <message>Entity not found - Error: User Daniel has reached its bandwidth quota of 100.00 Mbps.</message>
</opt>

JSON:

{
   "message" : ""
}

Códigos de error de HTTP

404: Entidad mygrid de vdc no encontrada: se ha especificado un nombre de VDC que no está configurado en la aplicación WS_API.
400.8: El elemento principal del usuario ha alcanzado su cuota de recurso del valor.
400.7: Se ha especificado un valor value no válido para el parámetro resource. El valor asignado a los parámetros warn o burst está fuera del intervalo.
404.1: Entidad no encontrada: no hay ninguna coincidencia de nombre del elemento principal para principal.
400.4: Sintaxis de solicitud incorrecta (URL): falta un argumento necesario (elemento principal).