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-000000000000)。

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)

可选。字段掩码用于指定更新将在 Draft 资源中覆盖的字段。updateMask 中指定的字段与资源相关,而不是与完整请求相关。如果字段在掩码中,则会被覆盖。如果用户未提供掩码,则所有字段都会被覆盖。

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

instance

object (Instance)

必需。要更新的资源。

instanceId

string

必需。实例的 ID。