REST Resource: projects.locations.zones

리소스: Zone

하드웨어 세트를 보유하는 영역입니다.

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "displayName": string,
  "state": enum (State),
  "contacts": [
    {
      object (Contact)
    }
  ],
  "ciqUri": string,
  "networkConfig": {
    object (ZoneNetworkConfig)
  },
  "globallyUniqueId": string,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "provisioningState": enum (ProvisioningState),
  "skipClusterProvisioning": boolean,
  "clusterIntentRequired": boolean,
  "clusterIntentVerified": boolean,
  "aiCapable": boolean
}
필드
name

string

식별자. 이 영역의 이름입니다. 형식: projects/{project}/locations/{location}/zones/{zone}
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"입니다.
labels

map (key: string, value: string)

선택사항입니다. 이 영역과 연결된 라벨(키-값 쌍)입니다. 라벨에 대한 자세한 내용은 라벨 만들기 및 관리를 참고하세요.

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

string

선택사항입니다. 이 영역의 사용자 친화적인 표시 이름입니다.
state

enum (State)

출력 전용입니다. 이 영역의 현재 상태입니다.
contacts[]

object (Contact)

필수 항목입니다. 지역 담당자 (이름, 이메일, 전화번호) 순서에 따라 달라짐: 목록의 첫 번째 연락처가 기본 연락처이고 두 번째 연락처가 보조 연락처입니다.
ciqUri

string

출력 전용입니다. 이 영역의 고객 접수 설문지 (CIQ) 시트로 연결되는 링크입니다.
networkConfig

object (ZoneNetworkConfig)

선택사항입니다. 이 영역의 네트워킹 구성입니다.
globallyUniqueId

string

출력 전용입니다. 이 Edge Zone에 대해 생성된 전역적으로 고유한 식별자입니다.
subscriptionConfigs[]

object (SubscriptionConfig)

출력 전용입니다. 이 영역의 구독 구성입니다.
provisioningState

enum (ProvisioningState)

출력 전용입니다. MAC 주소와 같은 구성의 프로비저닝 상태입니다.
skipClusterProvisioning

boolean

선택사항입니다. 공장 턴업 중에 클러스터 프로비저닝 단계를 건너뛸지 여부입니다. true인 경우 고객 사이트에 영역의 하드웨어가 설치된 후에 Kubernetes 클러스터가 생성됨을 나타냅니다.
clusterIntentRequired

boolean

출력 전용입니다. 주문을 수락하기 전에 고객이 유효한 클러스터 의도를 제공해야 하는지 여부를 나타냅니다. true인 경우 클러스터 인텐트가 있어야 주문을 수락할 수 있습니다. 이는 조기 검증을 적용하고 구성 누락으로 인한 지연을 방지하는 데 사용됩니다.
clusterIntentVerified

boolean

출력 전용입니다. 제공된 클러스터 인텐트가 성공적으로 검증되었는지 여부를 나타냅니다. 이 플래그는 주문을 수락하기 전에 클러스터 인텐트가 있는지 확인합니다.
aiCapable

boolean

출력 전용입니다. 이 영역이 GDC 소프트웨어 클러스터의 Gemini용인지 나타냅니다.

주

영역의 유효한 상태입니다.

열거형
STATE_UNSPECIFIED 영역의 상태가 지정되지 않았습니다.
ADDITIONAL_INFO_NEEDED 진행하려면 고객의 추가 정보가 필요합니다.
PREPARING Google에서 구역을 준비하고 있습니다.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 공장 턴업이 완료되었습니다.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED 영역에서 공장 설정 턴업 검사를 실행하고 있습니다.
READY_FOR_SITE_TURNUP 사이트 턴업을 위해 영역이 준비되었습니다.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 영역이 공장 설정 확인에 실패했습니다.
ACTIVE 영역을 사용할 수 있습니다.
CANCELLED 구간이 취소되었습니다.

ZoneNetworkConfig

영역의 네트워킹 구성입니다.

JSON 표현 
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer
}
필드
machineMgmtIpv4Range

string

