REST Resource: projects.locations.orders

资源：订单

GDC 硬件的订单。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "organizationContact": {
    object (OrganizationContact)
  },
  "targetWorkloads": [
    string
  ],
  "customerMotivation": string,
  "fulfillmentTime": string,
  "customerRequestedInstallationDate": {
    object (Date)
  },
  "regionCode": string,
  "orderFormUri": string,
  "type": enum (Type),
  "submitTime": string,
  "billingId": string,
  "existingHardware": [
    {
      object (HardwareLocation)
    }
  ],
  "deploymentType": enum (DeploymentType),
  "actualInstallationDate": {
    object (Date)
  },
  "estimatedInstallationDate": {
    object (Date)
  },
  "estimatedDeliveryDate": {
    object (Date)
  },
  "migration": boolean,
  "acceptedTime": string,
  "requestedDateChange": {
    object (Date)
  },
  "vendorNotes": string,
  "vendorContact": {
    object (OrganizationContact)
  },
  "aiCapable": boolean
}
字段
name

string

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

string

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

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

可选。与此订单关联的标签，以键值对的形式表示。如需详细了解标签，请参阅创建和管理标签。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
state

enum (State)

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

object (OrganizationContact)

必需。客户联系信息。
targetWorkloads[]

string

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

string

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

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
customerRequestedInstallationDate

object (Date)

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

string

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

string

仅限输出。订单表单的链接。
type

enum (Type)

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

string (Timestamp format)

仅限输出。提交订单的时间。提交订单时，系统会自动填充当前时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
billingId

string

仅限输出。将为此订单收费的 Google Cloud 结算 ID。
existingHardware[]

object (HardwareLocation)

可选。作为此订单的一部分要移除的现有硬件。注意：除非另有约定，否则移除的所有硬件都将被回收。
deploymentType

enum (DeploymentType)

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

object (Date)

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

object (Date)

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

object (Date)

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

boolean

可选。此订单是否是从客户现有基础架构的迁移。
acceptedTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
requestedDateChange

object (Date)

仅限输出。客户或 Google 希望将计划安装日期设置为的日期。
vendorNotes

string

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

object (OrganizationContact)

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

boolean

仅限输出。指示此订单是否用于支持 GDC 软件上的 Gemini 的硬件。成功提交订单后，系统会自动填充此字段。

状态

订单的有效状态。

枚举
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 未结算。

HardwareLocation

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

JSON 表示法 
{
  "site": string,
  "rackLocation": string,
  "rackSpace": [
    {
      object (RackSpace)
    }
  ]
}
字段
site

string

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

string

必需。机架在场地中的位置，例如 Floor 2, Room 201, Row 7, Rack 3。
rackSpace[]

object (RackSpace)

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

DeploymentType

部署的有效类型。

枚举
DEPLOYMENT_TYPE_UNSPECIFIED 部署类型未指定。
FULL_PRODUCTION 具有 SLO 的生产环境部署。
PROOF_OF_CONCEPT 具有尽力支持且没有 SLO 的部署。
INTERNAL 具有尽力支持且没有 SLO 的内部部署。
CUSTOMER_LAB 客户实验室部署，我们像支持生产环境一样支持它。

方法

cancel

 取消订单。

create

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

delete

 删除订单。

get

 获取订单的详细信息。

list

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

patch

 更新订单的参数。

requestDateChange

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

submit

 提交订单。