Obter funções de utilizador para um cliente

Obtenha uma lista de todas as funções/permissões anexadas a uma conta de utilizador. As variações incluem obter uma lista de todas as permissões em todas as contas de utilizador para um cliente, e obter uma lista de utilizadores que têm uma determinada função.

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).

Funções GDAP : Leitor de Diretório, Leitor Global, Administrador de Utilizador, Administrador de Função Privilegiada, Diretoria de Escritores

C#

Para recuperar todas as funções de diretório para um cliente especificado, recupere primeiro o ID do cliente especificado. Em seguida, use a sua coleção IAggregatePartner.Customers e ligue para o método ById (). Em seguida, ligue para a propriedade Do Diretório , seguida do método Get() ou **GetAsync()***.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var directoryRoles = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.Get();

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

Para recuperar uma lista de utilizadores de clientes que têm uma determinada função, primeiro recupere o ID do cliente especificado e o ID de papel de diretório. Em seguida, use a sua coleção IAggregatePartner.Customers e ligue para o método ById (). Em seguida, ligue para a propriedade Do Diretório , em seguida , o método ById( ) e, em seguida, a propriedade UserMembers , o seguido pelo método Get() ou GetAsync( ).

// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// string selectedDirectoryRoleId;

var userMembers = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedDirectoryRoleId).UserMembers.Get();

Amostra: App de teste de consola. Project: PartnerSDK.FeatureSamples Class: GetCustomerDirectoryRoleUserMembers.cs

Pedido de DESCANSO

Solicitar sintaxe

Método	URI do pedido
GET	{baseURL}/v1/clientes/{customer-tenant-id}/users/{user-id}/diretórios HTTP/1.1
GET	{baseURL}/v1/clientes/{cliente-inquilino-id}/diretórios HTTP/1.1
GET	{baseURL}/v1/clientes/{customer-tenant-id}/directyroles/{role-ID}/usermembers

Parâmetro URI

Utilize o seguinte parâmetro de consulta para identificar o cliente correto.

Nome	Tipo	Necessário	Descrição
cliente-inquilino-id	guid	Y	O valor é um design de cliente-inquilino-inquilino formatado guid que permite ao revendedor filtrar os resultados de um dado cliente que pertence ao revendedor.
id utilizador	guid	N	O valor é um id de utilizador formatado GUID que pertence a uma única conta de utilizador.
id role	guid	N	O valor é um id de papel formatado GUID que pertence a um tipo de papel. Você pode obter estes IDs consultando todas as funções de diretório para um cliente, em todas as contas de utilizador. (O segundo cenário, acima).

Cabeçalhos do pedido

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

Corpo do pedido

Exemplo de pedido

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id>/directoryroles HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76

Resposta do REST

Se for bem sucedido, este método devolve uma lista das funções associadas à conta de utilizador dada.

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 Códigos de Erro.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST

{
      "totalCount": 2,
      "items": [
        {
          "name": "Helpdesk Administrator",
          "id": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
          "attributes": { "objectType": "DirectoryRole" }
        },
        {
          "name": "User Account Administrator",
          "id": "fe930be7-5e62-47db-91af-98c3a49a38b1",
          "attributes": { "objectType": "DirectoryRole" }
        }
      ],
      "attributes": { "objectType": "Collection" }
}