验证域可用性

  • 项目

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

如何确定域是否可供使用。

必备条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和应用+用户凭据进行身份验证。

  • 域 (例如 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 参数

使用以下查询参数验证域可用性。

名称 类型 必须 说明
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: ec57501a-a4c3-45ee-ab2b-da4250545fc9
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

REST 响应

如果该域存在，则它不可用，并返回响应状态代码 200 OK。 如果找不到域，则可供使用，并返回响应状态代码 404“未找到”。

响应的成功和错误代码

每个响应都带有一个 HTTP 状态代码，用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表，请参阅合作伙伴中心 REST 错误代码。

域已在使用中的响应示例

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

域可用时的响应示例

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