Method: projects.locations.apps.importApp

Importa o app especificado.

Solicitação HTTP

POST https://ces.googleapis.com/v1beta/{parent=projects/*/locations/*}/apps:importApp

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso principal com o local do app a ser importado.

Corpo da solicitação

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

Representação JSON 
{
  "displayName": string,
  "appId": string,
  "importOptions": {
    object (ImportAppRequest.ImportOptions)
  },
  "ignoreAppLock": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsUri": string,
  "appContent": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "jsonPatchContent": string,
  "jsonPatchGcsUri": string
  // End of mutually exclusive fields.
}
Campos
displayName

string

Opcional. O nome de exibição do app a ser importado. * Se o app for criado na importação e o nome de exibição for especificado, o app importado vai usar esse nome. Se um conflito for detectado com um app existente, um carimbo de data/hora será anexado ao nome de exibição para torná-lo exclusivo. * Se o app for uma reimportação, esse campo não poderá ser definido. Fornecer um nome de exibição durante a reimportação vai resultar em um erro INVALID_ARGUMENT.
appId

string

Opcional. O ID a ser usado no app importado. * Se não for especificado, um ID exclusivo será atribuído automaticamente ao app. * Caso contrário, o app importado vai usar esse ID como o componente final do nome do recurso. Se um app com o mesmo ID já existir no local especificado do projeto, o conteúdo dele será substituído.
importOptions

object (ImportAppRequest.ImportOptions)

Opcional. Opções que regem o processo de importação do app.
ignoreAppLock

boolean

Opcional. Flag para substituir o bloqueio de app durante a importação. Se definido como "true", o processo de importação vai ignorar o bloqueio de app.
O app a ser importado. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
gcsUri

string

O URI do Google Cloud Storage de onde o app será importado. O formato desse URI precisa ser gs://<bucket-name>/<object-name>.
appContent

string (bytes format)

Bytes brutos que representam o arquivo ZIP compactado com a estrutura de pastas do app.

Uma string codificada em base64.
Fim dos campos mutuamente exclusivos.
Os patches JSON a serem aplicados ao app importado. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
jsonPatchContent

string

Opcional. Conteúdo do patch como uma string JSON.
jsonPatchGcsUri

string

Opcional. Um URI do Cloud Storage que aponta para um arquivo JSON com os patches.
Fim dos campos mutuamente exclusivos.

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 um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • ces.apps.import

Para mais informações, consulte a documentação do IAM.

ImportAppRequest.ImportOptions

Opções de configuração para o processo de importação de apps. Essas opções controlam o comportamento da importação, principalmente quando surgem conflitos com os dados do app.

Representação JSON 
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
Campos
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

Opcional. A estratégia a ser usada ao resolver conflitos durante a importação.
validateOnly

boolean

Opcional. Flag para simular o processo de importação. Se definido como "true", o processo de importação só vai realizar validações e não fará mudanças no app atual nem criará um novo.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

Define a estratégia para lidar com conflitos quando um app com o mesmo ID já existe ou quando recursos importados (como agentes, ferramentas etc.) têm os mesmos nomes de exibição que os recursos existentes no app.

Tipos enumerados
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED A estratégia de resolução de conflitos não foi especificada.
REPLACE Substituir os dados atuais pelos importados. Se já existir um app com o mesmo appId, o conteúdo dele será atualizado com base no app importado. Os recursos (app, agentes, ferramentas, exemplos, mecanismos de segurança, conjuntos de ferramentas) do app importado que tiverem o mesmo nome de exibição dos recursos atuais vão substituir os existentes. - Os recursos importados com novos nomes de exibição serão criados. - Os recursos atuais que não têm um nome de exibição correspondente no app importado não serão alterados.
OVERWRITE Substituir os dados atuais pelos importados. Se já existir um app com o mesmo appId, o conteúdo dele será substituído pelo app importado. Os recursos atuais (agentes, ferramentas, exemplos, proteções e conjuntos de ferramentas) no app serão excluídos. - Os recursos importados serão criados como novos recursos.