Package google.cloud.gdchardwaremanagement.v1alpha

索引

GDCHardwareManagement

GDC Hardware Management 服务。

CancelOrder

rpc CancelOrder(CancelOrderRequest) returns (Operation)

取消订单。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.submit

如需了解详情，请参阅 IAM 文档。
ChangeHardwareSubscription

rpc ChangeHardwareSubscription(ChangeHardwareSubscriptionRequest) returns (Operation)

更新硬件的订阅配置。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

为订单创建新评论。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.comments.create

如需了解详情，请参阅 IAM 文档。
CreateHardware

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

在给定的项目和位置中创建新硬件。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.create

如需了解详情，请参阅 IAM 文档。
CreateHardwareGroup

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

在给定订单中创建新的硬件组。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardwareGroups.create

如需了解详情，请参阅 IAM 文档。
CreateOrder

rpc CreateOrder(CreateOrderRequest) returns (Operation)

在给定的项目和位置中创建新订单。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.create

如需了解详情，请参阅 IAM 文档。
CreateSite

rpc CreateSite(CreateSiteRequest) returns (Operation)

在给定的项目和位置中创建新版协作平台网站。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.sites.create

如需了解详情，请参阅 IAM 文档。
CreateZone

rpc CreateZone(CreateZoneRequest) returns (Operation)

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

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.create

如需了解详情，请参阅 IAM 文档。
CreateZoneOperation

rpc CreateZoneOperation(CreateZoneOperationRequest) returns (Operation)

在给定可用区中创建新的 ZoneOperation。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
DeleteHardware

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

删除硬件。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.delete

如需了解详情，请参阅 IAM 文档。
DeleteHardwareGroup

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

删除硬件组。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardwareGroups.delete

如需了解详情，请参阅 IAM 文档。
DeleteOrder

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

删除订单。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.delete

如需了解详情，请参阅 IAM 文档。
DeleteSite

rpc DeleteSite(DeleteSiteRequest) returns (Operation)

删除网站。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.sites.delete

如需了解详情，请参阅 IAM 文档。
DeleteZone

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

删除区域。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.delete

如需了解详情，请参阅 IAM 文档。
DeleteZoneOperation

rpc DeleteZoneOperation(DeleteZoneOperationRequest) returns (Operation)

删除单个 ZoneOperation。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
GetChangeLogEntry

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

获取订单变更的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.changeLogEntries.get

如需了解详情，请参阅 IAM 文档。
GetComment

rpc GetComment(GetCommentRequest) returns (Comment)

获取评论的内容。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.comments.get

如需了解详情，请参阅 IAM 文档。
GetHardware

rpc GetHardware(GetHardwareRequest) returns (Hardware)

获取硬件详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.get

如需了解详情，请参阅 IAM 文档。
GetHardwareGroup

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

获取硬件组的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardwareGroups.get

如需了解详情，请参阅 IAM 文档。
GetOrder

rpc GetOrder(GetOrderRequest) returns (Order)

获取订单的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.get

如需了解详情，请参阅 IAM 文档。
GetSite

rpc GetSite(GetSiteRequest) returns (Site)

获取网站的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.sites.get

如需了解详情，请参阅 IAM 文档。
GetSku

rpc GetSku(GetSkuRequest) returns (Sku)

获取 SKU 的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.skus.get

如需了解详情，请参阅 IAM 文档。
GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

获取可用区的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.get

如需了解详情，请参阅 IAM 文档。
GetZoneOperation

rpc GetZoneOperation(GetZoneOperationRequest) returns (ZoneOperation)

获取单个 ZoneOperation 的详细信息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
ListChangeLogEntries

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

列出对订单所做的更改。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.changeLogEntries.list

如需了解详情，请参阅 IAM 文档。
ListComments

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

列出订单的注释。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.comments.list

如需了解详情，请参阅 IAM 文档。
ListHardware

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

列出给定项目和位置中的硬件。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.list

如需了解详情，请参阅 IAM 文档。
ListHardwareGroups

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

按给定顺序列出硬件群组。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardwareGroups.list

如需了解详情，请参阅 IAM 文档。
ListOrders

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

列出给定项目和位置中的订单。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.list

如需了解详情，请参阅 IAM 文档。
ListSites

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

列出给定项目和位置中的网站。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.sites.list

如需了解详情，请参阅 IAM 文档。
ListSkus

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

列出给定项目和位置的 SKU。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.skus.list

如需了解详情，请参阅 IAM 文档。
ListZoneOperations

rpc ListZoneOperations(ListZoneOperationsRequest) returns (ListZoneOperationsResponse)

列出给定项目和位置中的 ZoneOperation。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

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

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.list

如需了解详情，请参阅 IAM 文档。
RecordActionOnComment

rpc RecordActionOnComment(RecordActionOnCommentRequest) returns (Comment)

记录对评论执行的操作。如果请求中指定的操作为 READ，则评论中的查看时间会设置为收到请求的时间。如果评论已被标记为已读，则后续调用将被忽略。如果操作为 UNREAD，则系统会从评论中清除查看时间。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
RequestOrderDateChange

rpc RequestOrderDateChange(RequestOrderDateChangeRequest) returns (Operation)

更新单个订单的请求日期更改。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.update

如需了解详情，请参阅 IAM 文档。
SignalHardwareState

rpc SignalHardwareState(SignalHardwareStateRequest) returns (Operation)

指示硬件的状态。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.update

如需了解详情，请参阅 IAM 文档。
SignalZoneState

rpc SignalZoneState(SignalZoneStateRequest) returns (Operation)

指示可用区的状态。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.update

如需了解详情，请参阅 IAM 文档。
SubmitOrder

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

提交订单。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.submit

如需了解详情，请参阅 IAM 文档。
UpdateHardware

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

更新硬件参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardware.update

如需了解详情，请参阅 IAM 文档。
UpdateHardwareGroup

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

更新硬件组的参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.hardwareGroups.update

如需了解详情，请参阅 IAM 文档。
UpdateOrder

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

更新订单的参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.orders.update

如需了解详情，请参阅 IAM 文档。
UpdateSite

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

更新网站的参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.sites.update

如需了解详情，请参阅 IAM 文档。
UpdateZone

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

更新可用区的参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • gdchardwaremanagement.zones.update

如需了解详情，请参阅 IAM 文档。
UpdateZoneOperation

rpc UpdateZoneOperation(UpdateZoneOperationRequest) returns (Operation)

更新单个 ZoneOperation 的参数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。
ValidateHardware

rpc ValidateHardware(ValidateHardwareRequest) returns (Operation)

验证以 JSON 数据形式提供的硬件配置。此方法会执行静态检查，不会创建或修改任何资源

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

BGPConfig

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

字段
asn

string

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

string

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

CancelOrderRequest

取消订单的请求。

字段
name

string

必需。订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

运营商

运营商列表。

枚举
CARRIER_UNSPECIFIED 未指定运营商。
FEDEX FedEx。
UPS UPS。
USPS 快递公司：USPS。

ChangeHardwareSubscriptionRequest

更改硬件订阅配置的请求。

字段
name

string

必需。要更新的硬件的名称。
term_end_behavior

