Package google.cloud.gdchardwaremanagement.v1alpha

索引

• GDCHardwareManagement（接口）
• BGPConfig（消息）
• CancelOrderRequest（消息）
• Carrier（枚举）
• ChangeHardwareSubscriptionRequest（消息）
• ChangeHardwareSubscriptionRequest.TermEndBehavior（枚举）
• ChangeLogEntry（消息）
• Comment（消息）
• Contact（消息）
• CreateCommentRequest（消息）
• CreateHardwareGroupRequest（消息）
• CreateHardwareRequest（消息）
• CreateOrderRequest（消息）
• CreateSiteRequest（消息）
• CreateZoneOperationRequest（消息）
• CreateZoneRequest（消息）
• DeleteHardwareGroupRequest（消息）
• DeleteHardwareRequest（消息）
• DeleteOrderRequest（消息）
• DeleteSiteRequest（消息）
• DeleteZoneOperationRequest（消息）
• DeleteZoneRequest（消息）
• Dimensions（消息）
• Entity（枚举）
• GetChangeLogEntryRequest（消息）
• GetCommentRequest（消息）
• GetHardwareGroupRequest（消息）
• GetHardwareRequest（消息）
• GetOrderRequest（消息）
• GetSiteRequest（消息）
• GetSkuRequest（消息）
• GetZoneOperationRequest（消息）
• GetZoneRequest（消息）
• Hardware（消息）
• Hardware.DiskInfo（消息）
• Hardware.MacAddress（消息）
• Hardware.MacAddress.AddressType（枚举）
• Hardware.MachineInfo（消息）
• Hardware.MachineInfo.MachineType（枚举）
• Hardware.MemoryInfo（消息）
• Hardware.State（枚举）
• HardwareConfig（消息）
• HardwareGroup（消息）
• HardwareGroup.State（枚举）
• HardwareInstallationInfo（消息）
• HardwareInstallationInfo.RackType（枚举）
• HardwareLocation（消息）
• HardwarePhysicalInfo（消息）
• HardwarePhysicalInfo.Amperes（枚举）
• HardwarePhysicalInfo.NetworkUplinkType（枚举）
• HardwarePhysicalInfo.PowerReceptacleType（枚举）
• HardwarePhysicalInfo.Voltage（枚举）
• ListChangeLogEntriesRequest（消息）
• ListChangeLogEntriesResponse（消息）
• ListCommentsRequest（消息）
• ListCommentsResponse（消息）
• ListHardwareGroupsRequest（消息）
• ListHardwareGroupsResponse（消息）
• ListHardwareRequest（消息）
• ListHardwareResponse（消息）
• ListOrdersRequest（消息）
• ListOrdersResponse（消息）
• ListSitesRequest（消息）
• ListSitesResponse（消息）
• ListSkusRequest（消息）
• ListSkusResponse（消息）
• ListZoneOperationsRequest（消息）
• ListZoneOperationsResponse（消息）
• ListZonesRequest（消息）
• ListZonesResponse（消息）
• OperationMetadata（消息）
• Order（消息）
• Order.DeploymentType（枚举）
• Order.State（枚举）
• Order.Type（枚举）
• OrganizationContact（消息）
• PowerSupply（枚举）
• RackSpace（消息）
• RecordActionOnCommentRequest（消息）
• RecordActionOnCommentRequest.ActionType（枚举）
• RequestOrderDateChangeRequest（消息）
• RequestOrderDateChangeRequest.Reason（枚举）
• ResourceOperation（消息）
• ResourceOperation.State（枚举）
• ResourceOperation.StateHistoryEntry（消息）
• ResourceOperation.Type（枚举）
• ShippingInfo（消息）
• SignalHardwareStateRequest（消息）
• SignalHardwareStateRequest.StateSignal（枚举）
• SignalZoneStateRequest（消息）
• SignalZoneStateRequest.ProvisioningStateSignal（枚举）
• SignalZoneStateRequest.StateSignal（枚举）
• Site（消息）
• Sku（消息）
• Sku.Range（消息）
• Sku.Type（枚举）
• SkuConfig（消息）
• SkuInstance（消息）
• SubmitOrderRequest（消息）
• SubmitOrderRequest.Type（枚举）
• Subnet（消息）
• SubscriptionConfig（消息）
• SubscriptionConfig.SubscriptionState（枚举）
• TimePeriod（消息）
• UpdateHardwareGroupRequest（消息）
• UpdateHardwareRequest（消息）
• UpdateOrderRequest（消息）
• UpdateSiteRequest（消息）
• UpdateZoneOperationRequest（消息）
• UpdateZoneRequest（消息）
• ValidateHardwareRequest（消息）
• ValidateHardwareResponse（消息）
• ValidationResult（消息）
• Zone（消息）
• Zone.ProvisioningState（枚举）
• Zone.State（枚举）
• ZoneNetworkConfig（消息）
• ZoneOperation（消息）
• ZoneOperation.State（枚举）
• ZoneOperation.Type（枚举）
• ZoneOperationStep（消息）
• ZoneOperationStep.ExpansionStep（枚举）
• ZoneOperationStep.StepState（枚举）

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，则此订单的所有嵌套资源也会被删除。否则，只有当订单没有嵌套资源时，请求才会成功。

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 仅限输出。指示相应硬件是否适用于 GDC 软件上的 Gemini。
subscription_configs[]	SubscriptionConfig 仅限输出。相应硬件的订阅配置。
operations[]	ResourceOperation 仅限输出。对硬件执行的所有操作的列表。
errors[]	Status 仅限输出。硬件意图启动期间遇到的错误。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

