Share via

delegatedAdminRelationship を更新する

  • [アーティクル]

名前空間: microsoft.graph

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

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

  • 状態プロパティが の場合は、createdこのリレーションシップを更新できます。
  • autoExtendDuration プロパティは、状態が または activeの場合にcreated更新できます。
  • 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 microsoft.graph.delegatedAdminAccessDetails パートナーが顧客テナントで要求するか、アクセス権を持つ管理ロールの識別子。
autoExtendDuration 期間 リレーションシップの有効性が自動的に拡張される期間。ISO 8601 形式で示されます。 サポートされる値は、 P0D、 PT0S、です P180D。 既定値は PT0S です。 PT0S は、 endDateTime に達したときにリレーションシップが期限切れになり、自動的に拡張されていないことを示します。
顧客 microsoft.graph.delegatedAdminRelationshipCustomerParticipant リレーションシップの顧客の表示名と一意識別子。
displayName String 識別しやすくするために使用されるリレーションシップの表示名。 パートナー のすべての 委任された管理者リレーションシップで一意である必要があります。 最大長は 50 文字です。
duration 期間 ISO 8601 形式のリレーションシップの期間。 と の間P1DP2Yの値である必要があります。

応答

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

応答ヘッダー

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

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

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

例

要求

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

PATCH https://graph.microsoft.com/v1.0/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/v1.0/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/v1.0/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

{
}