Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Obtenha uma conta de usuário específica para um cliente.
Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
Uma ID do cliente (
customer-tenant-id
). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho Clientes, 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 é igual à ID do cliente (customer-tenant-id
).
Funções GDAP
Você precisará de pelo menos uma das seguintes funções GDAP:
- Leitor de Diretório
- Leitor global
- Administrador de usuários
C#
Para recuperar uma conta de usuário para um cliente, chame o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente. Em seguida, chame o método Users.ById para recuperar o usuário específico. Finalmente, chame o método Users.Get ou GetAsync para recuperar a conta de usuário.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;
// Get customer user detail.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Get();
Exemplo: Aplicativo de teste de console. Projeto: Exemplos de SDK do Partner Center Classe: GetCustomerUserDetails.cs
Solicitação REST
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
GET | {baseURL} /v1/clientes / {id de locatário cliente} /users/ {id de usuário} HTTP/1.1 |
Parâmetro do URI
Use os seguintes parâmetros de URI para identificar o cliente e o usuário corretos.
Nome | Type | Obrigatório | Descrição |
---|---|---|---|
id de locatário do cliente | guid | S | O valor é um ID de cliente-locatário formatado por GUID que permite ao revendedor filtrar os resultados de um determinado cliente que pertence ao revendedor. |
id de usuário | guid | S | O valor é um ID de usuário formatado em GUID que pertence a uma única conta de usuário. |
Cabeçalhos de solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
None.
Exemplo de solicitação
GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Resposta REST
Se bem-sucedido, esse método retorna a conta de usuário para o cliente.
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.
Exemplo de resposta
HTTP/1.1 200 OK
Content-Length: 432
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CV: uWM1EGU7+0aI2MvV.0
MS-ServerId: 020021921
Date: Wed, 21 Dec 2016 22:59:10 GMT
{
"usageLocation": "US",
"id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
"userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
"firstName": "Daniel",
"lastName": "Tsai",
"displayName": "Daniel Tsai",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerUser"
}
}