Aktualisieren von Benutzerkonten für einen Kunden
Aktualisieren Sie Details in einem vorhandenen Benutzerkonto für Ihren Kunden.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (
customer-tenant-id
). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id
).
GDAP-Rollen
Sie benötigen mindestens eine der folgenden GDAP-Rollen:
- Benutzeradministrator
- Verzeichnis schreiben
C#
Um die Details für einen angegebenen Kundenbenutzer zu aktualisieren, rufen Sie zuerst die angegebene Kunden-ID und den angegebenen Benutzer ab, um die Aktualisierung zu aktualisieren. Erstellen Sie dann eine aktualisierte Version des Benutzers in einem neuen CustomerUser-Objekt . Verwenden Sie dann Ihre IAggregatePartner.Customers-Auflistung , und rufen Sie die ById()- Methode auf. Rufen Sie dann die Users-Eigenschaft , die ById() -Methode auf, gefolgt von der Patch() -Methode.
// 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);
Beispiel
Konsolentest-App. Projekt: PartnerSDK.FeatureSamples-Klasse: CustomerUserUpdate.cs
REST-Anforderung
Anforderungssyntax
Methode | Anforderungs-URI |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
URI-Parameter
Verwenden Sie den folgenden Abfrageparameter, um den richtigen Kunden zu identifizieren.
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
customer-tenant-id | guid | J | Der Wert ist eine GUID-formatierte Kundenmandanten-ID , die es dem Händler ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, der zum Händler gehört. |
Benutzer-ID | guid | J | Der Wert ist eine GUID- formatierte Benutzer-ID , die zu einem einzelnen Benutzerkonto gehört. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Beispiel für eine Anfrage
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"
}
}
REST-Antwort
Bei erfolgreicher Ausführung gibt die Methode ein Benutzerkonto mit den aktualisierten Informationen zurück.
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.
Beispielantwort
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"
}
}