Müşteri kullanıcısını rolden kaldırma

Müşteri hesabındaki bir dizin rolünden kullanıcı kaldırma.

Önkoşullar

• İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.

• Bir müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde sırasıyla Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve son olarak Hesap'ı seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği arayın. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

GDAP rolleri

Aşağıdaki GDAP rolüne ihtiyacınız vardır:

• Ayrıcalıklı Rol Yöneticisi

C#

Bir kullanıcıyı dizin rolünden kaldırmak için, IAggregatePartner.Customers.ById yöntemine yapılan bir çağrıyla değiştirmek üzere kullanıcının bulunduğu müşteriyi seçin. Buradan, dizin rol kimliğiyle DirectoryRoles.ById yöntemini kullanarak rolü belirtin. Ardından, kaldırılacak kullanıcıyı tanımlamak için UserMembers.ById yöntemine ve kullanıcıyı rolden kaldırmak için Delete yöntemine erişin.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedRoleId;
// string selectedUserMemberId;

partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedRoleId).UserMembers.ById(selectedUserMemberId).Delete();

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıf: RemoveCustomerUserMemberFromDirectoryRole.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
SİL	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers/{user-ID} HTTP/1.1

URI parametresi

Doğru müşteriyi, rolü ve kullanıcıyı tanımlamak için aşağıdaki URI parametrelerini kullanın.

Ad	Tür	Gerekli	Açıklama
customer-tenant-id	guid	Y	Değer, müşteriyi tanımlayan, biçimlendirilmiş bir GUID customer-tenant-id'dir.
rol kimliği	guid	Y	Değer, rolü tanımlayan role-id biçiminde bir GUID'dir.
kullanıcı kimliği	guid	Y	Değer, GUID biçimli kullanıcı kimliği olan ve tek bir kullanıcı hesabını tanımlayan bir değerdir.

İstek üst bilgileri

Daha fazla bilgi için bkz. Ortak Merkezi REST başlıkları.

İstek gövdesi

Hiç kimse.

İstek örneği

DELETE https://api.partnercenter.microsoft.com/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee%20/directoryroles/729827e3-9c14-49f7-bb1b-9608f156bbb8/usermembers/aaaabbbb-0000-cccc-1111-dddd2222eeee%20 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0a00ec08-6273-46bb-ab6f-14a13959b381
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0
Connection: Keep-Alive

REST yanıtı

Kullanıcı rolden başarıyla kaldırılırsa yanıt gövdesi boş olur.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e784d7aa-8c8d-45ee-8f97-9e09823d7338
MS-CV: es01VX8do0u2aTXw.0
MS-ServerId: 101112616
Date: Tue, 20 Dec 2016 23:16:35 GMT