Atualizar contas de usuário para um cliente
Atualize os detalhes em uma conta de usuário existente para seu cliente.
Pré-requisitos
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:
- Administrador de usuários
- Gravadores de diretório
C#
Para atualizar os detalhes de um usuário de cliente especificado, primeiro recupere a ID do cliente especificada e o usuário a ser atualizado. Em seguida, crie uma versão atualizada do usuário em um novo objeto CustomerUser . Em seguida, use sua coleção IAggregatePartner.Customers e chame o método ById(). Em seguida, chame a propriedade Users, o método ById(), seguido pelo método Patch().
// string selectedCustomerId;
// customerUser specifiedUser;
// IAggregatePartner partnerOperations;
// Updated information
var userToUpdate = new CustomerUser()
{
PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "testPw@!122B" },
DisplayName = "DisplayNameChange",
FirstName = "FirstNameChange",
LastName = "LastNameChange",
UsageLocation = "US",
UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
};
// Update customer user information
User updatedCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(specifiedUser.Id).Patch(userToUpdate);
Exemplo
Aplicativo de teste de console. Projeto: PartnerSDK.FeatureSamples Classe: CustomerUserUpdate.cs
Solicitação REST
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
PATCH | {baseURL} /v1/clientes / {cliente-tenant-id} / usuários HTTP/1.1 |
Parâmetro do URI
Use o parâmetro de consulta a seguir para identificar o cliente correto.
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.
Exemplo de solicitação
PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
{
"usageLocation": "new country/region code",
"attributes": {
"objectType": "CustomerUser"
}
}
Resposta REST
Se bem-sucedido, esse método retorna uma conta de usuário com as informações atualizadas.
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.
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
{
"usageLocation": "new country/region code",
"id": "4b10bf41-ab11-40e3-8c53-cd67849b50de",
"userPrincipalName": "emailidchange@abcdefgh1234.onmicrosoft.com",
"firstName": "FirstNameChange",
"lastName": "LastNameChange",
"displayName": "DisplayNameChange",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/users/4b10bf41-ab11-40e3-8c53-cd67849b50de",
"method": "GET",
"headers": [
]
}
},
"attributes": {
"objectType": "CustomerUser"
}
}