ID による 1 つの修復アクティビティを取得する

[アーティクル]
08/14/2024

適用対象:

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

Microsoft Defender 脆弱性の管理を体験するには Microsoft Defender 脆弱性の管理パブリックプレビュー試用版にサインアップする方法について説明します。

重要

この記事の一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここで提供されるいかなる情報に関して、明示または黙示を問わず、いかなる保証も行いません。

注:

米国政府機関のお客様は、 Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してください。

ヒント

パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

API の説明

指定した修復アクティビティの情報を返します。 [ すべての修復アクティビティの取得] と同じ列を表示しますが、 指定した 1 つの修復アクティビティについてのみ結果を返します。

修復アクティビティの詳細については、こちらをご覧ください。

(ID) の指定された修復アクティビティを一覧表示する

URL: GET: /api/remediationTasks/{id}

アクセス許可

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

アクセス許可の種類	アクセス許可	アクセス許可の表示名
アプリケーション	RemediationTasks.Read.All	'脅威と脆弱性管理の脆弱性情報の読み取り'
委任 (職場または学校のアカウント)	RemediationTask.Read.Read	'脅威と脆弱性管理の脆弱性情報の読み取り'

プロパティ

プロパティ (ID)	データ型	説明	戻り値の例
カテゴリ	文字列	修復アクティビティのカテゴリ (ソフトウェア/セキュリティ構成)	ソフトウェア
completerEmail	String	修復アクティビティが誰かによって手動で完了された場合、この列にはメールが含まれます	Null
completerId	String	修復アクティビティが誰かによって手動で完了された場合、この列にはオブジェクト ID が含まれます	Null
completionMethod	String	修復アクティビティは、"完了としてマーク" を選択したユーザーが "自動的に" (すべてのデバイスに修正プログラムが適用されている場合) または "手動" で完了できます	自動
createdOn	DateTime	この修復アクティビティが作成された時刻	2021-01-12T18:54:11.5499478Z
説明	String	この修復アクティビティの説明	デバイスに影響する既知の脆弱性を軽減するために、Microsoft Silverlight を新しいバージョンに更新します。
dueOn	DateTime	この修復アクティビティに対して作成者が設定した期限	2021-01-13T00:00:00Z
fixedDevices		固定されているデバイスの数	2
ID	String	この修復アクティビティの ID	097d9735-5479-4899-b1b7-77398899df92
nameId	String	関連する製品名	Microsoft Silverlight
優先度	String	この修復アクティビティの作成者セットの優先度 (高\中\低)	高い
productId	String	関連する製品 ID	microsoft-_-silverlight
productivityImpactRemediationType	String	いくつかの構成変更は、ユーザーに影響を与えないデバイスに対してのみ要求できます。この値は、"すべての公開デバイス" または "ユーザーに影響のないデバイスのみ" の選択を示します。	AllExposedAssets
rbacGroupNames	String	関連するデバイスグループ名	[ "Windows Server"、"Windows 11"、"Windows 10" ]
recommendedProgram	String	にアップグレードするための推奨プログラム	Null
recommendedVendor	String	にアップグレードすることをお勧めするベンダー	Null
recommendedVersion	String	更新/アップグレードする推奨バージョン	Null
relatedComponent	String	この修復アクティビティの関連コンポーネント (セキュリティに関する推奨事項の関連コンポーネントと同様)	Microsoft Silverlight
requesterEmail	String	作成者のメールアドレス	globaladmin@UserName.contoso.com
requesterId	String	Creator オブジェクト ID	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	String	この修復アクティビティに作成者が追加したノート (フリーテキスト)	Null
Scid	String	関連するセキュリティに関する推奨事項の SCID	Null
状態	String	修復アクティビティの状態 (アクティブ/完了)	アクティブ
statusLastModifiedOn	DateTime	状態フィールドが更新された日付	2021-01-12T18:54:11.5499487Z
targetDevices	Long	この修復が適用される公開されているデバイスの数	43
Title	String	この修復アクティビティのタイトル	Microsoft Silverlight
型	String	修復の種類	Update
vendorId	String	関連ベンダー名	Microsoft

例

要求の例

GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c

応答の例

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
    "id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
    "title": "Update Microsoft Silverlight",
    "createdOn": "2021-02-10T13:20:36.4718166Z",
    "requesterId": "65548a1d-efo0-4a7a-8d19-1b967b5c36f4",
    "requesterEmail": "user1@contoso.com",
    "status": "Active",
    "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
    "description": "Update Silverlight to a later version to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
    "relatedComponent": "Microsoft Silverlight",
    "targetDevices": 18511,
    "rbacGroupNames": [
        "UnassignedGroup",
        "hhh"
    ],
    "fixedDevices": 2866,
    "requesterNotes": "test",
    "dueOn": "2021-02-11T00:00:00Z",
    "category": "Software",
    "productivityImpactRemediationType": null,
    "priority": "Medium",
    "completionMethod": null,
    "completerId": null,
    "completerEmail": null,
    "scid": null,
    "type": "Update",
    "productId": "microsoft-_-silverlight",
    "vendorId": "microsoft",
    "nameId": "silverlight",
    "recommendedVersion": null,
    "recommendedVendor": null,
    "recommendedProgram": null
}

次の方法で共有