Resource Manager 개요

Prev Next

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

Resource Manager는 네이버 클라우드 플랫폼 내 모든 리소스를 통합적으로 관리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Resource Manager 서비스에서는 사용자의 리소스 관련 기능에 대한 API를 RESTful 형태로 제공합니다.

Resource Manager 공통 설정

Resource Manager API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://resourcemanager.apigw.ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
  • Unix Timestamp 형식
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-Type Required 요청 데이터의 형식
  • application/json

응답

공통 응답 형식을 설명합니다.

응답 바디

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

error
error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
error Object - 오류 코드 및 메시지
  • successfalse인 경우 표시
error.errorCode Integer - 오류 코드
error.message String - 오류 메시지

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 - 'nrnList' cannot be empty. nrnList 값 누락
400 - 'tagKey' cannot be empty. tagKey 값 누락
400 - 'tagKey' cannot be empty when using 'tag' parameter. tag[].tagKey 값 누락
400 - 'tagValue' cannot be empty. tagValue 값 누락
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
    "error": {
        "errorCode": "400",
        "message": " 'nrnList' cannot be empty."
    }
}

Resource Manager API

Resource Manager 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
AttachGroup 그룹에 리소스 추가
AttachTag 리소스에 태그 추가
DetachGroup 그룹에서 리소스 삭제
DetachTag 리소스에서 태그 삭제
GetGroupList 리소스 그룹 목록 조회
GetResourceList 리소스 목록 조회

Resource Manager 연관 리소스

Resource Manager API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.