ExternalItem の更新

名前空間: microsoft.graph.externalConnectors

重要

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

外部アイテムのプロパティを更新します。

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

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

アクセス許可

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

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

HTTP 要求

PUT /external/connections/{connection-id}/items/{item-id}

パス パラメーター

パラメーター 型 説明
connection-id string この externalConnection の id プロパティ
item-id string 開発者が指定した externalItem の id プロパティ。

要求ヘッダー

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

要求本文

要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれていない既存のプロパティ ( properties オブジェクト内のプロパティを除く) は、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。 次のプロパティを更新できます。

プロパティ 型 説明
ACL microsoft.graph.externalConnectors.acl コレクション アクセス制御エントリの配列。 各エントリは、ユーザーまたはグループに付与されるアクセスを指定します。
content microsoft.graph.externalConnectors.externalItemContent アイテムのコンテンツのプレーン テキスト表現。 このプロパティのテキストには、フルテキストのインデックスが作成されます。
informationProtectionLabel microsoft.graph.externalConnectors.externalItemInformationProtectionLabel 項目の Microsoft Purview 秘密度ラベルを指定します。 sensitivityLabelId プロパティを Purview 秘密度ラベルの GUID に設定します。 その後、サービスはラベル ルールを項目に適用します。 ラベル GUID を取得するには、 Get sensitivityLabel API または Get-Label PowerShell コマンドを使用します。 省略可能。
properties オブジェクト 項目のプロパティを含むプロパティ バッグ。 プロパティは、externalConnection に定義されたスキーマに準拠する必要があります。

ACL コレクションの更新

更新要求に acl プロパティが含まれている場合、既存の ACL コレクションは要求に含まれるコレクションで上書きされます。

プロパティ オブジェクトの更新

更新要求に properties プロパティが含まれている場合、既存のプロパティ バッグは要求に含まれる値で上書きされます。

informationProtectionLabel オブジェクトの更新

informationProtectionLabel プロパティが更新要求に含まれている場合、既存の informationProtectionLabel バッグは要求の値で上書きされます。

応答

成功した場合、このメソッドは応答本文で 200 OK 応答コードと更新された externalItem オブジェクトを返します。

例

要求

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

PUT https://graph.microsoft.com/beta/external/connections/contosohr/items/TSP228082938
Content-type: application/json

{
  "acl": [
    {
      "type": "everyone",
      "value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
      "accessType": "grant",
    }
  ]
}

応答

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

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

{
  "id": "TSP228082938",
  "acl": [
    {
      "type": "everyone",
      "value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
      "accessType": "grant",
    }
  ],
  "properties": {
    "title": "Error in the payment gateway",
    "priority": 1,
    "assignee": "john@contoso.com"
  },
  "content": {
    "value": "<h1>Error in payment gateway</h1><p>Error details...</p>",
    "type": "html"
  }
}