Atualizar excesso de tempo

  • Artigo
  • 2 minutos para ler

Aplica-se a

  • Partner Center

Funções adequadas

  • Administrador global
  • Agente administrativo

Nota

As novas experiências de comércio para serviços baseados em licenças incluem muitas novas capacidades e estão disponíveis para todos os Cloud Solution Provider (CSPs). Para mais informações, consulte novas experiências de comércio.

Usado para definir overage para um determinado cliente para uma subscrição de consumo. Também pode ser usado para remover o excesso, definindo-o como falso. O overage permite que um cliente continue a utilizar os serviços se utilizar o serviço para além dos limites indicados. A overage define a sobreatenção da subscrição de consumo que o pay-as-you-go irá acumular.

Pré-requisitos

  • Credenciais descritas na autenticação do Partner Center. Este cenário suporta a autenticação com as credenciais de App autónoma e App+User.

  • Uma ID do cliente (customer-tenant-id). Se não souber a identificação do cliente, pode procurar no painel do Centro de Parceiros. Selecione CSP no menu Partner Center, seguido por Clientes. Selecione o cliente da lista de clientes e, em seguida, selecione Conta. Na página conta do cliente, procure o ID da Microsoft na secção Informação da Conta do Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).

  • Um ID de subscrição para a subscrição transitada.

Pedido de DESCANSO

[PUT] /clientes/{cliente-inquilino-id}/subscrições/overage

Solicitar sintaxe

Método URI do pedido
GET {baseURL}/v1/customers/{customer-tenant-id}/subscrições/overage HTTP/1.1

Parâmetro URI

Utilize os seguintes parâmetros de consulta para devolver o excesso de tempo de um cliente.

Nome Tipo Necessário Descrição
cliente-inquilino-id guid Y Um GUID correspondente ao inquilino do cliente.

Cabeçalhos do pedido

Para obter mais informações, consulte os cabeçalhos Partner Center REST.

Corpo do pedido

Nome Tipo Description
azureEntitlementId guid Um GUID que define a subscrição de consumo por excesso de tempo.
partnerId guid A identificação do MPN de um Revendedor Indireto. Apenas aplicável a um modelo de dois níveis (Fornecedor Indireto).

| overageEnabled | bool | Define se a sobreabilitada está ativada para uma determinada subscrição de consumo. |

Exemplo de pedido

GET 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

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

Resposta do REST

Se for bem sucedido, este método devolve a sobreagem a um cliente.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de estado HTTP que indica sucesso ou falha e informações adicionais de depuragem. Utilize uma ferramenta de rastreio de rede para ler este 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
    }
}