大网数据广告活动
Microsoft Graph 接口

创建域

· 52CE 我爱测

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

命名空间: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
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 adimitui)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。