Obter licenças atribuídas a um utilizador dentro de uma conta de cliente

Como obter uma lista de licenças atribuídas a um utilizador dentro de uma conta de cliente. Os exemplos mostrados aqui devolvem licenças atribuídas ao grupo1, o grupo de licenças padrão que representa licenças geridas por Azure Ative Directory. Para obter licenças atribuídas a grupos de licenças especificados, consulte obter licenças atribuídas a um utilizador por grupo de licenças.

Pré-requisitos

• Credenciais descritas na autenticação do Partner Center. Este cenário suporta a autenticação apenas com credenciais app+Utilizador.

• 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 identificador de utilizador.

C#

Para verificar quais as licenças atribuídas a um utilizador do grupo de licenças padrão grupo1, utilize primeiro o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente. Em seguida, ligue para o método Users.ById com o ID do utilizador para identificar o utilizador. Em seguida, obtenha uma interface para as operações de licença de utilizador do cliente a partir da propriedade Licenses . Por fim, ligue para o método Get ou GetAsync para recuperar a recolha das licenças atribuídas ao utilizador.

// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var customerUserAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get();

Amostra: App de teste de consola. Project: Partner Center SDK Samples Class: CustomerUserAssignedLicenses.cs

Pedido de DESCANSO

Solicitar sintaxe

Método	URI do pedido
GET	{baseURL}/v1/clientes/{customer-id}/users/{user-id}/licenses HTTP/1.1

Parâmetro URI

Utilize os seguintes parâmetros de percurso para identificar o cliente e o utilizador.

Nome	Tipo	Necessário	Descrição
id cliente	string	Yes	Uma cadeia formatada GUID que identifica o cliente.
user-id	string	Yes	Uma cadeia formatada GUID que identifica o utilizador.

Cabeçalhos do pedido

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

Corpo do pedido

Nenhum.

Exemplo de pedido

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/users/482e2152-4b49-48ec-b715-823365ce3d4c/licenses HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Resposta do REST

Se for bem sucedido, o corpo de resposta contém a recolha de recursos de Licença .

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

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 3883
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CV: WYkHYMfWTUajFosK.0
MS-ServerId: 020021921
Date: Fri, 09 Jun 2017 00:29:24 GMT

{
    "totalCount": 1,
    "items": [{
            "servicePlans": [{
                    "displayName": "Azure Information Protection Premium P1",
                    "serviceName": "RMS_S_PREMIUM",
                    "id": "6c57d4b6-3b23-47a5-9bc9-69f17b4947b3",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Intune A Direct",
                    "serviceName": "INTUNE_A",
                    "id": "c1ec4a95-1f05-45b3-a911-aa3fa01094f5",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Azure Active Directory Rights",
                    "serviceName": "RMS_S_ENTERPRISE",
                    "id": "bea4c11e-220a-4e6d-8eb8-8ea15d019f90",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Azure Active Directory Premium P1",
                    "serviceName": "AAD_PREMIUM",
                    "id": "41781fb2-bc02-4b7c-bd55-b576c07bb09d",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }, {
                    "displayName": "Microsoft Azure Multi-Factor Authentication",
                    "serviceName": "MFA_PREMIUM",
                    "id": "8a256a2b-b617-496d-b51b-e76466e88db0",
                    "capabilityStatus": "Assigned",
                    "targetType": "User"
                }
            ],
            "productSku": {
                "id": "efccb6f7-5641-4e0e-bd10-b4976e1bf68e",
                "name": "Enterprise Mobility + Security E3",
                "skuPartNumber": "EMS",
                "licenseGroupId": "group1"
            },
            "attributes": {
                "objectType": "License"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}