用于 GDC 软件上的 Gemini 的机器类型的枚举。

枚举
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 必需。电源插座类型。
network_uplink	NetworkUplinkType 必需。上行网络连接的类型。
voltage	Voltage 必需。电源电压。
amperes	Amperes 必需。电源电流。

安培

有效的安培值。

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

NetworkUplinkType

有效的网络上行类型。

枚举
NETWORK_UPLINK_TYPE_UNSPECIFIED	未指定网络上行类型。
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} 如需列出所有位置的硬件，请将位置替换为 -（连字符或短划线），并检查响应消息中的“unreachable”字段。
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} 如需列出所有位置的订单，请将位置替换为 -（连字符或短划线），并检查响应消息中的“无法访问”字段。
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 仅限输出。相应订单的状态。创建订单时，状态将设置为“草稿”。
organization_contact	OrganizationContact 可选。客户联系信息。如果订单用于在 GDC 软件上提供 Gemini，则此参数为可选；否则为必需。
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 仅限输出。订单移至“已接受”状态的时间。
requested_date_change	Date 仅限输出。客户或 Google 希望将预定的安装日期设置为的日期。
vendor_notes	string 仅限输出。供应商为此订单提供的备注。
vendor_contact	OrganizationContact 仅限输出。分配给相应订单的 SI 的联系信息。
ai_capable	bool 仅限输出。指示相应订单是否为支持 GDC 软件上 Gemini 的硬件。在成功提交订单后自动填充。
requested_delivery_date	Date 可选。客户可以使用此字段指定希望硬件送达的日期。

DeploymentType

部署的有效类型。

枚举
DEPLOYMENT_TYPE_UNSPECIFIED	部署类型未指定。
FULL_PRODUCTION	具有 SLO 的 Prod 部署。
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	交流电源。
POWER_SUPPLY_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 可选。如果请求的日期更改原因是“其他”，则必须填写此字段。

原因

请求更改日期的正当理由。

枚举
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	验证是否存在有效的聚类意图。
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 可选。相应网站的客户定义标识符。此 ID 可用于在客户自己的系统中标识相应网站。
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 Software 的硬件。
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 结算 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 必需。一个掩码，用于指定要通过此更新覆盖的 Site 中的字段。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 必需。一个掩码，用于指定要通过此更新覆盖的 Zone 中的字段。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 仅限输出。表示所提供的聚类意图是否已成功验证。此标志可确保在接受订单之前存在集群意图。
ai_capable	bool 可选。指示相应可用区是否适用于 GDC Software 集群上的 Gemini。
intel_pccs_key	string 可选。用于配置和证明 AI 加速器硬件的 Intel 平台配置和证明服务 (PCCS) 密钥。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
current_resource_operation	ResourceOperation 仅限输出。相应可用区的当前资源操作。
resource_operations[]	ResourceOperation 可选。已对可用区执行的所有资源操作的列表。
errors[]	Status 仅限输出。在区域启动期间遇到的错误。ErrorInfo 元数据将包含时间戳以及错误是否可重试。
site	string 可选。指定相应可用区中硬件所在的站点的名称。格式：projects/{project}/locations/{location}/sites/{site} 对于 Gemini on GDC 软件地区是必需的。

ProvisioningState

适用于 MAC 地址等配置的有效配置状态。

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

州

可用区的有效状态。

枚举
STATE_UNSPECIFIED	未指定区域的状态。
ADDITIONAL_INFO_NEEDED	需要客户提供更多信息才能继续处理。
INFO_COMPLETE	该区域包含开始准备区域所需的所有必要信息。
PREPARING	Google 正在准备 Zone。
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	该 Zone 已取消。
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 可选。在 GDC 软件集群上提供 Gemini 服务的可用区的 IPv4 子网。所提供范围的最后一个 /29 子网保留给 DHCP。
bgp_config	BGPConfig 可选。相应区域的边界网关协议 (BGP) 特定配置。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
top_level_domain	string 可选。相应区域的自定义顶级域名。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
tor_switch_type	string 可选。有关客户的 ToR 交换机类型的其他信息。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
boundary_proxy_public_ipv4_range	string 可选。边界代理的公共 IPv4 范围（采用 CIDR 表示法）。目前，预期值为 /32。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
boundary_proxy_private_edge_core_ipv4_range	string 可选。边界代理专用边缘到核心 IPv4 范围（采用 CIDR 表示法）。目前，预期值为 /32。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
boundary_proxy_private_core_edge_ipv4_range	string 可选。边界代理从私有核心到边缘的 IPv4 范围（采用 CIDR 表示法）。目前，预期值为 /32。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
bastion_host_public_ipv4_range	string 可选。堡垒主机公共 IPv4 范围（采用 CIDR 表示法）。目前，预期值为 /32。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
bastion_host_private_ipv4_range	string 可选。堡垒主机专用 IPv4 地址范围（采用 CIDR 表示法）。目前，预期值为 /32。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。
tls_public_root_certificate_pem	string 可选。采用 PEM 格式的 TLS 公共根证书。由在 GDC Software 集群上提供 Gemini 服务的可用区使用。

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_STEP_UNSPECIFIED	未指定步骤。
PREPARING_ZONE	更新了逻辑启动的可用区 intent。
HW_ID_UPDATE	使用标识符更新硬件列表。

StepState

工作流步骤的有效状态。

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