Documentation sur Oracle Cloud Infrastructure

Déplacement d'une passerelle d'API entre des compartiments

Découvrez comment déplacer des passerelles d'API entre des compartiments à l'aide du service de passerelle d'API.

Après avoir créé une passerelle d'API, vous pouvez décider de déplacer la passerelle d'API d'un compartiment à un autre. Une passerelle d'API et les déploiements d'API individuels sur cette dernière peuvent être dans des compartiments différents.

Notez que les appels à un déploiement d'API seront perturbés pendant le déplacement de la passerelle d'API sur laquelle il est déployé vers un autre compartiment. Ne pas appeler un déploiement d'API tant que l'opération de déplacement est terminée.

    1. Dans la page de liste Passerelles, recherchez la passerelle d'API à déplacer. Si vous avez besoin d'aide pour trouver la page de liste ou la passerelle d'API, voir Liste des passerelles d'API.
    2. Dans le menu Actions (trois points) de la passerelle d'API, sélectionnez Déplacer la ressource, sélectionnez le compartiment vers lequel vous voulez déplacer la passerelle d'API et sélectionnez Déplacer la ressource pour lancer le processus de déplacement de la passerelle d'API. Notez que les déploiements d'API sur la passerelle d'API ne sont pas déplacés vers le nouveau compartiment.

      Ne pas appeler les déploiements d'API alors que la passerelle d'API sur laquelle ils sont déployés est en cours de déplacement vers le nouveau compartiment.

    3. Dans la page Détails de la passerelle, sélectionnez Demandes de travail dans la liste Ressources et vérifiez que l'opération de déplacement est terminée.

      Une fois l'opération de déplacement terminée, reprenez les appels aux déploiements d'API déployés sur la passerelle d'API.

  • Pour déplacer des passerelles d'API vers un autre compartiment à l'aide de l'interface de ligne de commande :

    1. Configurez l'environnement client pour utiliser l'interface de ligne de commande (Configuration de l'environnement client afin d'utiliser l'interface de ligne de commande pour le développement de passerelles d'API).

    2. Pour déplacer une passerelle d'API vers un autre compartiment :

      1. Ouvrez une invite de commande et exécutez oci api-gateway gateway change-compartment pour déplacer la passerelle d'API :

        oci api-gateway gateway change-compartment --gateway-id <gateway-ocid> --compartment-id <compartment-ocid>

        où :

        • <gateway-ocid> est l'OCID de la passerelle d'API à déplacer. Pour connaître l'OCID de la passerelle d'API, voir Liste des passerelles d'API.
        • <compartment-ocid> est l'OCID du compartiment vers lequel déplacer la passerelle d'API.

        Par exemple :

        oci api-gateway gateway change-compartment --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga --compartment-id ocid1.compartment.oc1..aaaaaaaa7______ysq

        Notez que les déploiements d'API sur la passerelle d'API ne sont pas déplacés.

        La réponse à la commande comprend les données suivantes :

        • L'état du cycle de vie (par exemple, ACTIVE, FAILED).
        • L'ID demande de travail pour déplacer la passerelle d'API (les détails des demandes de travail sont disponibles pendant sept jours après l'achèvement, l'annulation ou l'échec).

        Si vous souhaitez que la commande attende avant de retourner un contrôle tant que la passerelle d'API n'est pas active (ou que la demande a échoué), incluez l'un des paramètres suivants ou les deux :

        • --wait-for-state ACTIVE
        • --wait-for-state FAILED

        Par exemple :

        oci api-gateway gateway change-compartment --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga --compartment-id ocid1.compartment.oc1..aaaaaaaa7______ysq" --wait-for-state ACTIVE

      2. (Facultatif) Pour voir le statut de la demande de travail qui déplace la passerelle d'API, entrez :

        oci api-gateway work-request get --work-request-id <work-request-ocid>

      3. (Facultatif) Pour voir les journaux de la demande de travail qui déplace la passerelle d'API, entrez :

        oci api-gateway work-request-log list --work-request-id <work-request-ocid>

      4. (Facultatif) Si la demande de travail qui déplace la passerelle API échoue et que vous voulez vérifier les journaux d'erreurs, entrez :

        oci api-gateway work-request-error --work-request-id <work-request-ocid>

      5. (Facultatif) Pour vérifier que la passerelle d'API a été déplacée, entrez la commande suivante et vérifiez que le nouvel OCID du compartiment de la passerelle d'API est celui attendu :

        oci api-gateway gateway get --gateway-id <gateway-ocid>

    Pour plus d'informations sur l'utilisation de l'interface de ligne de commande, voir Interface de ligne de commande. Pour la liste complète des indicateurs et des options disponibles pour les commandes d'interface de ligne de commande, voir Aide sur l'interface de ligne de commande.

  • Exécutez l'opération ChangeGatewayCompartment pour déplacer une passerelle d'API vers un autre compartiment.