REST Resource: projects.locations.privateClouds

리소스: PrivateCloud

프라이빗 클라우드 리소스를 나타냅니다. STANDARD 및 TIME_LIMITED 유형의 프라이빗 클라우드는 영역 리소스이고 STRETCHED 프라이빗 클라우드는 리전 리소스입니다.

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "state": enum (State),
  "networkConfig": {
    object (NetworkConfig)
  },
  "managementCluster": {
    object (ManagementCluster)
  },
  "description": string,
  "hcx": {
    object (Hcx)
  },
  "nsx": {
    object (Nsx)
  },
  "vcenter": {
    object (Vcenter)
  },
  "uid": string,
  "type": enum (Type)
}
필드
name

string

출력 전용입니다. 식별자. 이 프라이빗 클라우드의 리소스 이름입니다. 리소스 이름은 https://cloud.google.com/apis/design/resource_names의 규칙을 따르는 스키마가 없는 URI입니다. 예를 들면 projects/my-project/locations/us-central1-a/privateClouds/my-cloud입니다.
createTime

string (Timestamp format)

출력 전용입니다. 이 리소스의 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 이 리소스의 마지막 업데이트 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
deleteTime

string (Timestamp format)

출력 전용입니다. 리소스가 삭제되도록 예약된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
expireTime

string (Timestamp format)

출력 전용입니다. 리소스를 되돌릴 수 없이 삭제할 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
state

enum (State)

출력 전용입니다. 리소스의 상태입니다. 적절한 경우 이 열거형에 새 값이 추가될 수 있습니다.
networkConfig

object (NetworkConfig)

필수 항목입니다. 프라이빗 클라우드의 네트워크 구성입니다.
managementCluster

object (ManagementCluster)

필수 항목입니다. 입력 전용입니다. 이 프라이빗 클라우드의 관리 클러스터입니다. 이 필드는 프라이빗 클라우드를 만드는 동안 기본 클러스터의 세부정보를 제공하는 데 필요합니다.

Private Cloud를 만든 후에는 ManagementCluster.clusterId, ManagementCluster.nodeTypeId 필드를 변경할 수 없습니다.
description

string

이 프라이빗 클라우드에 대해 사용자가 제공한 설명입니다.
hcx

object (Hcx)

출력 전용입니다. HCX 어플라이언스
nsx

object (Nsx)

출력 전용입니다. NSX 어플라이언스
vcenter

object (Vcenter)

출력 전용입니다. vCenter 어플라이언스입니다.
uid

string

출력 전용입니다. 리소스에 대해 시스템에서 생성한 고유 식별자입니다.
type

enum (Type)

선택사항입니다. 프라이빗 클라우드의 유형입니다. 기본값은 STANDARD입니다.

주

열거형 State는 프라이빗 클라우드의 가능한 상태를 정의합니다.

열거형
STATE_UNSPECIFIED 기본값입니다. 절대로 이 값을 사용하지 마세요.
ACTIVE 프라이빗 클라우드가 준비되었습니다.
CREATING 프라이빗 클라우드를 만드는 중입니다.
UPDATING 프라이빗 클라우드가 업데이트되고 있습니다.
FAILED 프라이빗 클라우드가 실패 상태입니다.
DELETED 프라이빗 클라우드가 삭제될 예정입니다. 삭제 프로세스는 해당 undelete 메서드를 사용하여 취소할 수 있습니다.
PURGING 프라이빗 클라우드가 되돌릴 수 없이 삭제되고 시스템에서 삭제되고 있습니다.

NetworkConfig

피어링을 수행해야 하는 소비자 프로젝트의 네트워크 구성입니다.

JSON 표현 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
필드
managementCidr

string

필수 항목입니다. VMware 관리 어플라이언스에서 사용하는 관리 CIDR입니다.
vmwareEngineNetwork

string

선택사항입니다. 프라이빗 클라우드에 연결된 VMware Engine 네트워크의 상대 리소스 이름입니다. projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId} 형식으로 이름을 지정합니다. 여기서 {project}은 프로젝트 번호 또는 프로젝트 ID일 수 있습니다.
vmwareEngineNetworkCanonical

string

출력 전용입니다. VMware Engine 네트워크의 표준 이름(형식: projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId})
managementIpAddressLayoutVersion

integer

출력 전용입니다. 관리 IP 주소 범위의 IP 주소 레이아웃 버전입니다. 가능한 버전은 다음과 같습니다. * managementIpAddressLayoutVersion=1: 일부 기존 비공개 클라우드에서 사용되는 기존 IP 주소 레이아웃을 나타냅니다. 모든 기능을 지원하지 않으므로 새 비공개 클라우드에서는 더 이상 지원되지 않습니다. * managementIpAddressLayoutVersion=2: 새로 생성된 모든 비공개 클라우드에서 사용되는 최신 IP 주소 레이아웃을 나타냅니다. 이 버전은 현재의 모든 기능을 지원합니다.
dnsServerIp

string

출력 전용입니다. 프라이빗 클라우드의 DNS 서버 IP입니다. vCenter, NSX-T Manager, ESXi 호스트와 같은 프라이빗 클라우드의 관리 엔티티 이름 확인을 위해 모든 DNS 쿼리를 이 주소로 전달할 수 있습니다.

ManagementCluster

관리 클러스터 구성입니다.

JSON 표현 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
필드
clusterId

string

