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 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.