REST Resource: projects.locations.zones

资源：可用区

包含一组硬件的可用区。

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)

仅限输出。相应可用区的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。相应时区上次更新的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“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

仅限输出。为相应边缘区域生成的全局唯一标识符。
subscriptionConfigs[]

object (SubscriptionConfig)

仅限输出。相应可用区的订阅配置。
provisioningState

enum (ProvisioningState)

仅限输出。配置（例如 MAC 地址）的配置状态。
skipClusterProvisioning

boolean

可选。在恢复出厂设置期间是否跳过集群配置步骤。如果为 true，则表示在客户现场安装区域的硬件后，系统将创建 Kubernetes 集群。
clusterIntentRequired

boolean

仅限输出。表示客户是否必须先提供有效的集群意图，然后才能接受订单。如果为 true，则在存在集群意图之前，无法接受订单。此字段用于强制执行早期验证，并防止因缺少配置而导致延迟。
clusterIntentVerified

boolean

仅限输出。表示所提供的聚类意图是否已成功验证。此标志可确保在接受订单之前存在集群意图。
aiCapable

boolean

仅限输出。指示相应可用区是否适用于 GDC Software 集群上的 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 该 Zone 已取消。

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

 指示可用区的状态。