TermEndBehavior

必需。订阅在到期时的行为。

TermEndBehavior

订阅的到期行为。

枚举
TERM_END_BEHAVIOR_UNSPECIFIED 未指定到期行为。
TERMINATE_AT_TERM_END 到期行为是 TERMINATE_AT_TERM_END。

ChangeLogEntry

对订单所做更改的日志条目。

字段
name

string

标识符。此更新日志条目的名称。格式：projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}
create_time

Timestamp

仅限输出。此更新日志条目的创建时间。
labels

map<string, string>

可选。与此更新日志条目关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
log

string

仅限输出。此日志条目的内容。

评论

对订单的评论。

字段
name

string

标识符。此评论的名称。格式：projects/{project}/locations/{location}/orders/{order}/comments/{comment}
create_time

Timestamp

仅限输出。此评论的创建时间。
labels

map<string, string>

可选。与此评论关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
author

string

仅限输出。此评论作者的用户名。此字段会根据创建评论时使用的凭据自动填充。
text

string

必需。此评论的文本。文本长度不得超过 1000 个字符。
customer_viewed_time

Timestamp

仅限输出。客户首次查看此评论的时间戳。如果评论未被查看，则此时间戳将不设置。
author_entity

Entity

仅限输出。作者所属的实体。

联系人

联系人的详细联系信息。

字段
given_name

string

必需。联系人的名字。
family_name

string

可选。联系人的姓氏。
email

string

可选。联系人的主邮箱。
email_list[]

string

可选。联系人的完整电子邮件地址列表（包括主要电子邮件地址）。
phone

string

可选。联系人的电话号码。
time_zone

TimeZone

可选。联系人所在的时区。
reachable_times[]

TimePeriod

可选。可联系到该联系人的时间段。如果此字段为空，则表示可以随时联系到该联系人。
notes

string

可选。自由格式备注，详细说明联系人希望如何接收通知。例如，他们可能有首选联系方式，或者希望在后续任何上报中被抄送。

CreateCommentRequest

创建评论的请求。

字段
parent

string

必需。要创建评论的订单。格式：projects/{project}/locations/{location}/orders/{order}
comment_id

string

可选。用于在其父级范围内唯一标识评论的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 comment.name 字段将被忽略。
comment

Comment

必需。要创建的评论。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

CreateHardwareGroupRequest

创建硬件组的请求。

字段
parent

string

必需。创建硬件组的顺序。格式：projects/{project}/locations/{location}/orders/{order}
hardware_group_id

string

可选。用于在其父级范围内唯一标识 HardwareGroup 的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 hardware_group.name 字段将被忽略。
hardware_group

HardwareGroup

必需。要创建的硬件组。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

CreateHardwareRequest

创建硬件的请求。

字段
parent

string

必需。要在其中创建硬件的项目和位置。格式：projects/{project}/locations/{location}
hardware_id

string

可选。用于在其父级范围内唯一标识硬件的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 hardware.name 字段将被忽略。
hardware

Hardware

必需。要创建的资源。

CreateOrderRequest

创建订单的请求。

字段
parent

string

必需。要在其中创建订单的项目和位置。格式：projects/{project}/locations/{location}
order_id

string

可选。用于在其父级范围内唯一标识订单的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 order.name 字段将被忽略。
order

Order

必需。要创建的订单。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

CreateSiteRequest

创建网站的请求。

字段
parent

string

必需。要在其中创建网站的项目和位置。格式：projects/{project}/locations/{location}
site_id

string

可选。用于在其父级范围内唯一标识网站的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 site.name 字段将被忽略。
site

Site

必需。要创建的网站。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

CreateZoneOperationRequest

用于创建 ZoneOperation 的请求消息。

字段
parent

string

必需。将在其中创建此操作的父级可用区。格式：projects/{project}/locations/{location}/zones/{zone}
zone_operation_id

string

可选。用于在其父级范围内唯一标识 ZoneOperation 的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 zone_operation.name 字段将被忽略。
zone_operation

ZoneOperation

必需。要创建的可用区操作。
request_id

string

可选。用于标识请求的可选请求 ID。您可以指定一个唯一的请求 ID，这样，在您必须重试请求时，服务器就会知道忽略该请求（如果该请求已完成）。服务器将保证在第一次完成该请求后的至少 60 分钟内避免重复处理该请求。

CreateZoneRequest

创建可用区的请求。

字段
parent

string

必需。要在其中创建可用区的项目和位置。格式：projects/{project}/locations/{location}
zone_id

string

可选。用于在其父级范围内唯一标识可用区的 ID。此字段最多应包含 63 个字符，且必须以小写字符开头。仅接受小写字符、数字和 -。- 字符不能是第一个或最后一个字符。如果未设置该字段，系统会使用自动生成的 ID。

请求中的 zone.name 字段将被忽略。
zone

Zone

必需。要创建的可用区。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

DeleteHardwareGroupRequest

删除硬件组的请求。

字段
name

string

必需。硬件组的名称。格式：projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

DeleteHardwareRequest

删除硬件的请求。

字段
name

string

必需。硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

DeleteOrderRequest

删除订单的请求。

字段
name

string

必需。订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。
force

bool

可选。用于删除订单中任何嵌套资源（例如 HardwareGroup）的选项。如果为 true，则此订单的所有嵌套资源也会被删除。否则，只有当 Order 没有任何嵌套资源时，请求才会成功。

DeleteSiteRequest

删除网站的请求。

字段
name

string

必需。网站的名称。格式：projects/{project}/locations/{location}/sites/{site}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

DeleteZoneOperationRequest

用于删除 ZoneOperation 的请求消息。

字段
name

string

必需。资源的名称。格式：projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}
request_id

string

可选。用于标识请求的可选请求 ID。您可以指定一个唯一的请求 ID，这样，在您必须重试请求时，服务器就会知道忽略该请求（如果该请求已完成）。服务器将保证在第一次完成该请求后的至少 60 分钟内避免重复处理该请求。

DeleteZoneRequest

删除可用区的请求。

字段
name

string

必需。可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

维度

表示对象的尺寸。

字段
width_inches

float

必需。宽度（以英寸为单位）。
height_inches

float

必需。身高（英寸）。
depth_inches

float

必需。深度（英寸）。

实体

“实体”用于表示组织或当事方。

枚举
ENTITY_UNSPECIFIED 实体未指定。
GOOGLE Google。
CUSTOMER 客户。
VENDOR 供应商。

GetChangeLogEntryRequest

获取更新日志条目的请求。

字段
name

string

必需。更新日志条目的名称。格式：projects/{project}/locations/{location}/orders/{order}/changeLogEntries/{change_log_entry}

GetCommentRequest

获取评论的请求。

字段
name

string

必需。评论的名称。格式：projects/{project}/locations/{location}/orders/{order}/comments/{comment}

GetHardwareGroupRequest

获取硬件组的请求。

字段
name

string

必需。硬件组的名称。格式：projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}

GetHardwareRequest

获取硬件的请求。

字段
name

string

必需。硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}

GetOrderRequest

获取订单的请求。

字段
name

string

必需。资源的名称

