Excesso de custo por atualização

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 (Provedores 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á.

O grupo de recursos é sempre o M365. Os parceiros podem adicionar etiquetas e localizações ao grupo de recursos, mas não podem alterá-los.

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 Required. Um GUID que define a assinatura de consumo para consumo excessivo.
azureResourceGroup objeto Optional. Valor do nome das etiquetas e localização do grupo de recursos.
ID do parceiro GUID Aplicável apenas para um modelo de duas camadas (Provedor Indireto). O PartnerID de um revendedor indireto.
overageEnabled bool Required. 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: 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 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: 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"
    }
}
  • Last updated on