ID로 수정 작업 1개 가져오기
적용 대상:
엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판에 등록합니다.
Microsoft Defender 취약성 관리 경험하고 싶으신가요? Microsoft Defender 취약성 관리 공개 미리 보기 평가판에 등록하는 방법에 대해 자세히 알아봅니다.
중요
일부 정보는 상용으로 출시되기 전에 실질적으로 수정될 수 있는 사전 릴리스된 제품과 관련이 있습니다. Microsoft는 여기에서 제공하는 정보와 관련하여 명시적이거나 묵시적인 어떠한 보증도 제공하지 않습니다.
참고
미국 정부 고객인 경우 미국 정부 고객용 끝점용 Microsoft Defender에나열된 URIS를 사용하시기 바랍니다.
팁
성능을 향상시키려면 서버를 지리적 위치에 더 가깝게 사용할 수 있습니다.
- api-us.securitycenter.microsoft.com
- api-eu.securitycenter.microsoft.com
- api-uk.securitycenter.microsoft.com
API 설명
지정된 수정 작업에 대한 정보를 반환합니다. 모든 수정 작업 가져오기와 동일한 열을 표시하지만 지정된 수정 작업 하나에 대해서만 결과를 반환합니다.
(ID)에 대해 지정된 수정 작업 나열
URL: GET: /api/remediationTasks/{id}
사용 권한
이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Microsoft Defender API 사용을 참조하세요.
| 사용 권한 유형 | 사용 권한 | 사용 권한 표시 이름 |
|---|---|---|
| 응용 프로그램 | RemediationTasks.Read.All | '위협 및 취약성 관리 취약성 정보 읽기' |
| 위임됨(회사 또는 학교 계정) | RemediationTask.Read.Read | '위협 및 취약성 관리 취약성 정보 읽기' |
속성
| 속성(ID) | 데이터 형식 | 설명 | 반환된 값의 예 |
|---|---|---|---|
| Category | String | 수정 작업의 범주(소프트웨어/보안 구성) | 소프트웨어 |
| completerEmail | 문자열 | 누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 전자 메일이 포함됩니다. | Null |
| completerId | 문자열 | 누군가가 수정 작업을 수동으로 완료한 경우 이 열에는 해당 개체 ID가 포함됩니다. | Null |
| completionMethod | 문자열 | "완료된 것으로 표시"를 선택한 사용자가 수정 작업을 "자동으로" 완료하거나(모든 디바이스가 패치된 경우) "수동으로" 완료할 수 있습니다. | 자동 |
| createdOn | 날짜/시간 | 이 수정 작업을 만든 시간 | 2021-01-12T18:54:11.5499478Z |
| 설명 | 문자열 | 이 수정 활동에 대한 설명 | Microsoft Silverlight를 이후 버전으로 업데이트하여 디바이스에 영향을 주는 알려진 취약성을 완화합니다. |
| dueOn | 날짜/시간 | 작성자가 이 수정 작업에 대해 설정한 기한입니다. | 2021-01-13T00:00:00Z |
| fixedDevices | 고정된 디바이스 수 | 2 | |
| ID | 문자열 | 이 수정 작업의 ID | 097d9735-5479-4899-b1b7-77398899df92 |
| nameId | 문자열 | 관련 제품 이름 | Microsoft Silverlight |
| 우선 순위 | 문자열 | 이 수정 작업에 대해 만든 이 설정의 우선 순위(높음\중간\낮음) | 높음 |
| Productid | 문자열 | 관련 제품 ID | microsoft-_-silverlight |
| productivityImpactRemediationType | 문자열 | 사용자에게 영향을 주지 않는 디바이스에 대해서만 몇 가지 구성 변경을 요청할 수 있습니다. 이 값은 "노출된 모든 디바이스" 또는 "사용자에게 영향을 주지 않는 디바이스만" 중에서 선택할 수 있음을 나타냅니다. | AllExposedAssets |
| rbacGroupNames | 문자열 | 관련 디바이스 그룹 이름 | [ "Windows Server", "Windows 11", "Windows 10" ] |
| recommendedProgram | 문자열 | 업그레이드할 권장 프로그램 | Null |
| recommendedVendor | 문자열 | 업그레이드할 권장 공급업체 | Null |
| recommendedVersion | 문자열 | 업데이트/업그레이드에 권장되는 버전 | Null |
| relatedComponent | 문자열 | 이 수정 작업의 관련 구성 요소(보안 권장 사항에 대한 관련 구성 요소와 유사) | Microsoft Silverlight |
| requesterEmail | 문자열 | 작성자 전자 메일 주소 | globaladmin@UserName.contoso.com |
| requesterId | 문자열 | Creator 개체 ID | r647211f-2e16-43f2-a480-16ar3a2a796r |
| requesterNotes | 문자열 | 작성자가 이 수정 작업에 대해 추가한 노트(무료 텍스트) | Null |
| Scid | 문자열 | 관련 보안 권장 사항의 SCID | Null |
| 상태 | 문자열 | 수정 작업 상태(활성/완료됨) | 활성 |
| statusLastModifiedOn | 날짜/시간 | 상태 필드가 업데이트된 날짜 | 2021-01-12T18:54:11.5499487Z |
| targetDevices | 긴 | 이 수정에 적용할 수 있는 노출된 디바이스 수 | 43 |
| 제목 | 문자열 | 이 수정 작업의 제목 | Microsoft Silverlight |
| 유형 | 문자열 | 수정 유형 | 업데이트 |
| vendorId | 문자열 | 관련 공급업체 이름 | Microsoft |
예제
요청 예제
GET https://api-luna.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c
응답 예제
{
"@odata.context": "https://wpatdadi-luna-stg.cloudapp.net/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
}