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 文档。
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 文档。
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 文档。
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 文档。
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 文档。

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。

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

可选。用于在父级范围内唯一标识 Comment 的 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。

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。

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}

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

仅限输出。对硬件执行的所有操作的列表。

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

可选。机器类型。对于在 GDC 软件上运行 Gemini 的硬件，此项是必需的。
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 硬件配置失败。

HardwareConfig

GDC 硬件的配置。

字段
sku

string

必需。对相应硬件的 SKU 的引用。这可以指向特定 SKU 修订版本，格式为 resource_name@revision_id，如 AIP-162 中所定义。如果未指定 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 硬件组的状态未指定。
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}

如需列出所有位置的硬件，请将位置替换为 -（连字符或短划线），并检查响应消息中的“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}

如需列出所有位置的订单，请将位置替换为 -（连字符或短划线），并检查响应消息中的 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

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

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

必需。客户联系信息。
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 的硬件。在成功提交订单后自动填充。

DeploymentType

部署的有效类型。

枚举
DEPLOYMENT_TYPE_UNSPECIFIED 部署类型未指定。
FULL_PRODUCTION 具有 SLO 的 Prod 部署。
PROOF_OF_CONCEPT 部署，提供尽力支持，但没有 SLO。
INTERNAL 内部部署，提供尽力而为的支持，没有 SLO。
CUSTOMER_LAB 我们支持的客户实验环境部署，就像支持生产环境一样。

州

订单的有效状态。

枚举
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 直流电源。

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 希望将预定的安装日期设置为的日期。

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 修复操作。

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。

网站

将安装硬件的实际地点。

字段
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 是否适用于在 GDC 软件上运行 Gemini 的硬件。
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

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

UpdateZoneRequest

更新可用区的请求。

字段
update_mask

FieldMask

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

Zone

必需。要更新的地区。
request_id

string

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

可用区

包含一组硬件的可用区。

字段
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 服务的可用区使用。

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 相应地区的配置失败。
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 相应功能区在出厂启动检查中失败。
ACTIVE 该可用区可供使用。
CANCELLED 该 Zone 已取消。

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 Software 集群上为 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 服务的可用区使用。