REST Resource: projects.locations.orders

资源：Order

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,
  "requestedDeliveryDate": {
    object (Date)
  }
}
字段
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)

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

string

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

string

可选。有关客户下此订单的动机的信息。此字段的长度不得超过 1,000 个字符。
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

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

object (Date)

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

州

订单的有效状态。

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

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

object (RackSpace)

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

DeploymentType

部署的有效类型。

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

方法

cancel

 取消订单。

create

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

delete

 删除订单。

get

 获取订单的详细信息。

list

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

patch

 更新订单的参数。

requestDateChange

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

submit

 提交订单。