createCloudPostgresqlReadReplicaInstance
- 인쇄
- PDF
createCloudPostgresqlReadReplicaInstance
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
VPC 환경에서 이용 가능합니다.
Cloud DB for PostgreSQL 인스턴스에 Read Replica 서버 인스턴스를 추가합니다.
명령어
명령어 구문은 다음과 같습니다.
ncloud vpostgresql createCloudPostgresqlReadReplicaInstance [regionCode] [cloudPostgresqlInstanceNo] [subnetNo] [output]
파라미터
파라미터에 대한 설명은 다음과 같습니다.
파라미터 | 타입 | 필수 여부 | 설명 | 제약 사항 |
---|---|---|---|---|
regionCode | String | N | 리전 코드 - regionCode는 getRegionList 액션을 통해서 획득 - default: getRegionList 조회 결과의 첫 번째 리전을 선택 | - |
cloudPostgresqlInstanceNo | String | Y | Cloud DB for PostgreSQL 인스턴스 번호 - cloudPostgresqlInstanceNo는 getCloudPostgresqlInstanceList 액션을 통해서 획득 | - |
subnetNo | String | N | Subnet 번호 - subnetNo는 getCloudPostgresqlTargetSubnetList 액션을 통해서 획득 - Cloud DB for PostgreSQL 인스턴스의 isMultiZone이 false이면 subnetNo의 입력은 받지 않으며 기존 subnetNo에 생성 - Cloud DB for PostgreSQL 인스턴스의 isMultiZone이 true일 경우 반드시 입력 - Cloud DB for PostgreSQL Read Replica 인스턴스 생성 이후에 Subnet 이전은 불가 | - |
output | String | N | 응답 결과의 포맷 타입 - options: xml | json - default: json | - |
응답
응답 데이터 타입
- CloudPostgresqlInstanceList 타입
CloudPostgresqlInstanceList extends CommonResponse | 설명 |
---|---|
private Integer totalRows; | 조회된 목록의 총 개수 |
private List<CloudPostgresqlInstance> cloudPostgresqlInstanceList = new ArrayList<>(); | Cloud DB for PostgreSQL 인스턴스 목록 |
- CloudPostgresqlInstance 타입
CloudPostgresqlInstance | 설명 |
---|---|
private String cloudPostgresqlInstanceNo; | Cloud DB for PostgreSQL 인스턴스 번호 |
private String cloudPostgresqlServiceName; | Cloud DB for PostgreSQL 서비스 이름 |
private String cloudPostgresqlInstanceStatusName; | Cloud DB for PostgreSQL 인스턴스 상태 이름 - creating - deleted - deleting - downgrading - pending - recovering - reinstalling - restarting - running - settingup - shuttingdown - stopped - upgrading |
private CommonCode cloudPostgresqlInstanceStatus; | Cloud DB for PostgreSQL 인스턴스 상태 코드 - INIT (initiate) - CREAT (created) - DEL (deleted) |
private CommonCode cloudPostgresqlInstanceOperation; | Cloud DB for PostgreSQL 인스턴스 Operation 코드 - CREAT (create) - DEL (delete) - FO (failover) - NULL (no operation) - SETUP (setup) - UPGD (upgrade) - DWGD (downgrade) - BKP (backup) |
private String cloudPostgresqlImageProductCode; | Cloud DB for PostgreSQL 이미지 상품 코드 |
private String engineVersion; | Cloud DB for PostgreSQL 엔진 버전 |
private String license; | Cloud DB for PostgreSQL 라이선스 |
private Integer cloudPostgresqlPort; | Cloud DB for PostgreSQL 포트 |
private Boolean isHa; | 고가용성 여부 |
private Boolean isMultiZone; | 멀티존 여부 |
private Boolean isBackup; | 백업 여부 |
private Integer backupFileRetentionPeriod; | 백업 파일 보관 기간 |
private String backupTime; | 백업 시간 |
private Date createDate; | 생성일자 |
private AccessControlGroupNoList accessControlGroupNoList; | ACG 번호 목록 |
private CloudPostgresqlConfigList cloudPostgresqlConfigList; | Cloud DB for PostgreSQL Config 목록 |
private List<CloudPostgresqlServerInstance> cloudPostgresqlServerInstanceList; | Cloud DB for PostgreSQL 서버 인스턴스 목록 |
- AccessControlGroupNoList 타입
AccessControlGroupNoList | 설명 |
---|---|
private List<String> accessControlGroupNoList = new ArrayList<>(); | ACG 번호 목록 |
- CloudPostgresqlConfigList 타입
CloudPostgresqlConfigList | 설명 |
---|---|
private List<String> cloudPostgresqlConfigList = new ArrayList<>(); | Cloud DB for PostgreSQL Config 목록 |
- CloudPostgresqlServerInstance 타입
CloudPostgresqlServerInstance | 설명 |
---|---|
private String cloudPostgresqlServerInstanceNo; | Cloud DB for PostgreSQL 서버 인스턴스 번호 |
private String cloudPostgresqlServerName; | Cloud DB for PostgreSQL 서버 이름 |
private CommonCode cloudPostgresqlServerRole; | Cloud DB for PostgreSQL 서버 역할 |
private String cloudPostgresqlServerInstanceStatusName; | Cloud DB for PostgreSQL 서버 인스턴스 상태 이름 - creating - deleted - deleting - downgrading - pending - recovering - reinstalling - restarting - running - settingup - shuttingdown - stopped - upgrading - downgrading |
private CommonCode cloudPostgresqlServerInstanceStatus; | Cloud DB for PostgreSQL 서버 인스턴스 상태 코드 - DEL (deleted) - PEND (pending) - RUN (running) - STOP (stopped) - FSTOP (failure stopped) |
private CommonCode cloudPostgresqlServerInstanceOperation; | Cloud DB for PostgreSQL 서버 인스턴스 Operation 코드 - NOOP (no operation) - CREAT (create) - START (start) - RSTRT (restart) - SETUP (setup) - STOP (stop) - FO (failover) - DEL (delete) - UPGD (upgrade) - DWGD (downgrade) - RISTL (reinstall) |
private String cloudPostgresqlProductCode; | Cloud DB for PostgreSQL 상품 코드 |
private String regionCode; | 리전 코드 |
private String zoneCode; | Zone 코드 |
private String vpcNo; | VPC 번호 |
private String subnetNo; | Subnet 번호 |
private Boolean isPublicSubnet; | Public Subnet 여부 |
private String publicDomain; | 공인 도메인명 |
private String privateDomain; | 사설 도메인명 |
private CommonCode dataStorageType; | 데이터 스토리지 타입 |
private Boolean isStorageEncryption; | 데이터 스토리지 암호화 여부 |
private Long dataStorageSize; | 데이터 스토리지 사이즈 |
private Long usedDataStorageSize; | 사용중인 데이터 스토리지 사이즈 |
private Integer cpuCount; | CPU 개수 |
private Long memorySize; | 메모리 사이즈 |
private Date uptime; | VM 부팅 완료 시간 |
private Date createDate; | 생성일자 |
예시
호출과 응답 예시를 설명합니다.
호출 예시
호출 예시는 다음과 같습니다.
ncloud vpostgresql createCloudPostgresqlReadReplicaInstance --regionCode KR --cloudPostgresqlInstanceNo ****925 --subnetNo ****51
응답 예시
응답 예시는 다음과 같습니다.
응답 결과 포맷 타입(output)이 json 일 때
{
"createCloudPostgresqlReadReplicaInstanceResponse": {
"requestId": "543f6b42-dac9-49fb-bfd9-ebff72b35be1",
"returnCode": 0,
"returnMessage": "success",
"totalRows": 1,
"cloudPostgresqlInstanceList": [
{
"cloudPostgresqlInstanceNo": "****925",
"cloudPostgresqlServiceName": "test-****",
"cloudPostgresqlInstanceStatusName": "running",
"cloudPostgresqlInstanceStatus": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Created State"
},
"cloudPostgresqlInstanceOperation": {
"code": "NULL",
"codeName": "CLOUD DATABASE(VPC) Null OP"
},
"cloudPostgresqlImageProductCode": "SW.VPGSL.OS.LNX64.CNTOS.0708.PGSQL.133.B050",
"engineVersion": "PostgreSQL 13.3",
"license": "PostgreSQL License",
"cloudPostgresqlPort": 15432,
"isHa": true,
"isMultiZone": true,
"isBackup": true,
"backupFileRetentionPeriod": 10,
"backupTime": "02:00",
"createDate": "2021-08-30T18:00:00+0900",
"accessControlGroupNoList": [
"****48"
],
"cloudPostgresqlServerInstanceList": [
{
"cloudPostgresqlServerInstanceNo": "****926",
"cloudPostgresqlServerName": "test-****-001-gcb",
"cloudPostgresqlServerRole": {
"code": "M",
"codeName": "Primary"
},
"cloudPostgresqlServerInstanceStatusName": "running",
"cloudPostgresqlServerInstanceStatus": {
"code": "RUN",
"codeName": "CLOUD DATABASE(VPC) Server Running State"
},
"cloudPostgresqlServerInstanceOperation": {
"code": "NOOP",
"codeName": "CLOUD DATABASE(VPC) Server Null OP"
},
"cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
"regionCode": "KR",
"zoneCode": "KR-1",
"vpcNo": "****87",
"subnetNo": "****49",
"isPublicSubnet": true,
"privateDomain": "pg-****.vpc-cdb-kr.ntruss.com",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"isStorageEncryption": true,
"dataStorageSize": 10737418240,
"usedDataStorageSize": 4365656064,
"cpuCount": 2,
"memorySize": 4294967296,
"uptime": "2021-08-30T18:10:00+0900",
"createDate": "2021-08-30T18:00:00+0900"
},
{
"cloudPostgresqlServerInstanceNo": "****932",
"cloudPostgresqlServerName": "test-****-002-gcc",
"cloudPostgresqlServerRole": {
"code": "H",
"codeName": "Secondary"
},
"cloudPostgresqlServerInstanceStatusName": "running",
"cloudPostgresqlServerInstanceStatus": {
"code": "RUN",
"codeName": "CLOUD DATABASE(VPC) Server Running State"
},
"cloudPostgresqlServerInstanceOperation": {
"code": "NOOP",
"codeName": "CLOUD DATABASE(VPC) Server Null OP"
},
"cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
"regionCode": "KR",
"zoneCode": "KR-2",
"vpcNo": "****87",
"subnetNo": "****51",
"isPublicSubnet": true,
"privateDomain": "pg-****.vpc-cdb-kr.ntruss.com",
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"isStorageEncryption": true,
"dataStorageSize": 10737418240,
"usedDataStorageSize": 3291680768,
"cpuCount": 2,
"memorySize": 4294967296,
"uptime": "2021-08-30T18:10:00+0900",
"createDate": "2021-08-30T18:00:00+0900"
},
{
"cloudPostgresqlServerName": "test-****-003-gcd",
"cloudPostgresqlServerRole": {
"code": "S",
"codeName": "Read Replica"
},
"cloudPostgresqlServerInstanceStatusName": "creating",
"cloudPostgresqlServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) Server Pending State"
},
"cloudPostgresqlServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Server Create OP"
},
"cloudPostgresqlProductCode": "SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001",
"regionCode": "KR",
"zoneCode": "KR-2",
"vpcNo": "****87",
"subnetNo": "****51",
"isPublicSubnet": true,
"dataStorageType": {
"code": "SSD",
"codeName": "SSD"
},
"isStorageEncryption": true,
"dataStorageSize": 10737418240,
"cpuCount": 2,
"memorySize": 4294967296,
"createDate": "2021-08-30T18:30:00+0900"
}
]
}
]
}
}
응답 결과 포맷 타입(output)이 xml 일 때
<createCloudPostgresqlReadReplicaInstanceResponse>
<requestId>543f6b42-dac9-49fb-bfd9-ebff72b35be1</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<cloudPostgresqlInstanceList>
<cloudPostgresqlInstance>
<cloudPostgresqlInstanceNo>****925</cloudPostgresqlInstanceNo>
<cloudPostgresqlServiceName>test-****</cloudPostgresqlServiceName>
<cloudPostgresqlInstanceStatusName>running</cloudPostgresqlInstanceStatusName>
<cloudPostgresqlInstanceStatus>
<code>CREAT</code>
<codeName>CLOUD DATABASE(VPC) Created State</codeName>
</cloudPostgresqlInstanceStatus>
<cloudPostgresqlInstanceOperation>
<code>NULL</code>
<codeName>CLOUD DATABASE(VPC) Null OP</codeName>
</cloudPostgresqlInstanceOperation>
<cloudPostgresqlImageProductCode>SW.VPGSL.OS.LNX64.CNTOS.0708.PGSQL.133.B050</cloudPostgresqlImageProductCode>
<engineVersion>PostgreSQL 13.3</engineVersion>
<license>PostgreSQL License</license>
<cloudPostgresqlPort>15432</cloudPostgresqlPort>
<isHa>true</isHa>
<isMultiZone>true</isMultiZone>
<isBackup>true</isBackup>
<backupFileRetentionPeriod>10</backupFileRetentionPeriod>
<backupTime>02:00</backupTime>
<createDate>2021-08-30T18:00:00+0900</createDate>
<accessControlGroupNoList>
<accessControlGroupNo>****48</accessControlGroupNo>
</accessControlGroupNoList>
<cloudPostgresqlServerInstanceList>
<cloudPostgresqlServerInstance>
<cloudPostgresqlServerInstanceNo>****926</cloudPostgresqlServerInstanceNo>
<cloudPostgresqlServerName>test-****-001-gcb</cloudPostgresqlServerName>
<cloudPostgresqlServerRole>
<code>M</code>
<codeName>Primary</codeName>
</cloudPostgresqlServerRole>
<cloudPostgresqlServerInstanceStatusName>running</cloudPostgresqlServerInstanceStatusName>
<cloudPostgresqlServerInstanceStatus>
<code>RUN</code>
<codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
</cloudPostgresqlServerInstanceStatus>
<cloudPostgresqlServerInstanceOperation>
<code>NOOP</code>
<codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
</cloudPostgresqlServerInstanceOperation>
<cloudPostgresqlProductCode>SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001</cloudPostgresqlProductCode>
<regionCode>KR</regionCode>
<zoneCode>KR-1</zoneCode>
<vpcNo>****87</vpcNo>
<subnetNo>****49</subnetNo>
<isPublicSubnet>true</isPublicSubnet>
<privateDomain>pg-****.vpc-cdb-kr.ntruss.com</privateDomain>
<dataStorageType>
<code>SSD</code>
<codeName>SSD</codeName>
</dataStorageType>
<isStorageEncryption>true</isStorageEncryption>
<dataStorageSize>10737418240</dataStorageSize>
<usedDataStorageSize>4365656064</usedDataStorageSize>
<cpuCount>2</cpuCount>
<memorySize>4294967296</memorySize>
<uptime>2021-08-30T18:10:00+0900</uptime>
<createDate>2021-08-30T18:00:00+0900</createDate>
</cloudPostgresqlServerInstance>
<cloudPostgresqlServerInstance>
<cloudPostgresqlServerInstanceNo>****932</cloudPostgresqlServerInstanceNo>
<cloudPostgresqlServerName>test-****-002-gcc</cloudPostgresqlServerName>
<cloudPostgresqlServerRole>
<code>H</code>
<codeName>Secondary</codeName>
</cloudPostgresqlServerRole>
<cloudPostgresqlServerInstanceStatusName>running</cloudPostgresqlServerInstanceStatusName>
<cloudPostgresqlServerInstanceStatus>
<code>RUN</code>
<codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
</cloudPostgresqlServerInstanceStatus>
<cloudPostgresqlServerInstanceOperation>
<code>NOOP</code>
<codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
</cloudPostgresqlServerInstanceOperation>
<cloudPostgresqlProductCode>SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001</cloudPostgresqlProductCode>
<regionCode>KR</regionCode>
<zoneCode>KR-2</zoneCode>
<vpcNo>****87</vpcNo>
<subnetNo>****51</subnetNo>
<isPublicSubnet>true</isPublicSubnet>
<privateDomain>pg-****.vpc-cdb-kr.ntruss.com</privateDomain>
<dataStorageType>
<code>SSD</code>
<codeName>SSD</codeName>
</dataStorageType>
<isStorageEncryption>true</isStorageEncryption>
<dataStorageSize>10737418240</dataStorageSize>
<usedDataStorageSize>3291680768</usedDataStorageSize>
<cpuCount>2</cpuCount>
<memorySize>4294967296</memorySize>
<uptime>2021-08-30T18:10:00+0900</uptime>
<createDate>2021-08-30T18:00:00+0900</createDate>
</cloudPostgresqlServerInstance>
<cloudPostgresqlServerInstance>
<cloudPostgresqlServerName>test-****-003-gcd</cloudPostgresqlServerName>
<cloudPostgresqlServerRole>
<code>S</code>
<codeName>Read Replica</codeName>
</cloudPostgresqlServerRole>
<cloudPostgresqlServerInstanceStatusName>creating</cloudPostgresqlServerInstanceStatusName>
<cloudPostgresqlServerInstanceStatus>
<code>PEND</code>
<codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
</cloudPostgresqlServerInstanceStatus>
<cloudPostgresqlServerInstanceOperation>
<code>CREAT</code>
<codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
</cloudPostgresqlServerInstanceOperation>
<cloudPostgresqlProductCode>SVR.VPGSL.DBSVR.STAND.C002.M004.NET.SSD.B050.G001</cloudPostgresqlProductCode>
<regionCode>KR</regionCode>
<zoneCode>KR-2</zoneCode>
<vpcNo>****87</vpcNo>
<subnetNo>****51</subnetNo>
<isPublicSubnet>true</isPublicSubnet>
<dataStorageType>
<code>SSD</code>
<codeName>SSD</codeName>
</dataStorageType>
<isStorageEncryption>true</isStorageEncryption>
<dataStorageSize>10737418240</dataStorageSize>
<cpuCount>2</cpuCount>
<memorySize>4294967296</memorySize>
<createDate>2021-08-30T18:30:00+0900</createDate>
</cloudPostgresqlServerInstance>
</cloudPostgresqlServerInstanceList>
</cloudPostgresqlInstance>
</cloudPostgresqlInstanceList>
</createCloudPostgresqlReadReplicaInstanceResponse>
이 문서가 도움이 되었습니까?