getCloudDBInstanceList

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

개요

CloudDB 인스턴스 리스트 정보를 조회합니다.

요청

요청 헤더

요청 바디

API 요청 시 필드명의 대소문자 구분이 필요합니다

• cloudDBInstanceNoList

  • 조회할 인스턴스 번호

• pageNo

  • 건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호

• pageSize

  • 한 페이지에서 조회할 페이지 사이즈

• dbKindCode

  • 조회할 CloudDB의 종류를 선택합니다. MySQL만 입력 가능합니다.

• searchFilterName

  • 검색할 필터 종류

• searchFilterValue

  • 검색할 필터 값

• regionNo

  • Server API인 getRegionList를 통해 얻을수 있습니다.

• zoneNo

  • Server API인 getZoneList를 통해 얻을수 있습니다.

• responseFormatType

  • API 실행 결과를 응답 받을 format을 정합니다. xml과 json 중에서 선택 가능합니다.

응답

예시

요청 예시

GET {API_URL}/getCloudDBInstanceList
?pageNo=0
&pageSize=0
&dbKindCode=MYSQL
&responseFormatType=json

요청 샘플

• MySQL로 생성된 instance list 조회

{
  "pageNo": 0,
  "pageSize": 0,
  "dbKindCode": "MYSQL",
  "responseFormatType": "json"
}

응답 예시

connection: keep-alive 
 content-type: application/json;charset=UTF-8 
 date: Thu, 22 Sep 2022 02:18:35 GMT 
 server: nginx 
 transfer-encoding: chunked 
 x-ncp-apigw-response-origin: ENDPOINT 
 x-ncp-trace-id: 3adj16dhm2d9h3gcr6c8s66eb2 

{
  "getCloudDBInstanceListResponse": {
    "requestId": "0cd1e0ed-9492-42ed-8eee-ee8f3184b45b",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "cloudDBInstanceList": [
      {
        "cloudDBInstanceNo": "553065",
        "cloudDBServiceName": "testdb",
        "dbKindCode": "MYSQL",
        "engineVersion": "MYSQL8.0.18",
        "cpuCount": 2,
        "memorySize": 4294967296,
        "dataStorageType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "licenseCode": "GPL",
        "cloudDBPort": 3306,
        "isHa": true,
        "backupTime": "10:15",
        "backupFileRetentionPeriod": 1,
        "cloudDBInstanceStatusName": "running",
        "collation": "",
        "createDate": "2022-09-14T13:30:00+0900",
        "cloudDBImageProductCode": "SPSWMYSQLLINUX09",
        "cloudDBProductCode": "SPSVRDBAAS000001",
        "isCloudDBConfigNeedReboot": false,
        "isCloudDBNeedReboot": false,
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "평촌 zone",
          "regionNo": "1"
        },
        "region": {
          "regionNo": "1",
          "regionCode": "KR",
          "regionName": "KR-CENTRAL"
        },
        "cloudDBConfigList": [],
        "cloudDBConfigGroupList": [],
        "accessControlGroupList": [
          {
            "accessControlGroupConfigurationNo": "2073",
            "accessControlGroupName": "cloud-db-buqx",
            "accessControlGroupDescription": "Group for cloud DB service 'testdb' (automatically created)",
            "isDefault": false,
            "createDate": "2022-09-14T13:30:33+0900"
          }
        ],
        "cloudDBServerInstanceList": [
          {
            "cloudDBServerInstanceNo": "553066",
            "cloudDBServerInstanceStatusName": "running",
            "cloudDBServerName": "testdb-001",
            "cloudDBServerRole": {
              "code": "M",
              "codeName": "Master"
            },
            "privateDnsName": "db-gs3a.beta-cdb.gov-ntruss.com",
            "publicDnsName": "",
            "dataStorageSize": 10737418240,
            "usedDataStorageSize": 3221225472,
            "createDate": "2022-09-14T13:36:00+0900"
          },
          {
            "cloudDBServerName": "testdb-002",
            "cloudDBServerRole": {
              "code": "H",
              "codeName": "Hidden Master"
            }
          }
        ]
      }
    ]
  }
}

오류 코드

Cloud DB API 요청이 잘못되었거나, 처리 도중 오류가 발생하면 HTTP 상태코드로 성공/실패를 반환하고 JSON 형식으로 상세 메시지를 반환합니다

오류 코드는 Cloud DB API의 '공통 오류 코드'와 'API Gateway 오류 코드' 두 가지입니다