Method: projects.locations.applications.updateApplicationInstances

Adiciona a entrada do stream de destino ao aplicativo. Se o aplicativo for implantado, a nova instância correspondente será criada. Se o stream já estiver no aplicativo, a RPC vai falhar.

Solicitação HTTP

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

Em que {endpoint} é um dos endpoints de serviço compatíveis.

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do aplicativo a ser recuperado. Formato: "projects/{project}/locations/{location}/applications/{application}"

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "applicationInstances": [
    {
      object (UpdateApplicationInstance)
    }
  ],
  "requestId": string,
  "allowMissing": boolean
}
Campos
applicationInstances[]

object (UpdateApplicationInstance)
requestId

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor garante isso por pelo menos 60 minutos desde a primeira solicitação.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).
allowMissing

boolean

Se verdadeiro, a solicitação de atualização vai criar um recurso se o recurso de destino não existir. Dessa vez, o field_mask será ignorado.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

UpdateApplicationInstance

Representação JSON 
{
  "updateMask": string,
  "instance": {
    object (Instance)
  },
  "instanceId": string
}
Campos
updateMask

string (FieldMask format)

Opcional. A máscara de campo é usada para especificar os campos que serão substituídos no recurso de rascunho pela atualização. Os campos especificados em updateMask são relativos ao recurso, não à solicitação completa. Um campo será substituído se estiver na máscara. Se o usuário não fornecer uma máscara, todos os campos serão substituídos.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
instance

object (Instance)

Obrigatório. O recurso que está sendo atualizado.
instanceId

string

Obrigatório. O ID da instância.