컴퓨터 태그 API 추가 또는 제거

적용 대상:

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

참고

미국 정부 고객인 경우 미국 정부 고객용 끝점용 Microsoft Defender에나열된 URIS를 사용하시기 바랍니다.

팁

성능을 향상시키려면 서버를 지리적 위치에 더 가깝게 사용할 수 있습니다.

API 설명

특정 Machine 에 태그를 추가하거나 제거합니다.

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

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

참고

사용자 자격 증명을 사용하여 토큰을 얻을 때:

POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags

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

요청 본문에 다음 매개 변수를 사용하여 JSON 개체를 제공합니다.

매개 변수	유형	설명
값	문자열	태그 이름입니다. 필수입니다.
조치	Enum	추가 또는 제거. 허용되는 값은 '추가' 또는 '제거'입니다. 필수입니다.

성공하면 이 메서드는 응답 본문에 200 - 확인 응답 코드와 업데이트된 Machine을 반환합니다.

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

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags

{
  "Value" : "test Tag 2",
  "Action": "Add"
}