# Exemplos do CloudFront usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando oAWS Command Line Interface com o CloudFront.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `associate-distribution-tenant-web-acl`
O código de exemplo a seguir mostra como usar `associate-distribution-tenant-web-acl`.
**AWS CLI**
**Como associar uma ACL da web a um locatário de distribuição do CloudFront**
O exemplo `associate-distribution-tenant-web-acl` a seguir associa uma ACL da web a uma distribuição do CloudFront com a ETag `E13V1IB3VIYABC`.
```
aws cloudfront associate-distribution-tenant-web-acl \
--id dt_2wjDZi3hD1ivOXf6rpZJO1AB \
--if-match E13V1IB3VIYABC \
--web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f37123ABC
```
Resultado:
```
{
"ETag": "E1VC38T7YXBABC",
"Id": "dt_2wjDZi3hD1ivOXf6rpZJO1AB",
"WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f37123ABC"
}
```
Para ter mais informações, consulte [Usar proteções do AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [AssociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-tenant-web-acl.html) na *Referência de comandos da AWS CLI*.
### `associate-distribution-web-acl`
O código de exemplo a seguir mostra como usar `associate-distribution-web-acl`.
**AWS CLI**
**Como associar uma ACL da web a uma distribuição do CloudFront**
O exemplo `associate-distribution-web-acl` a seguir associa uma ACL da web a uma distribuição do CloudFront.
```
aws cloudfront associate-distribution-web-acl \
--id E1XNX8R2GOAABC \
--if-match E2YWS1C2J3OABC \
--web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cABC
```
Resultado:
```
{
"ETag": "E3QE7ED60U0ABC",
"Id": "E1XNX8R2GOAABC",
"WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cABC"
}
```
Para ter mais informações, consulte [Usar proteções do AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [AssociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-web-acl.html) na *Referência de comandos da AWS CLI*.
### `create-cloud-front-origin-access-identity`
O código de exemplo a seguir mostra como usar `create-cloud-front-origin-access-identity`.
**AWS CLI**
**Para criar uma identidade do acesso de origem do CloudFront**
O exemplo a seguir cria uma identidade do acesso de origem (OAI) do CloudFront fornecendo a configuração da OAI como um argumento da linha de comando:
```
aws cloudfront create-cloud-front-origin-access-identity \
--cloud-front-origin-access-identity-config \
CallerReference="cli-example",Comment="Example OAI"
```
Você pode fazer o mesmo fornecendo a configuração da OAI em um arquivo JSON, conforme mostrado no exemplo a seguir:
```
aws cloudfront create-cloud-front-origin-access-identity \
--cloud-front-origin-access-identity-config file://OAI-config.json
```
O arquivo `OAI-config.json` é um documento JSON no diretório atual que contém o seguinte:
```
{
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
```
Se você fornecer a configuração da OAI com um argumento da linha de comando ou um arquivo JSON, a saída será a mesma:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/origin-access-identity/cloudfront/E74FTE3AEXAMPLE",
"ETag": "E2QWRUHEXAMPLE",
"CloudFrontOriginAccessIdentity": {
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
}
}
```
+ Para ver detalhes da API, consulte [CreateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-cloud-front-origin-access-identity.html) na *Referência de comandos da AWS CLI*.
### `create-connection-group`
O código de exemplo a seguir mostra como usar `create-connection-group`.
**AWS CLI**
**Como criar um grupo de conexões no CloudFront**
O exemplo `create-connection-group` a seguir cria um grupo de conexões habilitado, especifica uma lista de IPs estáticos anycast e desabilita o IPv6.
```
aws cloudfront create-connection-group \
--name cg-with-anycast-ip-list \
--no-ipv6-enabled \
--enabled \
--anycast-ip-list-id aip_CCkW6gKrDiBD4n78123ABC \
--tags "Items=[{Key=abc,Value=123}]"
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"ConnectionGroup": {
"Id": "cg_2yb6uj74B4PCbfhT31WFdiSABC",
"Name": "cg-with-anycast-ip-list",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2yb6uj74B4PCbfhT31WFdiSABC",
"CreatedTime": "2025-06-16T16:25:50.061000+00:00",
"LastModifiedTime": "2025-06-16T16:25:50.061000+00:00",
"Tags": {
"Items": [
{
"Key": "abc",
"Value": "123"
}
]
},
"Ipv6Enabled": false,
"RoutingEndpoint": "dj6xusxq65abc.cloudfront.net",
"AnycastIpListId": "aip_CCkW6gKrDiBD4n78123ABC",
"Status": "InProgress",
"Enabled": true,
"IsDefault": false
}
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [CreateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-connection-group.html) na *Referência de comandos da AWS CLI*.
### `create-distribution-tenant`
O código de exemplo a seguir mostra como usar `create-distribution-tenant`.
**AWS CLI**
**Exemplo 1: criar um locatário de distribuição do CloudFront que usa um certificado personalizado**
O exemplo a seguir `create-distribution-tenant` cria um locatário de distribuição do CloudFront que especifica personalizações para desabilitar o WAF, adicionar restrições geográficas e usar outro certificado TLS.
```
aws cloudfront create-distribution-tenant \
--cli-input-json file://tenant.json
```
Conteúdo de `tenant.json`:
```
{
"DistributionId": "E1XNX8R2GOAABC",
"Domains": [
{
"Domain": "example.com"
}
],
"Parameters": [
{
"Name": "testParam",
"Value": "defaultValue"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"Enabled": false,
"Tags": {
"Items": [
{
"Key": "tag",
"Value": "tagValue"
}
]
},
"Name": "new-tenant-customizations",
"Customizations": {
"GeoRestrictions": {
"Locations": ["DE"],
"RestrictionType": "whitelist"
},
"WebAcl": {
"Action": "disable"
},
"Certificate": {
"Arn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc"
}
}
}
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"DistributionTenant": {
"Id": "dt_2yN5tYwVbPKr7m2IB69M1yp1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "new-tenant-customizations",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yN5tYwVbPKr7m2IB69M1yp1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "active"
}
],
"Tags": {
"Items": [
{
"Key": "tag",
"Value": "tagValue"
}
]
},
"Customizations": {
"WebAcl": {
"Action": "disable"
},
"Certificate": {
"Arn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc"
},
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"DE"
]
}
},
"Parameters": [
{
"Name": "testParam",
"Value": "defaultValue"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"CreatedTime": "2025-06-11T17:20:06.432000+00:00",
"LastModifiedTime": "2025-06-11T17:20:06.432000+00:00",
"Enabled": false,
"Status": "InProgress"
}
}
```
**Exemplo 2: criar um locatário de distribuição com um certificado herdado**
O exemplo a seguir `create-distribution-tenant` cria um locatário de distribuição e especifica um certificado TLS herdado da distribuição multilocatário.
```
aws cloudfront create-distribution-tenant \
--cli-input-json file://tenant.json
```
Conteúdo de `tenant.json`:
```
{
"DistributionId": "E1HVIAU7U12ABC",
"Domains": [
{
"Domain": "example.com"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"Enabled": true,
"Name": "new-tenant-no-cert"
}
```
Resultado:
```
{
"ETag": "E23ZP02F0ABC",
"DistributionTenant": {
"Id": "dt_2zhRB0vBe0B72LZCVy1mgzI1AB",
"DistributionId": "E1HVIAU7U12ABC",
"Name": "new-tenant-no-cert",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhRB0vBe0B72LZCVy1mgzI1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "active"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC",
"CreatedTime": "2025-07-10T20:59:38.414000+00:00",
"LastModifiedTime": "2025-07-10T20:59:38.414000+00:00",
"Enabled": true,
"Status": "InProgress"
}
}
```
**Exemplo 3: criar um locatário de distribuição do CloudFront usando um token de validação hospedado no CloudFront**
O exemplo a seguir `create-distribution-tenant` cria um locatário de distribuição e usa um token de validação hospedado no CloudFront para seu nome de domínio.
```
aws cloudfront create-distribution-tenant \
--cli-input-json file://tenant.json
```
Conteúdo de `tenant.json`:
```
{
"DistributionId": "E2GJ5J9QN12ABC",
"Domains": [
{
"Domain": "example.com"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC",
"Enabled": true,
"Name": "new-tenant-cf-hosted",
"ManagedCertificateRequest": {
"ValidationTokenHost": "cloudfront"
}
}
```
**Importante:** para executar esse comando com êxito, você deve configurar um registro DNS CNAME que aponte seu novo domínio (exemplo.com) para o endpoint de roteamento do grupo de conexão associado ao locatário da distribuição. Esse registro CNAME também deve ser propagado antes que o CloudFront possa concluir com êxito essa solicitação.
Resultado:
```
{
"ETag": "E23ZP02F0ABC",
"DistributionTenant": {
"Id": "dt_2zhStKrA524GvvTWJX92Ozl1AB",
"DistributionId": "E2GJ5J9QN12ABC",
"Name": "new-tenant-cf-hosted",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhStKrA524GvvTWJX92Ozl1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "inactive"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"ConnectionGroupId": "cg_2zhSaGatwwXjTjE42nneZzqABC",
"CreatedTime": "2025-07-10T21:13:46.416000+00:00",
"LastModifiedTime": "2025-07-10T21:13:46.416000+00:00",
"Enabled": true,
"Status": "InProgress"
}
}
```
**Exemplo 4: criar um locatário de distribuição do CloudFront usando um token de validação auto-hospedado**
O exemplo a seguir `create-distribution-tenant` cria um locatário de distribuição do CloudFront e usa um token de validação auto-hospedado.
```
aws cloudfront create-distribution-tenant \
--cli-input-json file://tenant.json
```
Conteúdo de `tenant.json`:
```
{
"DistributionId": "E2GJ5J9QN12ABC",
"Domains": [
{
"Domain": "example.com"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"Enabled": true,
"Name": "new-tenant-self-hosted",
"ManagedCertificateRequest": {
"ValidationTokenHost": "self-hosted"
}
}
```
Resultado:
```
{
"ETag": "E23ZP02F0ABC",
"DistributionTenant": {
"Id": "dt_2zhTFBV93OfFJJ3YMdNM5BC1AB",
"DistributionId": "E2GJ5J9QN12ABC",
"Name": "new-tenant-self-hosted",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2zhTFBV93OfFJJ3YMdNM5BC1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "inactive"
}
],
"Parameters": [
{
"Name": "tenantName",
"Value": "first-tenant"
}
],
"ConnectionGroupId": "cg_2yQEwpipGFN0hhA0ZemPabOABC",
"CreatedTime": "2025-07-10T21:16:39.828000+00:00",
"LastModifiedTime": "2025-07-10T21:16:39.828000+00:00",
"Enabled": true,
"Status": "InProgress"
}
}
```
**Importante:** depois de executar esse comando, o locatário da distribuição será criado sem validação. Para validar a solicitação de certificado gerenciado e configurar o DNS quando você estiver pronto para começar a receber tráfego, consulte [Configuração completa do domínio](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html#complete-domain-ownership) no *Guia do Desenvolvedor do Amazon CloudFront*.
Para obter mais informações sobre como criar locatários de distribuição, consulte [Criar uma distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [CreateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `create-distribution-with-tags`
O código de exemplo a seguir mostra como usar `create-distribution-with-tags`.
**AWS CLI**
**Para criar uma distribuição do CloudFront com tags**
O exemplo de `create-distribution-with-tags` a seguir cria uma distribuição com duas tags fornecendo a configuração de distribuição e as tags em um arquivo JSON chamado `dist-config-with-tags.json`.
```
aws cloudfront create-distribution-with-tags \
--distribution-config-with-tags file://dist-config-with-tags.json
```
O arquivo `dist-config-with-tags.json` é um documento JSON na pasta atual. Observe o objeto `Tags` na parte superior do arquivo, que contém duas tags:
`Name = ExampleDistribution``Project = ExampleProject`
Conteúdo de `dist-config-with-tags.json`:
```
{
"Tags": {
"Items": [
{
"Key": "Name",
"Value": "ExampleDistribution"
},
{
"Key": "Project",
"Value": "ExampleProject"
}
]
},
"DistributionConfig": {
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE",
"ETag": "E2QWRUHEXAMPLE",
"Distribution": {
"Id": "EDFDVBD6EXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE",
"Status": "InProgress",
"LastModifiedTime": "2019-12-04T23:35:41.433Z",
"InProgressInvalidationBatches": 0,
"DomainName": "d111111abcdef8.cloudfront.net",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
}
```
+ Para ver detalhes da API, consulte [CreateDistributionWithTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-with-tags.html) na *Referência de comandos da AWS CLI*.
### `create-distribution`
O código de exemplo a seguir mostra como usar `create-distribution`.
**AWS CLI**
**Exemplo 1: como criar uma distribuição do CloudFront**
O exemplo a seguir `create-distribution` cria uma distribuição para um bucket do S3 chamado `amzn-s3-demo-bucket` e também especifica `index.html` como o objeto raiz padrão, usando argumentos de linha de comandos.
```
aws cloudfront create-distribution \
--origin-domain-name amzn-s3-demo-bucket.s3.amazonaws.com \
--default-root-object index.html
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EMLARXS9EXAMPLE",
"ETag": "E9LHASXEXAMPLE",
"Distribution": {
"Id": "EMLARXS9EXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/EMLARXS9EXAMPLE",
"Status": "InProgress",
"LastModifiedTime": "2019-11-22T00:55:15.705Z",
"InProgressInvalidationBatches": 0,
"DomainName": "d111111abcdef8.cloudfront.net",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
}
```
**Exemplo 2: como criar uma distribuição do CloudFront usando um arquivo JSON**
O exemplo a seguir `create-distribution` cria uma distribuição para um bucket do S3 chamado `amzn-s3-demo-bucket` e também especifica `index.html` como o objeto raiz padrão, usando um arquivo JSON.
```
aws cloudfront create-distribution \
--distribution-config file://dist-config.json
```
Conteúdo de `dist-config.json`:
```
{
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
```
Consulte a amostra de saída no exemplo 1.
**Exemplo 3: criar uma distribuição multilocatária do CloudFront com um certificado**
O exemplo a seguir `create-distribution` cria uma distribuição do CloudFront com suporte multilocatário e especifica um certificado TLS.
```
aws cloudfront create-distribution \
--distribution-config file://dist-config.json
```
Conteúdo de `dist-config.json`:
```
{
"CallerReference": "cli-example-with-cert",
"Comment": "CLI example distribution",
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"OriginPath": "/{{tenantName}}",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC",
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": ["HEAD", "GET"],
"CachedMethods": {
"Quantity": 2,
"Items": ["HEAD", "GET"]
}
}
},
"Enabled": true,
"ViewerCertificate": {
"ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/191306a1-db01-49ca-90ef-fc414ee5dabc",
"SSLSupportMethod": "sni-only"
},
"HttpVersion": "http2",
"ConnectionMode": "tenant-only",
"TenantConfig": {
"ParameterDefinitions": [
{
"Name": "tenantName",
"Definition": {
"StringSchema": {
"Comment": "tenantName parameter",
"DefaultValue": "root",
"Required": false
}
}
}
]
}
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution/E1HVIAU7UABC",
"ETag": "E20LT7R1BABC",
"Distribution": {
"Id": "E1HVIAU7U12ABC",
"ARN": "arn:aws:cloudfront::123456789012:distribution/E1HVIAU7U12ABC",
"Status": "InProgress",
"LastModifiedTime": "2025-07-10T20:33:31.117000+00:00",
"InProgressInvalidationBatches": 0,
"DomainName": "example.com",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ActiveTrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-example-with-cert",
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"OriginPath": "/{{tenantName}}",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
},
"ConnectionAttempts": 3,
"ConnectionTimeout": 10,
"OriginShield": {
"Enabled": false
},
"OriginAccessControlId": ""
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"TrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": ["HEAD", "GET"],
"CachedMethods": {
"Quantity": 2,
"Items": ["HEAD", "GET"]
}
},
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": "",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC",
"GrpcConfig": {
"Enabled": false
}
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "CLI example distribution",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": false,
"ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/1954f095-11b6-4daf-9952-0c308a00abc",
"SSLSupportMethod": "sni-only",
"MinimumProtocolVersion": "TLSv1.2_2021",
"Certificate": "arn:aws:acm:us-east-1:123456789012:certificate/1954f095-11b6-4daf-9952-0c308a00abc",
"CertificateSource": "acm"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"TenantConfig": {
"ParameterDefinitions": [
{
"Name": "tenantName",
"Definition": {
"StringSchema": {
"Comment": "tenantName parameter",
"DefaultValue": "root",
"Required": false
}
}
}
]
},
"ConnectionMode": "tenant-only"
}
}
}
```
Para obter mais informações, consulte [Trabalhar com distribuições](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) no *Guia do desenvolvedor do Amazon CloudFront*.
**Exemplo 4: criar uma distribuição multilocatária do CloudFront sem um certificado**
O exemplo a seguir `create-distribution` cria uma distribuição do CloudFront com suporte multilocatário, mas sem um certificado TLS.
```
aws cloudfront create-distribution \
--distribution-config file://dist-config.json
```
Conteúdo de `dist-config.json`:
```
{
"CallerReference": "cli-example",
"Comment": "CLI example distribution",
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"OriginPath": "/{{tenantName}}",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC",
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
}
},
"Enabled": true,
"HttpVersion": "http2",
"ConnectionMode": "tenant-only",
"TenantConfig": {
"ParameterDefinitions": [
{
"Name": "tenantName",
"Definition": {
"StringSchema": {
"Comment": "tenantName parameter",
"DefaultValue": "root",
"Required": false
}
}
}
]
}
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution/E2GJ5J9QN12ABC",
"ETag": "E37YLVVQIABC",
"Distribution": {
"Id": "E2GJ5J9QNABC",
"ARN": "arn:aws:cloudfront::123456789012:distribution/E2GJ5J9QN12ABC",
"Status": "InProgress",
"LastModifiedTime": "2025-07-10T20:35:20.565000+00:00",
"InProgressInvalidationBatches": 0,
"DomainName": "example.com",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ActiveTrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-example-no-cert",
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"OriginPath": "/{{tenantName}}",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
},
"ConnectionAttempts": 3,
"ConnectionTimeout": 10,
"OriginShield": {
"Enabled": false
},
"OriginAccessControlId": ""
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"TrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": "",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5ABC",
"GrpcConfig": {
"Enabled": false
}
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "CLI example distribution",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"SSLSupportMethod": "sni-only",
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"TenantConfig": {
"ParameterDefinitions": [
{
"Name": "tenantName",
"Definition": {
"StringSchema": {
"Comment": "tenantName parameter",
"DefaultValue": "root",
"Required": false
}
}
}
]
},
"ConnectionMode": "tenant-only"
}
}
}
```
Para ter mais informações, consulte [Criar distribuições](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Consulte detalhes da API em [CreateDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution.html) na *Referência de comandos da AWS CLI*.
### `create-field-level-encryption-config`
O código de exemplo a seguir mostra como usar `create-field-level-encryption-config`.
**AWS CLI**
**Para criar uma configuração de criptografia no nível de campo do CloudFront**
O exemplo a seguir cria uma configuração de criptografia no nível de campo fornecendo os parâmetros de configuração em um arquivo JSON chamado `fle-config.json`. Antes de criar uma configuração de criptografia no nível de campo, você deve ter um perfil de criptografia no nível de campo. Para criar um perfil, consulte o comando create-field-level-encryption-profile.
Para obter mais informações sobre a criptografia no nível de campo do CloudFront, consulte [Como usar a criptografia no nível de campo para ajudar a proteger dados confidenciais](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) no *Guia do desenvolvedor do Amazon CloudFront*.
```
aws cloudfront create-field-level-encryption-config \
--field-level-encryption-config file://fle-config.json
```
O arquivo `fle-config.json` é um documento JSON na pasta atual que contém o seguinte:
```
{
"CallerReference": "cli-example",
"Comment": "Example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/field-level-encryption/C3KM2WVD605UAY",
"ETag": "E2P4Z4VU7TY5SG",
"FieldLevelEncryption": {
"Id": "C3KM2WVD605UAY",
"LastModifiedTime": "2019-12-10T21:30:18.974Z",
"FieldLevelEncryptionConfig": {
"CallerReference": "cli-example",
"Comment": "Example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0,
"Items": []
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
}
}
```
+ Para ver detalhes da API, consulte [CreateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-config.html) na *Referência de comandos da AWS CLI*.
### `create-field-level-encryption-profile`
O código de exemplo a seguir mostra como usar `create-field-level-encryption-profile`.
**AWS CLI**
**Para criar um perfil de criptografia no nível de campo do CloudFront**
O exemplo a seguir cria um perfil de criptografia no nível de campo fornecendo os parâmetros em um arquivo JSON chamado `fle-profile-config.json`. Antes de criar um perfil de criptografia no nível de campo, você deve ter uma chave pública do CloudFront. Para criar uma chave pública do CloudFront, consulte o comando create-public-key.
Para obter mais informações sobre a criptografia no nível de campo do CloudFront, consulte [Como usar a criptografia no nível de campo para ajudar a proteger dados confidenciais](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) no *Guia do desenvolvedor do Amazon CloudFront*.
```
aws cloudfront create-field-level-encryption-profile \
--field-level-encryption-profile-config file://fle-profile-config.json
```
O arquivo `fle-profile-config.json` é um documento JSON na pasta atual que contém o seguinte:
```
{
"Name": "ExampleFLEProfile",
"CallerReference": "cli-example",
"Comment": "FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField"
]
}
}
]
}
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/field-level-encryption-profile/PPK0UOSIF5WSV",
"ETag": "E2QWRUHEXAMPLE",
"FieldLevelEncryptionProfile": {
"Id": "PPK0UOSIF5WSV",
"LastModifiedTime": "2019-12-10T01:03:16.537Z",
"FieldLevelEncryptionProfileConfig": {
"Name": "ExampleFLEProfile",
"CallerReference": "cli-example",
"Comment": "FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField"
]
}
}
]
}
}
}
}
```
+ Para ver detalhes da API, consulte [CreateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-profile.html) na *Referência de comandos da AWS CLI*.
### `create-invalidation-for-distribution-tenant`
O código de exemplo a seguir mostra como usar `create-invalidation-for-distribution-tenant`.
**AWS CLI**
**Como criar uma invalidação do CloudFront para um locatário de distribuição**
O exemplo `create-invalidation-for-distribution-tenant` a seguir cria uma invalidação para todos os arquivos em um locatário de distribuição do CloudFront.
```
aws cloudfront create-invalidation-for-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJO1AB \
--invalidation-batch '{"Paths": {"Quantity": 1, "Items": ["/*"]}, "CallerReference": "invalidation-$(date +%s)"}'
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2020-05-31/distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJO1AB/invalidation/I2JGL2F1ZAA426PGG0YLLKABC",
"Invalidation": {
"Id": "I2JGL2F1ZAA426PGG0YLLKABC",
"Status": "InProgress",
"CreateTime": "2025-05-07T16:59:25.947000+00:00",
"InvalidationBatch": {
"Paths": {
"Quantity": 1,
"Items": [
"/*"
]
},
"CallerReference": "invalidation-$(date +%s)"
}
}
}
```
Para ter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [CreateInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation-for-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `create-invalidation`
O código de exemplo a seguir mostra como usar `create-invalidation`.
**AWS CLI**
**Como criar uma invalidação para uma distribuição do CloudFront**
O exemplo `create-invalidation` a seguir cria uma invalidação para os arquivos especificados na distribuição especificada do CloudFront:
```
aws cloudfront create-invalidation \
--distribution-id EDFDVBD6EXAMPLE \
--paths "/example-path/example-file.jpg" "/example-path/example-file2.png"
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE/invalidation/I1JLWSDAP8FU89",
"Invalidation": {
"Id": "I1JLWSDAP8FU89",
"Status": "InProgress",
"CreateTime": "2019-12-05T18:24:51.407Z",
"InvalidationBatch": {
"Paths": {
"Quantity": 2,
"Items": [
"/example-path/example-file2.png",
"/example-path/example-file.jpg"
]
},
"CallerReference": "cli-1575570291-670203"
}
}
}
```
No exemplo anterior, a AWS CLI gerou automaticamente um `CallerReference` aleatório. Para especificar seu próprio `CallerReference` ou evitar passar os parâmetros de invalidação como argumentos da linha de comando, é possível usar um arquivo JSON. O exemplo a seguir cria uma invalidação para dois arquivos fornecendo os parâmetros de invalidação em um arquivo JSON chamado `inv-batch.json`:
```
aws cloudfront create-invalidation \
--distribution-id EDFDVBD6EXAMPLE \
--invalidation-batch file://inv-batch.json
```
Conteúdo de `inv-batch.json`:
```
{
"Paths": {
"Quantity": 2,
"Items": [
"/example-path/example-file.jpg",
"/example-path/example-file2.png"
]
},
"CallerReference": "cli-example"
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/distribution/EDFDVBD6EXAMPLE/invalidation/I2J0I21PCUYOIK",
"Invalidation": {
"Id": "I2J0I21PCUYOIK",
"Status": "InProgress",
"CreateTime": "2019-12-05T18:40:49.413Z",
"InvalidationBatch": {
"Paths": {
"Quantity": 2,
"Items": [
"/example-path/example-file.jpg",
"/example-path/example-file2.png"
]
},
"CallerReference": "cli-example"
}
}
}
```
+ Para detalhes da API, consulte [CreateInvalidation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation.html) na *Referência de comandos da AWS CLI*.
### `create-public-key`
O código de exemplo a seguir mostra como usar `create-public-key`.
**AWS CLI**
**Como criar uma chave pública do CloudFront**
O exemplo a seguir cria uma chave pública do CloudFront fornecendo os parâmetros em um arquivo JSON chamado `pub-key-config.json`. Antes de usar esse comando, você deve ter uma chave pública codificada em PEM. Para obter mais informações, consulte [Criar um par de chaves do RSA](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html#field-level-encryption-setting-up-step1) no *Guia do desenvolvedor do Amazon CloudFront*.
```
aws cloudfront create-public-key \
--public-key-config file://pub-key-config.json
```
O arquivo `pub-key-config.json` é um documento JSON na pasta atual que contém o seguinte. Observe que a chave pública é codificada no formato PEM.
```
{
"CallerReference": "cli-example",
"Name": "ExampleKey",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n",
"Comment": "example public key"
}
```
Resultado:
```
{
"Location": "https://cloudfront.amazonaws.com/2019-03-26/public-key/KDFB19YGCR002",
"ETag": "E2QWRUHEXAMPLE",
"PublicKey": {
"Id": "KDFB19YGCR002",
"CreatedTime": "2019-12-05T18:51:43.781Z",
"PublicKeyConfig": {
"CallerReference": "cli-example",
"Name": "ExampleKey",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n",
"Comment": "example public key"
}
}
}
```
+ Consulte detalhes da API em [CreatePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-public-key.html) na *Referência de comandos da AWS CLI*.
### `delete-cloud-front-origin-access-identity`
O código de exemplo a seguir mostra como usar `delete-cloud-front-origin-access-identity`.
**AWS CLI**
**Para excluir uma identidade do acesso de origem do CloudFront**
O exemplo a seguir exclui a identidade do acesso de origem (OAI) com o ID `E74FTE3AEXAMPLE`. Para excluir uma OAI, você deve ter o ID da OAI e a `ETag`. O ID da OAI é retornado na saída dos comandos create-cloud-front-origin-access-identity e list-cloud-front-origin-access-identities. Para obter a `ETag`, use o comando get-cloud-front-origin-access-identity ou get-cloud-front-origin-access-identity-config. Use a opção `--if-match` para fornecer a `ETag` da OAI.
```
aws cloudfront delete-cloud-front-origin-access-identity \
--id E74FTE3AEXAMPLE \
--if-match E2QWRUHEXAMPLE
```
Quando bem-sucedido, este comando não tem saída.
+ Para ver detalhes da API, consulte [DeleteCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-cloud-front-origin-access-identity.html) na *Referência de comandos da AWS CLI*.
### `delete-connection-group`
O código de exemplo a seguir mostra como usar `delete-connection-group`.
**AWS CLI**
**Como excluir um grupo de conexões**
O exemplo `delete-connection-group` a seguir exclui um grupo de conexões. O grupo de conexões deve estar desabilitado e não pode ser associado a nenhum recurso do CloudFront.
```
aws cloudfront delete-connection-group \
--id cg_2wjLpjbHkLUdhWAjHllcOeABC \
--if-match ETVPDKIKX0DABC
```
Quando bem-sucedido, este comando não tem saída.
Para ter mais informações sobre como gerenciar grupos de conexões, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [DeleteConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-connection-group.html) na *Referência de comandos da AWS CLI*.
### `delete-distribution-tenant`
O código de exemplo a seguir mostra como usar `delete-distribution-tenant`.
**AWS CLI**
**Como excluir um locatário de distribuição**
O exemplo `delete-distribution-tenant` a seguir exclui um locatário de distribuição com a ETag `ETVPDKIKX0DABC`. O locatário de distribuição deve estar desabilitado e não pode ser associado a nenhum recurso do CloudFront.
```
aws cloudfront delete-distribution-tenant \
--id dt_2wjMUbg3NHZEQ7OfoalP5zi1AB \
--if-match ETVPDKIKX0DABC
```
Quando bem-sucedido, este comando não tem saída.
Para ter mais informações, consulte [Excluir uma distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [DeleteDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `delete-distribution`
O código de exemplo a seguir mostra como usar `delete-distribution`.
**AWS CLI**
**Como excluir uma distribuição do CloudFront**
O exemplo a seguir exclui a distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`. Você deve desabilitar uma distribuição antes de exclui-la. Use o comando update-distribution para desabilitar uma distribuição. Para obter mais informações, consulte exemplos do comando update-distribution.
Uma distribuição pode ser excluída depois de ser desabilitada. Para excluir uma distribuição, use a opção `--if-match` para fornecer o `ETag` da distribuição. Use o comando get-distribution ou get-distribution-config para obter o `ETag`.
```
aws cloudfront delete-distribution \
--id EDFDVBD6EXAMPLE \
--if-match E2QWRUHEXAMPLE
```
Quando bem-sucedido, este comando não tem saída.
+ Consulte detalhes da API em [DeleteDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution.html) na *Referência de comandos da AWS CLI*.
### `delete-field-level-encryption-config`
O código de exemplo a seguir mostra como usar `delete-field-level-encryption-config`.
**AWS CLI**
**Para excluir uma configuração de criptografia no nível de campo do CloudFront**
O exemplo a seguir exclui a configuração de criptografia no nível de campo do CloudFront com o ID `C3KM2WVD605UAY`. Para excluir uma configuração de criptografia no nível de campo, você deve ter o ID e a `ETag`. O ID é retornado na saída dos comandos create-field-level-encryption-config e list-field-level-encryption-configs. Para obter a `ETag`, use o comando get-field-level-encryption ou get-field-level-encryption-config. Use a opção `--if-match` para fornecer a `ETag` das configurações.
```
aws cloudfront delete-field-level-encryption-config \
--id C3KM2WVD605UAY \
--if-match E26M4BIAV81ZF6
```
Quando bem-sucedido, este comando não tem saída.
+ Para ver detalhes da API, consulte [DeleteFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-config.html) na *Referência de comandos da AWS CLI*.
### `delete-field-level-encryption-profile`
O código de exemplo a seguir mostra como usar `delete-field-level-encryption-profile`.
**AWS CLI**
**Para excluir um perfil de criptografia no nível de campo do CloudFront**
O exemplo a seguir exclui o perfil de criptografia no nível de campo do CloudFront com o ID `PPK0UOSIF5WSV`. Para excluir um perfil de criptografia no nível de campo, você deve ter o ID e a `ETag`. O ID é retornado na saída dos comandos create-field-level-encryption-profile e list-field-level-encryption-profiles. Para obter a `ETag`, use o comando get-field-level-encryption-profile ou get-field-level-encryption-profile-config. Use a opção `--if-match` para fornecer a `ETag` do perfil.
```
aws cloudfront delete-field-level-encryption-profile \
--id PPK0UOSIF5WSV \
--if-match EJETYFJ9CL66D
```
Quando bem-sucedido, este comando não tem saída.
+ Para ver detalhes da API, consulte [DeleteFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-profile.html) na *Referência de comandos da AWS CLI*.
### `delete-public-key`
O código de exemplo a seguir mostra como usar `delete-public-key`.
**AWS CLI**
**Para excluir uma chave pública do CloudFront**
O exemplo a seguir exclui a chave pública do CloudFront com o ID `KDFB19YGCR002`. Para excluir uma chave pública, você deve ter seu ID e `ETag`. O ID é retornado na saída dos comandos create-public-key e list-public-keys. Para obter a `ETag`, use o comando get-public-key ou get-public-key-config. Use a opção `--if-match` para fornecer a `ETag` da chave pública.
```
aws cloudfront delete-public-key \
--id KDFB19YGCR002 \
--if-match E2QWRUHEXAMPLE
```
Quando bem-sucedido, este comando não tem saída.
+ Para ver detalhes da API, consulte [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-public-key.html) na *Referência de comandos da AWS CLI*.
### `disassociate-distribution-tenant-web-acl`
O código de exemplo a seguir mostra como usar `disassociate-distribution-tenant-web-acl`.
**AWS CLI**
**Como desassociar uma ACL da web de um locatário de distribuição**
O exemplo `disassociate-distribution-tenant-web-acl` a seguir dissocia uma ACL da web de um locatário de distribuição com a ETag `E1PA6795UKMABC`.
```
aws cloudfront disassociate-distribution-tenant-web-acl \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB \
--if-match E1PA6795UKMABC
```
Resultado:
```
{
"ETag": "E13V1IB3VIYABC",
"Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB"
}
```
Para ter mais informações, consulte [Desabilitar as proteções de segurança do AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [DisassociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-tenant-web-acl.html) na *Referência de comandos da AWS CLI*.
### `disassociate-distribution-web-acl`
O código de exemplo a seguir mostra como usar `disassociate-distribution-web-acl`.
**AWS CLI**
**Como desassociar uma ACL da web de uma distribuição do CloudFront**
O exemplo `disassociate-distribution-web-acl` a seguir remove a associação entre uma ACL da web e uma distribuição do CloudFront com a ETag `E13V1IB3VIYABC`.
```
aws cloudfront disassociate-distribution-web-acl \
--id E1XNX8R2GOAABC \
--if-match EEZQ9Z24VM1ABC
```
Resultado:
```
{
"ETag": "E2YWS1C2J3OABC",
"Id": "E1XNX8R2GOAABC"
}
```
Para ter mais informações, consulte [Desabilitar as proteções de segurança do AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [DisassociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-web-acl.html) na *Referência de comandos da AWS CLI*.
### `get-cloud-front-origin-access-identity-config`
O código de exemplo a seguir mostra como usar `get-cloud-front-origin-access-identity-config`.
**AWS CLI**
**Como obter uma configuração de identidade do acesso de origem do CloudFront**
O exemplo a seguir obtém metadados sobre a identidade do acesso de origem (OAI) do CloudFront com o ID `E74FTE3AEXAMPLE`, incluindo a `ETag`. O ID da OAI é retornado na saída dos comandos create-cloud-front-origin-access-identity e list-cloud-front-origin-access-identities.
```
aws cloudfront get-cloud-front-origin-access-identity-config --id E74FTE3AEXAMPLE
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
}
```
+ Consulte detalhes da API em [GetCloudFrontOriginAccessIdentityConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity-config.html) na *Referência de comandos da AWS CLI*.
### `get-cloud-front-origin-access-identity`
O código de exemplo a seguir mostra como usar `get-cloud-front-origin-access-identity`.
**AWS CLI**
**Para obter uma identidade do acesso de origem do CloudFront**
O exemplo a seguir obtém a identidade do acesso de origem (OAI) do CloudFront com a ID `E74FTE3AEXAMPLE`, incluindo sua `ETag` e a ID canônica associada do S3. O ID da OAI é retornado na saída dos comandos create-cloud-front-origin-access-identity e list-cloud-front-origin-access-identities.
```
aws cloudfront get-cloud-front-origin-access-identity --id E74FTE3AEXAMPLE
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"CloudFrontOriginAccessIdentity": {
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
}
}
```
+ Consulte detalhes da API em [GetCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity.html) na *Referência de comandos da AWS CLI*.
### `get-connection-group-by-routing-endpoint`
O código de exemplo a seguir mostra como usar `get-connection-group-by-routing-endpoint`.
**AWS CLI**
**Como obter um grupo de conexão por endpoint de roteamento**
O exemplo `get-connection-group-by-routing-endpoint` a seguir recupera informações sobre um grupo de conexões usando o respectivo endpoint de roteamento.
```
aws cloudfront get-connection-group-by-routing-endpoint \
--routing-endpoint dvdg9gprgabc.cloudfront.net
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"ConnectionGroup": {
"Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC",
"Name": "connection-group-2",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC",
"CreatedTime": "2025-05-06T15:42:00.790000+00:00",
"LastModifiedTime": "2025-05-06T15:42:00.790000+00:00",
"Ipv6Enabled": true,
"RoutingEndpoint": "dvdg9gprgabc.cloudfront.net",
"Status": "Deployed",
"Enabled": true,
"IsDefault": false
}
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [GetConnectionGroupByRoutingEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group-by-routing-endpoint.html) na *Referência de comandos da AWS CLI*.
### `get-connection-group`
O código de exemplo a seguir mostra como usar `get-connection-group`.
**AWS CLI**
**Como obter um grupo de conexões do CloudFront**
O exemplo `get-connection-group` a seguir recupera informações sobre um grupo de conexões do CloudFront.
```
aws cloudfront get-connection-group \
--identifier cg_2wjDWTBKTlRB87cAaUQFaakABC
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"ConnectionGroup": {
"Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC",
"Name": "connection-group-2",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC",
"CreatedTime": "2025-05-06T15:42:00.790000+00:00",
"LastModifiedTime": "2025-05-06T15:42:00.790000+00:00",
"Ipv6Enabled": true,
"RoutingEndpoint": "dvdg9gprgabc.cloudfront.net",
"Status": "Deployed",
"Enabled": true,
"IsDefault": false
}
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [GetConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group.html) na *Referência de comandos da AWS CLI*.
### `get-distribution-config`
O código de exemplo a seguir mostra como usar `get-distribution-config`.
**AWS CLI**
**Como obter uma configuração de distribuição do CloudFront**
O exemplo a seguir obtém metadados sobre a distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`, incluindo o `ETag`. O ID de distribuição é retornado nos comandos create-distribution e list-distributions.
```
aws cloudfront get-distribution-config \
--id EDFDVBD6EXAMPLE
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"DistributionConfig": {
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
```
+ Consulte detalhes da API em [GetDistributionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-config.html) na *Referência de comandos da AWS CLI*.
### `get-distribution-tenant-by-domain`
O código de exemplo a seguir mostra como usar `get-distribution-tenant-by-domain`.
**AWS CLI**
**Como obter informações sobre um locatário de distribuição por domínio**
O exemplo `get-distribution-tenant-by-domain` a seguir recupera informações sobre um locatário de distribuição usando o domínio especificado.
```
aws cloudfront get-distribution-tenant-by-domain \
--domain example.com
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"DistributionTenant": {
"Id": "dt_2xVInRKCfUzQHgxosDs9hiLk1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "example-tenant-4",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2xVInRKCfUzQHgxosDs9hiLk1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "active"
}
],
"Parameters": [
{
"Name": "testParam",
"Value": "defaultValue"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"CreatedTime": "2025-05-23T16:16:20.871000+00:00",
"LastModifiedTime": "2025-05-23T16:16:20.871000+00:00",
"Enabled": false,
"Status": "Deployed"
}
}
```
Para obter mais informações, consulte [Understand how multi-tenant distributions work](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront Developer Guide*.
+ Para ver detalhes da API, consulte [GetDistributionTenantByDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant-by-domain.html) na *Referência de comandos da AWS CLI*.
### `get-distribution-tenant`
O código de exemplo a seguir mostra como usar `get-distribution-tenant`.
**AWS CLI**
**Como obter detalhes sobre um locatário de distribuição do CloudFront**
O exemplo `get-distribution-tenant` a seguir recupera informações sobre um locatário de distribuição do CloudFront.
```
aws cloudfront get-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Resultado:
```
{
"ETag": "E23ZP02F085ABC",
"DistributionTenant": {
"Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "example-tenant-2",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "inactive"
}
],
"ConnectionGroupId": "cg_2wjDWTBKTlRB87cAaUQFaakABC",
"CreatedTime": "2025-05-06T15:42:28.542000+00:00",
"LastModifiedTime": "2025-05-06T15:42:37.724000+00:00",
"Enabled": true,
"Status": "InProgress"
}
}
```
Para obter mais informações, consulte [Understand how multi-tenant distributions work](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront Developer Guide*.
+ Para ver detalhes da API, consulte [GetDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `get-distribution`
O código de exemplo a seguir mostra como usar `get-distribution`.
**AWS CLI**
**Como obter uma distribuição do CloudFront**
O exemplo de `get-distribution` a seguir obtém a distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`, incluindo a respectiva `ETag`. O ID de distribuição é retornado nos comandos create-distribution e list-distributions.
```
aws cloudfront get-distribution \
--id EDFDVBD6EXAMPLE
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"Distribution": {
"Id": "EDFDVBD6EXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE",
"Status": "Deployed",
"LastModifiedTime": "2019-12-04T23:35:41.433Z",
"InProgressInvalidationBatches": 0,
"DomainName": "d111111abcdef8.cloudfront.net",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-example",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-cli-example",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
}
```
+ Consulte detalhes da API em [GetDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution.html) na *Referência de comandos da AWS CLI*.
### `get-field-level-encryption-config`
O código de exemplo a seguir mostra como usar `get-field-level-encryption-config`.
**AWS CLI**
**Para obter metadados sobre uma configuração de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém metadados sobre a configuração de criptografia no nível de campo do CloudFront com o ID `C3KM2WVD605UAY`, incluindo a `ETag`:
```
aws cloudfront get-field-level-encryption-config --id C3KM2WVD605UAY
```
Resultado:
```
{
"ETag": "E2P4Z4VU7TY5SG",
"FieldLevelEncryptionConfig": {
"CallerReference": "cli-example",
"Comment": "Example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0,
"Items": []
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
}
```
+ Para ver detalhes da API, consulte [GetFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-config.html) na *Referência de comandos da AWS CLI*.
### `get-field-level-encryption-profile-config`
O código de exemplo a seguir mostra como usar `get-field-level-encryption-profile-config`.
**AWS CLI**
**Para obter uma configuração de perfil de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém metadados sobre o perfil de criptografia no nível de campo do CloudFront com o ID `PPK0UOSIF5WSV`, incluindo a `ETag`:
```
aws cloudfront get-field-level-encryption-profile-config --id PPK0UOSIF5WSV
```
Resultado:
```
{
"ETag": "E1QQG65FS2L2GC",
"FieldLevelEncryptionProfileConfig": {
"Name": "ExampleFLEProfile",
"CallerReference": "cli-example",
"Comment": "FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField"
]
}
}
]
}
}
}
```
+ Para ver detalhes da API, consulte [GetFieldLevelEncryptionProfileConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile-config.html) na *Referência de comandos da AWS CLI*.
### `get-field-level-encryption-profile`
O código de exemplo a seguir mostra como usar `get-field-level-encryption-profile`.
**AWS CLI**
**Para obter um perfil de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém o perfil de criptografia no nível de campo do CloudFront com o ID `PPK0UOSIF5WSV`, incluindo a `ETag`:
```
aws cloudfront get-field-level-encryption-profile --id PPK0UOSIF5WSV
```
Resultado:
```
{
"ETag": "E1QQG65FS2L2GC",
"FieldLevelEncryptionProfile": {
"Id": "PPK0UOSIF5WSV",
"LastModifiedTime": "2019-12-10T01:03:16.537Z",
"FieldLevelEncryptionProfileConfig": {
"Name": "ExampleFLEProfile",
"CallerReference": "cli-example",
"Comment": "FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField"
]
}
}
]
}
}
}
}
```
+ Para ver detalhes da API, consulte [GetFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile.html) na *Referência de comandos da AWS CLI*.
### `get-field-level-encryption`
O código de exemplo a seguir mostra como usar `get-field-level-encryption`.
**AWS CLI**
**Para obter uma configuração de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém a configuração de criptografia no nível de campo do CloudFront com o ID `C3KM2WVD605UAY`, incluindo a `ETag`:
```
aws cloudfront get-field-level-encryption --id C3KM2WVD605UAY
```
Resultado:
```
{
"ETag": "E2P4Z4VU7TY5SG",
"FieldLevelEncryption": {
"Id": "C3KM2WVD605UAY",
"LastModifiedTime": "2019-12-10T21:30:18.974Z",
"FieldLevelEncryptionConfig": {
"CallerReference": "cli-example",
"Comment": "Example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0,
"Items": []
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
}
}
```
+ Para ver detalhes da API, consulte [GetFieldLevelEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption.html) na *Referência de comandos da AWS CLI*.
### `get-invalidation-for-distribution-tenant`
O código de exemplo a seguir mostra como usar `get-invalidation-for-distribution-tenant`.
**AWS CLI**
**Como obter uma invalidação para um locatário de distribuição**
O exemplo `get-invalidation-for-distribution-tenant` a seguir obtém informações sobre uma invalidação para um locatário de distribuição.
```
aws cloudfront get-invalidation-for-distribution-tenant \
--distribution-tenant-id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB \
--id I4CU23QAPKMUDUU06F9OFGFABC
```
Resultado:
```
{
"Invalidation": {
"Id": "I4CU23QAPKMUDUU06F9OFGFABC",
"Status": "Completed",
"CreateTime": "2025-05-06T15:46:12.824000+00:00",
"InvalidationBatch": {
"Paths": {
"Quantity": 2,
"Items": [
"/example/invalidation",
"/more/invalidations"
]
},
"CallerReference": "007ee5a6-d0a0-42be-bb61-e7b915969b48"
}
}
}
```
Para ter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [GetInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation-for-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `get-invalidation`
O código de exemplo a seguir mostra como usar `get-invalidation`.
**AWS CLI**
**Para obter uma invalidação do CloudFront**
O exemplo a seguir obtém a invalidação com o ID `I2J0I21PCUYOIK` da distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`:
```
aws cloudfront get-invalidation --id I2J0I21PCUYOIK --distribution-id EDFDVBD6EXAMPLE
```
Resultado:
```
{
"Invalidation": {
"Status": "Completed",
"InvalidationBatch": {
"Paths": {
"Items": [
"/example-path/example-file.jpg",
"/example-path/example-file-2.jpg"
],
"Quantity": 2
},
"CallerReference": "cli-example"
},
"Id": "I2J0I21PCUYOIK",
"CreateTime": "2019-12-05T18:40:49.413Z"
}
}
```
+ Para ver detalhes da API, consulte [GetInvalidation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation.html) na *Referência de comandos da AWS CLI*.
### `get-managed-certificate-details`
O código de exemplo a seguir mostra como usar `get-managed-certificate-details`.
**AWS CLI**
**Como obter detalhes de certificados gerenciados**
O exemplo `get-managed-certificate-details` a seguir recupera os detalhes de um certificado do ACM gerenciado pelo CloudFront.
```
aws cloudfront get-managed-certificate-details \
--identifier dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Resultado:
```
{
"ManagedCertificateDetails": {
"CertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/655dc1fe-6d37-451d-a013-c2db3a034abc",
"CertificateStatus": "pending-validation",
"ValidationTokenHost": "self-hosted",
"ValidationTokenDetails": [
{
"Domain": "example.com",
"RedirectTo": "validation.us-east-1.acm-validations.aws/123456789012/.well-known/pki-validation/b315c9ae21284e7918bb9f3f422ab1c7.txt",
"RedirectFrom": "example.com/.well-known/pki-validation/b315c9ae21284e7918bb9f3f422ac3c7.txt"
}
]
}
}
```
Para ter mais informações, consulte [Solicitar certificados para locatários de distribuição do CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [GetManagedCertificateDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-managed-certificate-details.html) na *Referência de comandos da AWS CLI*.
### `get-public-key-config`
O código de exemplo a seguir mostra como usar `get-public-key-config`.
**AWS CLI**
**Para obter uma configuração de chave pública do CloudFront**
O exemplo a seguir obtém metadados sobre a chave pública do CloudFront com o ID `KDFB19YGCR002`, incluindo a `ETag`. O ID da chave pública é retornado nos comandos create-public-key e list-public-keys.
```
aws cloudfront get-public-key-config --id KDFB19YGCR002
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"PublicKeyConfig": {
"CallerReference": "cli-example",
"Name": "ExampleKey",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n",
"Comment": "example public key"
}
}
```
+ Para ver detalhes da API, consulte [GetPublicKeyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key-config.html) na *Referência de comandos da AWS CLI*.
### `get-public-key`
O código de exemplo a seguir mostra como usar `get-public-key`.
**AWS CLI**
**Para obter uma chave pública do CloudFront**
O exemplo a seguir obtém a chave pública do CloudFront com o ID `KDFB19YGCR002`, incluindo a `ETag`. O ID da chave pública é retornado nos comandos create-public-key e list-public-keys.
```
aws cloudfront get-public-key --id KDFB19YGCR002
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"PublicKey": {
"Id": "KDFB19YGCR002",
"CreatedTime": "2019-12-05T18:51:43.781Z",
"PublicKeyConfig": {
"CallerReference": "cli-example",
"Name": "ExampleKey",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n",
"Comment": "example public key"
}
}
}
```
+ Para ver detalhes da API, consulte [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key.html) na *Referência de comandos da AWS CLI*.
### `list-cloud-front-origin-access-identities`
O código de exemplo a seguir mostra como usar `list-cloud-front-origin-access-identities`.
**AWS CLI**
**Para listar as identidades do acesso de origem do CloudFront**
O exemplo a seguir obtém uma lista das identidades do acesso de origem (OAIs) do CloudFront na sua conta da AWS:
```
aws cloudfront list-cloud-front-origin-access-identities
```
Resultado:
```
{
"CloudFrontOriginAccessIdentityList": {
"Items": [
{
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"Comment": "Example OAI"
},
{
"Id": "EH1HDMBEXAMPLE",
"S3CanonicalUserId": "1489f6f2e6faacaae7ff64c4c3e6956c24f78788abfc1718c3527c263bf7a17EXAMPLE",
"Comment": "Test OAI"
},
{
"Id": "E2X2C9TEXAMPLE",
"S3CanonicalUserId": "cbfeebb915a64749f9be546a45b3fcfd3a31c779673c13c4dd460911ae402c2EXAMPLE",
"Comment": "Example OAI #2"
}
]
}
}
```
+ Consulte detalhes da API em [ListCloudFrontOriginAccessIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-cloud-front-origin-access-identities.html) na *Referência de comandos da AWS CLI*.
### `list-connection-groups`
O código de exemplo a seguir mostra como usar `list-connection-groups`.
**AWS CLI**
**Como listar grupos de conexões**
O exemplo `list-connection-groups` a seguir lista os grupos de conexões disponíveis na sua conta da AWS.
```
aws cloudfront list-connection-groups
```
Resultado:
```
{
"ConnectionGroups": [
{
"Id": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"Name": "CreatedByCloudFront-cg_2whCJoXMYCjHcxaLGrkllvyABC",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2whCJoXMYCjHcxaLGrkllvyABC",
"RoutingEndpoint": "d3sx0pso7m5abc.cloudfront.net",
"CreatedTime": "2025-05-05T22:32:29.630000+00:00",
"LastModifiedTime": "2025-05-05T22:32:29.630000+00:00",
"ETag": "E23ZP02F085ABC",
"Enabled": true,
"Status": "Deployed",
"IsDefault": true
},
{
"Id": "cg_2wjDWTBKTlRB87cAaUQFaakABC",
"Name": "connection-group-2",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2wjDWTBKTlRB87cAaUQFaakABC",
"RoutingEndpoint": "dvdg9gprgabc.cloudfront.net",
"CreatedTime": "2025-05-06T15:42:00.790000+00:00",
"LastModifiedTime": "2025-05-06T15:42:00.790000+00:00",
"ETag": "E23ZP02F085ABC",
"Enabled": true,
"Status": "Deployed",
"IsDefault": false
}
]
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [ListConnectionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-connection-groups.html) na *Referência de comandos da AWS CLI*.
### `list-distribution-tenants-by-customization`
O código de exemplo a seguir mostra como usar `list-distribution-tenants-by-customization`.
**AWS CLI**
**Como listar locatários de distribuição por personalização**
O exemplo `list-distribution-tenants-by-customization` a seguir lista os locatários de distribuição que usam a ACL da web especificada.
```
aws cloudfront list-distribution-tenants-by-customization \
--web-acl-arn arn:aws:wafv2:us-east-1:123456789012:global/webacl/CreatedByCloudFront-0273cd2f/a3c19bce-42b5-48a1-a8d4-b2bb2f28eabc
```
Resultado:
```
{
"DistributionTenantList": [
{
"Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "example-tenant-2",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "inactive"
}
],
"ConnectionGroupId": "cg_2wjDWTBKTlRB87cAaUQFaakABC",
"Customizations": {
"WebAcl": {
"Action": "override",
"Arn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/CreatedByCloudFront-0273cd2f/a3c19bce-42b5-48a1-a8d4-b2bb2f28eabc"
},
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"AL"
]
}
},
"CreatedTime": "2025-05-06T15:42:28.542000+00:00",
"LastModifiedTime": "2025-05-06T16:14:08.710000+00:00",
"ETag": "E1F83G8C2ARABC",
"Enabled": true,
"Status": "Deployed"
}
]
}
```
Para ter mais informações, consulte [Personalizações de locatários da distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [ListDistributionTenantsByCustomization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants-by-customization.html) na *Referência de comandos da AWS CLI*.
### `list-distribution-tenants`
O código de exemplo a seguir mostra como usar `list-distribution-tenants`.
**AWS CLI**
**Como listar locatários de distribuição do CloudFront**
O exemplo `list-distribution-tenants` a seguir lista três locatários de distribuição do CloudFront em sua conta da AWS pelo grupo de conexões associado.
```
aws cloudfront list-distribution-tenants \
--association-filter ConnectionGroupId=cg_2whCJoXMYCjHcxaLGrkllvyABC \
--max-items 3
```
Resultado:
```
{
"DistributionTenantList": [
{
"Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "new-tenant-customizations",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMvQgam3QkJo2z54FDl91dk1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "active"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"Customizations": {
"WebAcl": {
"Action": "disable"
},
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"DE"
]
}
},
"CreatedTime": "2025-06-11T15:54:02.142000+00:00",
"LastModifiedTime": "2025-06-11T15:54:02.142000+00:00",
"ETag": "E23ZP02F085ABC",
"Enabled": false,
"Status": "Deployed"
},
{
"Id": "dt_2yMuV7NJuBcAB0cwwxMCBZQ1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "new-tenant",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMuV7NJuBcAB0cwwxMCBZQ1AB",
"Domains": [
{
"Domain": "1.example.com",
"Status": "active"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"Customizations": {
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"DE"
]
}
},
"CreatedTime": "2025-06-11T15:46:23.466000+00:00",
"LastModifiedTime": "2025-06-11T15:46:23.466000+00:00",
"ETag": "E23ZP02F085ABC",
"Enabled": false,
"Status": "Deployed"
},
{
"Id": "dt_2xVInRKCfUzQHgxosDs9hiLk1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "new-tenant-2",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2xVInRKCfUzQHgxosDs9hiLk1AB",
"Domains": [
{
"Domain": "2.example.com",
"Status": "active"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"CreatedTime": "2025-05-23T16:16:20.871000+00:00",
"LastModifiedTime": "2025-05-23T16:16:20.871000+00:00",
"ETag": "E23ZP02F085ABC",
"Enabled": false,
"Status": "Deployed"
}
],
"NextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAzfQ=="
}
```
Para obter mais informações, consulte [Understand how multi-tenant distributions work](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront Developer Guide*.
+ Para ver detalhes da API, consulte [ListDistributionTenants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants.html) na *Referência de comandos da AWS CLI*.
### `list-distributions-by-connection-mode`
O código de exemplo a seguir mostra como usar `list-distributions-by-connection-mode`.
**AWS CLI**
**Como distribuições do CloudFront por modo de conexão**
O exemplo `list-distributions-by-connection-mode` a seguir lista distribuições do CloudFront com o modo de conexão especificado.
```
aws cloudfront list-distributions-by-connection-mode \
--connection-mode tenant-only
```
Resultado:
```
{
"DistributionList": {
"Items": [
{
"Id": "E1XNX8R2GOAABC",
"ARN": "arn:aws:cloudfront::123456789012:distribution/E1XNX8R2GOAABC",
"ETag": "EPT4JPJQDY1ABC",
"Status": "Deployed",
"LastModifiedTime": "2025-05-23T16:16:15.691000+00:00",
"DomainName": "-",
"Aliases": {
"Quantity": 0
},
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "example-cfn-simple-distribution123",
"DomainName": "example.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
},
"ConnectionAttempts": 3,
"ConnectionTimeout": 10,
"OriginShield": {
"Enabled": false
},
"OriginAccessControlId": "E2CJRMB5LKEABC"
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "example-cfn-simple-distribution123",
"TrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"Compress": true,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": "",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e5abc",
"GrpcConfig": {
"Enabled": false
}
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": false,
"ACMCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc",
"SSLSupportMethod": "sni-only",
"MinimumProtocolVersion": "TLSv1.2_2021",
"Certificate": "arn:aws:acm:us-east-1:123456789012:certificate/ec53f564-ea5a-4e4a-a0a2-e3c989449abc",
"CertificateSource": "acm"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cabc",
"HttpVersion": "http2",
"IsIPV6Enabled": false,
"Staging": false,
"ConnectionMode": "tenant-only"
}
]
}
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [ListDistributionsByConnectionMode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions-by-connection-mode.html) na *Referência de comandos da AWS CLI*.
### `list-distributions`
O código de exemplo a seguir mostra como usar `list-distributions`.
**AWS CLI**
**Para listar as distribuições do CloudFront**
O exemplo a seguir obtém uma lista de distribuições do CloudFront em sua conta da AWS.
```
aws cloudfront list-distributions
```
Resultado:
```
{
"DistributionList": {
"Items": [
{
"Id": "E23YS8OEXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/E23YS8OEXAMPLE",
"Status": "Deployed",
"LastModifiedTime": "2024-08-05T18:23:40.375000+00:00",
"DomainName": "abcdefgh12ijk.cloudfront.net",
"Aliases": {
"Quantity": 0
},
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"DomainName": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
},
"ConnectionAttempts": 3,
"ConnectionTimeout": 10,
"OriginShield": {
"Enabled": false
},
"OriginAccessControlId": "EIAP8PEXAMPLE"
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com",
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"TrustedKeyGroups": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"Compress": true,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": "",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e886EXAMPLE"
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"SSLSupportMethod": "vip",
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "HTTP2",
"IsIPV6Enabled": true,
"Staging": false
}
]
}
}
```
+ Consulte detalhes da API em [ListDistributions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions.html) na *Referência de comandos da AWS CLI*.
### `list-domain-conflicts`
O código de exemplo a seguir mostra como usar `list-domain-conflicts`.
**AWS CLI**
**Como listar conflitos de domínio para uma distribuição do CloudFront**
O exemplo `list-domain-conflicts` a seguir lista conflitos de domínio para uma distribuição do CloudFront.
```
aws cloudfront list-domain-conflicts \
--domain example.com \
--domain-control-validation-resource "DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB"
```
Resultado:
```
{
"DomainConflicts": [
{
"Domain": "example.com",
"ResourceType": "distribution-tenant",
"ResourceId": "***************ohWzv1b9It8J1AB",
"AccountId": "123456789012"
}
]
}
```
Para ter mais informações, consulte [Mover um nome de domínio alternativo para uma distribuição diferente](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [ListDomainConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-domain-conflicts.html) na *Referência de comandos da AWS CLI*.
### `list-field-level-encryption-configs`
O código de exemplo a seguir mostra como usar `list-field-level-encryption-configs`.
**AWS CLI**
**Para listar as configurações de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém uma lista das configurações de criptografia no nível de campo do CloudFront na sua conta da AWS:
```
aws cloudfront list-field-level-encryption-configs
```
Resultado:
```
{
"FieldLevelEncryptionList": {
"MaxItems": 100,
"Quantity": 1,
"Items": [
{
"Id": "C3KM2WVD605UAY",
"LastModifiedTime": "2019-12-10T21:30:18.974Z",
"Comment": "Example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0,
"Items": []
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
]
}
}
```
+ Para ver detalhes da API, consulte [ListFieldLevelEncryptionConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-configs.html) na *Referência de comandos da AWS CLI*.
### `list-field-level-encryption-profiles`
O código de exemplo a seguir mostra como usar `list-field-level-encryption-profiles`.
**AWS CLI**
**Para listar perfis de criptografia no nível de campo do CloudFront**
O exemplo a seguir obtém uma lista dos perfis de criptografia no nível de campo do CloudFront na sua conta da AWS:
```
aws cloudfront list-field-level-encryption-profiles
```
Resultado:
```
{
"FieldLevelEncryptionProfileList": {
"MaxItems": 100,
"Quantity": 2,
"Items": [
{
"Id": "P280MFCLSYOCVU",
"LastModifiedTime": "2019-12-05T01:05:39.896Z",
"Name": "ExampleFLEProfile",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField"
]
}
}
]
},
"Comment": "FLE profile for AWS CLI example"
},
{
"Id": "PPK0UOSIF5WSV",
"LastModifiedTime": "2019-12-10T01:03:16.537Z",
"Name": "ExampleFLEProfile2",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2ABC10EXAMPLE",
"ProviderId": "ExampleFLEProvider2",
"FieldPatterns": {
"Quantity": 1,
"Items": [
"ExampleSensitiveField2"
]
}
}
]
},
"Comment": "FLE profile #2 for AWS CLI example"
}
]
}
}
```
+ Para ver detalhes da API, consulte [ListFieldLevelEncryptionProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-profiles.html) na *Referência de comandos da AWS CLI*.
### `list-invalidations-for-distribution-tenant`
O código de exemplo a seguir mostra como usar `list-invalidations-for-distribution-tenant`.
**AWS CLI**
**Como listar invalidações para um locatário de distribuição do CloudFront**
O exemplo `list-invalidations-for-distribution-tenant` a seguir lista invalidações para um locatário de distribuição do CloudFront.
```
aws cloudfront list-invalidations-for-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Resultado:
```
{
"InvalidationList": {
"Items": [
{
"Id": "I4CU23QAPKMUDUU06F9OFGFABC",
"CreateTime": "2025-05-06T15:46:12.824000+00:00",
"Status": "Completed"
}
]
}
}
```
Para ter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [ListInvalidationsForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations-for-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `list-invalidations`
O código de exemplo a seguir mostra como usar `list-invalidations`.
**AWS CLI**
**Para listar as invalidações do CloudFront**
O exemplo a seguir obtém uma lista das invalidações da distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`:
```
aws cloudfront list-invalidations --distribution-id EDFDVBD6EXAMPLE
```
Resultado:
```
{
"InvalidationList": {
"Marker": "",
"Items": [
{
"Status": "Completed",
"Id": "YNY2LI2BVJ4NJU",
"CreateTime": "2019-08-31T21:15:52.042Z"
}
],
"IsTruncated": false,
"MaxItems": 100,
"Quantity": 1
}
}
```
+ Para ver detalhes da API, consulte [ListInvalidations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations.html) na *Referência de comandos da AWS CLI*.
### `list-public-keys`
O código de exemplo a seguir mostra como usar `list-public-keys`.
**AWS CLI**
**Para listar as chaves públicas do CloudFront**
O seguinte exemplo obtém uma lista das chaves públicas do CloudFront em sua conta da AWS:
```
aws cloudfront list-public-keys
```
Resultado:
```
{
"PublicKeyList": {
"MaxItems": 100,
"Quantity": 2,
"Items": [
{
"Id": "K2K8NC4HVFE3M0",
"Name": "ExampleKey",
"CreatedTime": "2019-12-05T01:04:28.818Z",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxPMbCA2Ks0lnd7IR+3pw\nwd3H/7jPGwj8bLUmore7bX+oeGpZ6QmLAe/1UOWcmZX2u70dYcSIzB1ofZtcn4cJ\nenHBAzO3ohBY/L1tQGJfS2A+omnN6H16VZE1JCK8XSJyfze7MDLcUyHZETdxuvRb\nA9X343/vMAuQPnhinFJ8Wdy8YBXSPpy7r95ylUQd9LfYTBzVZYG2tSesplcOkjM3\n2Uu+oMWxQAw1NINnSLPinMVsutJy6ZqlV3McWNWe4T+STGtWhrPNqJEn45sIcCx4\nq+kGZ2NQ0FyIyT2eiLKOX5Rgb/a36E/aMk4VoDsaenBQgG7WLTnstb9sr7MIhS6A\nrwIDAQAB\n-----END PUBLIC KEY-----\n",
"Comment": "example public key"
},
{
"Id": "K1S0LWQ2L5HTBU",
"Name": "ExampleKey2",
"CreatedTime": "2019-12-09T23:28:11.110Z",
"EncodedKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApOCAg88A8+f4dujn9Izt\n26LxtgAkn2opGgo/NKpMiaisyw5qlg3f1gol7FV6pYNl78iJg3EO8JBbwtlH+cR9\nLGSf60NDeVhm76Oc39Np/vWgOdsGQcRbi9WmKZeSODqjQGzVZWqPmito3FzWVk6b\nfVY5N36U/RdbVAJm95Km+qaMYlbIdF40t72bi3IkKYV5hlB2XoDjlQ9F6ajQKyTB\nMHa3SN8q+3ZjQ4sJJ7D1V6r4wR8jDcFVD5NckWJmmgIVnkOQM37NYeoDnkaOuTpu\nha/+3b8tOb2z3LBVHPkp85zJRAOXacSwf5rZtPYKBNFsixTa2n55k2r218mOkMC4\nUwIDAQAB\n-----END PUBLIC KEY-----",
"Comment": "example public key #2"
}
]
}
}
```
+ Para ver detalhes da API, consulte [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-public-keys.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar tags para uma distribuição do CloudFront**
O seguinte exemplo obtém uma lista das tags de uma distribuição do CloudFront:
```
aws cloudfront list-tags-for-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE
```
Resultado:
```
{
"Tags": {
"Items": [
{
"Key": "DateCreated",
"Value": "2019-12-04"
},
{
"Key": "Name",
"Value": "Example name"
},
{
"Key": "Project",
"Value": "Example project"
}
]
}
}
```
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `sign`
O código de exemplo a seguir mostra como usar `sign`.
**AWS CLI**
**Como assinar um URL do CloudFront**
O exemplo a seguir assina um URL do CloudFront. Para assinar um URL, você precisa do ID do par de chaves (chamado de **ID da chave de acesso** no console de gerenciamento da AWS) e da chave privada do par de chaves do CloudFront do signatário confiável. Para obter mais informações sobre URLs assinados, consulte [Veicular conteúdo privado com URLs assinados e cookies assinados](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) no *Guia do desenvolvedor do Amazon CloudFront*.
```
aws cloudfront sign \
--url https://d111111abcdef8.cloudfront.net/private-content/private-file.html \
--key-pair-id APKAEIBAERJR2EXAMPLE \
--private-key file://cf-signer-priv-key.pem \
--date-less-than 2020-01-01
```
Resultado:
```
https://d111111abcdef8.cloudfront.net/private-content/private-file.html?Expires=1577836800&Signature=nEXK7Kby47XKeZQKVc6pwkif6oZc-JWSpDkH0UH7EBGGqvgurkecCbgL5VfUAXyLQuJxFwRQWscz-owcq9KpmewCXrXQbPaJZNi9XSNwf4YKurPDQYaRQawKoeenH0GFteRf9ELK-Bs3nljTLjtbgzIUt7QJNKXcWr8AuUYikzGdJ4-qzx6WnxXfH~fxg4-GGl6l2kgCpXUB6Jx6K~Y3kpVOdzUPOIqFLHAnJojbhxqrVejomZZ2XrquDvNUCCIbePGnR3d24UPaLXG4FKOqNEaWDIBXu7jUUPwOyQCvpt-GNvjRJxqWf93uMobeMOiVYahb-e0KItiQewGcm0eLZQ__&Key-Pair-Id=APKAEIBAERJR2EXAMPLE
```
+ Para ver detalhes da API, consulte [Sign](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/sign.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como marcar uma distribuição do CloudFront**
O exemplo `tag-resource` a seguir adiciona duas tags à distribuição do CloudFront especificada.
```
aws cloudfront tag-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \
--tags 'Items=[{Key=Name,Value="Example name"},{Key=Project,Value="Example project"}]'
```
Em vez de usar argumentos de linha de comando, forneça as tags em um arquivo JSON, conforme mostrado no seguinte exemplo:
```
aws cloudfront tag-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \
--tags file://tags.json
```
Conteúdo de `tags.json`:
```
{
"Items": [
{
"Key": "Name",
"Value": "Example name"
},
{
"Key": "Project",
"Value": "Example project"
}
]
}
```
Este comando não produz saída.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover tags de uma distribuição do CloudFront**
O exemplo a seguir remove duas tags de uma distribuição do CloudFront usando argumentos de linha de comando:
```
aws cloudfront untag-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \
--tag-keys Items=Name,Project
```
Em vez de usar argumentos de linha de comando, forneça as chaves de tag em um arquivo JSON, conforme mostrado no seguinte exemplo:
```
aws cloudfront untag-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE \
--tag-keys file://tag-keys.json
```
O arquivo `tag-keys.json` é um documento JSON na pasta atual que contém o seguinte:
```
{
"Items": [
"Name",
"Project"
]
}
```
Quando bem-sucedido, este comando não tem saída.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-cloud-front-origin-access-identity`
O código de exemplo a seguir mostra como usar `update-cloud-front-origin-access-identity`.
**AWS CLI**
**Para atualizar uma identidade do acesso de origem do CloudFront**
O exemplo a seguir atualiza a identidade do acesso de origem (OAI) com o ID `E74FTE3AEXAMPLE`. O único campo que você pode atualizar é `Comment` da OAI.
Para atualizar uma OAI, você deve ter o ID da OAI e a `ETag`. O ID da OAI é retornado na saída dos comandos create-cloud-front-origin-access-identity e list-cloud-front-origin-access-identities. Para obter a `ETag`, use o comando get-cloud-front-origin-access-identity ou get-cloud-front-origin-access-identity-config. Use a opção `--if-match` para fornecer a `ETag` da OAI.
```
aws cloudfront update-cloud-front-origin-access-identity \
--id E74FTE3AEXAMPLE \
--if-match E2QWRUHEXAMPLE \
--cloud-front-origin-access-identity-config \
CallerReference=cli-example,Comment="Example OAI Updated"
```
Você pode fazer o mesmo fornecendo a configuração da OAI em um arquivo JSON, conforme mostrado no exemplo a seguir:
```
aws cloudfront update-cloud-front-origin-access-identity \
--id E74FTE3AEXAMPLE \
--if-match E2QWRUHEXAMPLE \
--cloud-front-origin-access-identity-config file://OAI-config.json
```
O arquivo `OAI-config.json` é um documento JSON no diretório atual que contém o seguinte:
```
{
"CallerReference": "cli-example",
"Comment": "Example OAI Updated"
}
```
Se você fornecer a configuração da OAI com um argumento da linha de comando ou um arquivo JSON, a saída será a mesma:
```
{
"ETag": "E9LHASXEXAMPLE",
"CloudFrontOriginAccessIdentity": {
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI Updated"
}
}
}
```
+ Para ver detalhes da API, consulte [UpdateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-cloud-front-origin-access-identity.html) na *Referência de comandos da AWS CLI*.
### `update-connection-group`
O código de exemplo a seguir mostra como usar `update-connection-group`.
**AWS CLI**
**Como atualizar um grupo de conexões do CloudFront**
O exemplo `update-connection-group` a seguir desabilita um grupo de conexões do CloudFront e o IPv6.
```
aws cloudfront update-connection-group \
--id cg_2yHsDkcPKeUlVkk3aEgLKcjABC \
--no-ipv6-enabled \
--no-enabled \
--if-match E3UN6WX5RRO2ABC
```
Resultado:
```
{
"ETag": "E1F83G8C2ARABC",
"ConnectionGroup": {
"Id": "cg_2yHsDkcPKeUlVkk3aEgLKcjABC",
"Name": "cg-example",
"Arn": "arn:aws:cloudfront::123456789012:connection-group/cg_2yHsDkcPKeUlVkk3aEgLKcjABC",
"CreatedTime": "2025-06-09T20:58:35.481000+00:00",
"LastModifiedTime": "2025-06-11T16:25:54.280000+00:00",
"Ipv6Enabled": false,
"RoutingEndpoint": "du9xp1elo1abc.cloudfront.net",
"Status": "InProgress",
"Enabled": false,
"IsDefault": false
}
}
```
Para ter mais informações, consulte [Criar grupo de conexões personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [UpdateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-connection-group.html) na *Referência de comandos da AWS CLI*.
### `update-distribution-tenant`
O código de exemplo a seguir mostra como usar `update-distribution-tenant`.
**AWS CLI**
**Como atualizar um locatário de distribuição do CloudFront**
O exemplo `update-distribution-tenant` a seguir atualiza um locatário de distribuição do CloudFront com um novo valor de parâmetro e adiciona um país às restrições geográficas.
```
aws cloudfront update-distribution-tenant \
--cli-input-json file://update-tenant.json
```
Conteúdo de `update-tenant.json`:
```
{
"Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB",
"IfMatch": "E1F83G8C2ARABC",
"Parameters": [
{
"Name": "testParam",
"Value": "newParameterValue"
}
],
"Customizations": {
"WebAcl": {
"Action": "disable"
},
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"DE",
"GB",
"ES"
]
}
}
}
```
Resultado:
```
{
"ETag": "E1PA6795UKMABC",
"DistributionTenant": {
"Id": "dt_2yMvQgam3QkJo2z54FDl91dk1AB",
"DistributionId": "E1XNX8R2GOAABC",
"Name": "new-tenant-customizations",
"Arn": "arn:aws:cloudfront::123456789012:distribution-tenant/dt_2yMvQgam3QkJo2z54FDl91dk1AB",
"Domains": [
{
"Domain": "example.com",
"Status": "active"
}
],
"Customizations": {
"WebAcl": {
"Action": "disable"
},
"GeoRestrictions": {
"RestrictionType": "whitelist",
"Locations": [
"DE",
"ES",
"GB"
]
}
},
"Parameters": [
{
"Name": "testParam",
"Value": "newParameterValue"
}
],
"ConnectionGroupId": "cg_2whCJoXMYCjHcxaLGrkllvyABC",
"CreatedTime": "2025-06-11T15:54:02.142000+00:00",
"LastModifiedTime": "2025-06-11T16:42:45.531000+00:00",
"Enabled": false,
"Status": "InProgress"
}
}
```
Para ter mais informações, consulte [Personalizações de locatários da distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [UpdateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution-tenant.html) na *Referência de comandos da AWS CLI*.
### `update-distribution`
O código de exemplo a seguir mostra como usar `update-distribution`.
**AWS CLI**
**Exemplo 1: como atualizar o objeto raiz padrão de uma distribuição do CloudFront**
O exemplo a seguir atualiza o objeto raiz padrão para `index.html` para a distribuição do CloudFront com o ID `EDFDVBD6EXAMPLE`.
```
aws cloudfront update-distribution \
--id EDFDVBD6EXAMPLE \
--default-root-object index.html
```
Resultado:
```
{
"ETag": "E2QWRUHEXAMPLE",
"Distribution": {
"Id": "EDFDVBD6EXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE",
"Status": "InProgress",
"LastModifiedTime": "2019-12-06T18:55:39.870Z",
"InProgressInvalidationBatches": 0,
"DomainName": "d111111abcdef8.cloudfront.net",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "6b10378d-49be-4c4b-a642-419ccaf8f3b5",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "example-website",
"DomainName": "www.example.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"CustomOriginConfig": {
"HTTPPort": 80,
"HTTPSPort": 443,
"OriginProtocolPolicy": "match-viewer",
"OriginSslProtocols": {
"Quantity": 2,
"Items": [
"SSLv3",
"TLSv1"
]
},
"OriginReadTimeout": 30,
"OriginKeepaliveTimeout": 5
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "example-website",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 1,
"Items": [
"*"
]
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": true,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http1.1",
"IsIPV6Enabled": true
}
}
}
```
**Exemplo 2: como atualizar uma distribuição do CloudFront**
O exemplo a seguir desabilita a distribuição do CloudFront com o ID `EMLARXS9EXAMPLE` fornecendo a configuração de distribuição em um arquivo JSON chamado `dist-config-disable.json`. Para atualizar uma distribuição, use a opção `--if-match` para fornecer o `ETag` da distribuição. Use o comando get-distribution ou get-distribution-config para obter o `ETag`. Observe que o campo `Enabled` está definido como `false` no arquivo JSON.
Depois de usar o exemplo a seguir para desabilitar uma distribuição, use o comando delete-distribution para exclui-la.
```
aws cloudfront update-distribution \
--id EMLARXS9EXAMPLE \
--if-match E2QWRUHEXAMPLE \
--distribution-config file://dist-config-disable.json
```
Conteúdo de `dist-config-disable.json`:
```
{
"CallerReference": "cli-1574382155-496510",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": false,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
```
Resultado:
```
{
"ETag": "E9LHASXEXAMPLE",
"Distribution": {
"Id": "EMLARXS9EXAMPLE",
"ARN": "arn:aws:cloudfront::123456789012:distribution/EMLARXS9EXAMPLE",
"Status": "InProgress",
"LastModifiedTime": "2019-12-06T18:32:35.553Z",
"InProgressInvalidationBatches": 0,
"DomainName": "d111111abcdef8.cloudfront.net",
"ActiveTrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"DistributionConfig": {
"CallerReference": "cli-1574382155-496510",
"Aliases": {
"Quantity": 0
},
"DefaultRootObject": "index.html",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939",
"DomainName": "amzn-s3-demo-bucket.s3.amazonaws.com",
"OriginPath": "",
"CustomHeaders": {
"Quantity": 0
},
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
}
]
},
"OriginGroups": {
"Quantity": 0
},
"DefaultCacheBehavior": {
"TargetOriginId": "amzn-s3-demo-bucket---s3.amazonaws.com.rproxy.goskope.com-1574382155-273939",
"ForwardedValues": {
"QueryString": false,
"Cookies": {
"Forward": "none"
},
"Headers": {
"Quantity": 0
},
"QueryStringCacheKeys": {
"Quantity": 0
}
},
"TrustedSigners": {
"Enabled": false,
"Quantity": 0
},
"ViewerProtocolPolicy": "allow-all",
"MinTTL": 0,
"AllowedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"HEAD",
"GET"
]
}
},
"SmoothStreaming": false,
"DefaultTTL": 86400,
"MaxTTL": 31536000,
"Compress": false,
"LambdaFunctionAssociations": {
"Quantity": 0
},
"FieldLevelEncryptionId": ""
},
"CacheBehaviors": {
"Quantity": 0
},
"CustomErrorResponses": {
"Quantity": 0
},
"Comment": "",
"Logging": {
"Enabled": false,
"IncludeCookies": false,
"Bucket": "",
"Prefix": ""
},
"PriceClass": "PriceClass_All",
"Enabled": false,
"ViewerCertificate": {
"CloudFrontDefaultCertificate": true,
"MinimumProtocolVersion": "TLSv1",
"CertificateSource": "cloudfront"
},
"Restrictions": {
"GeoRestriction": {
"RestrictionType": "none",
"Quantity": 0
}
},
"WebACLId": "",
"HttpVersion": "http2",
"IsIPV6Enabled": true
}
}
}
```
+ Consulte detalhes da API em [UpdateDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution.html) na *Referência de comandos da AWS CLI*.
### `update-domain-association`
O código de exemplo a seguir mostra como usar `update-domain-association`.
**AWS CLI**
**Como atualizar uma associação de domínio**
O exemplo `update-domain-association` a seguir atualiza uma associação de domínio para um locatário de distribuição com a ETag `E23ZP02F085ABC`.
```
aws cloudfront update-domain-association \
--domain example.com \
--target-resource DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB \
--if-match E23ZP02F085ABC
```
Resultado:
```
{
"ETag": "ETVPDKIKX0ABC",
"Domain": "example.com",
"ResourceId": "dt_2x9GhoK0TZRsohWzv1b9It8J1AB"
}
```
Para ter mais informações, consulte [Mover um nome de domínio alternativo para uma distribuição diferente](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [UpdateDomainAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-domain-association.html) na *Referência de comandos da AWS CLI*.
### `update-field-level-encryption-config`
O código de exemplo a seguir mostra como usar `update-field-level-encryption-config`.
**AWS CLI**
**Para atualizar uma configuração de criptografia no nível de campo do CloudFront**
O exemplo a seguir atualiza o campo `Comment` da configuração de criptografia no nível de campo com o ID `C3KM2WVD605UAY` fornecendo os parâmetros em um arquivo JSON.
Para atualizar uma configuração de criptografia no nível de campo, você deve ter o ID da configuração e a `ETag`. O ID é retornado na saída dos comandos create-field-level-encryption-config e list-field-level-encryption-configs. Para obter a `ETag`, use o comando get-field-level-encryption ou get-field-level-encryption-config. Use a opção `--if-match` para fornecer a `ETag` das configurações.
```
aws cloudfront update-field-level-encryption-config \
--id C3KM2WVD605UAY \
--if-match E2P4Z4VU7TY5SG \
--field-level-encryption-config file://fle-config.json
```
O arquivo `fle-config.json` é um documento JSON no diretório atual que contém o seguinte:
```
{
"CallerReference": "cli-example",
"Comment": "Updated example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
```
Resultado:
```
{
"ETag": "E26M4BIAV81ZF6",
"FieldLevelEncryption": {
"Id": "C3KM2WVD605UAY",
"LastModifiedTime": "2019-12-10T22:26:26.170Z",
"FieldLevelEncryptionConfig": {
"CallerReference": "cli-example",
"Comment": "Updated example FLE configuration",
"QueryArgProfileConfig": {
"ForwardWhenQueryArgProfileIsUnknown": true,
"QueryArgProfiles": {
"Quantity": 0,
"Items": []
}
},
"ContentTypeProfileConfig": {
"ForwardWhenContentTypeIsUnknown": true,
"ContentTypeProfiles": {
"Quantity": 1,
"Items": [
{
"Format": "URLEncoded",
"ProfileId": "P280MFCLSYOCVU",
"ContentType": "application/x-www-form-urlencoded"
}
]
}
}
}
}
}
```
+ Para ver detalhes da API, consulte [UpdateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-config.html) na *Referência de comandos da AWS CLI*.
### `update-field-level-encryption-profile`
O código de exemplo a seguir mostra como usar `update-field-level-encryption-profile`.
**AWS CLI**
**Para atualizar um perfil de criptografia no nível de campo do CloudFront**
O exemplo a seguir atualiza o perfil de criptografia no nível de campo com o ID `PPK0UOSIF5WSV`. Este exemplo atualiza o `Name` e o `Comment` do perfil e adiciona um segundo item `FieldPatterns`, fornecendo os parâmetros em um arquivo JSON.
Para atualizar um perfil de criptografia no nível de campo, você deve ter o ID e a `ETag` do perfil. O ID é retornado na saída dos comandos create-field-level-encryption-profile e list-field-level-encryption-profiles. Para obter a `ETag`, use o comando get-field-level-encryption-profile ou get-field-level-encryption-profile-config. Use a opção `--if-match` para fornecer a `ETag` do perfil.
```
aws cloudfront update-field-level-encryption-profile \
--id PPK0UOSIF5WSV \
--if-match E1QQG65FS2L2GC \
--field-level-encryption-profile-config file://fle-profile-config.json
```
O arquivo `fle-profile-config.json` é um documento JSON no diretório atual que contém o seguinte:
```
{
"Name": "ExampleFLEProfileUpdated",
"CallerReference": "cli-example",
"Comment": "Updated FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 2,
"Items": [
"ExampleSensitiveField",
"SecondExampleSensitiveField"
]
}
}
]
}
}
```
Resultado:
```
{
"ETag": "EJETYFJ9CL66D",
"FieldLevelEncryptionProfile": {
"Id": "PPK0UOSIF5WSV",
"LastModifiedTime": "2019-12-10T19:05:58.296Z",
"FieldLevelEncryptionProfileConfig": {
"Name": "ExampleFLEProfileUpdated",
"CallerReference": "cli-example",
"Comment": "Updated FLE profile for AWS CLI example",
"EncryptionEntities": {
"Quantity": 1,
"Items": [
{
"PublicKeyId": "K2K8NC4HVFE3M0",
"ProviderId": "ExampleFLEProvider",
"FieldPatterns": {
"Quantity": 2,
"Items": [
"ExampleSensitiveField",
"SecondExampleSensitiveField"
]
}
}
]
}
}
}
}
```
+ Para ver detalhes da API, consulte [UpdateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-profile.html) na *Referência de comandos da AWS CLI*.
### `verify-dns-configuration`
O código de exemplo a seguir mostra como usar `verify-dns-configuration`.
**AWS CLI**
**Como verificar a configuração de DNS de um domínio**
O exemplo `verify-dns-configuration` a seguir verifica a configuração de DNS de um domínio.
```
aws cloudfront verify-dns-configuration \
--domain example.com \
--identifier dt_2x9GhoK0TZRsohWzv1b9It8J1AB
```
Resultado:
```
{
"DnsConfigurationList": [
{
"Domain": "example.com",
"Status": "valid-configuration"
}
]
}
```
Para ter mais informações, consulte [Mover um nome de domínio alternativo para uma distribuição diferente](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/alternate-domain-names-move.html) no *Guia do desenvolvedor do Amazon CloudFront*.
+ Para ver detalhes da API, consulte [VerifyDnsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/verify-dns-configuration.html) na *Referência de comandos da AWS CLI*.