次の方法で共有

delegatedAdminRelationship を作成する

  • [アーティクル]

名前空間: microsoft.graph

新しい delegatedAdminRelationship オブジェクトを 作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) DelegatedAdminRelationship.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション DelegatedAdminRelationship.ReadWrite.All 注意事項なし。

重要

アプリケーションのアクセス許可を使用してこの API を呼び出すには、 appId2832473f-ec63-45fb-976f-5d45a7d4bb91 パートナー テナントで パートナー顧客委任管理 という名前のサービス プリンシパルをプロビジョニングする必要があります。 パートナー テナントでサービス プリンシパルをプロビジョニングするには、 Create servicePrincipal API を呼び出します。

HTTP 要求

POST /tenantRelationships/delegatedAdminRelationships

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 delegatedAdminRelationship オブジェクトの JSON 表現を指定します。

delegatedAdminRelationship を作成するときに、次のプロパティを指定できます。

プロパティ 型 説明
accessDetails microsoft.graph.delegatedAdminAccessDetails パートナーが顧客テナントで要求するか、アクセス権を持つ管理ロールの識別子。 必須です。
autoExtendDuration 期間 リレーションシップの有効性が自動的に拡張される期間。ISO 8601 形式で示されます。 サポートされる値は、 P0D、 PT0S、 P180Dです。 既定値は PT0S です。 PT0S は、 endDateTime に達したときにリレーションシップが期限切れになり、自動的に拡張されていないことを示します。 省略可能。
顧客 microsoft.graph.delegatedAdminRelationshipCustomerParticipant リレーションシップの顧客の表示名と一意識別子。 省略可能。
displayName String 識別しやすくするために使用されるリレーションシップの表示名。 パートナー のすべての 委任された管理者リレーションシップで一意である必要があります。 必須です。 最大長は 50 文字です。
duration 期間 ISO 8601 形式のリレーションシップの期間。 P1DとP2Y包括の間の値である必要があります。 必須です。

応答

成功した場合、このメソッドは応答コード 201 Created と、応答本文に delegatedAdminRelationship オブジェクトを返します。

応答には、作成された委任された管理者関係への URL を含む Location ヘッダーが含まれています。 各 delegatedAdminRelationship オブジェクトには、RFC2616に従って @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"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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",
  "autoExtendDuration": "P180D",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:24:42.3148266Z",
  "activatedDateTime": "",
  "endDateTime": "2024-02-10T11:24:42.3148266Z"
}