创建域

命名空间：microsoft.graph

向租户添加域。

重要说明：必须完成所有权验证，才可以使用与 Azure AD 租户关联的域。有关详细信息，请参阅 列出 verificationDnsRecords。需要对根域进行验证。例如，需要对 contoso.com 进行验证。如果已验证根域，则将自动验证该根域的子域。例如，如果已验证 contoso.com，则将自动验证 subdomain.contoso.com。

Permissions

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Domain.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	Domain.ReadWrite.All

HTTP 请求

POST /domains

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-Type	application/json

请求正文

在请求正文中，提供 domain 对象的 JSON 表示形式。

请求正文包含新域的 id 属性。Id 是唯一可以指定，也是必须指定的属性。此 id 属性值是要创建的完全限定的域名。

响应

如果成功，此方法在响应正文中返回 201 Created 响应代码和 domain 对象。

示例

请求

在请求正文中，提供 domain 对象的 JSON 表示形式。

POST https://graph.microsoft.com/v1.0/domains
Content-type: application/json

{
  "id": "contoso.com"
}

响应

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-type: application/json

{
  "authenticationType": "authenticationType-value",
  "availabilityStatus": "availabilityStatus-value",
  "id": "contoso.com",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true
}