고객의 삭제된 사용자 역할 설정

아티클
03/06/2024

고객 계정 내에는 디렉터리 역할 집합이 있습니다. 사용자 계정을 해당 역할에 할당할 수 있습니다.

전제 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱 + 사용자 자격 증명을 사용한 인증만 지원합니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 선택하여파트너 센터에서 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

GDAP 역할

다음 GDAP 역할이 필요합니다.

권한 있는 역할 관리자

C#

고객 사용자에게 디렉터리 역할을 할당하려면 관련 사용자 세부 정보가 포함된 새 UserMember 를 만듭니다. 그런 다음 지정된 고객 ID를 사용하여 IAggregatePartner.Customers.ById 메서드를 호출하여 고객을 식별합니다. 여기에서 디렉터리 역할 ID와 함께 DirectoryRoles.ById 메서드를 사용하여 역할을 지정합니다. 그런 다음 UserMembers 컬렉션에 액세스하고 Create 메서드를 사용하여 해당 역할에 할당된 사용자 멤버의 컬렉션에 새 사용자 멤버를 추가합니다.

// 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);

샘플: 콘솔 테스트 앱. 프로젝트: 파트너 센터 SDK 샘플 클래스: AddUserMemberToDirectoryRole.cs

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers HTTP/1.1

URI 매개 변수

다음 URI 매개 변수를 사용하여 올바른 고객 및 역할을 식별합니다. 역할을 할당할 사용자를 식별하려면 요청 본문에 식별 정보를 제공합니다.

입력	종류	필수	설명
customer-tenant-id	guid	Y	값은 재판매인이 재판매인에 속한 지정된 고객에 대한 결과를 필터링할 수 있도록 하는 GUID 형식 의 customer-tenant-id 입니다.
role-id	guid	Y	값은 사용자에게 할당할 역할을 식별하는 GUID 형식 의 역할 ID 입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

Request body

이 표에서는 요청 본문의 필수 속성에 대해 설명합니다.

입력	종류	필수	설명
ID	string	Y	역할에 추가할 사용자의 ID입니다.
DisplayName	string	Y	사용자의 친숙한 표시 이름입니다.
UserPrincipalName	string	Y	사용자 계정의 이름입니다.
특성	개체	Y	"ObjectType":"UserMember"를 포함합니다.

요청 예제

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 응답

이 메서드는 사용자가 역할을 성공적으로 할당할 때 역할 ID가 연결된 사용자 계정을 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

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"
    }
}

다음을 통해 공유