일괄 업데이트 경고

아티클
07/04/2024

적용 대상:

엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판을 신청하세요.

참고

미국 정부 고객인 경우 미국 정부 고객용 엔드포인트용 Microsoft Defender에 나열된 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

API 설명

기존 경고 일괄 처리의 속성을 업데이트 합니다.

주석 제출은 속성을 업데이트하거나 업데이트하지 않고 사용할 수 있습니다.

updatable 속성은 , determination및 classificationassignedTo입니다status.

제한 사항

API에서 사용할 수 있는 경고를 업데이트할 수 있습니다. 자세한 내용은 경고 나열을 참조하세요.
이 API에 대한 속도 제한은 분당 10개의 호출과 시간당 500개의 호출입니다.

권한

이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Microsoft Defender API 사용을 참조하세요.

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	Alert.ReadWrite.All	'모든 경고 읽기 및 쓰기'
위임됨(회사 또는 학교 계정)	Alert.ReadWrite	'경고 읽기 및 쓰기'

참고

사용자 자격 증명을 사용하여 토큰을 가져오는 경우:

사용자에게 '경고 조사'라는 역할 권한이 있어야 합니다. 자세한 내용은 역할 만들기 및 관리를 참조하세요.
사용자는 디바이스 그룹 설정에 따라 경고와 연결된 디바이스에 액세스할 수 있어야 합니다. 자세한 내용은 디바이스 그룹 만들기 및 관리를 참조하세요.

디바이스 그룹 만들기는 엔드포인트용 Defender 플랜 1 및 플랜 2에서 지원됩니다.

HTTP 요청

POST /api/alerts/batchUpdate

요청 헤더

이름	유형	설명
권한 부여	String	전달자 {token}. 필수입니다.
Content-Type	String	application/json. 필수입니다.

요청 본문

요청 본문에서 업데이트할 경고의 ID와 이러한 경고에 대해 업데이트하려는 관련 필드의 값을 제공합니다.

요청 본문에 포함되지 않은 기존 속성은 이전 값을 유지하거나 다른 속성 값의 변경 내용에 따라 다시 계산됩니다.

최상의 성능을 위해 변경되지 않은 기존 값을 포함해서는 안 됩니다.

속성	유형	설명
alertIds	목록<문자열>	업데이트할 경고의 ID 목록입니다. 필수
상태	String	지정된 경고의 업데이트된 상태를 지정합니다. 속성 값은 '새로 만들기', 'InProgress' 및 'Resolved'입니다.
assignedTo	String	지정된 경고의 소유자
분류	String	지정된 경고의 사양을 지정합니다. 속성 값은 , `Informational, expected activity`및 `FalsePositive`입니다`TruePositive`.
결심	String	지정된 경고의 결정을 지정합니다. 각 분류에 대해 가능한 결정 값은 다음과 같습니다. True positive: `Multistage attack` (MultiStagedAttack), `Malicious user activity` (MaliciousUserActivity), `Compromised account` (CompromisedUser) – 그에 따라 `Malware` public api에서 열거형 이름을 변경하는 것이 좋습니다. (맬웨어), (피싱), `PhishingUnwanted software` (UnwantedSoftware) 및 `Other` (기타). 정보, 예상 활동:`Security test` (SecurityTesting), `Line-of-business application` (LineOfBusinessApplication), `Confirmed activity` (ConfirmedUserActivity) - 그에 따라 퍼블릭 API에서 열거형 이름을 변경하는 것이 좋습니다. 및 `Other` (기타). 가양성:`Not malicious` (정리) - 그에 따라 `Not enough data to validate` public api에서 열거형 이름을 변경하는 것이 좋습니다(InsufficientData) 및 `Other` (기타).
주석	String	지정된 경고에 추가할 주석입니다.

참고

2022년 8월 29일 경에는 이전에 지원되었던 경고 결정 값('Apt' 및 'SecurityPersonnel')이 더 이상 사용되지 않으며 API를 통해 더 이상 사용할 수 없습니다.

응답

성공하면 이 메서드는 빈 응답 본문을 사용하여 200 OK를 반환합니다.

예제

요청

다음은 요청의 예입니다.

POST https://api.securitycenter.microsoft.com/api/alerts/batchUpdate

{
    "alertIds": ["da637399794050273582_760707377", "da637399989469816469_51697947354"],
    "status": "Resolved",
    "assignedTo": "secop2@contoso.com",
    "classification": "FalsePositive",
    "determination": "Malware",
    "comment": "Resolve my alert and assign to secop2"
}

팁

더 자세히 알아보고 싶으신가요? Microsoft 기술 커뮤니티: 엔드포인트용 Microsoft Defender 기술 커뮤니티에서 Microsoft 보안 커뮤니티에 참여하세요.

다음을 통해 공유