Atualizar excedente

Aplica-se a

• Central de Parceiros

Funções apropriadas

• Agente de administração

Observação

As novas experiências de comércio para serviços baseados em licença incluem muitos novos recursos e estão disponíveis para todos os CSPs (Provedores de Soluções na Nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.

Usado para definir o excedente de um determinado cliente para uma assinatura de consumo. Também pode ser usado para remover o excedente definindo-o como false. O excedente permite que um cliente continue usando os serviços se usar o serviço além dos limites estabelecidos. Excedente define o excedente de assinatura de consumo pago conforme o uso será acumulado.

O grupo de recursos é sempre M365. Os parceiros podem adicionar marcas e locais ao grupo de recursos, mas não podem alterá-los.

Pré-requisitos

• Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

• Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o workspace Clientes, o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

• Pelo menos uma assinatura excedente qualificada adquirida para o cliente.

Solicitação REST

[PUT] /clientes/{id do locatário do cliente}/assinaturas/excedente

Sintaxe da solicitação

Método	URI da solicitação
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parâmetro do URI

Use os parâmetros de consulta a seguir para retornar o excedente de um cliente.

Nome	Tipo	Obrigatória	Descrição
id de locatário do cliente	guid	Y	Um GUID correspondente ao locatário do cliente.

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nome	Tipo	Descrição
azureEntitlementId	guid	Required. Um GUID que define a assinatura de consumo para excedente.
azureResourceGroup	objeto	Optional. Nomeie o valor das marcas e o local do grupo de recursos.
partnerId	guid	Aplicável apenas para um modelo de duas camadas (Provedor Indireto). O PartnerID de um revendedor indireto.
overageEnabled	bool	Required. Indique se o excedente deve ser habilitado para uma determinada assinatura de consumo.

Exemplo de solicitação

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
}

Resposta REST

Se for bem-sucedido, esse método retornará o excedente para um cliente.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

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"
    }
}