Memverifikasi ketersediaan domain

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud for US Government

Cara menentukan apakah domain tersedia untuk digunakan.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

  • Domain (misalnya contoso.onmicrosoft.com).

C#

Untuk memverifikasi apakah domain tersedia, pertama-tama panggil IAggregatePartner.Domains untuk mendapatkan antarmuka ke operasi domain. Kemudian panggil metode ByDomain dengan domain untuk memeriksa. Metode ini mengambil antarmuka ke operasi yang tersedia untuk domain tertentu. Terakhir, panggil metode Exists untuk melihat apakah domain sudah ada.

// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";

bool result = partnerOperations.Domains.ByDomain(domain).Exists();

Sampel: Aplikasi pengujian konsol. Proyek: Kelas Sampel SDK Pusat Mitra: CheckDomainAvailability.cs

Permintaan REST

Minta sintaks

Metode Meminta URI
HEAD {baseURL}/v1/domains/{domain} HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk memverifikasi ketersediaan domain.

Nama Jenis Diperlukan Deskripsi
domain string Y String yang mengidentifikasi domain untuk diperiksa.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada

Contoh permintaan

HEAD https://api.partnercenter.microsoft.com/v1/domains/contoso.onmicrosoft.com HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Respons REST

Jika domain ada, domain tidak tersedia untuk digunakan dan kode status respons 200 OK dikembalikan. Jika domain tidak ditemukan, domain tersedia untuk digunakan dan kode status respons 404 Tidak Ditemukan dikembalikan.

Respons keberhasilan dan kode kesalahan

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 saat domain sudah digunakan

HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CV: 7UXAHds8J0mNUCSp.0
MS-ServerId: 201022015
Date: Tue, 31 Jan 2017 22:22:35 GMT

Contoh respons saat domain tersedia

HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT
  • Last updated on