표시기 API 나열

아티클
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 설명

모든 활성 표시기의 컬렉션을 검색합니다.

OData V4 쿼리를 지원합니다.

OData의 $filter 쿼리는 , , createdByDisplayName, expirationTime, generateAlert, title, indicatorTyperbacGroupIdsrbacGroupNamesindicatorValue, creationTimeDateTimeUtc, createdByseverityaction및 속성에서 application지원됩니다.
$stop 최대값은 10,000입니다.
$skip.

엔드포인트용 Microsoft Defender를 사용하는 OData 쿼리의 예제를 참조하세요.

제한 사항

이 API의 속도 제한은 분당 100개의 호출과 시간당 1,500건의 호출입니다.

권한

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

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	Ti.ReadWrite	`Read and write Indicators`
응용 프로그램	Ti.ReadWrite.All	`Read and write All Indicators`
위임됨(회사 또는 학교 계정)	Ti.ReadWrite	`Read and write Indicators`

HTTP 요청

GET https://api.securitycenter.microsoft.com/api/indicators

요청 헤더

이름	유형	설명
권한 부여	String	전달자 {token}. 필수입니다.

요청 본문

비우다

응답

성공하면 이 메서드는 표시기 엔터티 컬렉션이 포함된 200 Ok 응답 코드를 반환합니다.

참고

애플리케이션에 권한이 있는 Ti.ReadWrite.All 경우 모든 지표에 노출됩니다. 그렇지 않으면 만든 지표에만 노출됩니다.

예 1

예제 1 요청

다음은 모든 지표를 가져오는 요청의 예입니다.

GET https://api.securitycenter.microsoft.com/api/indicators

예제 1 응답

다음은 응답의 예입니다.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Indicators",
    "value": [
        {
            "id": "995",
            "indicatorValue": "12.13.14.15",
            "indicatorType": "IpAddress",
            "action": "Alert",
            "application": "demo-test",
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T11:15:35.3688259Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "test",
            "rbacGroupNames": []
        },
        {
            "id": "996",
            "indicatorValue": "220e7d15b0b3d7fac48f2bd61114db1022197f7f",
            "indicatorType": "FileSha1",
            "action": "AlertAndBlock",
            "application": null,
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T10:54:23.2009016Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "TEST",
            "rbacGroupNames": [ "Group1", "Group2" ]
        }
        ...
    ]
}

예 2

예제 2 요청

다음은 작업이 있는 모든 지표를 가져오는 요청의 예입니다 AlertAndBlock .

GET https://api.securitycenter.microsoft.com/api/indicators?$filter=action+eq+'AlertAndBlock'

예제 2 응답