GetSiteRequest

获取网站的请求。

字段
name

string

必需。网站的名称。格式：projects/{project}/locations/{location}/sites/{site}

GetSkuRequest

获取 SKU 的请求。

字段
name

string

必需。SKU 的名称。格式：projects/{project}/locations/{location}/skus/{sku}

GetZoneOperationRequest

用于获取 ZoneOperation 的请求消息。

字段
name

string

必需。资源的名称。格式：projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}

GetZoneRequest

获取可用区的请求。

字段
name

string

必需。可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}

硬件

在某个地点安装的硬件实例。

字段
name

string

标识符。此硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}
display_name

string

可选。此硬件的显示名称。
create_time

Timestamp

仅限输出。此硬件的创建时间。
update_time

Timestamp

仅限输出。此硬件的上次更新时间。
labels

map<string, string>

可选。与此硬件关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
order

string

可选。此硬件所属订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
hardware_group

string

仅限输出。此硬件所属硬件组的名称。格式：projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}
site

string

必需。此硬件所属站点的名称。格式：projects/{project}/locations/{location}/sites/{site}
state

State

仅限输出。此硬件的当前状态。
ciq_uri

string

仅限输出。此硬件的客户信息收集问卷调查表 (CIQ) 的链接。
config

HardwareConfig

必需。此硬件的配置。
estimated_installation_date

Date

仅限输出。此硬件的预计安装日期。
physical_info

HardwarePhysicalInfo

可选。此硬件的物理属性。
installation_info

HardwareInstallationInfo

可选。此硬件的安装信息。
zone

string

必需。此硬件所属可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}
requested_installation_date
(deprecated)

Date

可选。已弃用：请求的安装日期已移至 Order 资源。请改为对 Order 资源使用 customer_requested_installation_date。
actual_installation_date

Date

仅限输出。此硬件的实际安装日期。由 Google 填写。
machine_infos[]

MachineInfo

可选。启动所需的每台机器资产信息。
estimated_delivery_date

Date

仅限输出。硬件的预计送达日期。
ai_capable

bool

仅限输出。指明此硬件是否适用于 Gemini on GDC 软件。
subscription_configs[]

SubscriptionConfig

仅限输出。此硬件的订阅配置。
operations[]

ResourceOperation

仅限输出。在硬件上执行的所有操作的列表。
errors[]

Status

仅限输出。硬件 intent 启动期间遇到的错误。ErrorInfo 元数据将包含时间戳以及错误是否可重试。
shipping_info

ShippingInfo

仅限输出。此硬件的配送信息。

DiskInfo

机器上各个磁盘的相关信息。

字段
manufacturer

string

可选。磁盘制造商。
slot

int32

可选。磁盘插槽编号。
serial_number

string

可选。磁盘序列号。
psid

string

可选。磁盘 PSID。
part_number

string

可选。磁盘部件号。
model_number

string

可选。磁盘型号。

MacAddress

用于描述机器 MAC 地址的消息。

字段
address

string

仅限输出。地址字符串。
type

AddressType

仅限输出。此 MAC 地址的地址类型。
ipv4_address

string

仅限输出。与 MAC 地址关联的静态 IP 地址（如果使用）。仅适用于虚拟 MAC 地址类型。

AddressType

不同类型 MAC 地址的枚举。

枚举
ADDRESS_TYPE_UNSPECIFIED 未指定地址类型。
NIC 网络接口卡的地址。
BMC 基板管理控制器的地址。
VIRTUAL 虚拟接口的地址。

MachineInfo

供应商将在启动期间提供有关各个机器的信息。

字段
service_tag

string

可选。机器服务代码。
mac_addresses[]

MacAddress

仅限输出。每个关联的 MAC 地址。
name

string

仅限输出。计算机名称。
disk_infos[]

DiskInfo

可选。每个已安装磁盘的信息。
machine_type

MachineType

可选。机器类型。运行 Gemini on GDC 软件的硬件必须满足此要求。
tpm_ek_cert_hash

string

可选。TPM EK 证书哈希。硬件维修期间需要。
gpu_serial_numbers[]

string

可选。GPU 序列号。硬件维修期间需要。
cpu_serial_numbers[]

string

可选。CPU 序列号。硬件维修期间需要。
memory_infos[]

MemoryInfo

可选。每个已安装内存的信息。硬件维修期间需要。
idrac_mac_address

string

可选。iDRAC MAC 地址。硬件维修期间需要。
nic_serial_numbers[]

string

可选。NIC 序列号。硬件维修期间需要。

MachineType

Gemini on GDC Software 所用机器类型的枚举。

枚举
MACHINE_TYPE_UNSPECIFIED 未指定机器类型。
DELL_XE9680 Dell XE9680 服务器。
DELL_XE9780 Dell XE9780 服务器。

MemoryInfo

机器上各个内存的信息。

字段
serial_number

string

可选。内存序列号。
size_bytes

int64

可选。内存大小。
part_number

string

可选。内存部件号。

州

硬件的有效状态。

枚举
STATE_UNSPECIFIED 硬件状态未指定。
ADDITIONAL_INFO_NEEDED 需要客户提供更多信息才能继续。
BUILDING Google 已开始为此硬件构建硬件。
SHIPPING 硬件已制造完成，正在发货。
INSTALLING 正在安装硬件。
INSTALLED 硬件已安装。
FAILED 发生错误，需要客户干预。
INFO_COMPLETE 硬件具有所有必需的信息。
READY_FOR_PROVISIONING 硬件已准备好进行预配。
PROVISIONING_STARTED 硬件已开始预配。
PROVISIONING_FAILED 硬件配置失败。
AWAITING_IDENTIFIERS 需要添加硬件的标识符。
READY_FOR_BOOTSTRAP 硬件已准备好进行引导。

HardwareConfig

GDC 硬件的配置。

字段
sku

string

必需。对该硬件 SKU 的引用。这可以指向 AIP-162 中定义的 resource_name@revision_id 形式的特定 SKU 修订版本。如果未指定 revision_id，则表示最新修订版本。
power_supply

PowerSupply

必需。此硬件的电源类型。
subscription_duration_months

int32

可选。硬件的订阅时长（以月为单位）。
auto_renewal

bool

可选。指明硬件订阅是否会在期限结束时自动续订。当所选 SKU 支持自动续订时，可以设置此属性。

HardwareGroup

属于同一订单、具有相同 SKU 且交付到同一站点的一组硬件。

字段
name

string

标识符。此硬件组的名称。格式：projects/{project}/locations/{location}/orders/{order}/hardwareGroups/{hardware_group}
create_time

Timestamp

仅限输出。此硬件组的创建时间。
update_time

Timestamp

仅限输出。上次更新此硬件组的时间。
labels

map<string, string>

可选。与此硬件组关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
hardware_count

int32

必需。此 HardwareGroup 中的硬件数量。
config

HardwareConfig

必需。此 HardwareGroup 中硬件的配置。
site

string

必需。此 HardwareGroup 中的硬件将要送达的场所的名称。格式：projects/{project}/locations/{location}/sites/{site}
state

State

仅限输出。此 HardwareGroup 的当前状态。
zone

string

可选。此 HardwareGroup 中的硬件所属可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}
requested_installation_date
(deprecated)

Date

可选。已废弃：不应使用此值。请改用 Order 资源中的 requested_installation_date 字段。

州

HardwareGroup 的有效状态。

枚举
STATE_UNSPECIFIED 未指定 HardwareGroup 的状态。
ADDITIONAL_INFO_NEEDED 需要客户提供更多信息才能继续。
BUILDING Google 已开始为此 HardwareGroup 构建硬件。
SHIPPING 硬件已制造完成，正在发货。
INSTALLING 正在安装硬件。
PARTIALLY_INSTALLED HardwareGroup 中的部分硬件已安装。
INSTALLED HardwareGroup 中的所有硬件均已安装。
FAILED 发生错误，需要客户干预。

HardwareInstallationInfo

硬件安装信息。

字段
rack_location

string

可选。机架在站点中的位置，例如：2 楼 201 室 7 排 3 号机架。
power_distance_meters

int32

必需。与电源插座的距离（米）。
switch_distance_meters

int32

必需。与网络交换机的距离（米）。
rack_unit_dimensions

Dimensions

可选。机架单元的尺寸。
rack_space

RackSpace

可选。为硬件分配的机架空间。
rack_type

RackType

必需。机架类型。

RackType

有效的机架类型。

枚举
RACK_TYPE_UNSPECIFIED 机架类型未指定。
TWO_POST 双立柱机架。
FOUR_POST 四立柱机架。

HardwareLocation

表示一个或多个硬件的位置。

字段
site

string

必需。硬件所在站点的名称。格式：projects/{project}/locations/{location}/sites/{site}
rack_location

string

必需。机架在站点中的位置，例如：2 楼 201 室 7 排 3 号机架。
rack_space[]

RackSpace

可选。机架中硬件占用的空间。如果未设置，则假定此位置为整个机架。

HardwarePhysicalInfo

硬件的物理属性。

字段
power_receptacle

PowerReceptacleType

必需。电源插座类型。
voltage

Voltage

必需。电源电压。
amperes

Amperes

必需。电源电流。

安培

有效的安培值。

枚举
AMPERES_UNSPECIFIED 未指定电流。
AMPERES_15 15A.

NetworkUplinkType

有效的网络上行类型。

枚举
RJ_45 RJ-45。

PowerReceptacleType

有效的电源插座类型。

枚举
POWER_RECEPTACLE_TYPE_UNSPECIFIED 设施插头类型未指定。
NEMA_5_15 NEMA 5-15。
C_13 C13.
STANDARD_EU

已弃用：请改用 TYPE_G_BS1363、CEE_7_3、CEE_7_5 或 TYPE_F。
TYPE_G_BS1363 G 型 / BS1363。
CEE_7_3 C 7/3。
CEE_7_5 C 7/5。
TYPE_F 输入 F。

电压

有效电压值。

枚举
VOLTAGE_UNSPECIFIED 电压未指定。
VOLTAGE_110 120V。
VOLTAGE_220 220V。

ListChangeLogEntriesRequest

列出更新日志条目的请求。

字段
parent

string

必需。要列出其更新日志条目的订单。格式：projects/{project}/locations/{location}/orders/{order}
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListChangeLogEntriesResponse

更新日志条目的列表。

字段
change_log_entries[]

ChangeLogEntry

更新日志条目列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。

ListCommentsRequest

列出评论的请求。

字段
parent

string

必需。要列出其评论的订单。格式：projects/{project}/locations/{location}/orders/{order}
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListCommentsResponse

列出评论的请求。

字段
comments[]

Comment

评论列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。

ListHardwareGroupsRequest

列出硬件组的请求。

字段
parent

string

必需。硬件组的列出顺序。格式：projects/{project}/locations/{location}/orders/{order}
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListHardwareGroupsResponse

硬件组列表。

字段
hardware_groups[]

HardwareGroup

硬件组列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。

ListHardwareRequest

列出硬件的请求。

字段
parent

string

必需。要列出硬件的项目和位置。格式：projects/{project}/locations/{location}

如需列出所有位置的硬件，请将位置替换为 -（连字符或短划线字符），并检查响应消息中的无法访问字段。
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListHardwareResponse

硬件列表。

字段
hardware[]

Hardware

硬件列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。仅用于对通配符位置 - 的查询。如果非空，则表示结果不完整。

ListOrdersRequest

列出订单的请求。

字段
parent

string

必需。要列出其中订单的项目和位置。格式：projects/{project}/locations/{location}

如需列出所有位置的订单，请将位置替换为 -（连字符或短划线字符），并检查响应消息中的 unreachable 字段。
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListOrdersResponse

订单列表。

字段
orders[]

Order

订单列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。仅用于对通配符位置 - 的查询。如果非空，则表示结果不完整。

ListSitesRequest

列出网站的请求。

字段
parent

string

必需。要列出其中网站的项目和位置。格式：projects/{project}/locations/{location}

如需列出所有位置的站点，请将位置替换为 -（连字符或短划线字符），并检查响应消息中的 unreachable 字段。
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListSitesResponse

网站列表。

字段
sites[]

Site

网站列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。仅用于对通配符位置 - 的查询。如果非空，则表示结果不完整。

ListSkusRequest

列出 SKU 的请求。

字段
parent

string

必需。要在其中列出 SKU 的项目和位置。格式：projects/{project}/locations/{location}

如需列出所有位置的 SKU，请将位置替换为 -（连字符或短划线字符），并检查响应消息中的 unreachable 字段。
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListSkusResponse

SKU 列表。

字段
skus[]

Sku

SKU 列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。仅用于对通配符位置 - 的查询。如果非空，则表示结果不完整。

ListZoneOperationsRequest

用于列出 ZoneOperations 的请求消息。

字段
parent

string

必需。ListZoneOperationsRequest 的父级值。格式：projects/{project}/locations/{location}/zones/{zone}
page_size

int32

可选。要返回的资源数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个资源。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
page_token

string

可选。从之前的 ListZoneOperations 调用接收的页面令牌。利用其进行后续页面检索。
filter

string

可选。过滤结果。
order_by

string

可选。有关如何对结果进行排序的提示。

ListZoneOperationsResponse

ListZoneOperations 的响应消息。

字段
zone_operations[]

ZoneOperation

指定集合中的资源。
next_page_token

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。
unreachable[]

string

无序列表。无法到达的位置。

ListZonesRequest

列出可用区的请求。

字段
parent

string

必需。要列出可用区的项目和位置。格式：projects/{project}/locations/{location}

如需列出所有位置中的可用区，请将位置替换为 -（连字符或短划线字符），并检查响应消息中的 unreachable 字段。
page_size

int32

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
page_token

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤条件。请参阅 AIP-160。
order_by

string

可选。有关如何对结果进行排序的提示。

ListZonesResponse

可用区列表。

字段
zones[]

Zone

可用区列表。
next_page_token

string

标识服务器应返回的结果页面的令牌。
unreachable[]

string

无序列表。无法到达的位置。仅用于对通配符位置 - 的查询。如果非空，则表示结果不完整。

OperationMetadata

表示长时间运行的操作的元数据。

字段
create_time

Timestamp

仅供输出。操作的创建时间。
end_time

Timestamp

仅供输出。操作完成运行的时间。
target

string

仅限输出。由服务器定义的操作目标的资源路径。
verb

string

仅限输出。操作执行的谓词。
status_message

string

仅限输出。人类可读的操作状态（如果有）。
requested_cancellation

bool

仅限输出。标识用户是否已请求取消操作。已成功取消的操作具有 [Operation.error][] 值且 google.rpc.Status.code 为 1（对应于 Code.CANCELLED）。
api_version

string

仅限输出。用于启动操作的 API 版本。

订单

GDC 硬件订单。

字段
name

string

标识符。此订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
display_name

string

可选。此订单的显示名称。
create_time

Timestamp

仅限输出。此订单的创建时间。
update_time

Timestamp

仅限输出。此订单的上次更新时间。
labels

map<string, string>

可选。与此订单关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
state

State

仅限输出。此订单的状态。创建订单时，状态将设置为 DRAFT。
organization_contact

OrganizationContact

可选。客户联系信息。对于 Gemini on GDC 软件订单，此字段为可选字段；对于其他订单，此字段为必填字段。
target_workloads[]

string

可选。此订单所针对的客户指定的相关工作负载。此字段最多可包含 20 个元素，每个元素的长度不得超过 50 个字符。
customer_motivation

string

可选。有关客户下此订单的动机的信息。此字段的长度不得超过 1,000 个字符。
fulfillment_time
(deprecated)

Timestamp

可选。已弃用：请改用 customer_requested_installation_date。
customer_requested_installation_date

Date

可选。客户为此订单请求的安装日期。
region_code

string

必需。此订单将部署到的 Unicode CLDR 区域代码。如需查看有效 CLDR 区域代码的列表，请参阅语言子标签注册表。
order_form_uri

string

仅限输出。指向订购单的链接。
type

Type

仅限输出。此订单的类型。
submit_time

Timestamp

仅限输出。订单提交时间。在提交订单时自动填充为当前时间。
billing_id

string

仅限输出。此订单的 Google Cloud 结算 ID。
existing_hardware[]

HardwareLocation

可选。此订单中要移除的现有硬件。注意：除非另有约定，否则所有拆除的硬件都将被回收。
deployment_type

DeploymentType

仅限输出。此订单的部署类型。
actual_installation_date

Date

仅限输出。此订单的实际安装日期。
estimated_installation_date

Date

仅限输出。此订单的预计安装日期。
estimated_delivery_date

Date

仅限输出。此订单的预计送达日期。
migration

bool

可选。此订单是否是从客户现有基础设施进行的迁移。
accepted_time

Timestamp

仅限输出。订单移至 ACCEPTED 状态的时间。
requested_date_change

Date

仅限输出。客户或 Google 希望设置的预定安装日期。
vendor_notes

string

仅限输出。供应商提供的此订单的备注。
vendor_contact

OrganizationContact

仅限输出。分配给此订单的 SI 的联系信息。
ai_capable

bool

仅限输出。指明此订单是否针对支持 Gemini on GDC 软件的硬件。在订单成功提交后自动填充。
requested_delivery_date

Date

可选。客户可以使用此字段指定他们希望硬件送达的日期。

DeploymentType

部署的有效类型。

枚举
DEPLOYMENT_TYPE_UNSPECIFIED 未指定部署类型。
FULL_PRODUCTION 具有 SLO 的生产部署。
PROOF_OF_CONCEPT 部署时提供尽力支持，不提供服务等级目标 (SLO)。
INTERNAL 内部部署，提供尽力而为的支持，无 SLO。
CUSTOMER_LAB 我们像对待生产环境一样支持的客户实验室部署。
INTERNAL_CANARY 内部 Canary 版。

州

订单的有效状态。

枚举
STATE_UNSPECIFIED 订单状态未指定。
DRAFT 客户正在起草订单，尚未提交。
SUBMITTED 订单已提交给 Google。
INFO_COMPLETE 客户已提供履行订单所需的所有信息。
ACCEPTED Google 已接受订单。
ADDITIONAL_INFO_NEEDED 订单需要客户提供更多信息。
BUILDING Google 已开始为该订单制造硬件。
SHIPPING 硬件已制造完成，正在发货。
INSTALLING 正在安装硬件。
FAILED 处理订单时出错，需要客户介入。
PARTIALLY_COMPLETED 订单已部分完成，即部分硬件已送达并安装。
COMPLETED 订单已完成。
CANCELLED 订单已取消。

类型

订单的有效类型。

枚举
TYPE_UNSPECIFIED 未指定订单类型。
PAID 由客户支付。
POC 为客户提供概念验证。
UNPAID 未结算。

OrganizationContact

客户组织的联系信息。

字段
address

PostalAddress

必需。组织的地址。
email

string

可选。组织的邮箱。
phone

string

可选。组织的手机号码。
contacts[]

Contact

必需。组织中位于此位置的各个联系人。取决于顺序：列表中的第一个联系人是主要联系人，第二个是次要联系人，依此类推。

PowerSupply

电源选项。

枚举
POWER_SUPPLY_UNSPECIFIED 未指定电源。
POWER_SUPPLY_AC AC 电源。
POWER_SUPPLY_DC DC 电源。

RackSpace

表示机架中的连续空间。

字段
start_rack_unit

int32

必需。机架空间的第一个机架单元（含）。
end_rack_unit

int32

必需。机架空间的最后一个机架单元（含）。

RecordActionOnCommentRequest

请求记录对评论执行的操作。

字段
name

string

必需。评论的名称。格式：projects/{project}/locations/{location}/orders/{order}/comments/{comment}
action_type

ActionType

必需。所记录操作的操作类型。

ActionType

评论的有效操作类型。

枚举
ACTION_TYPE_UNSPECIFIED 未指定操作。
READ 将评论标记为已读。
UNREAD 将评论标记为未读。

RequestOrderDateChangeRequest

请求更改订单的请求日期。

字段
name

string

必需。要更新的订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
requested_date

Date

必需。客户或 Google 希望设置的预定安装日期。
reason

Reason

可选。请求更改日期的原因。
reason_details

string

可选。如果请求更改日期的原因为“OTHER”，则必须填写此字段。

原因

请求更改日期的有效原因。

枚举
REASON_UNSPECIFIED 未指定日期变更的原因。
REASON_SITE_NOT_READY 该网站尚未准备好进行安装。
REASON_FACILITY_ACCESS_ISSUE 存在设施准入问题。
REASON_CONSTRUCTION_OR_RENOVATION_DELAY 施工或翻修延误。
REASON_POINT_OF_CONTACT_UNAVAILABLE 联系人无法到场。
REASON_SCHEDULE_CONFLICT 日程存在冲突。
REASON_SPECIFIED_INCORRECT_DATE 之前指定的请求日期不正确。
REASON_OTHER 其他原因。

ResourceOperation

表示正在对资源执行的操作

字段
uid

string

仅限输出。操作 ID。
state

State

仅限输出。操作状态。
type

Type

仅限输出。操作类型。
state_history[]

StateHistoryEntry

仅限输出。操作的状态历史记录。
requires_re_turnup

bool

仅限输出。一个标志，用于指示是否需要重新启动。

州

操作状态的枚举。

枚举
STATE_UNSPECIFIED 未指定操作状态。
AWAITING_CUSTOMER_INPUT 此操作正在等待客户输入。
PROGRESSING 操作正在进行中。
COMPLETED 操作已完成。

StateHistoryEntry

操作状态历史记录的条目。

字段
state

State

仅限输出。操作状态。
update_time

Timestamp

仅限输出。操作状态更新时的时间戳。
reason

string

仅限输出。状态更改的原因。
responsible_entity

Entity

仅限输出。更改状态的实体。

类型

操作的类型。未来可能会向此枚举添加新值。

枚举
TYPE_UNSPECIFIED 未指定的操作类型。
REPAIR 修复操作。
SUSPEND 暂停操作。
RESUME 恢复操作。

ShippingInfo

ShippingInfo 描述了货件的物流信息。

字段
carrier

Carrier

仅限输出。运单的承运公司。
tracking_id

string

仅限输出。运单的跟踪 ID。

SignalHardwareStateRequest

用于指示硬件状态的请求。

字段
name

string

必需。硬件的名称。格式：projects/{project}/locations/{location}/hardware/{hardware}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。
state_signal

StateSignal

可选。指定要为此硬件发送的状态信号。
operation_type

Type

可选。指定要发出状态信号的操作类型。如果未指定类型，则系统会假定该信号用于初始配置。
re_turnup_required

bool

可选。指明在完成维修流程时是否需要重新启动。

StateSignal

硬件的有效状态信号。

枚举
STATE_SIGNAL_UNSPECIFIED 未指定硬件的状态信号。
READY_FOR_PROVISIONING 硬件已准备好进行预配。

SignalZoneStateRequest

用于指示可用区状态的请求。

字段
name

string

必需。可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。
state_signal

StateSignal

可选。要为此区域发送的状态信号。必须设置 state_signal 或 provisioning_state_signal，但不能同时设置这两者。
provisioning_state_signal

ProvisioningStateSignal

可选。要为此可用区发送的预配状态信号。必须设置 state_signal 或 provisioning_state_signal，但不能同时设置这两者。
step

string

可选。正在执行的步骤。当 state_signal 为 FACTORY_TURNUP_CHECKS_STARTED 或 FACTORY_TURNUP_CHECKS_FAILED 时，提供更精细的状态。
details

string

可选。其他详细信息，例如 state_signal 为 FACTORY_TURNUP_CHECKS_FAILED 时的出错提示。它还可以包含网站验证输出。

ProvisioningStateSignal

可用区的有效预配状态信号。

枚举
PROVISIONING_STATE_SIGNAL_UNSPECIFIED 未指定配置状态信号。
PROVISIONING_IN_PROGRESS 正在进行配置。
PROVISIONING_COMPLETE 配置已完成。

StateSignal

可用区的有效状态信号。

枚举
STATE_SIGNAL_UNSPECIFIED 未指定可用区的状态信号。
FACTORY_TURNUP_CHECKS_STARTED 已开始进行工厂启动检查。
FACTORY_TURNUP_CHECKS_PASSED 该可用区已准备好进行站点启用。
READY_FOR_SITE_TURNUP

该可用区已准备好进行站点启用。已弃用，但未删除。
FACTORY_TURNUP_CHECKS_FAILED 该可用区未通过工厂启动检查。
VERIFY_CLUSTER_INTENT_PRESENCE 验证是否存在有效的集群 intent。
SITE_VALIDATION_PASSED 网站验证已通过所有检查。
SITE_VALIDATION_FAILED 网站验证失败。

网站

将安装硬件的实体站点。

字段
name

string

标识符。网站的名称。格式：projects/{project}/locations/{location}/sites/{site}
display_name

string

可选。此网站的显示名称。
description

string

可选。此网站的说明。
create_time

Timestamp

仅限输出。此网站的创建时间。
update_time

Timestamp

仅限输出。此网站的上次更新时间。
labels

map<string, string>

可选。与此网站关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
organization_contact

OrganizationContact

必需。此站点的联系信息。
google_maps_pin_uri

string

可选。指向该场所的 Google 地图地址位置的网址。示例值：https://goo.gl/maps/xxxxxxxxx。
access_times[]

TimePeriod

可选。可进入场地的时间段。如果此字段为空，则表示该网站始终可访问。

Google 会使用此字段来安排初始安装以及后续的硬件维护。您可以随时更新此设置。例如，如果初始安装请求是在非工作时间提出的，但维护应在正常工作时间内进行，则您应在初始安装完成后更新访问时间。
notes

string

可选。关于此场地的任何其他备注。请提供以下信息：- 安全或访问限制 - 影响技术人员访问站点的任何法规 - 移动设备所需的任何特殊流程或审批 - 站点访问期间是否有代表在场
customer_site_id

string

可选。客户为此网站定义的标识符。这可用于在客户自己的系统中标识网站。
installation_requirements_met

bool

可选。指明客户的站点是否符合所有安装要求。

SKU

GDC 硬件的库存单元 (SKU)。

字段
name

string

标识符。此 SKU 的名称。格式：projects/{project}/locations/{location}/skus/{sku}
display_name

string

仅限输出。此 SKU 的显示名称。
create_time

Timestamp

仅限输出。此 SKU 的创建时间。
update_time

Timestamp

仅限输出。此 SKU 的上次更新时间。
config

SkuConfig

仅限输出。此 SKU 的配置。
instances[]

SkuInstance

仅限输出。此 SKU 的可用实例。此字段应用于检查 SKU 的库存状况。
description

string

仅限输出。此 SKU 的说明。
revision_id

string

仅限输出。SKU 修订版本 ID。每当 config 更新时，系统都会创建一个新修订版本。格式为 8 个字符的十六进制字符串。
is_active

bool

仅限输出。用于指示此修订版本是否处于活跃状态的标志。只有有效修订版本才能用于新订单。
type

Type

仅限输出。此 SKU 的类型。
vcpu_count

int32

仅限输出。与此 SKU 关联的 vCPU 数量。
hardware_count_ranges[]

Range

仅限输出。使用此 SKU 的可用区中允许的硬件数量的包含范围。
ai_capable

bool

仅限输出。此 SKU 是否适用于运行 Gemini on GDC 软件的硬件。
customer_sourced

bool

仅限输出。此 SKU 是否适用于客户采购的硬件。

范围

包含边界值的范围。

字段
min

int32

范围的最小值。
max

int32

范围的最大值。

类型

SKU 的有效类型。

枚举
TYPE_UNSPECIFIED SKU 的类型未指定。此值不符合要求。
RACK 机架 SKU。
SERVER 服务器 SKU。

SkuConfig

SKU 的配置。

字段
cpu

string

有关 CPU 配置的信息。
gpu

string

GPU 配置的相关信息。
ram

string

有关 RAM 配置的信息。
storage

string

关于存储配置的信息。

SkuInstance

SKU 的特定实例。

字段
region_code

string

