REST Resource: projects.locations.saas

資源：Saas

Saas 代表供應商管理的 SaaS 服務。

JSON 表示法 
{
  "name": string,
  "locations": [
    {
      object (Location)
    }
  ],
  "state": enum (State),
  "conditions": [
    {
      object (SaasCondition)
    }
  ],
  "error": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
欄位
name

string

ID。資源名稱 (資源的完整 URI)，遵循標準命名架構：

"projects/{project}/locations/{location}/saas/{saas}"
locations[]

object (Location)

選用。這項服務適用的地點清單。推出是指生成推出計畫的清單。
state

enum (State)

僅供輸出。SaaS 的狀態。如果 applicationTemplate 為空，則一律為 ACTIVE 狀態。
conditions[]

object (SaasCondition)

僅供輸出。一組條件，指出這個資源可能擁有的各種條件。
error

object (Status)

僅供輸出。如果狀態為「FAILED」，則會顯示相應的錯誤代碼和訊息。所有其他狀態的預設值為 code=OK。
labels

map (key: string, value: string)

選用。資源上的標籤，可用於分類，類似於 Kubernetes 資源標籤。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
annotations

map (key: string, value: string)

選用。註解是與資源一起儲存的非結構化鍵/值對應，外部工具可能會設定註解，用來儲存及擷取任意中繼資料。這些屬性無法查詢，修改物件時應保留這些屬性。

詳情請參閱：https://kubernetes.io/docs/user-guide/annotations

包含 "key": value 組合清單的物件，例如 { "name": "wrench", "mass": "1.3kg", "count": "3" }。
uid

string

僅供輸出。資源專屬識別碼。在服務範圍內，這項資源適用的時間和空間中，UID 是獨一無二的。UID 通常是由伺服器在成功建立資源時產生，且不可變更。資源名稱會重複使用，因此您可以使用 UID 明確識別資源。這應為 UUID4。
etag

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

位置

服務可用的位置資訊。

JSON 表示法 
{
  "name": string
}
欄位
name

string

選用。地點名稱。

狀態

SaaS 的狀態。

列舉
STATE_TYPE_UNSPECIFIED 未指定狀態類型。
ACTIVE

已淘汰：請改用 STATE_ACTIVE。
RUNNING

已淘汰：請改用 STATE_RUNNING。
FAILED

已淘汰：請改用 STATE_FAILED。
STATE_ACTIVE SaaS 準備就緒
STATE_RUNNING 匯入、同步或複製 ApplicationTemplates 的過程中
STATE_FAILED 匯入、同步或複製 ApplicationTemplate 處理程序時發生失敗

SaasCondition

SaasCondition 會說明 Saas 的狀態。

JSON 表示法 
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
欄位
status

enum (Status)

這是必要旗標，條件的狀態。
type

enum (Type)

這是必要旗標，條件類型。
lastTransitionTime

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

string

這是必要旗標，使用者可理解的訊息，指出最近一次轉換的詳細資料。
reason

string

這是必要旗標，條件上次轉換的簡要原因。

狀態

列舉條件狀態。

列舉
STATUS_UNSPECIFIED 未指定條件狀態。
STATUS_UNKNOWN 條件符合狀態不明。
STATUS_TRUE 條件為 true。
STATUS_FALSE 條件為 false。

類型

條件類型列舉。

列舉
TYPE_UNSPECIFIED 未指定條件類型。
TYPE_READY 條件類型已準備就緒。
TYPE_SYNCHRONIZED 條件類型已同步處理。

方法

create

 建立新的 SaaS。

delete

 刪除單一 SaaS。

get

 擷取單一 SaaS。

list

 擷取 SaaS 集合。

patch

 更新單一 SaaS。