Method: projects.locations.applications.updateApplicationInstances

ターゲット ストリーム入力をアプリケーションに追加します。アプリケーションがデプロイされている場合、対応する新しいアプリケーション インスタンスが作成されます。ストリームがすでにアプリケーションにある場合、RPC は失敗します。

HTTP リクエスト

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

ここで、{endpoint} はサポートされているサービス エンドポイントのいずれかです。

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 で受信していたかどうかを確認できます。受信していた場合は、2 回目のリクエストは無視されます。これにより、クライアントが重複するコミットを誤って作成することを防ぐことができます。

リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID（00000000-0000-0000-0000-000000000000）はサポートされていません。
allowMissing

boolean

true の場合、更新リクエストは、ターゲット リソースが存在しない場合、1 つのリソースを作成します。この場合、field_mask は無視されます。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、認証の概要をご覧ください。

UpdateApplicationInstance

JSON 表現 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
フィールド
updateMask

string (FieldMask format)

省略可。フィールド マスクは、更新によって Draft リソースで上書きするフィールドを指定するために使用されます。updateMask で指定されたフィールドは、リクエスト全体ではなく、リソースに対する相対フィールドです。マスクに含まれるフィールドは上書きされます。ユーザーがマスクを指定しなければ、すべてのフィールドが上書きされます。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
instance

object (Instance)

必須。更新されるリソース。
instanceId

string

必須。インスタンスの ID。