Obter subscrições de um cliente através do PartnerID

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para Nuvem Microsoft para o Governo dos EUA

Como obter uma lista de assinaturas fornecidas por um determinado parceiro do Microsoft AI Cloud Partner Program para um cliente especificado.

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.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Partner Center ao selecionar o espaço de trabalho Clientes, depois o cliente da lista de clientes e, em seguida, Conta. Na página da Conta do cliente, procure o ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é a mesma que a ID do cliente (customer-tenant-id).
ID do Parceiro

C#

Para obter uma lista de assinaturas fornecidas por um determinado parceiro a um cliente especificado, primeiro use o métodoIAggregatePartner.Customers.ByIdcom a ID do cliente para identificar o cliente. Em seguida, obtenha uma interface para as operações de coleta de assinaturas de clientes da propriedade Subscriptions e chame o método ByPartner com o PartnerID para identificar o parceiro e recuperar uma interface para as operações de assinaturas do parceiro. Por fim, chame o método Get ou GetAsync para obter a coleção.

// IAggregatePartner partnerOperations;
// string customerId;
// string partnerMpnId;

var customerSubscriptionsByMpnId = partnerOperations.Customers.ById(customerId).Subscriptions.ByPartner(partnerMpnId).Get();

Exemplo de: Aplicativo de teste de console. Project: Exemplos de SDK do Partner Center Class: GetSubscriptionsByMpnid.cs

Java

O Java SDK do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de código aberto mantido pela comunidade de parceiros e não suportado oficialmente pela Microsoft. Você pode obter ajuda da comunidade ou reportar um problema no GitHub caso surja um problema.

Para obter uma lista de assinaturas fornecidas por um determinado parceiro a um cliente especificado, primeiro use a função IAggregatePartner.getCustomers.byId com o ID do cliente para identificar o cliente. Em seguida, obtenha uma interface para as operações de cobrança de assinaturas dos clientes a partir da função getSubscriptions, e chame a função byPartner com o PartnerID para identificar o parceiro e recuperar uma interface para as operações de assinaturas de parceiros. Por fim, chame a função get para obter a coleção.

// IAggregatePartner partnerOperations;
// String customerId;
// String partnerMpnId;

ResourceCollection<Subscription> customerSubscriptionsByMpnId = partnerOperations.getCustomers().byId(customerId).getSubscriptions().byPartner(partnerMpnId).get();

PowerShell

O módulo PowerShell do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de código aberto mantido pela comunidade de parceiros e não suportado oficialmente pela Microsoft. Você pode obter ajuda da comunidade ou reportar um problema no GitHub caso surja um problema.

Para obter uma lista de assinaturas fornecidas por um determinado parceiro a um cliente especificado, execute o comando Get-PartnerCustomerSubscription. Especifique o ID do cliente para identificar o cliente usando o parâmetro CustomerId e preencha o parâmetro MpnId com o PartnerID para identificar o parceiro.

# $customerId
# $partnerMpnId

Get-PartnerCustomerSubscription -CustomerId $customerId -MpnId $partnerMpnId

Pedido REST

Sintaxe da solicitação

Método	Solicitar URI
OBTER	{baseURL}/v1/customers/{customer-id}/subscriptions?mpn_id={mpn-id} HTTP/1.1

Parâmetros de URI

Use o caminho e os parâmetros de consulta a seguir para identificar o cliente e o parceiro.

Nome	Tipo	Necessário	Descrição
ID do cliente	string	Sim	Uma cadeia de caracteres formatada em GUID que identifica o cliente.
ID do MPN	Int	Sim	Um PartnerID que identifica o parceiro.

Cabeçalhos de solicitação

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

Corpo do pedido

Nenhuma.

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions?mpn_id=4847383 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd 
MS-RequestId: f98d0f61-01da-4d27-a923-8ec1e46e7358 
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Resposta REST

Se for bem-sucedida, o corpo da resposta conterá a coleção de recursos de Assinatura .

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 os códigos de erro REST do Partner Center .

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 985
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f98d0f61-01da-4d27-a923-8ec1e46e7358
Date: Thu, 13 Apr 2024 20:58:08 GMT

