Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Migrar um nome de domínio personalizado para um tipo de endpoint de API diferente no API Gateway

Modo de foco
Migrar um nome de domínio personalizado para um tipo de endpoint de API diferente no API Gateway - Amazon API Gateway

Você pode migrar seu nome de domínio personalizado entre endpoints regionais e otimizados para bordas. Primeiro adicione o novo tipo de configuração de endpoint à lista endpointConfiguration.types existente para o nome de domínio personalizado. Em seguida, configure um registro DNS para apontar o nome de domínio personalizado para o endpoint recém-provisionado. Por fim, você remove os dados de configuração do nome de domínio personalizado obsoleto.

Considerações

Veja a seguir considerações sobre como migrar o domínio personalizado entre um endpoint de API regional e um endpoint de API otimizado para borda.

  • Um nome de domínio personalizado otimizado para borda exige um certificado fornecido pelo ACM da região Leste dos EUA (N. da Virgínia): us-east-1. Esse certificado é distribuído por todas as localizações geográficas.

  • Um nome de domínio regional personalizado exige um certificado fornecido pelo ACM na mesma região que hospeda a API. Você pode migrar um nome de domínio personalizado otimizado para borda que não esteja na região us-east-1 para um nome de domínio regional personalizado solicitando um novo certificado do ACM da região da API.

  • Pode levar até 60 segundos para concluir uma migração entre um nome de domínio personalizado otimizado para borda e um nome de domínio regional personalizado. O tempo de migração também depende de quando você atualiza os registros DNS.

Migrar nomes de domínios personalizados

O procedimento a seguir mostra como migrar um nome de domínio personalizado otimizado para borda para um nome de domínio regional personalizado.

AWS Management Console
  1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

  2. Escolha Custom Domain Names (Nomes de domínios personalizados) no painel de navegação principal.

  3. Escolha um nome de domínio personalizado otimizado para borda.

  4. Em Configuração de endpoint, escolha Editar.

  5. Escolha Adicionar endpoint regional.

  6. Em Certificado do ACM, escolha um certificado.

    O certificado regional deve estar da mesma região da API regional.

  7. Escolha Salvar alterações.

  8. Configure um registro DNS para apontar o nome de domínio regional personalizado para esse nome de host regional. Consulte mais informações sobre como configurar o Route 53 para encaminhar o tráfego ao API Gateway.

  9. Depois de confirmar que a configuração de DNS está usando o endpoint correto, você exclui a configuração de endpoint otimizado para borda. Escolha o nome de domínio personalizado e, em Configuração de endpoint otimizado para borda, escolha Excluir.

  10. Confirme sua escolha e exclua o endpoint.

AWS CLI

O seguinte comando update-domain-name mostra como migrar o nome de domínio personalizado para um nome de domínio regional personalizado:

aws apigateway update-domain-name \ --domain-name 'api.example.com' \ --patch-operations '[ { "op":"add", "path": "/endpointConfiguration/types","value": "REGIONAL" }, { "op":"add", "path": "/regionalCertificateArn", "value": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149" } ]'

O certificado regional deve ser da mesma região da API regional.

A resposta bem-sucedida tem um código de status 200 OK e um corpo semelhante ao seguinte:

{ "certificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a", "certificateName": "edge-cert", "certificateUploadDate": "2017-10-16T23:22:57Z", "distributionDomainName": "d1frvgze7vy1bf.cloudfront.net", "domainName": "api.example.com", "endpointConfiguration": { "types": [ "EDGE", "REGIONAL" ] }, "regionalCertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/cd833b28-58d2-407e-83e9-dce3fd852149", "regionalDomainName": "d-fdisjghyn6.execute-api.us-west-2.amazonaws.com" }

Para o nome de domínio personalizado regional migrado, a propriedade regionalDomainName resultante retorna o nome de host da API regional. Você deve configurar um registro DNS para apontar o nome de domínio personalizado regional para esse nome de host regional. Isso permite que o tráfego direcionado para o nome de domínio personalizado seja roteado para o host regional.

Depois que o registro DNS for definido, você poderá remover o nome de domínio personalizado otimizado para borda. O comando update-domain-name a seguir mostra como remover o nome de domínio personalizado otimizado para borda.

aws apigateway update-domain-name \ --domain-name api.example.com \ --patch-operations '[ {"op":"remove", "path":"/endpointConfiguration/types", "value":"EDGE"}, {"op":"remove", "path":"certificateName"}, {"op":"remove", "path":"certificateArn"} ]'
  1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

  2. Escolha Custom Domain Names (Nomes de domínios personalizados) no painel de navegação principal.

  3. Escolha um nome de domínio personalizado otimizado para borda.

  4. Em Configuração de endpoint, escolha Editar.

  5. Escolha Adicionar endpoint regional.

  6. Em Certificado do ACM, escolha um certificado.

    O certificado regional deve estar da mesma região da API regional.

  7. Escolha Salvar alterações.

  8. Configure um registro DNS para apontar o nome de domínio regional personalizado para esse nome de host regional. Consulte mais informações sobre como configurar o Route 53 para encaminhar o tráfego ao API Gateway.

  9. Depois de confirmar que a configuração de DNS está usando o endpoint correto, você exclui a configuração de endpoint otimizado para borda. Escolha o nome de domínio personalizado e, em Configuração de endpoint otimizado para borda, escolha Excluir.

  10. Confirme sua escolha e exclua o endpoint.

