GetActivityList

Classic/VPC 환경에서 이용 가능합니다.

리소스 작업 내역을 조회합니다. 리소스는 사용자가 네이버 클라우드 플랫폼에서 생성한 자원의 단위입니다. 리소스는 식별이 가능하도록 NRN(Ncloud Resource Names)이라는 고유한 키 값으로 구분하여 관리하기 때문에 NRN을 사용하여 호출 시 특정 리소스에 대한 작업 내역을 조회할 수 있습니다.

참고

NRN(Ncloud Resource Names)의 개념과 명명 규칙에 대한 자세한 설명은 Resource Manager 사용 가이드의 NRN 및 리소스 유형을 참조해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
POST	/api/v1/activities

요청 헤더

Cloud Activity Tracer API에서 공통으로 사용하는 헤더에 대한 정보는 Cloud Activity Tracer 요청 헤더를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`fromEventTime`	Integer	Optional	조회 기간 시작 일시(Unix Timestamp) (밀리초) 조회 일시로부터 30일 전 (기본값)
`toEventTime`	Integer	Optional	조회 기간 종료 일시(Unix Timestamp) (밀리초) 조회 일시 (기본값)
`nrn`	String	Optional	네이버 클라우드 플랫폼 리소스 식별 값
`pageIndex`	Integer	Optional	페이지 번호 0~N (기본값: 0)
`pageSize`	Integer	Optional	페이지 출력 수 100 이하 (기본값: 20)

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://cloudactivitytracer.apigw.gov-ntruss.com/api/v1/activities' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
        "pageIndex": "0",
        "pageSize": "4"
 }'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`pageIndex`	Integer	-	페이지 번호
`pageSize`	Integer	-	페이지 출력 수
`itemCount`	Integer	-	응답 결과 수
`hasMore`	Boolean	-	추가 페이지 존재 여부 `true` \| `false` `true`: 존재 `false`: 존재 안 함
`items`	Array	-	응답 결과

`items`

items에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`historyId`	String	-	리소스 작업 내역 아이디
`nrn`	String	-	네이버 클라우드 플랫폼 리소스 식별 값
`eventTime`	Integer	-	작업 변경 일시(Unix Timestamp) (밀리초)
`platformType`	String	-	플랫폼 구분 `BOTH` \| `VPC` \| `Classic` `BOTH`: 플랫폼 공통 환경 `VPC`: VPC 환경 `Classic`: Classic 환경
`productName`	String	-	리소스의 서비스 코드
`productDisplayName`	String	-	리소스의 서비스 이름
`regionCode`	String	-	리소스의 리전 코드
`regionDispalyName`	String	-	리소스의 리전 이름
`resourceType`	String	-	리소스 유형
`resourceId`	String	-	리소스 아이디
`resourceName`	String	-	리소스 이름
`actionDisplayName`	String	-	작업 이름
`actionResultType`	String	-	작업 결과 `SUCCESS` \| `FAIL` `SUCCESS`: 성공 `FAIL`: 실패
`actionUserType`	String	-	작업자 유형 `Customer` \| `Sub` `Customer`: 메인 계정 `Sub`: 서브 계정
`actionSubAccountNo`	Integer	-	서브 계정 회원 번호 `actionUserType`이 `Sub`인 경우 표시
`sourceType`	String	-	작업을 요청한 클라이언트 유형 `API` \| `CONSOLE` \| `PORTAL` \| `SYSTEM`
`sourceIp`	String	-	작업을 요청한 클라이언트 IP 주소 `sourceType`이 `CONSOLE`이거나 `PORTAL`인 경우 표시
`productData`	Object	-	리소스 상세 정보 각 필드 정보: 리소스별 API 가이드 참조

응답 상태 코드

Cloud Activity Tracer API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는
Cloud Activity Tracer 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "pageIndex": 0,
    "pageSize": 4,
    "itemCount": 3,
    "hasMore": true,
    "items": [
        {
            "historyId": "67074579e2a352720c5736d1",
            "nrn": "nrn:PUB:Account::****:Customer/static",
            "eventTime": 1728529785024,
            "platformType": "BOTH",
            "productName": "Account",
            "productDisplayName": "Account",
            "regionCode": "",
            "regionDisplayName": "공통",
            "resourceType": "Customer",
            "resourceId": "static",
            "actionDisplayName": "Login",
            "actionResultType": "SUCCESS",
            "actionUserType": "Customer",
            "sourceType": "PORTAL",
            "sourceIp": "***.***.***.***",
            "productData": {
                "twoFactorLoginType": "PHONE",
                "twoFactorLoginManagerName": "홍*동",
                "twoFactorLoginInfo": "+82-010********",
                "clientIpCountry": "KR",
                "isTwoSetFactorLogin": "true",
                "isSuccess": "true",
                "clientIp": "***.***.***.***",
                "loginLevel": "2",
                "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36",
                "userType": "CUSTOMER",
                "userName": "honggildong@navercorp.com"
            }
        },
        {
            "historyId": "67068762e2a352720c56d28e",
            "nrn": "nrn:PUB:SecureZone:KR:****:Member/Standard/****",
            "eventTime": 1728481122336,
            "platformType": "Classic",
            "productName": "SecureZone",
            "productDisplayName": "Secure Zone",
            "regionCode": "KR",
            "regionDisplayName": "Korea",
            "resourceType": "Member",
            "resourceId": "Standard/****",
            "resourceName": "홍길동",
            "actionDisplayName": "Add Member",
            "actionResultType": "SUCCESS",
            "actionUserType": "Customer",
            "sourceType": "CONSOLE",
            "sourceIp": "***.***.***.***",
            "productData": {
                "memberNo": "******",
                "instanceNo": "****",
                "memberName": "홍길동",
                "secureZoneNo": "1",
                "secureZoneName": "Secure",
                "firewallType": "STANDARD",
                "zone": "KR2"
            }
        },
        {
            "historyId": "6706874376a86d3b2d5a64fe",
            "nrn": "nrn:PUB:CloudLogAnalytics:KR:****:Analytics/static",
            "eventTime": 1728481091000,
            "platformType": "BOTH",
            "productName": "CloudLogAnalytics",
            "productDisplayName": "Cloud Log Analytics",
            "regionCode": "KR",
            "regionDisplayName": "한국",
            "resourceType": "Analytics",
            "resourceId": "static",
            "resourceName": "CloudLogAnalytics",
            "actionDisplayName": "Subscribe To Cloud Log Analytics",
            "actionResultType": "SUCCESS",
            "sourceType": "SYSTEM",
            "productData": {
                "memberNo": "******",
                "instanceNo": "26950604",
                "prodNo": "1",
                "startYmdt": "2024-10-08 22:38:10"
            }
        }
    ]
}