Obter 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.

Costumava ter excesso de tempo para um cliente. 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

[GET] /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

Nenhuma

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

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

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