適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
ドメインを使用できるかどうかを判断する方法。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
ドメイン (例:
contoso.onmicrosoft.com)。
C#
ドメインが使用可能かどうかを確認するには、まず IAggregatePartner.Domains を呼び出して、ドメイン操作へのインターフェイスを取得します。 次に、ドメインを指定して ByDomain メソッドを呼び出してチェックします。 このメソッドは、特定のドメインで使用できる操作へのインターフェイスを取得します。 最後に、 Exists メソッドを呼び出して、ドメインが既に存在するかどうかを確認します。
// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";
bool result = partnerOperations.Domains.ByDomain(domain).Exists();
サンプル: コンソール テスト アプリ。 プロジェクト: パートナー センター SDK サンプル クラス: CheckDomainAvailability.cs
REST 要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| HEAD | {baseURL}/v1/domains/{domain} HTTP/1.1 |
URI パラメーター
ドメインの可用性を確認するには、次のクエリ パラメーターを使用します。
| 名前 | Type | 必須 | 説明 |
|---|---|---|---|
| domain | string | Y | チェック対象のドメインを識別する文字列。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
なし
要求の例
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
REST 応答
ドメインが存在する場合は使用できません。応答状態コード 200 OK が返されます。 ドメインが見つからない場合は、使用でき、応答状態コード 404 Not Found が返されます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。
ドメインが既に使用されている場合の応答の例
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
ドメインが使用可能な場合の応答の例
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