Documentação do Oracle Cloud Infrastructure

Excluir um Gateway de API

Descubra como excluir gateways de API que você criou anteriormente com o serviço API Gateway.

Depois de criar um gateway de API, você pode decidir que o gateway de API não é mais necessário. Você pode excluir um gateway de API do serviço API Gateway, desde que não haja implantações de API nele.

Os gateways de API excluídos continuam a ser mostrados na Console por 90 dias, com um status Excluído. Após 90 dias, os gateways de API excluídos não são mais mostrados.

    1. Na página da lista Gateways, localize o gateway de API que você deseja excluir. 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 de API, selecione Excluir.

      O gateway da API é removido permanentemente. Observe que você não poderá excluir um gateway de API se ele ainda tiver implantações de API nele. Você deve primeiro excluir as implantações de API.

  • Para excluir gateways de API 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 excluir um gateway de API existente:

      1. Abra um prompt de comando e execute oci api-gateway gateway delete para excluir o gateway de API:

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

        em que:

        • <gateway-ocid> é o OCID do gateway de API a ser excluído. Para descobrir o OCID do gateway de API, consulte Lista de Gateways de API.

        Por exemplo:

        oci api-gateway gateway delete --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga

        Observe que você não poderá excluir um gateway de API se ele ainda tiver implantações de API nele (incluindo implantações de API que estejam em compartimentos distintos no próprio gateway de API). Você deve primeiro excluir as implantações de API.

        A resposta ao comando inclui:

        • O estado do ciclo de vida (por exemplo, DELETED, FAILED).
        • O id da solicitação de serviço para excluir 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 quiser que o comando aguarde o retorno de controle até que o gateway de API tenha sido excluído (ou a solicitação tenha falhado), inclua um ou ambos os parâmetros a seguir:

        • --wait-for-state DELETED
        • --wait-for-state FAILED

        Por exemplo:

        oci api-gateway gateway delete --gateway-id ocid1.apigateway.oc1..aaaaaaaab______hga --wait-for-state DELETED

      2. (Opcional) Para ver o status da solicitação de serviço que está excluindo 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á excluindo 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 serviço que está excluindo o gateway da 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 foi excluído, digite o seguinte comando e confirme se o estado do ciclo de vida do gateway de API é DELETED:

        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 DeleteGateway para excluir um gateway de API.