次の方法で共有

delegatedAdminRelationship を更新する

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

delegatedAdminRelationship オブジェクトのプロパティを更新します。

次の制限が適用されます。

  • 状態プロパティがcreatedされている場合は、このリレーションシップを更新できます。
  • 状態がcreatedまたはactiveの場合は、autoExtendDuration プロパティを更新できます。
  • Microsoft Entraグローバル管理者ロールは、実行時間の長い操作を示す status プロパティがactiveされている場合にのみ削除できます。

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

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

アクセス許可

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

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

重要

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

HTTP 要求

PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
If-Match If-match: {etag}。 delegatedAdminRelationship が更新される最後の既知の ETag 値。 LIST または GET 操作から ETag 値を取得します。 必須です。
Content-Type application/json. 必須です。

要求本文

要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

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

応答

成功した場合、このメソッドは 200 OK または 202 Accepted 応答コードを返します。 応答本文には、応答が200 OKされるときに delegatedAdminRelationship オブジェクトが含まれます。

応答ヘッダー

名前 説明
Content-Type application/json.
場所 実行時間の長い操作の場所。
Retry-After 実行時間の長い操作の状態をチェックするために、Location URL に対して後続の API 呼び出しを実行できる時間。

状態プロパティがactiveされている間に、リレーションシップからMicrosoft Entraグローバル管理者ロールを削除すると、このメソッドは202 Accepted応答を返します。 応答には、操作の進行状況を監視するために使用できる Url が Location ヘッダーに含まれています。

要求本文の accessDetails プロパティの unifiedRoles 配列のMicrosoft Entraグローバル管理者ロールに対応するテンプレート ID を指定しない場合、API は応答本文で200 OKと元の delegatedAdminRelationship オブジェクトを返します。

例

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836
If-Match: W/"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw=="
Content-Type: application/json

{
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

応答

次の例は応答を示しています。

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.delegatedAdminRelationship",
  "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/$metadata#delegatedAdminRelationships/$entity",
  "@odata.etag": "W/\"JyIwMzAwZTM0ZS0wMDAwLTAyMDAtMDAwMC02MTRjZjI1YzAwMDAiJw==\"",
  "id": "5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836",
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "status": "created",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:26:44.9941884Z",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

次に示す応答の例は、location ヘッダーと Retry-After ヘッダーと共に202 Accepted応答コードを返します。

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2
Retry-After: 10
Content-Type: application/json

{
}