Etki alanı kullanılabilirliğini doğrulama
Uygulama hedefi: Iş Ortağı Merkezi | 21Vianet tarafından işletilen iş ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi
Bir etki alanının kullanıma hazır olup olmadığını belirleme.
Önkoşullar
Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Bir etki alanı (örneğin
contoso.onmicrosoft.com).
C#
Bir etki alanının kullanılabilir olup olmadığını doğrulamak için, önce etki alanı işlemlerine bir arabirim almak üzere ıaggregatepartner. Domains ' ı çağırın. Ardından, denetlenecek etki alanı ile bydomain yöntemini çağırın. Bu yöntem, belirli bir etki alanı için kullanılabilir işlemlere bir arabirim alır. Son olarak, etki alanının zaten mevcut olup olmadığını görmek için EXISTS metodunu çağırın.
// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";
bool result = partnerOperations.Domains.ByDomain(domain).Exists();
Örnek: konsol test uygulaması. Project: iş ortağı merkezi SDK örnekleri sınıfı: checkdomainavaılabılıty. cs
REST isteği
İstek sözdizimi
| Yöntem | İstek URI'si |
|---|---|
| BAŞLı | {BaseUrl}/v1/Domains/{Domain} http/1.1 |
URI parametresi
Etki alanı kullanılabilirliğini doğrulamak için aşağıdaki sorgu parametresini kullanın.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| alanını | string | Y | Denetlenecek etki alanını tanımlayan bir dize. |
İstek üst bilgileri
Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.
İstek gövdesi
Yok
İstek örneği
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: ec57501a-a4c3-45ee-ab2b-da4250545fc9
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive
REST yanıtı
Etki alanı varsa, kullanım için kullanılamaz ve 200 Tamam yanıt durum kodu döndürülür. Etki alanı bulunmazsa, kullanılabilir ve 404 yanıt durum kodu döndürülür.
Yanıt başarısı ve hata kodları
Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş ortağı MERKEZI Rest hata kodları.
Etki alanı zaten kullanımda olduğunda yanıt örneği
HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CV: 7UXAHds8J0mNUCSp.0
MS-ServerId: 201022015
Date: Tue, 31 Jan 2017 22:22:35 GMT
Etki alanı kullanılabilir olduğunda yanıt örneği
HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: 54770745-17f0-433c-bd7b-0265e5b38f98
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT