Oracle Cloud Infrastructure - Dokumentation

API-Gateway zwischen Compartments verschieben

Erfahren Sie, wie Sie API-Gateways mit dem API-Gateway-Service zwischen Compartments verschieben.

Nachdem Sie ein API-Gateway erstellt haben, können Sie das API-Gateway von einem Compartment in ein anderes verschieben. Ein API-Gateway und die einzelnen darin bereitgestellten API-Deployments können sich in unterschiedlichen Compartments befinden.

Beachten Sie, dass Aufrufe an ein API-Deployment unterbrochen werden, während das API-Gateway, in dem es bereitgestellt ist, in ein anderes Compartment verschoben wird. Rufen Sie kein API-Deployment auf, bis der Verschiebevorgang abgeschlossen ist.

    1. Suchen Sie auf der Listenseite Gateways das API-Gateway, das Sie verschieben möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder des API-Gateways benötigen, finden Sie weitere Informationen unter API-Gateways auflisten.
    2. Wählen Sie im Menü Aktionen (drei Punkte) für das API-Gateway die Option Ressource verschieben aus, wählen Sie das Compartment aus, in das Sie das API-Gateway verschieben möchten, und wählen Sie Ressource verschieben aus, um den Prozess zum Verschieben des API-Gateways zu beginnen. Beachten Sie, dass API-Deployments, die im API-Gateway vorhanden sind, nicht in das neue Compartment verschoben werden.

      Rufen Sie keine API-Deployments auf, während das API-Gateway, in dem sie bereitgestellt werden, in das neue Compartment verschoben wird.

    3. Wählen Sie auf der Seite Gatewaydetails in der Liste Ressourcen die Option Arbeitsanforderungen aus, und bestätigen Sie, dass der Verschiebevorgang abgeschlossen ist.

      Nach Abschluss des Verschiebevorgangs können Sie API-Deployments, die im API-Gateway bereitgestellt sind, wiederaufnehmen.

  • So verschieben Sie API-Gateways mit der CLI in ein anderes Compartment:

    1. Konfigurieren Sie die Clientumgebung zur Verwendung der CLI (Clientumgebung zur Verwendung der CLI für API-Gateway-Entwicklung konfigurieren).

    2. So verschieben Sie ein API-Gateway in ein anderes Compartment:

      1. Öffnen Sie eine Eingabeaufforderung, und führen Sie oci api-gateway gateway change-compartment aus, um das API-Gateway zu verschieben:

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

        Dabei gilt:

        • <gateway-ocid> ist die OCID des zu verschiebenden API-Gateways. Unter API-Gateways auflisten können Sie die OCID des API-Gateway ermitteln.
        • <compartment-ocid> ist die OCID des Compartments, in das das API-Gateway verschoben werden soll.

        Beispiel:

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

        Beachten Sie, dass API-Deployments, die im API-Gateway vorhanden sind, nicht verschoben werden.

        Die Antwort auf den Befehl umfasst Folgendes:

        • Den Lebenszyklusstatus (Beispiel: ACTIVE, FAILED).
        • Die ID der Arbeitsanforderung zum Verschieben des API-Gateways (Details der Arbeitsanforderungen sind für sieben Tage nach Abschluss, Abbruch oder Fehler verfügbar).

        Wenn der Befehl die Steuerung erst dann zurückgeben soll, wenn das API-Gateway aktiv ist (oder die Anforderung nicht erfolgreich war), nehmen Sie einen oder beide der folgenden Parameter auf:

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

        Beispiel:

        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. (Optional) Um den Status der Arbeitsanforderung anzuzeigen, die das API-Gateway verschiebt, geben Sie Folgendes ein:

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

      3. (Optional) Um die Logs der Arbeitsanforderung anzuzeigen, die das API-Gateway verschiebt, geben Sie Folgendes ein:

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

      4. (Optional) Wenn die Arbeitsanforderung, die das API-Gateway verschiebt, nicht erfolgreich ist und Sie die Fehlerlogs prüfen möchten, geben Sie Folgendes ein:

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

      5. (Optional) Um zu prüfen, ob das API-Gateway verschoben wurde, geben Sie den folgenden Befehl ein und bestätigen Sie, dass die neue Compartment-OCID des API-Gateways wie erwartet ist:

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

    Weitere Informationen zur Verwendung der CLI finden Sie unter Befehlszeilenschnittstelle (CLI). Eine vollständige Liste der Flags und Optionen, die für CLI-Befehle verfügbar sind, finden Sie in der CLI-Hilfe.

  • Führen Sie den Vorgang ChangeGatewayCompartment aus, um ein API-Gateway in ein anderes Compartment zu verschieben.