Obter um resumo de uso para todas as assinaturas de um cliente

  • Artigo

Aplica-se a: Partner Center | Partner Center para o Microsoft Cloud for US Government

Você pode usar o recurso CustomerUsageSummary para obter o uso de um serviço ou recurso específico do Azure por um cliente durante o período de cobrança atual.

Observação

Geralmente, os dados de uso não faturados com classificação diária ficam disponíveis por meio da API ou do portal do Partner Center após 24 horas. Dependendo da sua localização e quando os medidores relatam o uso, podem ocorrer atrasos adicionais.

Às vezes, você pode não ver os dados de uso não faturados mais recentes do início do mês até que os dados de uso faturados do mês anterior sejam entregues. Isso é para garantir que os dados de uso cobrados sejam entregues de forma eficiente dentro do SLA. Depois de receber os dados de uso cobrados, você pode começar a recuperar todos os dados de uso não faturados atualizados desde o início do mês.

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de 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 espaço de trabalho Clientes, o cliente na 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).

C#

Para obter um resumo de uso para todas as assinaturas de um cliente:

  1. Use sua coleção IAggregatePartner.Customers para chamar o método ById().

  2. Chame a propriedade UsageSummary, seguida pelos métodos Get() ou GetAsync():

    // IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Para obter um exemplo, consulte o seguinte:

Solicitação REST

Sintaxe da solicitação

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

Parâmetro do URI

Esta tabela lista o parâmetro de consulta necessário para obter as informações de uso classificado do cliente.

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

Cabeçalhos da solicitação

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

Corpo da solicitação

Nenhum.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

Resposta REST

Se bem-sucedido, esse método retorna um recurso CustomerUsageSummary no corpo da resposta.

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 uma lista completa, consulte Códigos de erro.

Exemplo de resposta para assinatura do Microsoft Azure (MS-AZR-0145P)

Neste exemplo, o cliente comprou uma oferta 145P Azure PayG .

Para clientes com assinaturas do Microsoft Azure (MS-AZR-0145P), não haverá alteração na resposta da API.

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

Exemplo de resposta para o plano do Azure

Neste exemplo, o cliente comprou um plano do Azure.

Para clientes com planos do Azure, há as seguintes alterações na resposta da API:

  • currencyLocale é substituído por currencyCode
  • usdTotalCost é um novo campo
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "44908a11-641b-4c53-b7fc-0f2bfca8a581",
    "resourceName": "Modern Azure Customer UK",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}