Method: projects.locations.applications.updateApplicationInstances

將目標串流輸入內容新增至應用程式。如果應用程式已部署，系統會建立對應的新應用程式執行個體。如果串流已在應用程式中，RPC 就會失敗。

HTTP 要求

POST https://{endpoint}/v1/{name=projects/*/locations/*/applications/*}:updateApplicationInstances

其中 {endpoint} 是支援的服務端點之一。

這些網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必填項目。要擷取的應用程式名稱。格式：「projects/{project}/locations/{location}/applications/{application}」

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "applicationInstances": [
    {
      object (UpdateApplicationInstance)
    }
  ],
  "requestId": string,
  "allowMissing": boolean
}
欄位
applicationInstances[]

object (UpdateApplicationInstance)
requestId

string

(非必要) 用於識別要求的選用要求 ID。請指定專屬的請求 ID，這樣一來，如果您必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證在首次要求後的至少 60 分鐘內。

舉例來說，假設您提出初始要求，但要求逾時，如果您再次使用相同的要求 ID 提出要求，伺服器會檢查是否已收到使用相同要求 ID 的原始作業，如果是的話，就會忽略第二項要求。這可避免客戶不小心建立重複的承諾。

要求 ID 必須是有效的 UUID，但系統不支援零 UUID (00000000-0000-0000-0000-0000000000000)。
allowMissing

boolean

如果為 true，如果目標資源不存在，更新要求就會建立一個資源，這時系統會忽略 field_mask。

回應主體

如果成功，回應主體會包含 Operation 的執行個體。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱驗證總覽一文。

UpdateApplicationInstance

JSON 表示法 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
欄位
updateMask

string (FieldMask format)

(非必要) 欄位遮罩用於指定更新作業在草稿資源中要覆寫的欄位。updateMask 中指定的欄位是相對於資源，而非完整要求。如果欄位位於遮罩中，就會遭到覆寫。如果使用者未提供遮罩，則會覆寫所有欄位。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
instance

object (Instance)

這是必要旗標，正在更新的資源。
instanceId

string

這是必要旗標，執行個體的 ID。