Method: projects.locations.apps.importApp

Importa la app especificada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso principal con la ubicación de la app que se importará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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

Es opcional. Es el nombre visible de la app que se importará. * Si la app se crea durante la importación y se especifica el nombre visible, la app importada usará este nombre visible. Si se detecta un conflicto con una app existente, se agregará una marca de tiempo al nombre visible para que sea único. * Si la app es una reimportación, no se debe establecer este campo. Si proporcionas un nombre visible durante la reimportación, se generará un error INVALID_ARGUMENT.

appId

string

Es opcional. Es el ID que se usará para la app importada. * Si no se especifica, se asignará automáticamente un ID único para la app. * De lo contrario, la app importada usará este ID como el componente final de su nombre de recurso. Si ya existe una app con el mismo ID en la ubicación especificada del proyecto, se reemplazará el contenido de la app existente.

importOptions

object (ImportAppRequest.ImportOptions)

Es opcional. Son las opciones que rigen el proceso de importación de la app.

ignoreAppLock

boolean

Es opcional. Es una marca para anular el bloqueo de apps durante la importación. Si se establece como verdadero, el proceso de importación ignorará el bloqueo de apps.

Es la app que se importará. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
gcsUri

string

URI de Google Cloud Storage desde el que se importará la app. El formato de este URI debe ser gs://<bucket-name>/<object-name>.

appContent

string (bytes format)

Son los bytes sin procesar que representan el archivo ZIP comprimido con la estructura de carpetas de la app.

Es una cadena codificada en Base64.

Fin de los campos mutuamente excluyentes.
Son los parches de JSON que se aplicarán a la app importada. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
jsonPatchContent

string

Es opcional. Es el contenido del parche como una cadena JSON.

jsonPatchGcsUri

string

Es opcional. Es un URI de Cloud Storage que apunta a un archivo JSON que contiene los parches.

Fin de los campos mutuamente excluyentes.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • ces.apps.import

Para obtener más información, consulta la documentación de IAM.

ImportAppRequest.ImportOptions

Son las opciones de configuración para el proceso de importación de la app. Estas opciones controlan el comportamiento de la importación, en especial cuando surgen conflictos con los datos de app existentes.

Representación JSON
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
Campos
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

Es opcional. Es la estrategia que se usará cuando se resuelvan conflictos durante la importación.

validateOnly

boolean

Es opcional. Es una marca para ejecutar el proceso de importación en modo de prueba. Si se establece como verdadero, el proceso de importación solo realizará validaciones y no realizará ningún cambio en la app existente ni creará una nueva.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

Define la estrategia para controlar los conflictos cuando ya existe una app con el mismo ID o cuando los recursos importados (como los agentes, las herramientas, etcétera) tienen los mismos nombres visibles que los recursos existentes dentro de esa app.

Enums
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED No se especifica la estrategia de resolución de conflictos.
REPLACE Reemplazar los datos existentes por los datos importados Si ya existe una app con el mismo appId, su contenido se actualizará según la app importada. Los recursos (app, agentes, herramientas, ejemplos, medidas de seguridad y conjuntos de herramientas) de la app importada que tengan el mismo nombre visible que los recursos existentes reemplazarán a los existentes. - Se crearán recursos importados con nombres visibles nuevos. - Los recursos existentes que no tengan un nombre visible coincidente en la app importada permanecerán sin cambios.
OVERWRITE Reemplazar los datos existentes por los datos importados Si ya existe una app con el mismo appId, su contenido se sobrescribirá con la app importada. Se borrarán los recursos existentes (agentes, herramientas, ejemplos, medidas de protección, conjuntos de herramientas) en la app. - Los recursos importados se crearán como recursos nuevos.