Documentação do Oracle Cloud Infrastructure

Movendo um Gateway de API entre Compartimentos

Descubra como mover gateways de API entre compartimentos com o serviço API Gateway.

Depois de criar um gateway de API, você pode decidir mover o gateway de API de um compartimento para outro. Um gateway de API e as implantações de API individuais implantadas nele podem estar em compartimentos diferentes.

Observe que as chamadas para uma implantação de API serão interrompidas, enquanto o gateway de API no qual ele está implantado estiver sendo movido para outro compartimento. Não chamada uma implantação de API até que a operação de movimentação seja concluída.

    1. Na página da lista Gateways, localize o gateway de API que você deseja mover. Se precisar de ajuda para localizar a página da lista ou o gateway de API, consulte Listando Gateways de API.
    2. No menu Ações (três pontos) do gateway da API, selecione Mover Recurso, selecione o compartimento para o qual você deseja mover o gateway da API e selecione Mover Recurso para iniciar o processo de movimentação do gateway da API. Observe que as implantações de API no gateway de API não são movidas para o novo compartimento.

      Não chame implantações de API enquanto o gateway de API em que elas estão implantadas estiver no processo de movimentação para o novo compartimento.

    3. Na página Detalhes do Gateway, selecione Solicitações de Serviço na lista Recursos e confirme se a operação de movimentação foi concluída.

      Quando a operação de movimentação for concluída, reinicie as chamadas às implantações de API implantadas no gateway de API.

  • Para mover gateways de API para outro compartimento usando a CLI:

    1. Configure seu ambiente de cliente para usar a CLI ( Configurando Seu Ambiente de Cliente para usar a CLI para o Desenvolvimento de Gateway de API).

    2. Para mover um gateway de API para outro compartimento:

      1. Abra um prompt de comando e execute oci api-gateway gateway change-compartment para mover o gateway de API:

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

        em que:

        • <gateway-ocid> é o OCID do gateway de API a ser movido. Para descobrir o OCID do gateway de API, consulte Lista de Gateways de API.
        • <compartment-ocid> é o OCID do compartimento para o qual o gateway de API será movido.

        Por exemplo:

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

        Observe que as implantações de API no gateway de API não são movidas.

        A resposta ao comando inclui:

        • O estado do ciclo de vida (por exemplo, ACTIVE, FAILED).
        • O id da solicitação de serviço para mover o gateway de API (detalhes das solicitações de serviço estão disponíveis por sete dias após a conclusão, o cancelamento ou a falha).

        Se você quiser que o comando aguarde o retorno de controle até que o gateway de API esteja ativo (ou a solicitação tenha falhado), inclua um ou ambos os parâmetros a seguir:

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

        Por exemplo:

        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. (Opcional) Para ver o status da solicitação de serviço que está movendo o gateway de API, informe:

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

      3. (Opcional) Para exibir os logs da solicitação de serviço que está movendo o gateway de API, informe:

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

      4. (Opcional) Se a solicitação de trabalho que está movendo o gateway de API falhar e você quiser revisar os logs de erro, informe:

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

      5. (Opcional) Para verificar se o gateway de API tiver sido movido, digite o seguinte comando e confirme se o OCID do novo compartimento do gateway de API é o esperado:

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

    Para obter mais informações sobre o uso da CLI, consulte Interface de Linha de Comando (CLI). Para obter uma lista completa de flags e opções disponíveis para comandos da CLI, consulte a Ajuda da CLI.

  • Execute a operação ChangeGatewayCompartment para mover um gateway de API para outro compartimento.