Excesso de custo por atualização

Artigo
03/09/2025

Aplica-se a

Centro de Parceiros

Funções apropriadas

Agente administrativo

Nota

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

Usado para definir o excesso de utilização para um determinado cliente numa subscrição de consumo. Também pode ser usado para remover excedentes, definindo-o como falso. O uso adicional permite que um cliente continue a utilizar o serviço se exceder os limites indicados. O excesso de idade define o excesso de subscrição de consumo a que se acumulará.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma identificação de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center. Selecione a área de trabalho Clientes, escolha o cliente na lista, e depois em Conta. Na página de Conta do cliente, procure o ID da Microsoft na secção Informações da Conta Cliente. O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).
Pelo menos uma assinatura de excesso qualificada comprada para o cliente.

Pedido REST

[PUT] /customers/{customer-tenant-id}/assinaturas/excesso

Sintaxe da solicitação

Método	URI do pedido
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parâmetro URI

Utilize os seguintes parâmetros de consulta para retornar o excedente de um cliente.

Nome	Tipo	Obrigatório	Descrição
ID de cliente-inquilino	GUID	Y	Um GUID correspondente ao locatário do cliente.

Cabeçalhos do pedido

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

Corpo do pedido

Nome	Tipo	Descrição
azureEntitlementId	GUID	Um GUID que define a assinatura de consumo para consumo excessivo.
ID do parceiro	GUID	O PartnerID de um revendedor indireto. Aplicável apenas para um modelo de duas camadas (Provedor Indireto).
overageEnabled	bool	Indique se o excesso de consumo 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: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Resposta do REST

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

Códigos de sucesso e erro de resposta

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

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}

Partilhar via