コンピューターの更新

適用対象:

• Microsoft Defender for Endpoint Plan 1
• Microsoft Defender for Endpoint Plan 2
• Microsoft Defender XDR

Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。

API の説明

既存の Machine のプロパティを更新 します。

更新可能なプロパティは、 machineTags と deviceValueです。

制限事項

1. API で使用できるマシンを更新できます。
2. 更新マシンはタグ コレクションにのみタグを追加します。 タグが存在する場合は、本文の tags コレクションに含まれている必要があります。
3. この API のレート制限は、1 分あたり 100 呼び出しと 1 時間あたり 1500 呼び出しです。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「Microsoft Defender for Endpoint API を使用する」を参照してください。

HTTP 要求

PATCH /api/machines/{machineId}

要求ヘッダー

要求本文

要求本文で、更新する必要がある関連フィールドの値を指定します。

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

パフォーマンスを最大限に高めるには、変更されていない既存の値を含めてはいけません。

応答

成功した場合、このメソッドは 200 OK を返し、更新されたプロパティを持つ応答本文の マシン エンティティを返します。

本文のマシン タグコレクションに既存のマシン タグが含まれていない場合は、すべてのタグが要求本文で指定されたタグに置き換えられます。

指定した ID を持つマシンが見つからなかった場合 - 404 が見つかりません。

例

要求

要求の例を次に示します。

PATCH https://api.securitycenter.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}