Actualización del uso por encima del límite

Se aplica a

• Centro de partners

Roles adecuados

• Agente de administración

Nota:

Las nuevas experiencias comerciales para los servicios basados en licencias incluyen muchas funcionalidades nuevas y están disponibles para todos los Proveedores de soluciones en la nube (CSP). Para más información, consulte Introducción a las nuevas experiencias comerciales.

Se usa para establecer el uso por encima del límite de un cliente determinado en una suscripción de consumo. También se puede usar para quitar el uso por encima del límite estableciendo en false. El uso por encima del límite permite a un cliente seguir usando servicios si usan el servicio más allá de los límites indicados. El uso por encima del límite define la suscripción de consumo por encima del límite de pago por uso.

El grupo de recursos siempre es M365. Los asociados pueden agregar etiquetas y ubicaciones al grupo de recursos, pero no pueden cambiarla.

Requisitos previos

• Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.

• Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

• Al menos una suscripción de uso por encima del límite válida comprada para el cliente.

Solicitud REST

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

Sintaxis de la solicitud

Método	URI de la solicitud
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parámetro de URI

Use los siguientes parámetros de consulta para devolver el uso por encima del límite de un cliente.

Nombre	Type	Obligatorio	Descripción
customer-tenant-id	guid	Y	GUID correspondiente al inquilino del cliente.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Nombre	Type	Descripción
azureEntitlementId	guid	Required. GUID que define la suscripción de consumo para el uso por encima del límite.
azureResourceGroup	objeto	Optional. Valor de nombre de las etiquetas y la ubicación del grupo de recursos.
partnerId	guid	Solo se aplica a un modelo de dos niveles (proveedor indirecto). PartnerID de un revendedor indirecto.
overageEnabled	bool	Required. Indique si se debe habilitar el uso por encima del límite para una suscripción de consumo determinada.

Ejemplo de solicitud

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "overageEnabled": true
}

Respuesta REST

Si se ejecuta correctamente, este método devuelve el uso por encima del límite de un cliente.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}