创建 delegatedAdminRelationship

  • 项目

命名空间：microsoft.graph

创建新的 delegatedAdminRelationship 对象。

权限

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

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

HTTP 请求

POST /tenantRelationships/delegatedAdminRelationships

请求标头

名称 说明
Authorization 持有者 {token}。 必填。
Content-Type application/json. 必需。

请求正文

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

创建 delegatedAdminRelationship 时，可以指定以下属性。

属性 类型 说明
accessDetails microsoft.graph.delegatedAdminAccessDetails 合作伙伴在客户租户中请求或有权访问的管理角色的标识符。 必填。
客户 microsoft.graph.delegatedAdminRelationshipCustomerParticipant 关系的客户的显示名称和唯一标识符。 可选。
displayName String 为便于识别而使用的关系的显示名称。 在合作伙伴 的所有 委派管理员关系中必须是唯一的。 必填。
duration 持续时间 ISO 8601 格式的关系持续时间。 必须是 和 P2Y （含）之间的P1D值。 必填。

响应

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

响应包含 一个 Location 标头，其中包含已创建的委托管理关系的 URL。 根据 RFC2616，每个 delegatedAdminRelationship 对象都包含 一个 @odata.etag 属性。

示例

请求

POST https://graph.microsoft.com/v1.0/tenantRelationships/delegatedAdminRelationships
Content-Type: application/json

{
  "displayName": "Contoso admin relationship",
  "duration": "P730D",
  "customer": {
    "tenantId": "4b827261-d21f-4aa9-b7db-7fa1f56fb163",
    "displayName": "Contoso subsidiary Inc"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  }
}

响应

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

HTTP/1.1 201 Created
Content-Type: application/json
Location: https://graph.microsoft.com/v1.0/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836

{
  "@odata.type": "#microsoft.graph.delegatedAdminRelationship",
  "@odata.context": "https://graph.microsoft.com/v1.0/tenantRelationships/$metadata#delegatedAdminRelationships",
  "@odata.etag": "W/\"JyIxODAwZTY4My0wMDAwLTAyMDAtMDAwMC02MTU0OWFmMDAwMDAiJw==\"",
  "id": "5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836",
  "displayName": "Contoso admin relationship",
  "duration": "P730D",
  "customer": {
    "tenantId": "4b827261-d21f-4aa9-b7db-7fa1f56fb163",
    "displayName": "Contoso subsidiary Inc"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "status": "created",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:24:42.3148266Z",
  "activatedDateTime": "",
  "endDateTime": "2024-02-10T11:24:42.3148266Z"
}