Preparação para o Serviço API Gateway

Antes de usar o serviço API Gateway para criar gateways de API e implantar APIs neles como implantações de API:

• Você deve ter acesso a uma tenancy do Oracle Cloud Infrastructure. A tenancy deve estar inscrita em uma ou mais das regiões nas quais o serviço API Gateway está disponível (consulte Disponibilidade por Região).

• Sua tenancy deve ter cota suficiente em recursos relacionados ao Gateway de API (consulte Limites do Serviço).

• Em sua tenancy, já deverá haver um compartimento para possuir os recursos de rede necessários. Se esse compartimento não existir ainda, você terá que criá-lo. Consulte Criar Compartimentos para Possuir os Recursos de Rede e os Recursos do Serviço API Gateway na Tenancy, se ainda não existirem.
• O compartimento que possui recursos de rede deve conter uma VCN, uma sub-rede regional pública ou privada e outros recursos (como um gateway de internet, uma tabela de roteamento, listas de segurança e/ou grupos de segurança de rede). Para garantir alta disponibilidade, os gateways de API só podem ser criados em sub-redes regionais (não sub-redes específicas do AD). Observe que um gateway de API deve atingir os back-ends definidos na especificação de implantação de API. Por exemplo, se o back-end estiver na internet pública, a VCN deverá ter um gateway de internet para permitir que o gateway de API roteie solicitações para o back-end.

• A VCN deve ter um conjunto de opções de DHCP que inclua um resolvedor de DNS apropriado para mapear nomes de host definidos em uma especificação de implantação de API para endereços IP. Se esse conjunto de opções de DHCP já não existir na VCN, você terá que criá-lo. Selecione as opções de DHCP definidas para a sub-rede do gateway de API da seguinte forma:

  • Se o nome do host for publicado publicamente na internet ou se o nome do host pertencer a uma instância na mesma VCN, selecione um conjunto de opções de DHCP que tenha Internet fornecida pela Oracle e Resolvedor de VCN como o Tipo de DNS. Este é o padrão se você não selecionar explicitamente um conjunto de opções de DHCP.
  • Se o nome do host estiver em sua própria rede privada ou interna (por exemplo, conectado à VCN pelo FastConnect), selecione um conjunto de opções de DHCP que tenha Resolvedor Personalizado como o Tipo de DNS e tenha o URL de um servidor DNS adequado que possa resolver o nome do host para um endereço IP.

  Observe que você pode alterar os detalhes do servidor DNS no conjunto de opções de DHCP especificado para a sub-rede de um gateway de API. O gateway de API será reconfigurado para usar os detalhes atualizados do servidor DNS em duas horas. Para obter mais informações sobre como resolver nomes de host para endereços IP, consulte DNS na Sua Rede Virtual na Nuvem e Opções de DHCP.

• Em sua tenancy, já deverá haver um compartimento para possuir recursos relacionados ao Gateway de API (gateways de API, implantações de API). Esse compartimento pode ser, mas não precisa ser, o mesmo compartimento que contém os recursos de rede. Consulte Criar Compartimentos para Possuir os Recursos de Rede e os Recursos do Serviço API Gateway na Tenancy, se ainda não existirem. Observe que os recursos relacionados ao Gateway de API podem residir no compartimento raiz. Porém, se você espera que várias equipes criem gateways de API, a prática recomendada é criar um compartimento separado para cada equipe.

• Para criar gateways de API e implantar APIs neles, você deve pertencer a um dos seguintes:

  • O grupo de Administradores da tenancy.

  • Um grupo ao qual as políticas concedem as permissões apropriadas para os recursos relacionados à rede e ao Gateway de API. Consulte Criar Políticas para Controlar o Acesso a Recursos Relacionados à Rede e ao Serviço API Gateway.

• As políticas devem ser definidas para fornecer aos gateways de API que você cria acesso a recursos adicionais, se necessário. Consulte Criar Políticas para Controlar o Acesso a Recursos Relacionados à Rede e ao Serviço API Gateway.