Ange användarroller för en kund
I ett kundkonto finns det en uppsättning katalogroller. Du kan tilldela användarkonton till dessa roller.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id
).
GDAP-roller
Du behöver följande GDAP-roll:
- Administratör för privilegierad roll
C#
Om du vill tilldela en katalogroll till en kundanvändare skapar du en ny UserMember med relevant användarinformation. Anropa sedan metoden IAggregatePartner.Customers.ById med det angivna kund-ID:t för att identifiera kunden. Därifrån använder du metoden DirectoryRoles.ById med katalogroll-ID:t för att ange rollen. Öppna sedan samlingen UserMembers och använd metoden Skapa för att lägga till den nya användarmedlemmen i samlingen med användarmedlemmar som tilldelats den rollen.
// UserMember createdUser;
// IAggregatePartner partnerOperations;
// Customer selectedCustomer;
// IDirectoryRole selectedRole;
// Create the new user member.
UserMember userMemberToAdd = new UserMember()
{
UserPrincipalName = createdUser.UserPrincipalName,
DisplayName = createdUser.DisplayName,
Id = createdUser.Id
};
// Add the new user member to the role.
var userMemberAdded = partnerOperations.Customers.ById(selectedCustomer.Id).DirectoryRoles.ById(selectedRole.Id).UserMembers.Create(userMemberToAdd);
Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: AddUserMemberToDirectoryRole.cs
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1 |
URI-parameter
Använd följande URI-parametrar för att identifiera rätt kund och roll. Om du vill identifiera den användare som rollen ska tilldelas anger du den identifierande informationen i begärandetexten.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
customer-tenant-id | Guid | Y | Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren. |
roll-id | Guid | Y | Värdet är ett GUID-formaterat roll-ID som identifierar rollen som användaren ska tilldelas. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
I den här tabellen beskrivs de nödvändiga egenskaperna i begärandetexten.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
Id | Sträng | Y | ID:t för användaren som ska läggas till i rollen. |
DisplayName | Sträng | Y | Användarens egna visningsnamn. |
UserPrincipalName | Sträng | Y | Namnet på användarens huvudnamn. |
Attribut | Objekt | Y | Innehåller "ObjectType":"UserMember" |
Exempel på begäran
POST https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/directoryroles/f023fd81-a637-4b56-95fd-791ac0226033/usermembers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a56cb2e5-a156-4f68-9155-57ffe2b93d18
MS-CorrelationId: 90bda268-7929-4ad6-be01-89c5af5fc504
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 180
Expect: 100-continue
{
"Id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
"DisplayName": "Daniel Tsai",
"UserPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
"Attributes": {
"ObjectType": "UserMember"
}
}
REST-svar
Den här metoden returnerar användarkontot med roll-ID:t kopplat när användaren har tilldelats rollen.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.
Svarsexempel
HTTP/1.1 201 Created
Content-Length: 231
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 90bda268-7929-4ad6-be01-89c5af5fc504
MS-RequestId: a56cb2e5-a156-4f68-9155-57ffe2b93d18
MS-CV: aia94+gnrEeQqkGr.0
MS-ServerId: 101112202
Date: Tue, 20 Dec 2016 23:36:55 GMT
{
"displayName": "Daniel Tsai",
"userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
"roleId": "f023fd81-a637-4b56-95fd-791ac0226033",
"id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
"attributes": {
"objectType": "UserMember"
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för