O procedimento a seguir mostra como migrar um nome de domínio personalizado regional para um nome de domínio personalizado otimizado para borda.

AWS Management Console
  1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

  2. No painel de navegação principal, selecione Nomes de domínio personalizados.

  3. Escolha um nome de domínio regional personalizado.

  4. Em Configuração de endpoint, escolha Editar.

  5. Escolha Adicionar endpoint otimizado para borda.

  6. Em Certificado do ACM, escolha um certificado.

    O certificado de domínio otimizado para bordas deve ser criado na região us-east-1.

  7. Escolha Salvar.

  8. Configure um registro DNS para apontar o nome de domínio personalizado otimizado para borda para esse nome de host otimizado para borda. Consulte mais informações sobre como configurar o Route 53 para encaminhar o tráfego ao API Gateway.

  9. Depois de confirmar que a configuração de DNS está usando o endpoint correto, você exclui a configuração de endpoint regional. Escolha o nome de domínio personalizado e, em Configuração de endpoint (regional), escolha Excluir.

  10. Confirme sua escolha e exclua o endpoint.

AWS CLI

O seguinte comando update-domain-name mostra como migrar o nome de domínio personalizado para um nome de domínio personalizado otimizado para borda:

aws apigateway update-domain-name \ --domain-name 'api.example.com' \ --patch-operations '[ { "op":"add", "path": "/endpointConfiguration/types","value": "EDGE" }, { "op":"add", "path": "/certificateName", "value": "edge-cert" }, {"op":"add", "path": "/certificateArn", "value": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a"} ]'

O certificado de domínio otimizado para bordas deve ser criado na região us-east-1.

A resposta bem-sucedida tem um código de status 200 OK e um corpo semelhante ao seguinte:

{ "certificateArn": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a", "certificateName": "edge-cert", "certificateUploadDate": "2017-10-16T23:22:57Z", "distributionDomainName": "d1frvgze7vy1bf.cloudfront.net", "domainName": "api.example.com", "endpointConfiguration": { "types": [ "EDGE", "REGIONAL" ] }, "regionalCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/3d881b54-851a-478a-a887-f6502760461d", "regionalDomainName": "d-cgkq2qwgzf.execute-api.us-east-1.amazonaws.com" }

Para o nome de domínio personalizado especificado, o API Gateway retorna o nome de host da API otimizada para bordas como o valor da propriedade distributionDomainName. Você deve definir um registro DNS para apontar o nome de domínio personalizado otimizado para fronteiras para esse nome de domínio de distribuição. Isso permite que o tráfego direcionado para o nome de domínio personalizado otimizado para bordas seja roteado para o nome de host da API otimizada para bordas.

Depois que o registro DNS for definido, você poderá remover o tipo de endpoint REGION do nome de domínio personalizado. O seguinte comando update-domain-name mostra como remover o tipo de endpoint regional:

aws apigateway update-domain-name \ --domain-name api.example.com \ --patch-operations '[ {"op":"remove", "path":"/endpointConfiguration/types", value:"REGIONAL"}, {"op":"remove", "path":"regionalCertificateArn"} ]'

O resultado desse comando é semelhante à seguinte saída, com os dados da configuração do nome de domínio otimizado para fronteiras:

{ "certificateArn": "arn:aws:acm:us-east-1:738575810317:certificate/34a95aa1-77fa-427c-aa07-3a88bd9f3c0a", "certificateName": "edge-cert", "certificateUploadDate": "2017-10-16T23:22:57Z", "distributionDomainName": "d1frvgze7vy1bf.cloudfront.net", "domainName": "regional.haymuto.com", "endpointConfiguration": { "types": "EDGE" } }
  1. Inicie uma sessão no console do API Gateway em https://console.aws.amazon.com/apigateway.

  2. No painel de navegação principal, selecione Nomes de domínio personalizados.

  3. Escolha um nome de domínio regional personalizado.

  4. Em Configuração de endpoint, escolha Editar.

  5. Escolha Adicionar endpoint otimizado para borda.

  6. Em Certificado do ACM, escolha um certificado.

    O certificado de domínio otimizado para bordas deve ser criado na região us-east-1.

  7. Escolha Salvar.

  8. Configure um registro DNS para apontar o nome de domínio personalizado otimizado para borda para esse nome de host otimizado para borda. Consulte mais informações sobre como configurar o Route 53 para encaminhar o tráfego ao API Gateway.

  9. Depois de confirmar que a configuração de DNS está usando o endpoint correto, você exclui a configuração de endpoint regional. Escolha o nome de domínio personalizado e, em Configuração de endpoint (regional), escolha Excluir.

  10. Confirme sua escolha e exclua o endpoint.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.