Method: projects.locations.apps.importApp

Importe l'application spécifiée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource parente avec l'emplacement de l'application à importer.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
displayName

string

Facultatif. Nom à afficher de l'application à importer. * Si l'application est créée lors de l'importation et que le nom à afficher est spécifié, l'application importée utilisera ce nom à afficher. Si un conflit est détecté avec une application existante, un code temporel est ajouté au nom à afficher pour le rendre unique. * Si l'application est réimportée, ce champ ne doit pas être défini. Si vous fournissez un nom à afficher lors de la réimportation, une erreur INVALID_ARGUMENT s'affichera.
appId

string

Facultatif. ID à utiliser pour l'application importée. * Si aucun ID n'est spécifié, un ID unique sera automatiquement attribué à l'application. * Sinon, l'application importée utilisera cet ID comme composant final de son nom de ressource. Si une application portant le même ID existe déjà à l'emplacement spécifié dans le projet, le contenu de l'application existante sera remplacé.
importOptions

object (ImportAppRequest.ImportOptions)

Facultatif. Options régissant le processus d'importation de l'application.
ignoreAppLock

boolean

Facultatif. Indicateur permettant de remplacer le verrouillage d'application lors de l'importation. Si la valeur est définie sur "true", le processus d'importation ignore le verrouillage d'application.
Application à importer. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
gcsUri

string

URI Google Cloud Storage à partir duquel importer l'application. Le format de cet URI doit être gs://<bucket-name>/<object-name>.
appContent

string (bytes format)

Octets bruts représentant le fichier ZIP compressé avec la structure de dossiers de l'application.

Chaîne encodée en base64.
Fin des champs qui s'excluent mutuellement.
Il s'agit des correctifs JSON à appliquer à l'application importée. Vous trouverez ci-dessous une liste de champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
jsonPatchContent

string

Facultatif. Contenu du correctif sous forme de chaîne JSON.
jsonPatchGcsUri

string

Facultatif. URI Cloud Storage pointant vers un fichier JSON contenant les correctifs.
Fin des champs qui s'excluent mutuellement.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • ces.apps.import

Pour en savoir plus, consultez la documentation IAM.

ImportAppRequest.ImportOptions

Options de configuration pour le processus d'importation d'applications. Ces options permettent de contrôler le comportement de l'importation, en particulier en cas de conflit avec les données d'application existantes.

Représentation JSON 
{
  "conflictResolutionStrategy": enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy),
  "validateOnly": boolean
}
Champs
conflictResolutionStrategy

enum (ImportAppRequest.ImportOptions.ConflictResolutionStrategy)

Facultatif. Stratégie à utiliser pour résoudre les conflits lors de l'importation.
validateOnly

boolean

Facultatif. Indicateur pour effectuer un dry run du processus d'importation. Si la valeur est définie sur "true", le processus d'importation n'effectue que des validations et n'apporte aucune modification à l'application existante ni n'en crée une.

ImportAppRequest.ImportOptions.ConflictResolutionStrategy

Définit la stratégie de gestion des conflits lorsqu'une application portant le même ID existe déjà ou lorsque des ressources importées (comme des agents, des outils, etc.) ont le même nom à afficher que des ressources existantes dans cette application.

Enums
CONFLICT_RESOLUTION_STRATEGY_UNSPECIFIED La stratégie de résolution des conflits n'est pas spécifiée.
REPLACE remplacer les données existantes par les données importées ; Si une application avec le même appId existe déjà, son contenu sera mis à jour en fonction de l'application importée. Les ressources (application, agents, outils, exemples, garde-fous, ensembles d'outils) de l'application importée qui ont le même nom à afficher que les ressources existantes écraseront celles-ci. - Des ressources importées avec de nouveaux noms à afficher seront créées. - Les ressources existantes qui n'ont pas de nom à afficher correspondant dans l'application importée resteront inchangées.
OVERWRITE Écraser les données existantes avec les données importées Si une application avec le même appId existe déjà, son contenu sera écrasé par l'application importée. Les ressources existantes (agents, outils, exemples, garde-fous, ensembles d'outils) dans l'application seront supprimées. - Les ressources importées seront créées en tant que nouvelles ressources.