如需了解版本信息，请参阅 Distributed Cloud connected 版本说明。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

REST Resource: projects.locations.zones

资源：Zone
- JSON 表示法
州/省/直辖市/自治区
ZoneNetworkConfig
- JSON 表示法
子网
- JSON 表示法
BGPConfig
- JSON 表示法
ProvisioningState
方法

资源：Zone

包含一组硬件的可用区。

JSON 表示法

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, "intelPccsKey": string, "currentResourceOperation": { object (`ResourceOperation`) }, "resourceOperations": [ { object (`ResourceOperation`) } ], "errors": [ { object (`Status`) } ], "site": string }

{
  "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,
  "intelPccsKey": string,
  "currentResourceOperation": {
    object (ResourceOperation)
  },
  "resourceOperations": [
    {
      object (ResourceOperation)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "site": string
}

字段
`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` 仅限输出。指明提供的集群 intent 是否已成功验证。此标志可确保在接受订单之前存在集群意图。
`aiCapable`	`boolean` 可选。指明此可用区是否适用于 Gemini on GDC Software 集群。
`intelPccsKey`	`string` 可选。Intel 平台配置和认证服务 (PCCS) 密钥，用于预配和认证 AI 加速器硬件。由为 Gemini on GDC 软件集群提供服务的可用区使用。
`currentResourceOperation`	`object (ResourceOperation)` 仅限输出。可用区的当前资源操作。
`resourceOperations[]`	`object (ResourceOperation)` 可选。已在可用区中执行的所有资源操作的列表。
`errors[]`	`object (Status)` 仅限输出。可用区启动期间遇到的错误。ErrorInfo 元数据将包含时间戳以及错误是否可重试。
`site`	`string` 可选。指定此可用区中硬件所在的站点的名称。格式：`projects/{project}/locations/{location}/sites/{site}`。对于 Gemini on GDC Software 可用区，此字段为必填字段。

州

可用区的有效状态。

枚举
`STATE_UNSPECIFIED`	未指定可用区状态。
`ADDITIONAL_INFO_NEEDED`	需要客户提供更多信息才能继续。
`INFO_COMPLETE`	该区域包含开始区域准备工作所需的所有信息。
`PREPARING`	Google 正在准备可用区。
`READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS`	工厂启动已成功。
`CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED`	该可用区正在运行工厂启动检查。
`READY_FOR_PROVISIONING`	该可用区已准备好进行预配。
`READY_FOR_SITE_TURNUP`	该可用区已准备好进行站点启用。
`PROVISIONING_STARTED`	已开始预配区域。
`PROVISIONING_FAILED`	该可用区的预配失败。
`OFFLINE`	该区域处于离线状态。
`CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED`	该可用区未通过工厂启动检查。
`ACTIVE`	该区域可供使用。
`CANCELLED`	该区域已被取消。
`AWAITING_HARDWARE`	该区域正在等待硬件关联。

ZoneNetworkConfig

可用区的网络配置。

JSON 表示法

JSON 表示法
{ "machineMgmtIpv4Range": string, "kubernetesNodeIpv4Range": string, "kubernetesControlPlaneIpv4Range": string, "managementIpv4Subnet": { object (`Subnet`) }, "kubernetesIpv4Subnet": { object (`Subnet`) }, "dnsIpv4Addresses": [ string ], "kubernetesPrimaryVlanId": integer, "aiCapableIpv4Subnet": { object (`Subnet`) }, "bgpConfig": { object (`BGPConfig`) }, "topLevelDomain": string, "torSwitchType": string, "boundaryProxyPublicIpv4Range": string, "boundaryProxyPrivateEdgeCoreIpv4Range": string, "boundaryProxyPrivateCoreEdgeIpv4Range": string, "bastionHostPublicIpv4Range": string, "bastionHostPrivateIpv4Range": string, "tlsPublicRootCertificatePem": string }

{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer,
  "aiCapableIpv4Subnet": {
    object (Subnet)
  },
  "bgpConfig": {
    object (BGPConfig)
  },
  "topLevelDomain": string,
  "torSwitchType": string,
  "boundaryProxyPublicIpv4Range": string,
  "boundaryProxyPrivateEdgeCoreIpv4Range": string,
  "boundaryProxyPrivateCoreEdgeIpv4Range": string,
  "bastionHostPublicIpv4Range": string,
  "bastionHostPrivateIpv4Range": string,
  "tlsPublicRootCertificatePem": string
}

字段
`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 中。为了实现网络分段，可以选择将它们分开。
`aiCapableIpv4Subnet`	`object (Subnet)` 可选。为 Gemini on GDC Software 集群提供服务的可用区的 IPv4 子网。所提供范围的最后一个 /29 子网预留给 DHCP。
`bgpConfig`	`object (BGPConfig)` 可选。此可用区的边界网关协议 (BGP) 特定配置。由为 Gemini on GDC 软件集群提供服务的可用区使用。
`topLevelDomain`	`string` 可选。此区域的自定义顶级域名。由为 Gemini on GDC 软件集群提供服务的可用区使用。
`torSwitchType`	`string` 可选。有关客户 ToR 交换机类型的其他信息。由为 Gemini on GDC 软件集群提供服务的可用区使用。
`boundaryProxyPublicIpv4Range`	`string` 可选。边界代理公共 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC Software 集群提供服务的可用区使用。
`boundaryProxyPrivateEdgeCoreIpv4Range`	`string` 可选。边界代理专用边缘到核心 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC Software 集群提供服务的可用区使用。
`boundaryProxyPrivateCoreEdgeIpv4Range`	`string` 可选。边界代理专用核心到边缘 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC Software 集群提供服务的可用区使用。
`bastionHostPublicIpv4Range`	`string` 可选。堡垒主机的公共 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC Software 集群提供服务的可用区使用。
`bastionHostPrivateIpv4Range`	`string` 可选。采用 CIDR 表示法的堡垒主机私有 IPv4 范围。目前应为 /32。由为 Gemini on GDC Software 集群提供服务的可用区使用。
`tlsPublicRootCertificatePem`	`string` 可选。采用 PEM 格式的 TLS 公共根证书。由为 Gemini on GDC 软件集群提供服务的可用区使用。

子网

表示子网。

JSON 表示法
{ "addressRange": string, "defaultGatewayIpAddress": string }

字段

字段
`addressRange`	`string` 必需。此子网的地址范围（采用 CIDR 表示法）。
`defaultGatewayIpAddress`	`string` 必需。此子网的默认网关。

addressRange

string

必需。此子网的地址范围（采用 CIDR 表示法）。

defaultGatewayIpAddress

string

必需。此子网的默认网关。

BGPConfig

边界网关协议 (BGP) 配置。

JSON 表示法
{ "asn": string, "l3PeerIps": [ string ] }

字段

字段
`asn`	`string` 必需。BGP 自治系统编号 (ASN)。
`l3PeerIps[]`	`string` 必需。BGP 对等 IP。必须至少提供两个 L3 对等 IP。

asn

string

必需。BGP 自治系统编号 (ASN)。

l3PeerIps[]

string

必需。BGP 对等 IP。必须至少提供两个 L3 对等 IP。

ProvisioningState

MAC 地址等配置的有效预配状态。

枚举
`PROVISIONING_STATE_UNSPECIFIED`	未指定预配状态。
`PROVISIONING_REQUIRED`	必须进行配置。由 Google 设置。
`PROVISIONING_IN_PROGRESS`	正在进行配置。由客户设置。
`PROVISIONING_COMPLETE`	配置已完成。由客户设置。

方法
`create`	在给定的项目和位置中创建新可用区。
`delete`	删除区域。
`get`	获取可用区的详细信息。
`list`	列出给定项目和位置中的可用区。
`patch`	更新可用区的参数。
`signal`	指示可用区的状态。

REST Resource: projects.locations.zones

资源：Zone

州

ZoneNetworkConfig

子网

BGPConfig

ProvisioningState

方法

`create`

`delete`

`get`

`list`

`patch`

`signal`

REST Resource: projects.locations.zones 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

资源：Zone

州

ZoneNetworkConfig

子网

BGPConfig

ProvisioningState

方法

create

delete

get

list

patch

signal

REST Resource: projects.locations.zones

`create`

`delete`

`get`

`list`

`patch`

`signal`