此实例适用的 Unicode CLDR 区域代码。
power_supply

PowerSupply

此实例的电源类型。
billing_sku

string

对 Cloud Billing API 中相应 SKU 的引用。您可以使用该 API 检索估算价格信息。格式：services/{service}/skus/{sku}
billing_sku_per_vcpu

string

Cloud Billing API 中每个 vCPU 对应 SKU 的引用。您可以使用该 API 检索估算价格信息。格式：services/{service}/skus/{sku}
subscription_duration_months

int32

硬件的订阅时长（以月为单位）。

SubmitOrderRequest

提交订单的请求。

字段
name

string

必需。订单的名称。格式：projects/{project}/locations/{location}/orders/{order}
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。
type

Type

可选。此请求的类型。如果未设置，则请求类型假定为 INFO_PENDING。

类型

有效的提交订单请求类型。

枚举
TYPE_UNSPECIFIED 未指定请求类型。不应使用此值。
INFO_PENDING 请使用此请求类型提交订单并与 Google 展开对话。提交后，您将无法修改所订购硬件的数量或 SKU。请注意，在您提供更多信息（例如可用区网络配置、硬件物理和安装信息等）之前，此订单尚无法履行。如果您要提交 SKU 类型为 RACK 的订单，请使用此请求类型，因为需要在 API 之外提供其他信息。
INFO_COMPLETE 如果您已准备好提交订单以进行履单，请使用此请求类型。除了 INFO_PENDING 所需的信息之外，订单还必须包含所有必需的信息，例如可用区网络配置、硬件物理和安装信息等。之后，您将无法再更改任何订单信息。

子网

表示子网。

字段
address_range

string

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

string

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

SubscriptionConfig

用于存储订阅配置的消息。

字段
subscription_id

string

仅限输出。订阅的唯一标识符。
billing_id

string

仅限输出。创建订阅时使用的 Google Cloud Billing ID。
state

SubscriptionState

仅限输出。订阅的当前状态。
start_time

Timestamp

仅限输出。订阅的开始时间。

SubscriptionState

表示订阅状态的枚举。

枚举
SUBSCRIPTION_STATE_UNSPECIFIED 状态未指定。
ACTIVE “有效”状态表示订阅已成功创建，并且正在进行结算。
INACTIVE “无效”表示订阅已成功创建，但尚未开始结算。
ERROR 订阅处于错误状态。
FAILED_TO_RETRIEVE 未能检索到订阅状态。这可能是暂时性问题。用户应重试请求。
COMPLETED 订阅已完成，因为已到结束日期。

TimePeriod

表示一周中的某个时间段。

字段
start_time

TimeOfDay

必需。时间段的开始时间。
end_time

TimeOfDay

必需。时间段的结束时间。
days[]

DayOfWeek

必需。时间段在每周内的哪些天有效。

UpdateHardwareGroupRequest

更新硬件组的请求。

字段
update_mask

FieldMask

必需。一个掩码，用于指定 HardwareGroup 中要通过此更新覆盖的字段。update_mask 中指定的字段与硬件组相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果您未提供掩码，则所有字段都会被覆盖。
hardware_group

HardwareGroup

必需。要更新的硬件组。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

UpdateHardwareRequest

更新硬件的请求。

字段
update_mask

FieldMask

必需。一个掩码，用于指定要通过此更新覆盖的硬件中的字段。update_mask 中指定的字段与硬件相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果您未提供掩码，则所有字段都会被覆盖。
hardware

Hardware

必需。要更新的硬件。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

UpdateOrderRequest

更新订单的请求。

字段
update_mask

FieldMask

必需。一个掩码，用于指定要通过此更新覆盖的订单中的字段。update_mask 中指定的字段与订单相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果您未提供掩码，则所有字段都会被覆盖。
order

Order

必需。要更新的订单。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

UpdateSiteRequest

更新网站的请求。

字段
update_mask

FieldMask

必需。一个掩码，用于指定要通过此更新覆盖的网站中的字段。update_mask 中指定的字段与网站相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果您未提供掩码，则所有字段都会被覆盖。
site

Site

必需。要更新的网站。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

UpdateZoneOperationRequest

用于更新 ZoneOperation 的请求消息。

字段
update_mask

FieldMask

可选。字段掩码用于指定更新要在 ZoneOperation 资源中覆盖的字段。updateMask 中指定的字段与资源相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果用户未提供掩码，则所有字段都将被覆盖。
zone_operation

ZoneOperation

必需。正在更新的资源。
request_id

string

可选。用于标识请求的可选请求 ID。您可以指定一个唯一的请求 ID，这样，在您必须重试请求时，服务器就会知道忽略该请求（如果该请求已完成）。服务器将保证在第一次完成该请求后的至少 60 分钟内避免重复处理该请求。

UpdateZoneRequest

更新区域的请求。

字段
update_mask

FieldMask

必需。一个掩码，用于指定要通过此更新覆盖的区域中的字段。update_mask 中指定的字段与可用区相关，而不是与完整请求相关。如果字段在掩码中，则会被覆盖。 如果您未提供掩码，则所有字段都会被覆盖。
zone

Zone

必需。要更新的可用区。
request_id

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

ValidateHardwareRequest

验证硬件的请求。

字段
parent

string

必需。要验证硬件的项目和位置。格式：projects/{project}/locations/{location}
data

Struct

必需。要验证的数据。其中包含验证类型（BOM、BMC、NW）以及包含验证所需详细信息的平台信息。Sample JSON: { "validation_type": "BOM", "machine_spec": "DellXE9680Spec", "platform_info": { "bom_validation_info": { "bios_version": { "cmd": "echo 2.6.3", "failed": false, "rc": 0.0, "stderr": "", "stdout": "2.6.3" } } } }

ValidateHardwareResponse

ValidateHardware 方法的响应消息。

字段
validation_results[]

ValidationResult

验证结果。

ValidationResult

验证结果。

字段
type

string

验证的类型。
status

string

验证的状态。
message

string

验证结果的消息。
resolutions[]

string

可选。针对验证失败的建议解决方法。

可用区

包含一组硬件的可用区。

字段
name

string

标识符。此可用区的名称。格式：projects/{project}/locations/{location}/zones/{zone}
create_time

Timestamp

仅限输出。此可用区的创建时间。
update_time

Timestamp

仅限输出。上次更新此区域的时间。
labels

map<string, string>

可选。与此可用区关联的标签（键值对）。如需详细了解标签，请参阅创建和管理标签。
display_name

string

可选。此可用区的直观易懂的显示名称。
state

State

仅限输出。此可用区的当前状态。
contacts[]

Contact

必需。区域联系人（姓名、邮箱、手机）。取决于顺序：列表中的第一个联系人是主要联系人，第二个是次要联系人，依此类推。
ciq_uri

string

仅限输出。此可用区的客户信息收集问卷调查 (CIQ) 表格的链接。
network_config

ZoneNetworkConfig

可选。此可用区的网络配置。
globally_unique_id

string

仅限输出。为此边缘可用区生成的全局唯一标识符。
subscription_configs[]

SubscriptionConfig

仅限输出。此可用区的订阅配置。
provisioning_state

