Encontre a distribuição padrão de origem ou o locatário da distribuição - Amazon CloudFront

Encontre a distribuição padrão de origem ou o locatário da distribuição

Antes de mover um nome de domínio alternativo de uma distribuição (padrão ou locatário) para outra, localize a distribuição de origem. Esse é o recurso ao qual o nome de domínio alternativo já está associado. Quando você conhece o ID da Conta da AWS dos recursos das distribuições de origem e de destino, pode determinar como o nome de domínio alternativo será movido.

Observações
  • Recomendamos que você use a operação da API ListDomainConflicts, pois ela é compatível com distribuições padrão e locatários de distribuição.

  • A operação da API ListConflictingAliases só é compatível com distribuições padrão.

Siga estes exemplos para encontrar a distribuição de origem (padrão ou locatário).

list-domain-conflicts
dica
  • Para uma distribuição padrão, você deve ter as permissões cloudfront:GetDistribution e cloudfront:ListDomainConflicts.

  • Para um locatário de distribuição, você deve ter as permissões cloudfront:GetDistributionTenant e cloudfront:ListDomainConflicts.

Para usar list-domain-conflicts para encontrar a distribuição padrão de origem ou o locatário da distribuição
  1. Use o comando list-domain-conflicts conforme mostrado no exemplo a seguir.

    1. Substitua www.exemplo.com pelo nome de domínio.

    2. Para domain-control-validation-resource, especifique o ID da distribuição padrão de destino ou do locatário de distribuição que você configurou anteriormente. Você deve ter uma distribuição padrão ou um locatário de distribuição em sua conta, com um certificado associado que abranja o domínio especificado.

    3. Execute este comando usando credenciais que estão na mesma Conta da AWS que a distribuição padrão de destino ou locatário da distribuição.

    Solicitação

    Este exemplo especifica um locatário de distribuição.

    aws cloudfront list-domain-conflicts \ --domain www.example.com \ --domain-control-validation-resource "DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8JABC"

    Resposta

    Para cada nome de domínio na saída do comando, você verá o seguinte:

    • O tipo de recurso que é associado ao domínio

    • O ID do recurso.

    • O ID da Conta da AWS que é proprietária do recurso

    O ID do recurso e o ID da conta estão parcialmente ocultos. Isso permite identificar a distribuição padrão ou o locatário de distribuição que pertence à sua conta e ajuda a proteger as informações daqueles que você não possui.

    { "DomainConflicts": [ { "Domain": "www.example.com", "ResourceType": "distribution-tenant", "ResourceId": "***************ohWzv1b9It8JABC", "AccountId": "******112233" } ] }

    A resposta lista todos os nomes de domínio que entram em conflito ou se sobrepõem ao que você especificou

    Exemplo
    • Se você especificar locatario1.exemplo.com, a resposta incluirá locatario1.exemplo.com e o nome de domínio alternativo curinga sobreposto (*.exemplo.com, se ele existir).

    • Se você especificar *.locatario1.exemplo.com, a resposta incluirá *.locatario1.exemplo.com e quaisquer nomes de domínio alternativos cobertos por esse curinga (por exemplo, teste.locatario1.exemplo.com, dev.locatario1.exemplo.com e assim por diante).

  2. Na resposta, localize a distribuição padrão de origem ou o locatário de distribuição do nome de domínio alternativo que você está movendo e observe o ID da Conta da AWS.

  3. Compare o ID da conta da distribuição padrão de origem ou do locatário de distribuição com o ID da conta em que você criou a distribuição padrão ou o locatário de distribuição de destino na etapa anterior. Em seguida, você pode determinar se a origem e o destino estão na mesma Conta da AWS. Isso ajuda você a determinar como mover o nome de domínio alternativo.

    Para obter mais informações, consulte o comando list-domain-conflicts na Referência da AWS Command Line Interface.

list-conflicting-aliases (standard distributions only)
dica

Você deve ter as permissões cloudfront:GetDistribution e cloudfront:ListConflictingAliases na distribuição padrão de destino.

Para usar list-conflicting-aliases para encontrar a distribuição padrão de origem
  1. Use o comando list-conflicting-aliases conforme mostrado no exemplo a seguir.

    1. Substitua www.exemplo.com pelo nome de domínio alternativo e EDFDVBD6EXAMPLE pelo ID da distribuição padrão de destino configurada anteriormente.

    2. Execute este comando usando credenciais que estão na mesma Conta da AWS que a distribuição padrão de destino.

    Solicitação

    Este exemplo especifica uma distribuição padrão.

    aws cloudfront list-conflicting-aliases \ --alias www.example.com \ --distribution-id EDFDVBD6EXAMPLE

    Resposta

    Para cada nome de domínio alternativo na saída do comando, você poderá ver o ID da distribuição padrão à qual ele está associado e o ID da Conta da AWS proprietária da distribuição padrão. Os IDs de distribuição padrão e de conta são parcialmente ocultados, o que permite identificar as distribuições padrão e contas que você possui, e ajuda a proteger as informações daquelas que você não possui.

    { "ConflictingAliasesList": { "MaxItems": 100, "Quantity": 1, "Items": [ { "Alias": "www.example.com", "DistributionId": "*******EXAMPLE", "AccountId": "******112233" } ] } }

    A resposta lista os nomes de domínio alternativos que entram em conflito ou se sobrepõem ao que você especificou.

    Exemplo
    • Se você especificar www.exemplo.com, a resposta incluirá www.exemplo.com e o nome de domínio alternativo curinga sobreposto (*.exemplo.com), se ele existir.

    • Se você especificar *.exemplo.com, a resposta incluirá *.exemplo.com e quaisquer nomes de domínio alternativos cobertos por esse curinga (por exemplo, www.exemplo.com, teste.exemplo.com, dev.exemplo.com e assim por diante).

  2. Encontre a distribuição padrão para o nome de domínio alternativo que você está movendo e anote o ID da Conta da AWS. Compare esse ID da conta com o ID da conta em que você criou a distribuição padrão de destino na etapa anterior. Em seguida, você pode determinar se essas duas distribuições padrão estão na mesma Conta da AWS e como mover o nome de domínio alternativo.

    Para obter mais informações, consulte o comando list-conflicting-aliases na Referência da AWS Command Line Interface

Em seguida, consulte o tópico a seguir para mover o nome de domínio alternativo.