여러 컴퓨터에 대한 태그 추가 또는 제거

아티클
08/14/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
ina.api.security.microsoft.com

API 설명

지정된 컴퓨터 집합에 대한 태그를 추가하거나 제거합니다.

제한 사항

구성된 보존 기간에 따라 마지막으로 본 컴퓨터에 게시할 수 있습니다.
이 API의 속도 제한은 분당 100개의 호출과 시간당 1,500건의 호출입니다.
API 호출당 최대 500대의 컴퓨터에 대한 태그를 추가하거나 제거할 수 있습니다.

권한

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

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

참고

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

사용자에게는 '보안 설정 관리' 이상의 역할 권한이 있어야 합니다. 자세한 내용은 역할 만들기 및 관리를 참조하세요.
사용자는 컴퓨터 그룹 설정에 따라 컴퓨터에 액세스할 수 있어야 합니다(자세한 내용은 컴퓨터 그룹 만들기 및 관리를 참조하세요).

HTTP 요청

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

요청 헤더

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

요청 본문

요청 본문에서 JSON 개체에 다음 매개 변수를 제공합니다.

매개 변수	형식	설명
값	String	태그 이름입니다. 필수입니다.
작업	열거형	추가 또는 제거. 허용되는 값은 '추가' 또는 '제거'입니다. 필수입니다.
MachineIds	목록(문자열)	업데이트할 컴퓨터 ID 목록입니다. 필수 특성입니다.

응답

성공하면 이 메서드는 응답 본문에 200 - Ok 응답 코드 및 업데이트된 컴퓨터를 반환합니다.

요청 예제

다음은 여러 컴퓨터에 태그를 추가하는 요청의 예입니다.

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

컴퓨터 태그를 제거하려면 요청 본문에서 '추가' 대신 작업을 '제거'로 설정합니다.

팁

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

다음을 통해 공유