필수 항목입니다. 머신 관리용 IPv4 주소 블록입니다. 영역의 머신당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. managementIpv4Subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.
kubernetesNodeIpv4Range

string

필수 항목입니다. Kubernetes 노드의 IPv4 주소 블록입니다. 영역의 머신당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. kubernetesIpv4Subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.
kubernetesControlPlaneIpv4Range

string

필수 항목입니다. Kubernetes 컨트롤 플레인의 IPv4 주소 블록입니다. 영역에서 클러스터당 하나 이상의 주소를 할당할 수 있을 만큼 큰 비공개 RFC1918 또는 공개 CIDR 블록이어야 합니다. kubernetesIpv4Subnet에 있어야 하며 다른 주소 범위와 분리되어야 합니다.
managementIpv4Subnet

object (Subnet)

필수 항목입니다. 관리 네트워크의 IPv4 서브넷입니다.
kubernetesIpv4Subnet

object (Subnet)

선택사항입니다. Kubernetes 네트워크의 IPv4 서브넷입니다. 지정하지 않으면 Kubernetes 서브넷이 관리 서브넷과 동일합니다.
dnsIpv4Addresses[]

string

선택사항입니다. DNS 네임서버입니다. GDC 인프라가 이 IP를 통해 DNS 쿼리를 확인합니다. 지정하지 않으면 Google DNS가 사용됩니다.
kubernetesPrimaryVlanId

integer

선택사항입니다. Kubernetes VLAN ID입니다. 기본적으로 기본 Kubernetes 네트워크를 포함한 Kubernetes 노드는 머신 관리 네트워크와 동일한 VLAN에 있습니다. 네트워크 세분화 목적을 위해 필요에 따라 분리할 수 있습니다.

서브넷

서브넷을 나타냅니다.

JSON 표현 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
필드
addressRange

string

필수 항목입니다. CIDR 표기법으로 표시된 이 서브넷의 주소 범위입니다.
defaultGatewayIpAddress

string

필수 항목입니다. 이 서브넷의 기본 게이트웨이입니다.

SubscriptionConfig

구독 구성을 저장하는 메시지입니다.

JSON 표현 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
필드
subscriptionId

string

출력 전용입니다. 정기 결제의 고유 식별자입니다.
billingId

string

출력 전용입니다. 구독이 생성된 Google Cloud 결제 ID입니다.
state

enum (SubscriptionState)

출력 전용입니다. 정기 결제의 현재 상태입니다.

SubscriptionState

정기 결제의 상태를 나타내는 열거형입니다.

열거형
SUBSCRIPTION_STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
ACTIVE 활성 상태는 정기 결제가 성공적으로 생성되었으며 청구가 진행 중임을 의미합니다.
INACTIVE 비활성은 구독이 생성되었지만 아직 청구가 시작되지 않았음을 의미합니다.
ERROR 정기 결제가 오류 상태입니다.
FAILED_TO_RETRIEVE 구독 상태를 가져오지 못했습니다. 일시적인 문제일 수 있습니다. 사용자가 요청을 다시 시도해야 합니다.
COMPLETED 종료일에 도달하여 구독이 완료되었습니다.

ProvisioningState

MAC 주소와 같은 구성의 유효한 프로비저닝 상태입니다.

열거형
PROVISIONING_STATE_UNSPECIFIED 프로비저닝 상태가 지정되지 않았습니다.
PROVISIONING_REQUIRED 프로비저닝이 필요합니다. Google에서 설정합니다.
PROVISIONING_IN_PROGRESS 프로비저닝이 진행 중입니다. 고객이 설정합니다.
PROVISIONING_COMPLETE 프로비저닝이 완료되었습니다. 고객이 설정합니다.

메서드

create

 특정 프로젝트와 위치에 새 영역을 만듭니다.

delete

 영역을 삭제합니다.

get

 영역의 세부정보를 가져옵니다.

list

 특정 프로젝트와 위치의 영역을 나열합니다.

patch

 영역의 파라미터를 업데이트합니다.

signal

 영역의 상태를 알립니다.