Validación de la cuota de servicio para un proveedor de recursos
Se aplica a: Windows Azure Pack
Valida la cuota de servicio para un proveedor de recursos.
Solicitud
Reemplace <NotificationEndpoint> por la dirección del punto de conexión de la API rest de notificación del proveedor de recursos personalizado de Azure Pack Windows.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
PUT |
<http:// NotificationEndpoint>/quota?validateOnly=true |
HTTP/1.1 |
Parámetros de identificador URI
En la tabla siguiente se describen los parámetros de URI.
Parámetro de URI |
Descripción |
|---|---|
validateOnly |
Establézcalo en true para validar la cuota. |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
Encabezado de solicitud |
Descripción |
|---|---|
Autorización: Básico |
Obligatorio. Token de autorización básico. |
x-ms-principal-id |
Obligatorio. El identificador de la entidad de seguridad. |
x-ms-client-request-id |
Opcional. Identificador de solicitud de cliente. |
x-ms-client-session-id |
Opcional. Identificador de sesión de cliente. |
x-ms-principal-liveid |
Opcional. Identificador activo principal. |
Cuerpo de la solicitud
En la tabla siguiente se describen los elementos del cuerpo de la solicitud.
Nombre del elemento |
Descripción |
|---|---|
QuotaUpdateBatchSubscription |
Un lote de la configuración de cuota que se va a omitir mediante la validación. Para obtener más información, vea QuotaUpdateBatch (objeto de punto de conexión de notificación). |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
Una operación correcta devuelve el código de estado 200 (CORRECTO) si la cuota es válida. Si la cuota no es válida, se devuelve 400 con un objeto ResourceProviderError (objeto de punto de conexión de notificación) que contiene un mensaje de error localizado que explica el motivo del error de validación.
Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Administración de servicios de Azure Pack).
Encabezados de respuesta
La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
Cuerpo de la respuesta
Ninguno.
Ejemplo
En el ejemplo siguiente se muestra una validación de la cuota de servicio para una solicitud del proveedor de recursos .
PUT https://<NotificationEndpoint>:30012/quota?validateOnly=true HTTP/1.1
Referer: https://<Computer>:30004/plans/MyServicePlanX18aa6bac-5e8d-439e-b4d9-4a7dea4e843a/quota
Accept-Language: en-US
x-ms-client-request-id: 0ee49d13-7b86-4840-b0e1-046106a8d813-2014-07-09 23:16:21Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 840de34d9d9a484a8ddd7255a44cb1fd.2014-07-09T23:16:22.6545190Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30012
Content-Length: 273
Expect: 100-continue
{
"BaseQuota": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
}
],
"AddOnQuotas": [
],
"SubscriptionIdsToUpdate": [
]
}
En el ejemplo de código siguiente se muestra la respuesta JSON para Validar la cuota de servicio de un proveedor de recursos.
{
"BaseQuota": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
}
],
"AddOnQuotas": [
],
"SubscriptionIdsToUpdate": [
]
}
Resumen
Cada vez que haya un cambio en la cuota Validar la cuota de servicio para un proveedor de recursos se llama para confirmar que la nueva cuota es válida. La llamada se realiza antes de actualizar la cuota Configuración de un proveedor de recursos en cada suscripción existente.