Mettre à jour des comptes d’utilisateur d’un client
Mettez à jour les détails dans un compte d’utilisateur existant pour votre client.
Prerequisites
Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID du client (
customer-tenant-id
). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id
).
Rôles GDAP
Vous aurez besoin d’au moins l’un des rôles GDAP suivants :
- Administrateur d'utilisateurs
- Enregistreurs de répertoire
C#
Pour mettre à jour les détails d’un utilisateur client spécifié, commencez par récupérer l’ID client et l’utilisateur spécifiés à mettre à jour. Ensuite, créez une version mise à jour de l’utilisateur dans un nouvel objet CustomerUser . Utilisez ensuite votre collection IAggregatePartner.Customers et appelez la méthode ById(). Appelez ensuite la propriété Users, la méthode ById(), suivie de la méthode 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);
Exemple
Application de test de console. Projet : PartnerSDK.FeatureSamples , classe : CustomerUserUpdate.cs
Demande REST
Syntaxe de la requête
Method | URI de demande |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
Paramètre d’URI
Utilisez le paramètre de requête suivant pour identifier le client approprié.
Nom | Type | Obligatoire | Description |
---|---|---|---|
id-locataire-client | guid | O | La valeur est un ID client au format GUID qui permet au revendeur de filtrer les résultats d’un client donné qui appartient au revendeur. |
user-id | guid | O | La valeur est un ID d’utilisateur au format GUID qui appartient à un seul compte d’utilisateur. |
En-têtes de demande
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Exemple de requête
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"
}
}
Réponse REST
Si elle réussit, cette méthode retourne un compte d’utilisateur avec les informations mises à jour.
Codes d’erreur et de réussite de la réponse
Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.
Exemple de réponse
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"
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour