컴퓨터에 대한 태그 추가 또는 제거
적용 대상:
- .. /microsoft-defender-endpoint.md
- .. /microsoft-defender-endpoint.md
엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판을 신청하세요.
참고
미국 정부 고객인 경우 미국 정부 고객을 위해 엔드포인트용 Microsoft Defender 나열된 URI를 사용하세요.
팁
성능을 향상시키려면 서버를 지리적 위치에 더 가깝게 사용할 수 있습니다.
- api-us.securitycenter.microsoft.com
- api-eu.securitycenter.microsoft.com
- api-uk.securitycenter.microsoft.com
- api-au.securitycenter.microsoft.com
API 설명
특정 컴퓨터에 대한 태그를 추가하거나 제거 합니다.
제한 사항
구성된 보존 기간에 따라 마지막으로 본 컴퓨터에 게시할 수 있습니다.
이 API에 대한 속도 제한은 분당 100개 호출 및 시간당 1500개 호출입니다.
권한
이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Defender API 사용을 참조하세요.
사용 권한 유형 | 사용 권한 | 사용 권한 표시 이름 |
---|---|---|
응용 프로그램 | Machine.ReadWrite.All | '모든 컴퓨터 정보 읽기 및 쓰기' |
위임됨(회사 또는 학교 계정) | Machine.ReadWrite | '컴퓨터 정보 읽기 및 쓰기' |
참고
사용자 자격 증명을 사용하여 토큰을 가져오는 경우:
- 사용자에게는 '보안 설정 관리' 이상의 역할 권한이 있어야 합니다. 자세한 내용은 Create 및 역할 관리를 참조하세요.
- 사용자는 컴퓨터 그룹 설정에 따라 컴퓨터에 액세스할 수 있어야 합니다(자세한 내용은 컴퓨터 그룹 Create 및 관리 참조).
HTTP 요청
POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags
요청 헤더
이름 | 유형 | 설명 |
---|---|---|
권한 부여 | String | 전달자 {token}. 필수입니다. |
Content-Type | 문자열 | application/json. 필수입니다. |
요청 본문
요청 본문에서 JSON 개체에 다음 매개 변수를 제공합니다.
매개 변수 | 형식 | 설명 |
---|---|---|
값 | String | 태그 이름입니다. 필수입니다. |
작업 | 열거형 | 추가 또는 제거. 허용되는 값은 '추가' 또는 '제거'입니다. 필수입니다. |
응답
성공하면 이 메서드는 응답 본문에서 200 - Ok 응답 코드 및 업데이트된 머신을 반환합니다.
요청 예제
다음은 컴퓨터 태그를 추가하는 요청의 예입니다.
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}
컴퓨터 태그를 제거하려면 요청 본문에서 '추가' 대신 작업을 '제거'로 설정합니다.
팁
더 자세히 알아보고 싶으신가요? 기술 커뮤니티: 엔드포인트용 Microsoft Defender Tech Community의 Microsoft 보안 커뮤니티와 Engage.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기