Obter informações de implantação de licenças de parceiroGet partner licenses deployment information

Aplica-se aApplies To

  • Partner CenterPartner Center

Como obter informações de implantação de licenças de parceiros agregadas para incluir todos os clientes.How to get partner licenses deployment information aggregated to include all customers.

Observação

Esse cenário é substituído por obter informações de implantação de licenças.This scenario is superceded by Get licenses deployment information.

Pré-requisitosPrerequisites

Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte à autenticação com credenciais de aplicativo + usuário.This scenario supports authentication with App+User credentials.

C#C#

Para recuperar dados agregados na implantação de licenças, primeiro obtenha uma interface para operações de coleta de análise de nível de parceiro da propriedade IAggregatePartner. Analytics .To retrieve aggregated data on licenses deployment, first get an interface to partner level analytics collection operations from the IAggregatePartner.Analytics property. Em seguida, recupere uma interface para a coleção de análise de licenças de nível de parceiro da propriedade licenças .Then retrieve an interface to the partner level licenses analytics collection from the Licenses property. Por fim, chame o método Deployment. Get para obter os dados agregados na implantação de licenças.Finally, call the Deployment.Get method to get the aggregated data on licenses deployment. Se o método tiver sucesso, você obterá uma coleção de objetos PartnerLicensesDeploymentInsights .If the method succeeds you'll get a collection of PartnerLicensesDeploymentInsights objects.

// IAggregatePartner partnerOperations;

var partnerLicensesDeploymentAnalytics = partnerOperations.Analytics.Licenses.Deployment.Get();

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/Analytics/licenses/Deployment http/1.1{baseURL}/v1/analytics/licenses/deployment HTTP/1.1

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

GET https://api.partnercenter.microsoft.com/v1/analytics/licenses/deployment HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Resposta RESTREST response

Se for bem-sucedido, o corpo da resposta conterá uma coleção de recursos do PartnerLicensesDeploymentInsights que fornece informações sobre as licenças implantadas.If successful, the response body contains a collection of PartnerLicensesDeploymentInsights resources that provide information about the licenses deployed.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 102030524
Date: Tue, 14 Mar 2017 17:55:01 GMT

{
    "totalCount": 2,
    "items": [{
            "proratedDeploymentPercent": 0.0,
            "licensesSold": 343,
            "processedDateTime": "2017-03-10T00:00:00+00:00",
            "serviceName": "crm",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }, {
            "proratedDeploymentPercent": 1.0,
            "licensesSold": 4464,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}