Update user accounts for a customer (Actualizar cuentas de usuario para un cliente)
Actualice los detalles de una cuenta de usuario existente para el cliente.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un id. de cliente (
customer-tenant-id
). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id
).
Roles de GDAP
Necesitará al menos uno de los siguientes roles de GDAP:
- Administrador de usuarios
- Escritores de directorios
C#
Para actualizar los detalles de un usuario cliente especificado, primero recupere el identificador de cliente y el usuario especificados para actualizar. A continuación, cree una versión actualizada del usuario en un nuevo objeto CustomerUser . A continuación, use la colección IAggregatePartner.Customers y llame al método ById(). A continuación, llame a la propiedad Users, el método ById(), seguido del 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);
Ejemplo
Aplicación de prueba de consola. Project: PartnerSDK.FeatureSamples (Clase): CustomerUserUpdate.cs
Solicitud REST
Sintaxis de la solicitud
Method | URI de solicitud |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
Parámetro de URI
Use el siguiente parámetro de consulta para identificar el cliente correcto.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
customer-tenant-id | guid | Y | El valor es un GUID con formato customer-tenant-id que permite al revendedor filtrar los resultados de un cliente determinado que pertenece al revendedor. |
user-id | guid | Y | El valor es un identificador de usuario con formato GUID que pertenece a una sola cuenta de usuario. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Ejemplo de solicitud
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"
}
}
Respuesta REST
Si se ejecuta correctamente, este método devuelve una cuenta de usuario con la información actualizada.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
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"
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de