Method: projects.locations.apps.importApp

Importa l'app specificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa padre con la posizione dell'app da importare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
displayName

string

Facoltativo. Il nome visualizzato dell'app da importare. * Se l'app viene creata durante l'importazione e viene specificato il nome visualizzato, l'app importata utilizzerà questo nome visualizzato. Se viene rilevato un conflitto con un'app esistente, al nome visualizzato viene aggiunto un timestamp per renderlo univoco. * Se l'app viene reimportata, questo campo non deve essere impostato. Se fornisci un nome visualizzato durante la reimportazione, si verifica un errore INVALID_ARGUMENT.
appId

string

Facoltativo. L'ID da utilizzare per l'app importata. * Se non specificato, verrà assegnato automaticamente un ID univoco per l'app. * In caso contrario, l'app importata utilizzerà questo ID come componente finale del nome risorsa. Se esiste già un'app con lo stesso ID nella posizione specificata del progetto, il contenuto dell'app esistente verrà sostituito.
importOptions

object (ImportAppRequest.ImportOptions)

Facoltativo. Opzioni che regolano il processo di importazione per l'app.
ignoreAppLock

boolean

Facoltativo. Flag per ignorare il blocco dell'app durante l'importazione. Se impostato su true, il processo di importazione ignorerà il blocco dell'app.
L'app da importare. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
gcsUri

string

L'URI Google Cloud Storage da cui importare l'app. Il formato di questo URI deve essere gs://<bucket-name>/<object-name>.
appContent

string (bytes format)

Byte non elaborati che rappresentano il file ZIP compresso con la struttura delle cartelle dell'app.

Una stringa con codifica in base64.
Fine dei campi che si escludono a vicenda.
Le patch JSON da applicare all'app importata. Di seguito è riportato un elenco di campi reciprocamente esclusivi. In una risposta verrà impostato al massimo uno dei campi:
jsonPatchContent

string

Facoltativo. Contenuto della patch come stringa JSON.
jsonPatchGcsUri

string

Facoltativo. Un URI Cloud Storage che rimanda a un file JSON contenente le patch.
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • ces.apps.import

Per saperne di più, consulta la documentazione di IAM.

ImportAppRequest.ImportOptions

Opzioni di configurazione per il processo di importazione delle app. Queste opzioni controllano il comportamento dell'importazione, in particolare quando si verificano conflitti con i dati delle app esistenti.

Rappresentazione JSON 
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
Campi
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

Facoltativo. La strategia da utilizzare per risolvere i conflitti durante l'importazione.
validateOnly

boolean

Facoltativo. Flag per l'esecuzione di una prova dry run della procedura di importazione. Se impostato su true, il processo di importazione eseguirà solo le convalide e non apporterà modifiche all'app esistente né ne creerà una nuova.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

Definisce la strategia per la gestione dei conflitti quando esiste già un'app con lo stesso ID o quando le risorse importate (come agenti, strumenti e così via) hanno gli stessi nomi visualizzati delle risorse esistenti all'interno dell'app.

Enum
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED La strategia di risoluzione dei conflitti non è specificata.
REPLACE Sostituisci i dati esistenti con quelli importati. Se esiste già un'app con lo stesso appId, i suoi contenuti verranno aggiornati in base all'app importata. - Le risorse (app, agenti, strumenti, esempi, linee guida, toolset) nell'app importata che hanno lo stesso nome visualizzato delle risorse esistenti sovrascriveranno quelle esistenti. - Verranno create risorse importate con nuovi nomi visualizzati. - Le risorse esistenti che non hanno un nome visualizzato corrispondente nell'app importata rimarranno invariate.
OVERWRITE Sovrascrivere i dati esistenti con i dati importati. Se esiste già un'app con lo stesso appId, i suoi contenuti verranno sovrascritti con l'app importata. - Le risorse esistenti (agenti, strumenti, esempi, protezioni, set di strumenti) nell'app verranno eliminate. - Le risorse importate verranno create come nuove risorse.