{ 
  "totalCount": 2, 
  "items": [ 
    { 
      "id": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
      "offerId": "DB2E705F-B82A-4024-A3D5-D88E12F2DB35", 
      "offerName": "Intune Device", 
      "friendlyName": "new offer purchase", 
      "quantity": 5, 
      "unitType": "Licenses", 
      "creationDate": "2024-04-10T23:02:26.02Z", 
      "effectiveStartDate": "2024-04-10T00:00:00Z", 
      "commitmentEndDate": "2025-05-07T00:00:00Z", 
      "status": "active", 
      "autoRenewEnabled": true, 
      "isTrial": false, 
      "billingType": "license", 
      "billingCycle": "monthly", 
      "partnerId": "4847383", 
      "contractType": "subscription", 
      "links": { 
        "offer": { 
          "uri": "/offers/DB2E705F-B82A-4024-A3D5-D88E12F2DB35?country=US", 
          "method": "GET", 
          "headers": [] 
        }, 
        "self": { 
          "uri": "/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
          "method": "GET", 
          "headers": [] 
        } 
      }, 
      "orderId": "3EDDCAC6-63B2-4C40-B0B6-F47E18301492", 
      "attributes": { 
        "etag": "eyJpZCI6IjQyMjI2ZWQ2LTA3MGEtNGUwZi1iODBjLTRjZGZiM2U5N2FhNyIsInZlcnNpb24iOjF9", 
        "objectType": "Subscription" 
      } 
    }, 
    { 
        "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
        "offerId": "CFQ7TTC0LH18:0001:CFQ7TTC0P0WS", 
        "offerName": "Microsoft 365 Business Basic", 
        "friendlyName": "Microsoft 365 Business Basic", 
        "productType": { 
            "id": "OnlineServicesNCE", 
            "displayName": "OnlineServicesNCE" 
        }, 
        "quantity": 2, 
        "unitType": "Licenses", 
        "hasPurchasableAddons": false, 
        "creationDate": "2024-06-05T19:26:38.3667635Z", 
        "effectiveStartDate": "2024-06-05T00:00:00Z", 
        "commitmentEndDate": "2024-07-04T00:00:00Z", 
        "commitmentEndDateTime": "2024-07-04T23:59:59Z", 
        "cancellationAllowedUntilDate": "2024-06-12T19:27:03.440527Z", 
        "billingCycleEndDate": "2024-07-04T00:00:00Z", 
        "billingCycleEndDateTime": "2024-07-04T23:59:59Z", 
        "status": "active", 
        "autoRenewEnabled": true, 
        "isTrial": false, 
        "billingType": "license", 
        "billingCycle": "monthly", 
        "termDuration": "P1M", 
        "renewalTermDuration": "", 
        "isMicrosoftProduct": true, 
        "partnerId": "4847383", 
        "attentionNeeded": false, 
        "actionTaken": false, 
        "contractType": "subscription", 
        "links": { 
            "product": { 
                "uri": "/products/CFQ7TTC0LH18?country=US", 
                "method": "GET", 
                "headers": [] 
            }, 
            "sku": { 
                "uri": "/products/CFQ7TTC0LH18/skus/0001?country=US", 
                "method": "GET", 
                "headers": [] 
            }, 
            "availability": { 
                "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0P0WS?country=US", 
                "method": "GET", 
                "headers": [] 
            }, 
            "self": { 
                "uri": "/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
                "method": "GET", 
                "headers": [] 
            } 
        }, 
        "publisherName": "Microsoft Corporation", 
        "refundableQuantity": { 
            "totalQuantity": 1, 
            "details": [ 
                { 
                    "quantity": 1, 
                    "allowedUntilDateTime": "2024-06-14T17:41:13.4675407Z" 
                } 
            ] 
        }, 
        "orderId": "79d9f5e2f43a", 
        "attributes": { 
            "objectType": "Subscription" 
        } 
    } 
  ], 
  "attributes": { "objectType": "Collection" } 
}

Ver também

Partner Center Analytics - Recursos

Feedback

Esta página foi útil?

Last updated on 2025-03-11