ProvisioningState

仅限输出。MAC 地址等配置的预配状态。
skip_cluster_provisioning

bool

可选。是否在工厂启动期间跳过集群预配步骤。如果为 true，则表示在客户站点安装可用区的硬件后，将创建 Kubernetes 集群。
cluster_intent_required

bool

仅限输出。指明客户是否必须在接受订单之前提供有效的集群意向。如果为 true，则在集群意图存在之前，无法接受订单。这用于强制执行早期验证，并防止因缺少配置而导致延迟。
cluster_intent_verified

bool

仅限输出。指明提供的集群 intent 是否已成功验证。此标志可确保在接受订单之前存在集群意图。
ai_capable

bool

可选。指明此可用区是否适用于 Gemini on GDC Software 集群。
intel_pccs_key

string

可选。Intel 平台配置和认证服务 (PCCS) 密钥，用于预配和认证 AI 加速器硬件。由为 Gemini on GDC 软件集群提供服务的可用区使用。
current_resource_operation

ResourceOperation

仅限输出。可用区的当前资源操作。
resource_operations[]

ResourceOperation

可选。已在可用区中执行的所有资源操作的列表。
errors[]

Status

仅限输出。可用区启动期间遇到的错误。ErrorInfo 元数据将包含时间戳以及错误是否可重试。
site

string

可选。指定此可用区中硬件所在的站点的名称。格式：projects/{project}/locations/{location}/sites/{site}。对于 Gemini on GDC Software 可用区，此字段为必填字段。

ProvisioningState

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

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

州

可用区的有效状态。

枚举
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

可用区的网络配置。

字段
machine_mgmt_ipv4_range

string

必需。用于机器管理的 IPv4 地址块。应为专用 RFC1918 或公共 CIDR 块，其大小足以在可用区中为每台机器分配至少一个地址。应位于 management_ipv4_subnet 中，且与其他地址范围不相交。
kubernetes_node_ipv4_range

string

必需。用于 Kubernetes 节点的 IPv4 地址块。应为专用 RFC1918 或公共 CIDR 块，其大小足以在可用区中为每台机器分配至少一个地址。应位于 kubernetes_ipv4_subnet 中，且与其他地址范围不相交。
kubernetes_control_plane_ipv4_range

string

必需。用于 Kubernetes 控制平面的 IPv4 地址块。应为专用 RFC1918 或公共 CIDR 块，其大小足以在可用区中为每个集群分配至少一个地址。应位于 kubernetes_ipv4_subnet 中，且与其他地址范围不相交。
management_ipv4_subnet

Subnet

必需。管理网络的 IPv4 子网。
kubernetes_ipv4_subnet

Subnet

可选。Kubernetes 网络的 IPv4 子网。如果未指定，Kubernetes 子网将与管理子网相同。
dns_ipv4_addresses[]

string

可选。DNS 域名服务器。GDC 基础设施将通过这些 IP 解析 DNS 查询。如果未指定，则使用 Google DNS。
kubernetes_primary_vlan_id

int32

可选。Kubernetes VLAN ID。默认情况下，Kubernetes 节点（包括 Kubernetes 主网络）与机器管理网络位于同一 VLAN 中。为了实现网络分段，可以选择将它们分开。
ai_capable_ipv4_subnet

Subnet

可选。为 Gemini on GDC Software 集群提供服务的可用区的 IPv4 子网。所提供范围的最后一个 /29 子网预留给 DHCP。
bgp_config

BGPConfig

可选。此可用区的边界网关协议 (BGP) 特定配置。由为 Gemini on GDC 软件集群提供服务的可用区使用。
top_level_domain

string

可选。此区域的自定义顶级域名。由为 Gemini on GDC 软件集群提供服务的可用区使用。
tor_switch_type

string

可选。有关客户 ToR 交换机类型的其他信息。由为 Gemini on GDC 软件集群提供服务的可用区使用。
boundary_proxy_public_ipv4_range

string

可选。边界代理公共 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC 软件集群提供服务的可用区使用。
boundary_proxy_private_edge_core_ipv4_range

string

可选。边界代理专用边缘到核心 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC 软件集群提供服务的可用区使用。
boundary_proxy_private_core_edge_ipv4_range

string

可选。边界代理专用核心到边缘 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC 软件集群提供服务的可用区使用。
bastion_host_public_ipv4_range

string

可选。堡垒主机的公共 IPv4 范围（采用 CIDR 表示法）。目前应为 /32。由为 Gemini on GDC 软件集群提供服务的可用区使用。
bastion_host_private_ipv4_range

string

可选。采用 CIDR 表示法的堡垒主机私有 IPv4 范围。目前应为 /32。由为 Gemini on GDC 软件集群提供服务的可用区使用。
tls_public_root_certificate_pem

string

可选。采用 PEM 格式的 TLS 公共根证书。由为 Gemini on GDC 软件集群提供服务的可用区使用。

ZoneOperation

表示对可用区的操作。

字段
name

string

标识符。操作的名称。格式：“projects/{project}/locations/{location}/zones/{zone}/ops/{zone_operation}”
create_time

Timestamp

仅限输出。此操作的创建时间。
update_time

Timestamp

仅限输出。上次更新此操作的时间。
labels

map<string, string>

可选。与此操作关联的标签（键值对）。
type

Type

必需。不可变。此操作的类型。
impacted_hardware[]

string

可选。受此可用区操作影响的硬件。
state

State

仅限输出。操作的状态。
current_step

ZoneOperationStep

仅限输出。操作的当前步骤。
step_history[]

ZoneOperationStep

仅限输出。操作的步骤历史记录。
etag

string

可选。添加了基于 go/ccfe-etag 的 etag。

州

可用区操作的有效状态。

枚举
STATE_UNSPECIFIED 状态未设置。
RUNNING 操作正在进行中。
SUCCEEDED 操作已成功完成。
FAILED 操作失败。
CANCELLED 该操作已被取消。

类型

操作的类型。

枚举
TYPE_UNSPECIFIED 未设置类型。
EXPANSION 可用区扩展操作。

ZoneOperationStep

表示工作流步骤。

字段
state

StepState

仅限输出。工作流步骤的状态。
start_time

Timestamp

仅限输出。工作流步骤开始的时间。
end_time

Timestamp

仅限输出。工作流步骤结束的时间。
error

Status

仅限输出。工作流步骤失败时的出错提示。
联合字段 step_type。步骤的类型。step_type 只能是下列其中一项：
expansion_step

ExpansionStep

EXPANSION 操作类型的步骤。

ExpansionStep

EXPANSION 工作流的有效步骤。

枚举
EXPANSION_STEP_UNSPECIFIED 未指定步骤。
PREPARING_ZONE 更新逻辑启动的可用区意图。
HW_ID_UPDATE 使用标识符更新硬件列表。

StepState

工作流步骤的有效状态。

枚举
STEP_STATE_UNSPECIFIED 未指定工作流步骤状态。
PENDING 该步骤正在等待开始。
RUNNING 该步骤正在进行中。
SUCCEEDED 步骤已成功完成。
FAILED 该步骤失败。
SKIPPED 该步骤已跳过。