Package google.cloud.gdchardwaremanagement.v1alpha

索引

GDCHardwareManagement

GDC Hardware Management 服务。

CreateComment

rpc CreateComment(CreateCommentRequest) returns (Operation)

针对订单创建新评论。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.comments.create

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

rpc CreateHardware(CreateHardwareRequest) returns (Operation)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardware.create

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

rpc CreateHardwareGroup(CreateHardwareGroupRequest) returns (Operation)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardwareGroups.create

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

rpc CreateOrder(CreateOrderRequest) returns (Operation)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.create

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

rpc CreateSite(CreateSiteRequest) returns (Operation)

在给定的项目和位置中创建新网站。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.sites.create

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

rpc CreateZone(CreateZoneRequest) returns (Operation)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.zones.create

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

rpc DeleteHardware(DeleteHardwareRequest) returns (Operation)

删除硬件。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardware.delete

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

rpc DeleteHardwareGroup(DeleteHardwareGroupRequest) returns (Operation)

删除硬件组。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardwareGroups.delete

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

rpc DeleteOrder(DeleteOrderRequest) returns (Operation)

删除订单。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.delete

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

rpc DeleteZone(DeleteZoneRequest) returns (Operation)

删除可用区。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.zones.delete

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

rpc GetChangeLogEntry(GetChangeLogEntryRequest) returns (ChangeLogEntry)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.changeLogEntries.get

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

rpc GetComment(GetCommentRequest) returns (Comment)

获取评论的内容。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.comments.get

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

rpc GetHardware(GetHardwareRequest) returns (Hardware)

获取硬件详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardware.get

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

rpc GetHardwareGroup(GetHardwareGroupRequest) returns (HardwareGroup)

获取硬件组的详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardwareGroups.get

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

rpc GetOrder(GetOrderRequest) returns (Order)

获取订单的详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.get

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

rpc GetSite(GetSiteRequest) returns (Site)

获取网站的详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.sites.get

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

rpc GetSku(GetSkuRequest) returns (Sku)

获取 SKU 的详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.skus.get

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

rpc GetZone(GetZoneRequest) returns (Zone)

获取可用区的详细信息。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.zones.get

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

rpc ListChangeLogEntries(ListChangeLogEntriesRequest) returns (ListChangeLogEntriesResponse)

列出对订单做出的更改。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.changeLogEntries.list

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

rpc ListComments(ListCommentsRequest) returns (ListCommentsResponse)

列出订单的评论。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.comments.list

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

rpc ListHardware(ListHardwareRequest) returns (ListHardwareResponse)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardware.list

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

rpc ListHardwareGroups(ListHardwareGroupsRequest) returns (ListHardwareGroupsResponse)

按指定顺序列出硬件组。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardwareGroups.list

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

rpc ListOrders(ListOrdersRequest) returns (ListOrdersResponse)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.list

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

rpc ListSites(ListSitesRequest) returns (ListSitesResponse)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.sites.list

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

rpc ListSkus(ListSkusRequest) returns (ListSkusResponse)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.skus.list

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

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.zones.list

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

rpc SubmitOrder(SubmitOrderRequest) returns (Operation)

提交订单。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.submit

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

rpc UpdateHardware(UpdateHardwareRequest) returns (Operation)

更新硬件参数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardware.update

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

rpc UpdateHardwareGroup(UpdateHardwareGroupRequest) returns (Operation)

更新硬件组的参数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.hardwareGroups.update

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

rpc UpdateOrder(UpdateOrderRequest) returns (Operation)

更新订单的参数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.orders.update

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

rpc UpdateSite(UpdateSiteRequest) returns (Operation)

更新网站的参数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.sites.update

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

rpc UpdateZone(UpdateZoneRequest) returns (Operation)

更新相应地区的参数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

IAM 权限

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

  • gdchardwaremanagement.zones.update

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

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 个字符。

联系人

联系人的联系信息。

字段
given_name

string

必需。联系人的名字。
family_name

string

可选。联系人的姓氏。
email

string

必需。联系人的电子邮件地址。
phone

string

必需。联系人的电话号码。
time_zone

TimeZone

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

TimePeriod

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

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

DeleteZoneRequest

用于删除可用区的请求。

字段
name

string

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

string

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

维度

表示对象的尺寸。

字段
width_inches

float

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

float

必需。身高，以英寸为单位。
depth_inches

float

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

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

Date

可选。相应硬件的请求安装日期。如果硬件的 HardwareGroup 指定了此属性，则在接受订单时会自动填充此属性。也可以由客户填写。
actual_installation_date

Date

仅限输出。相应硬件的实际安装日期。由 Google 填写。

州

硬件的有效状态。

枚举
STATE_UNSPECIFIED 硬件状态未指定。
ADDITIONAL_INFO_NEEDED 需要客户提供更多信息才能继续处理。
BUILDING Google 已开始为此硬件构建硬件。
SHIPPING 硬件已构建完毕，正在配送中。
INSTALLING 正在安装硬件。
INSTALLED 硬件已安装。
FAILED 发生了错误，需要客户介入。

HardwareConfig

GDC 硬件的配置。

字段
sku

string

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

PowerSupply

必需。相应硬件的电源类型。
subscription_duration_months

int32

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

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

Date

可选。相应 HardwareGroup 中硬件的请求安装日期。由客户填写。

州

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 标准欧式插座。

电压

有效电压值。

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

Timestamp

必需。客户指定的订单完成期限。
region_code

string

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

string

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

Type

仅限输出。相应订单的类型。
submit_time

Timestamp

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

string

必需。要为此订单收取费用的 Google Cloud 结算 ID。
existing_hardware[]

HardwareLocation

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

州

订单的有效状态。

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

类型

订单的有效类型。

枚举
TYPE_UNSPECIFIED 订单类型未指定。
PAID 由客户支付。
POC 面向客户的概念验证。

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

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

网站

将安装硬件的实际地点。

字段
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

可选。网站可访问的时间段。如果此字段为空，则表示相应网站随时可访问。
notes

string

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

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 数量。

类型

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。

子网

表示子网。

字段
address_range

string

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

string

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

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

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

州

可用区的有效状态。

枚举
STATE_UNSPECIFIED 未指定区域的状态。
ADDITIONAL_INFO_NEEDED 需要客户提供更多信息才能继续处理。
PREPARING Google 正在准备该区域。
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 子网将与管理子网相同。