Bagikan melalui

Mendapatkan daftar semua akun pengguna untuk pelanggan

Artikel ini menjelaskan cara mendapatkan daftar semua akun pengguna milik salah satu pelanggan Anda.

Untuk mencari satu akun pengguna berdasarkan ID, lihat Mendapatkan akun pengguna berdasarkan ID.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial App+User.

  • ID pelanggan (customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan, lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).

Peran dari GDAP

Anda akan memerlukan setidaknya salah satu peran GDAP berikut:

  • Pembaca Direktori
  • Pembaca global
  • Administrator Pengguna

C#

Untuk mengambil koleksi semua akun pengguna untuk pelanggan tertentu:

  1. Panggil metode IAggregatePartner.Customers.ById dengan ID pelanggan yang ditentukan untuk mengidentifikasi pelanggan.

  2. Panggil metode Users.Get atau GetAsync untuk mengambil koleksi.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

// Get customer users collection.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.Get();

Misalnya, lihat yang berikut ini:

Permintaan REST

Sintaksis permintaan

Metode Meminta URI
AMBIL {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1

Parameter URI

Gunakan parameter URI berikut untuk mengidentifikasi pelanggan yang benar.

Nama Jenis Diperlukan Deskripsi
id penyewa pelanggan panduan Y Nilainya adalah GUID yang diformat customer-tenant-id yang memungkinkan reseller memfilter hasil untuk pelanggan tertentu milik reseller.

Header permintaan

Untuk informasi selengkapnya, lihat header REST Pusat Mitra.

Isi permintaan

Tidak.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Tanggapan REST

Jika berhasil, metode ini mengembalikan kumpulan akun pengguna untuk pelanggan.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat kode kesalahan REST Pusat Mitra .

Contoh respons

HTTP/1.1 200 OK
Content-Length: 1030
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CV: 6zmKqrSFB0+t7m3y.0
MS-ServerId: 101112616
Date: Wed, 21 Dec 2016 21:13:24 GMT

 {
    "totalCount": 2,
    "items": [{
            "usageLocation": "US",
            "id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
            "userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
            "firstName": "Daniel",
            "lastName": "Tsai",
            "displayName": "Daniel Tsai",
            "userDomainType": "none",
            "state": "active",
            "links": {
                "self": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "CustomerUser"
            }
        }, {
            "id": "6e668259-1f09-479d-bcb8-d9b03e826b8d",
            "userPrincipalName": "admin@dtdemocspcustomer005.onmicrosoft.com",
            "firstName": "Daniel",
            "lastName": "Tsai",
            "displayName": "DT Demo CSP Customer 005",
            "userDomainType": "none",
            "state": "active",
            "links": {
                "self": {
                    "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/6e668259-1f09-479d-bcb8-d9b03e826b8d",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "CustomerUser"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}