- Solicitud HTTP
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
- ImportAppRequest.ImportOptions
- ImportAppRequest.ImportOptions.ConflictResolutionStrategy
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 |
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 ( |
| Campos | |
|---|---|
displayName |
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 |
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 |
Es opcional. Son las opciones que rigen el proceso de importación de la app. |
ignoreAppLock |
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 |
URI de Google Cloud Storage desde el que se importará la app. El formato de este URI debe ser |
appContent |
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 |
Es opcional. Es el contenido del parche como una cadena JSON. |
jsonPatchGcsUri |
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-platformhttps://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 ( |
| Campos | |
|---|---|
conflictResolutionStrategy |
Es opcional. Es la estrategia que se usará cuando se resuelvan conflictos durante la importación. |
validateOnly |
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. |