필수 항목입니다. 사용자가 제공한 새 Cluster의 식별자입니다. 식별자는 다음 요구사항을 충족해야 합니다.

  • 영숫자 문자와 하이픈만 1~63개 포함
  • 알파벳 문자로 시작
  • 하이픈이 아닌 문자로 끝남
  • UUID 형식으로 지정되지 않음
  • RFC 1034 (섹션 3.5)를 준수합니다.
nodeTypeConfigs

map (key: string, value: object (NodeTypeConfig))

필수 항목입니다. 이 클러스터의 클러스터 노드 유형의 맵입니다. 여기서 키는 노드 유형의 표준 식별자입니다 (NodeType에 해당).

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
stretchedClusterConfig

object (StretchedClusterConfig)

선택사항입니다. 스트레치 클러스터의 구성입니다. 확장된 프라이빗 클라우드에 필요합니다.

Hcx

HCX Cloud Manager 어플라이언스에 관한 세부정보입니다.

JSON 표현 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
필드
internalIp

string

어플라이언스의 내부 IP 주소입니다.
version

string

어플라이언스 버전입니다.
state

enum (State)

출력 전용입니다. 어플라이언스의 상태입니다.
fqdn

string

어플라이언스의 정규화된 도메인 이름입니다.

주

어플라이언스 상태

열거형
STATE_UNSPECIFIED 지정되지 않은 어플라이언스 상태입니다. 기본값입니다.
ACTIVE 어플라이언스가 작동 중이며 사용할 수 있습니다.
CREATING 어플라이언스가 배포되고 있습니다.
ACTIVATING 어플라이언스가 활성화되고 있습니다.

Nsx

NSX Manager 어플라이언스에 관한 세부정보입니다.

JSON 표현 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
필드
internalIp

string

어플라이언스의 내부 IP 주소입니다.
version

string

어플라이언스 버전입니다.
state

enum (State)

출력 전용입니다. 어플라이언스의 상태입니다.
fqdn

string

어플라이언스의 정규화된 도메인 이름입니다.

주

어플라이언스 상태

열거형
STATE_UNSPECIFIED 지정되지 않은 어플라이언스 상태입니다. 기본값입니다.
ACTIVE 어플라이언스가 작동 중이며 사용할 수 있습니다.
CREATING 어플라이언스가 배포되고 있습니다.

vCenter

vCenter Server 관리 어플라이언스에 대한 세부정보입니다.

JSON 표현 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
필드
internalIp

string

어플라이언스의 내부 IP 주소입니다.
version

string

어플라이언스 버전입니다.
state

enum (State)

출력 전용입니다. 어플라이언스의 상태입니다.
fqdn

string

어플라이언스의 정규화된 도메인 이름입니다.

주

어플라이언스 상태

열거형
STATE_UNSPECIFIED 지정되지 않은 어플라이언스 상태입니다. 기본값입니다.
ACTIVE 어플라이언스가 작동 중이며 사용할 수 있습니다.
CREATING 어플라이언스가 배포되고 있습니다.

유형

열거형 유형은 프라이빗 클라우드 유형을 정의합니다.

열거형
STANDARD 표준 비공개는 영역 리소스이며 노드가 3개 이상입니다. 기본 유형입니다.
TIME_LIMITED 시간 제한 프라이빗 클라우드는 영역 리소스이며 노드가 1개만 있을 수 있고 수명이 제한됩니다. 정의된 기간이 지나면 삭제되며, 최대 3개 이상의 노드로 확장하여 표준 프라이빗 클라우드로 변환할 수 있습니다.
STRETCHED 확장된 프라이빗 클라우드는 중복이 있는 리전별 리소스이며, 노드가 최소 6개이고 노드 수는 짝수여야 합니다.

메서드

create

 특정 프로젝트와 위치에 새 PrivateCloud 리소스를 만듭니다.

delete

 삭제할 PrivateCloud 리소스를 예약합니다.

get

 리소스 이름으로 PrivateCloud 리소스를 가져옵니다.

getDnsForwarding

 DnsForwarding 구성의 세부정보를 가져옵니다.

getIamPolicy

 리소스의 액세스 제어 정책을 가져옵니다.

list

 특정 프로젝트와 위치의 PrivateCloud 리소스를 나열합니다.

patch

 PrivateCloud 리소스를 수정합니다.

privateCloudDeletionNow

 현재 소프트 삭제 상태인 프라이빗 클라우드의 삭제를 가속화합니다. 소프트 삭제 상태인 PrivateCloud 리소스의 PrivateCloud.state은 SOFT_DELETED로 설정되고 PrivateCloud.expireTime은 삭제를 더 이상 되돌릴 수 없는 시간으로 설정됩니다.

resetNsxCredentials

 NSX 어플라이언스의 사용자 인증 정보를 재설정합니다.

resetVcenterCredentials

 vCenter 어플라이언스의 사용자 인증 정보를 재설정합니다.

setIamPolicy

 지정된 리소스의 액세스 제어 정책을 설정합니다.

showNsxCredentials

 NSX 어플라이언스의 사용자 인증 정보 세부정보를 가져옵니다.

showVcenterCredentials

 vCenter 어플라이언스의 사용자 인증 정보 세부정보를 가져옵니다.

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.

undelete

 DeletePrivateCloud에 의해 이전에 삭제가 예약된 프라이빗 클라우드를 복원합니다.

updateDnsForwarding

 연결된 도메인과 같은 DnsForwarding 구성의 매개변수를 업데이트합니다.