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)
  }
}
欄位
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)

這是必要旗標，顧客聯絡資訊。
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 帳單 ID。
existingHardware[]

object (HardwareLocation)

選用。現有硬體將於本次訂單中移除。注意：除非另有協議，否則移除的硬體都會回收。
deploymentType

enum (DeploymentType)

僅供輸出。這項訂單的部署類型。
actualInstallationDate

object (Date)

僅供輸出。這項訂單的實際安裝日期。
estimatedInstallationDate

object (Date)

僅供輸出。這項訂單的預計安裝日期。
estimatedDeliveryDate

object (Date)

僅供輸出。這筆訂單的預計送達日期。
migration

boolean

選用。這筆訂單是否為從客戶現有基礎架構遷移而來。
acceptedTime

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"。
requestedDateChange

object (Date)

僅供輸出。客戶或 Google 要設定排定安裝日期的日期。
vendorNotes

string

僅供輸出。供應商提供的這項訂單附註。
vendorContact

object (OrganizationContact)

僅供輸出。指派給這筆訂單的 SI 聯絡資訊。

狀態

訂單的有效狀態。

列舉
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 我們支援客戶實驗室部署作業，就像支援正式環境一樣。

方法

cancel

 取消訂單。

create

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

delete

 刪除訂單。

get

 取得訂單詳細資料。

list

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

patch

 更新訂單的參數。

requestDateChange

 更新單一訂單的所要求日期變更。

submit

 提交訂單。