Obter subscrições de um cliente através do PartnerID
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government
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 selecionando a área de trabalho Clientes e, em seguida, 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 é a mesma que a ID do cliente (customer-tenant-id).Um PartnerID
C#
Para obter uma lista de assinaturas fornecidas por um determinado parceiro a um cliente especificado, primeiro use o método IAggregatePartner.Customers.ById com a ID do cliente para identificar o cliente. Em seguida, obtenha uma interface para as operações de coleta de assinaturas do cliente na propriedade Subscriptions e chame o método ByPartner com o PartnerID para identificar o parceiro e recuperar uma interface para as operações de assinatura do parceiro. Finalmente, 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: Aplicativo de teste de console. Projeto: Exemplo de SDK do Partner Center Classe: GetSubscriptionsByMpnid.cs
Java
O SDK Java 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 abrir um problema no GitHub se tiver 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 coleta de assinaturas do cliente na 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 assinatura do parceiro. Finalmente, 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 abrir um problema no GitHub se tiver 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 | URI do pedido |
|---|---|
| GET | {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 | Obrigatório | Descrição |
|---|---|---|---|
| ID do cliente | cadeia | Sim | Uma cadeia de caracteres formatada em GUID que identifica o cliente. |
| ID do MPN | número inteiro | Sim | Um PartnerID que identifica o parceiro. |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo do pedido
Nenhum.
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 do REST
Se bem-sucedida, o corpo da resposta contém 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 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" }
}