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,
  "requestedDeliveryDate": {
    object (Date)
  }
}
欄位
name

string

ID。這筆訂單的名稱。格式：projects/{project}/locations/{location}/orders/{order}
displayName

string

選用。這筆訂單的顯示名稱。
createTime

string (Timestamp format)

僅供輸出。建立這筆訂單的時間。

使用 RFC 3339，產生的輸出內容一律會經過 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 正規化，並使用 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)

僅供輸出。這筆訂單的狀態。建立訂單時，狀態會設為「草稿」。
organizationContact

object (OrganizationContact)

選用。客戶聯絡資訊。如果訂單用於 Gemini on GDC Software，則為選填，否則為必填。
targetWorkloads[]

string

選用。客戶指定這筆訂單要處理的工作負載。這項屬性最多只能包含 20 個元素，且每個元素的長度不得超過 50 個半形字元。
customerMotivation

string

選用。客戶下這筆訂單的動機。這個欄位的長度不得超過 1000 個字元。
fulfillmentTime
(deprecated)

string (Timestamp format)

選用。已淘汰：請改用 customerRequestedInstallationDate。

使用 RFC 3339，產生的輸出內容一律會經過 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 正規化，並使用 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 Billing 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 正規化，並使用 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)

僅供輸出。指派給這筆訂單的系統整合商聯絡資訊。
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 含有服務等級目標的正式環境部署作業。
PROOF_OF_CONCEPT 部署作業，提供盡力支援，不含服務水準目標。
INTERNAL 內部部署，提供盡力支援，不含服務水準目標。
CUSTOMER_LAB 客戶實驗室部署作業，我們支援的方式與正式環境相同。
INTERNAL_CANARY 內部初期測試。

方法

cancel

 取消訂單。

create

 在指定專案和位置建立新訂單。

delete

 刪除訂單。

get

 取得訂單詳細資料。

list

 列出指定專案和位置中的訂單。

patch

 更新訂單參數。

requestDateChange

 更新單一訂單的日期異動要求。

submit

 提交訂單。