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)
  }
}
字段
name

string

标识符。相应可用区的名称。格式:projects/{project}/locations/{location}/zones/{zone}

createTime

string (Timestamp format)

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

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

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

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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)

可选。相应可用区的网络配置。

可用区的有效状态。

枚举
STATE_UNSPECIFIED 未指定区域的状态。
ADDITIONAL_INFO_NEEDED 需要客户提供更多信息才能继续处理。
PREPARING Google 正在准备该区域。
ACTIVE 该可用区可供使用。
CANCELLED 该 Zone 已取消。

ZoneNetworkConfig

相应可用区的网络配置。

JSON 表示法
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  }
}
字段
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 子网将与管理子网相同。

子网

表示子网。

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

string

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

defaultGatewayIpAddress

string

必需。相应子网的默认网关。

方法

create

在给定的项目和位置中创建新区域。

delete

删除可用区。

get

获取可用区的详细信息。

list

列出给定项目和位置中的可用区。

patch

更新相应地区的参数。