Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# CloudFront exemplos usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with 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**
**Para associar uma ACL da web a um inquilino CloudFront de distribuição**
O `associate-distribution-tenant-web-acl` exemplo a seguir associa uma ACL da web a uma CloudFront distribuição com. 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
```
Saída:
```
{
"ETag": "E1VC38T7YXBABC",
"Id": "dt_2wjDZi3hD1ivOXf6rpZJO1AB",
"WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f37123ABC"
}
```
Para obter mais informações, consulte [Usar proteções AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [AssociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-tenant-web-acl.html)em *Referência de AWS CLI Comandos*.
### `associate-distribution-web-acl`
O código de exemplo a seguir mostra como usar `associate-distribution-web-acl`.
**AWS CLI**
**Para associar uma ACL da web a uma distribuição CloudFront **
O `associate-distribution-web-acl` exemplo a seguir associa uma ACL da web a uma CloudFront distribuição.
```
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
```
Saída:
```
{
"ETag": "E3QE7ED60U0ABC",
"Id": "E1XNX8R2GOAABC",
"WebACLArn": "arn:aws:wafv2:us-east-1:123456789012:global/webacl/web-global-example/626900da-5f64-418b-ba9b-743f3746cABC"
}
```
Para obter mais informações, consulte [Usar proteções AWS WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-awswaf.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [AssociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/associate-distribution-web-acl.html)em *Referência de AWS CLI Comandos*.
### `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 de acesso de CloudFront origem**
O exemplo a seguir cria uma identidade de acesso de CloudFront origem (OAI) fornecendo a configuração da OAI como um argumento de 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 obter detalhes da API, consulte [CreateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-cloud-front-origin-access-identity.html)em *Referência de AWS CLI Comandos*.
### `create-connection-group`
O código de exemplo a seguir mostra como usar `create-connection-group`.
**AWS CLI**
**Para criar um grupo de conexão no CloudFront**
O `create-connection-group` exemplo a seguir cria um grupo de conexão ativado, especifica uma lista de IPs estáticos do Anycast e desativa. 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}]"
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [CreateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-connection-group.html)em *Referência de AWS CLI Comandos*.
### `create-distribution-tenant`
O código de exemplo a seguir mostra como usar `create-distribution-tenant`.
**AWS CLI**
**Exemplo 1: Para criar um inquilino de CloudFront distribuição que usa um certificado personalizado**
O `create-distribution-tenant` exemplo a seguir cria um inquilino de CloudFront distribuição que especifica personalizações para desativar 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"
}
}
}
```
Saída:
```
{
"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"
}
```
Saída:
```
{
"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: Para criar um inquilino CloudFront de distribuição usando um token de CloudFront validação -hosted**
O `create-distribution-tenant` exemplo a seguir cria um inquilino de distribuição e usa um token de validação CloudFront -hosted 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 a solicitação CloudFront possa ser concluída com êxito.
Saída:
```
{
"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: Para criar um inquilino CloudFront de distribuição usando um token de validação auto-hospedado**
O `create-distribution-tenant` exemplo a seguir cria um inquilino CloudFront de distribuição 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"
}
}
```
Saída:
```
{
"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 *Amazon CloudFront Developer* Guide.
Para obter mais informações sobre a criação de inquilinos de distribuição, consulte [Criar uma distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [CreateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `create-distribution-with-tags`
O código de exemplo a seguir mostra como usar `create-distribution-with-tags`.
**AWS CLI**
**Para criar uma CloudFront distribuição 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
}
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateDistributionWithTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution-with-tags.html)em *Referência de AWS CLI Comandos*.
### `create-distribution`
O código de exemplo a seguir mostra como usar `create-distribution`.
**AWS CLI**
**Exemplo 1: Para criar uma CloudFront distribuição**
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
```
Saída:
```
{
"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: Para criar uma CloudFront distribuição 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: Para criar uma distribuição CloudFront multilocatária com um certificado**
O `create-distribution` exemplo a seguir cria uma CloudFront distribuição 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
}
}
}
]
}
}
```
Saída:
```
{
"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 Como [trabalhar com distribuições](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) no *Amazon CloudFront Developer Guide*.
**Exemplo 4: Para criar uma distribuição CloudFront multilocatária sem um certificado**
O `create-distribution` exemplo a seguir cria uma CloudFront distribuição 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
}
}
}
]
}
}
```
Saída:
```
{
"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 obter mais informações, consulte [Configurar distribuições](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [CreateDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-distribution.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
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 criptografia em CloudFront nível de campo, consulte [Usando criptografia em nível de campo para ajudar a proteger dados confidenciais no](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) Amazon Developer Guide. 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"
}
]
}
}
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-config.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
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 em nível de campo, você deve ter uma chave CloudFront pública. Para criar uma chave CloudFront pública, consulte o create-public-key comando.
*Para obter mais informações sobre criptografia em CloudFront nível de campo, consulte [Usando criptografia em nível de campo para ajudar a proteger dados confidenciais no](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html) Amazon Developer Guide. 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"
]
}
}
]
}
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-field-level-encryption-profile.html)em *Referência de AWS CLI Comandos*.
### `create-invalidation-for-distribution-tenant`
O código de exemplo a seguir mostra como usar `create-invalidation-for-distribution-tenant`.
**AWS CLI**
**Para criar uma CloudFront invalidação para um inquilino de distribuição**
O `create-invalidation-for-distribution-tenant` exemplo a seguir cria uma invalidação para todos os arquivos em um locatário CloudFront de distribuição.
```
aws cloudfront create-invalidation-for-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJO1AB \
--invalidation-batch '{"Paths": {"Quantity": 1, "Items": ["/*"]}, "CallerReference": "invalidation-$(date +%s)"}'
```
Saída:
```
{
"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 obter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Amazon CloudFront Developer* Guide.
+ Para obter detalhes da API, consulte [CreateInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation-for-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `create-invalidation`
O código de exemplo a seguir mostra como usar `create-invalidation`.
**AWS CLI**
**Para criar uma invalidação para uma distribuição CloudFront **
O `create-invalidation` exemplo a seguir cria uma invalidação para os arquivos especificados na CloudFront distribuição especificada:
```
aws cloudfront create-invalidation \
--distribution-id EDFDVBD6EXAMPLE \
--paths "/example-path/example-file.jpg" "/example-path/example-file2.png"
```
Saída:
```
{
"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 aleatório. `CallerReference` 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"
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateInvalidation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-invalidation.html)em *Referência de AWS CLI Comandos*.
### `create-public-key`
O código de exemplo a seguir mostra como usar `create-public-key`.
**AWS CLI**
**Para criar uma chave CloudFront pública**
O exemplo a seguir cria uma chave CloudFront pública 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 RSA](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/field-level-encryption.html#field-level-encryption-setting-up-step1) no *Amazon CloudFront Developer Guide*.
```
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"
}
```
Saída:
```
{
"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"
}
}
}
```
+ Para obter detalhes da API, consulte [CreatePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/create-public-key.html)em *Referência de AWS CLI Comandos*.
### `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 de acesso de CloudFront origem**
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 do OAI é retornado na saída dos comandos create-cloud-front-origin -access-identity e -access-identities. list-cloud-front-origin Para obter o`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 obter detalhes da API, consulte [DeleteCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-cloud-front-origin-access-identity.html)em *Referência de AWS CLI Comandos*.
### `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ão deve estar desativado e não pode ser associado a nenhum CloudFront recurso.
```
aws cloudfront delete-connection-group \
--id cg_2wjLpjbHkLUdhWAjHllcOeABC \
--if-match ETVPDKIKX0DABC
```
Quando bem-sucedido, este comando não tem saída.
Para obter mais informações sobre o gerenciamento de grupos de conexão, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [DeleteConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-connection-group.html)em *Referência de AWS CLI Comandos*.
### `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 `delete-distribution-tenant` exemplo a seguir exclui um inquilino de distribuição com. ETag `ETVPDKIKX0DABC` O inquilino da distribuição deve estar desativado e não pode ser associado a nenhum CloudFront recurso.
```
aws cloudfront delete-distribution-tenant \
--id dt_2wjMUbg3NHZEQ7OfoalP5zi1AB \
--if-match ETVPDKIKX0DABC
```
Quando bem-sucedido, este comando não tem saída.
Para obter mais informações, consulte [Excluir uma distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [DeleteDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `delete-distribution`
O código de exemplo a seguir mostra como usar `delete-distribution`.
**AWS CLI**
**Para excluir uma CloudFront distribuição**
O exemplo a seguir exclui a CloudFront distribuição 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. Para obter o`ETag`, use o comando get-distribution ouget-distribution-config .
```
aws cloudfront delete-distribution \
--id EDFDVBD6EXAMPLE \
--if-match E2QWRUHEXAMPLE
```
Quando bem-sucedido, este comando não tem saída.
+ Para obter detalhes da API, consulte [DeleteDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-distribution.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir exclui a configuração de criptografia CloudFront em nível de campo 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 o`ETag`, use o comando get-field-level-encryption or 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 obter detalhes da API, consulte [DeleteFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-config.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir exclui o perfil de criptografia CloudFront em nível de campo 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 o`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 obter detalhes da API, consulte [DeleteFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-field-level-encryption-profile.html)em *Referência de AWS CLI Comandos*.
### `delete-public-key`
O código de exemplo a seguir mostra como usar `delete-public-key`.
**AWS CLI**
**Para excluir uma chave CloudFront pública**
O exemplo a seguir exclui a chave CloudFront pública com o ID`KDFB19YGCR002`. Para excluir uma chave pública, você deve ter seu ID e `ETag`. O ID é retornado na saída dos list-public-keys comandos create-public-key e. Para obter o`ETag`, use o get-public-key-config comando get-public-key or. 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 obter detalhes da API, consulte [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/delete-public-key.html)em *Referência de AWS CLI Comandos*.
### `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 `disassociate-distribution-tenant-web-acl` exemplo a seguir dissocia uma Web ACL de um locatário de distribuição com. ETag `E1PA6795UKMABC`
```
aws cloudfront disassociate-distribution-tenant-web-acl \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB \
--if-match E1PA6795UKMABC
```
Saída:
```
{
"ETag": "E13V1IB3VIYABC",
"Id": "dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB"
}
```
Para obter mais informações, consulte [Desativar as proteções de segurança AWS do WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [DisassociateDistributionTenantWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-tenant-web-acl.html)em *Referência de AWS CLI Comandos*.
### `disassociate-distribution-web-acl`
O código de exemplo a seguir mostra como usar `disassociate-distribution-web-acl`.
**AWS CLI**
**Para desassociar uma Web ACL de uma distribuição CloudFront **
O `disassociate-distribution-web-acl` exemplo a seguir remove a associação entre uma ACL da web e uma CloudFront distribuição com ETag `E13V1IB3VIYABC`.
```
aws cloudfront disassociate-distribution-web-acl \
--id E1XNX8R2GOAABC \
--if-match EEZQ9Z24VM1ABC
```
Saída:
```
{
"ETag": "E2YWS1C2J3OABC",
"Id": "E1XNX8R2GOAABC"
}
```
Para obter mais informações, consulte [Desativar as proteções de segurança AWS do WAF](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/disable-waf.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [DisassociateDistributionWebAcl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/disassociate-distribution-web-acl.html)em *Referência de AWS CLI Comandos*.
### `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**
**Para obter uma configuração de identidade de acesso de CloudFront origem**
O exemplo a seguir obtém metadados sobre a identidade de acesso de CloudFront origem (OAI) com o ID`E74FTE3AEXAMPLE`, incluindo seu. `ETag` O ID do OAI é retornado na saída dos comandos create-cloud-front-origin -access-identity e -access-identities. list-cloud-front-origin
```
aws cloudfront get-cloud-front-origin-access-identity-config --id E74FTE3AEXAMPLE
```
Saída:
```
{
"ETag": "E2QWRUHEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
}
```
+ Para obter detalhes da API, consulte [GetCloudFrontOriginAccessIdentityConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity-config.html)em *Referência de AWS CLI Comandos*.
### `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 de acesso de CloudFront origem**
O exemplo a seguir obtém a identidade de acesso de CloudFront origem (OAI) com a ID`E74FTE3AEXAMPLE`, incluindo sua `ETag` e a ID canônica associada do S3. O ID do OAI é retornado na saída dos comandos create-cloud-front-origin -access-identity e -access-identities. list-cloud-front-origin
```
aws cloudfront get-cloud-front-origin-access-identity --id E74FTE3AEXAMPLE
```
Saída:
```
{
"ETag": "E2QWRUHEXAMPLE",
"CloudFrontOriginAccessIdentity": {
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"CloudFrontOriginAccessIdentityConfig": {
"CallerReference": "cli-example",
"Comment": "Example OAI"
}
}
}
```
+ Para obter detalhes da API, consulte [GetCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-cloud-front-origin-access-identity.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [GetConnectionGroupByRoutingEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group-by-routing-endpoint.html)em *Referência de AWS CLI Comandos*.
### `get-connection-group`
O código de exemplo a seguir mostra como usar `get-connection-group`.
**AWS CLI**
**Para obter um grupo de CloudFront conexão**
O `get-connection-group` exemplo a seguir recupera informações sobre um grupo de CloudFront conexão.
```
aws cloudfront get-connection-group \
--identifier cg_2wjDWTBKTlRB87cAaUQFaakABC
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [GetConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-connection-group.html)em *Referência de AWS CLI Comandos*.
### `get-distribution-config`
O código de exemplo a seguir mostra como usar `get-distribution-config`.
**AWS CLI**
**Para obter uma configuração CloudFront de distribuição**
O exemplo a seguir obtém metadados sobre a CloudFront distribuição com o ID`EDFDVBD6EXAMPLE`, incluindo seu`ETag`. O ID de distribuição é retornado nos comandos create-distribution e list-distributions.
```
aws cloudfront get-distribution-config \
--id EDFDVBD6EXAMPLE
```
Saída:
```
{
"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
}
}
```
+ Para obter detalhes da API, consulte [GetDistributionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-config.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 [Entenda como as distribuições multilocatárias funcionam](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront * Developer Guide.
+ Para obter detalhes da API, consulte [GetDistributionTenantByDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant-by-domain.html)em *Referência de AWS CLI Comandos*.
### `get-distribution-tenant`
O código de exemplo a seguir mostra como usar `get-distribution-tenant`.
**AWS CLI**
**Para obter detalhes sobre um inquilino CloudFront de distribuição**
O `get-distribution-tenant` exemplo a seguir recupera informações sobre um inquilino CloudFront de distribuição.
```
aws cloudfront get-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Saída:
```
{
"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 [Entenda como as distribuições multilocatárias funcionam](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront * Developer Guide.
+ Para obter detalhes da API, consulte [GetDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `get-distribution`
O código de exemplo a seguir mostra como usar `get-distribution`.
**AWS CLI**
**Para obter uma CloudFront distribuição**
O `get-distribution` exemplo a seguir obtém a CloudFront distribuição com o ID`EDFDVBD6EXAMPLE`, incluindo seu`ETag`. O ID de distribuição é retornado nos comandos create-distribution e list-distributions.
```
aws cloudfront get-distribution \
--id EDFDVBD6EXAMPLE
```
Saída:
```
{
"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
}
}
}
```
+ Para obter detalhes da API, consulte [GetDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-distribution.html)em *Referência de AWS CLI Comandos*.
### `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 em CloudFront nível de campo**
O exemplo a seguir obtém metadados sobre a configuração de criptografia CloudFront em nível de campo com o ID`C3KM2WVD605UAY`, incluindo seu: `ETag`
```
aws cloudfront get-field-level-encryption-config --id C3KM2WVD605UAY
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-config.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront perfil de criptografia em nível de campo**
O exemplo a seguir obtém metadados sobre o perfil de criptografia CloudFront em nível de campo com ID`PPK0UOSIF5WSV`, incluindo seu: `ETag`
```
aws cloudfront get-field-level-encryption-profile-config --id PPK0UOSIF5WSV
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFieldLevelEncryptionProfileConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile-config.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir obtém o perfil de criptografia CloudFront em nível de campo com ID`PPK0UOSIF5WSV`, incluindo seu: `ETag`
```
aws cloudfront get-field-level-encryption-profile --id PPK0UOSIF5WSV
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption-profile.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir obtém a configuração de criptografia CloudFront em nível de campo com o ID`C3KM2WVD605UAY`, incluindo seu: `ETag`
```
aws cloudfront get-field-level-encryption --id C3KM2WVD605UAY
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFieldLevelEncryption](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-field-level-encryption.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Amazon CloudFront Developer* Guide.
+ Para obter detalhes da API, consulte [GetInvalidationForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation-for-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `get-invalidation`
O código de exemplo a seguir mostra como usar `get-invalidation`.
**AWS CLI**
**Para obter uma CloudFront invalidação**
O exemplo a seguir obtém a invalidação com o ID `I2J0I21PCUYOIK` para a CloudFront distribuição com o ID: `EDFDVBD6EXAMPLE`
```
aws cloudfront get-invalidation --id I2J0I21PCUYOIK --distribution-id EDFDVBD6EXAMPLE
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetInvalidation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-invalidation.html)em *Referência de AWS CLI Comandos*.
### `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 `get-managed-certificate-details` exemplo a seguir recupera os detalhes de um certificado ACM CloudFront gerenciado.
```
aws cloudfront get-managed-certificate-details \
--identifier dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Saída:
```
{
"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 obter mais informações, consulte [Solicitar certificados para seu locatário CloudFront de distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/managed-cloudfront-certificates.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [GetManagedCertificateDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-managed-certificate-details.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront pública**
O exemplo a seguir obtém metadados sobre a chave CloudFront pública com o ID`KDFB19YGCR002`, incluindo seu`ETag`. O ID da chave pública é retornado nos list-public-keys comandos create-public-key e.
```
aws cloudfront get-public-key-config --id KDFB19YGCR002
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetPublicKeyConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key-config.html)em *Referência de AWS CLI Comandos*.
### `get-public-key`
O código de exemplo a seguir mostra como usar `get-public-key`.
**AWS CLI**
**Para obter uma chave CloudFront pública**
O exemplo a seguir obtém a chave CloudFront pública com o ID`KDFB19YGCR002`, incluindo seu`ETag`. O ID da chave pública é retornado nos list-public-keys comandos create-public-key e.
```
aws cloudfront get-public-key --id KDFB19YGCR002
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/get-public-key.html)em *Referência de AWS CLI Comandos*.
### `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 identidades de acesso de CloudFront origem**
O exemplo a seguir obtém uma lista das identidades de acesso de CloudFront origem (OAIs) em sua AWS conta:
```
aws cloudfront list-cloud-front-origin-access-identities
```
Saída:
```
{
"CloudFrontOriginAccessIdentityList": {
"Items": [
{
"Id": "E74FTE3AEXAMPLE",
"S3CanonicalUserId": "cd13868f797c227fbea2830611a26fe0a21ba1b826ab4bed9b7771c9aEXAMPLE",
"Comment": "Example OAI"
},
{
"Id": "EH1HDMBEXAMPLE",
"S3CanonicalUserId": "1489f6f2e6faacaae7ff64c4c3e6956c24f78788abfc1718c3527c263bf7a17EXAMPLE",
"Comment": "Test OAI"
},
{
"Id": "E2X2C9TEXAMPLE",
"S3CanonicalUserId": "cbfeebb915a64749f9be546a45b3fcfd3a31c779673c13c4dd460911ae402c2EXAMPLE",
"Comment": "Example OAI #2"
}
]
}
}
```
+ Para obter detalhes da API, consulte [ListCloudFrontOriginAccessIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-cloud-front-origin-access-identities.html)em *Referência de AWS CLI Comandos*.
### `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 `list-connection-groups` exemplo a seguir lista os grupos de conexão disponíveis na sua AWS conta.
```
aws cloudfront list-connection-groups
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [ListConnectionGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-connection-groups.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter mais informações, consulte [Personalizações de locatários de distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) no *Amazon CloudFront * Developer Guide.
+ Para obter detalhes da API, consulte [ListDistributionTenantsByCustomization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants-by-customization.html)em *Referência de AWS CLI Comandos*.
### `list-distribution-tenants`
O código de exemplo a seguir mostra como usar `list-distribution-tenants`.
**AWS CLI**
**Para listar inquilinos CloudFront de distribuição**
O `list-distribution-tenants` exemplo a seguir lista três inquilinos de CloudFront distribuição em sua AWS conta pelo grupo de conexão associado.
```
aws cloudfront list-distribution-tenants \
--association-filter ConnectionGroupId=cg_2whCJoXMYCjHcxaLGrkllvyABC \
--max-items 3
```
Saída:
```
{
"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 [Entenda como as distribuições multilocatárias funcionam](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-config-options.html) no *Amazon CloudFront * Developer Guide.
+ Para obter detalhes da API, consulte [ListDistributionTenants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distribution-tenants.html)em *Referência de AWS CLI Comandos*.
### `list-distributions-by-connection-mode`
O código de exemplo a seguir mostra como usar `list-distributions-by-connection-mode`.
**AWS CLI**
**Para listar CloudFront distribuições por modo de conexão**
O `list-distributions-by-connection-mode` exemplo a seguir lista as CloudFront distribuições com o modo de conexão especificado.
```
aws cloudfront list-distributions-by-connection-mode \
--connection-mode tenant-only
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [ListDistributionsByConnectionMode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions-by-connection-mode.html)em *Referência de AWS CLI Comandos*.
### `list-distributions`
O código de exemplo a seguir mostra como usar `list-distributions`.
**AWS CLI**
**Para listar CloudFront distribuições**
O exemplo a seguir obtém uma lista das CloudFront distribuições em sua AWS conta.
```
aws cloudfront list-distributions
```
Saída:
```
{
"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
}
]
}
}
```
+ Para obter detalhes da API, consulte [ListDistributions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-distributions.html)em *Referência de AWS CLI Comandos*.
### `list-domain-conflicts`
O código de exemplo a seguir mostra como usar `list-domain-conflicts`.
**AWS CLI**
**Para listar conflitos de domínio para uma CloudFront distribuição**
O `list-domain-conflicts` exemplo a seguir lista os conflitos de domínio de uma CloudFront distribuição.
```
aws cloudfront list-domain-conflicts \
--domain example.com \
--domain-control-validation-resource "DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB"
```
Saída:
```
{
"DomainConflicts": [
{
"Domain": "example.com",
"ResourceType": "distribution-tenant",
"ResourceId": "***************ohWzv1b9It8J1AB",
"AccountId": "123456789012"
}
]
}
```
Para obter 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 *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [ListDomainConflicts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-domain-conflicts.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir obtém uma lista das configurações de criptografia em CloudFront nível de campo em sua conta: AWS
```
aws cloudfront list-field-level-encryption-configs
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListFieldLevelEncryptionConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-configs.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
O exemplo a seguir obtém uma lista dos perfis de criptografia em CloudFront nível de campo em sua AWS conta:
```
aws cloudfront list-field-level-encryption-profiles
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListFieldLevelEncryptionProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-field-level-encryption-profiles.html)em *Referência de AWS CLI Comandos*.
### `list-invalidations-for-distribution-tenant`
O código de exemplo a seguir mostra como usar `list-invalidations-for-distribution-tenant`.
**AWS CLI**
**Para listar as invalidações de um inquilino de distribuição CloudFront **
O `list-invalidations-for-distribution-tenant` exemplo a seguir lista as invalidações de um inquilino de CloudFront distribuição.
```
aws cloudfront list-invalidations-for-distribution-tenant \
--id dt_2wjDZi3hD1ivOXf6rpZJOSNE1AB
```
Saída:
```
{
"InvalidationList": {
"Items": [
{
"Id": "I4CU23QAPKMUDUU06F9OFGFABC",
"CreateTime": "2025-05-06T15:46:12.824000+00:00",
"Status": "Completed"
}
]
}
}
```
Para obter mais informações, consulte [Invalidar arquivos para remover conteúdo](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) no *Amazon CloudFront Developer* Guide.
+ Para obter detalhes da API, consulte [ListInvalidationsForDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations-for-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `list-invalidations`
O código de exemplo a seguir mostra como usar `list-invalidations`.
**AWS CLI**
**Para listar CloudFront invalidações**
O exemplo a seguir obtém uma lista das invalidações da CloudFront distribuição com o ID: `EDFDVBD6EXAMPLE`
```
aws cloudfront list-invalidations --distribution-id EDFDVBD6EXAMPLE
```
Saída:
```
{
"InvalidationList": {
"Marker": "",
"Items": [
{
"Status": "Completed",
"Id": "YNY2LI2BVJ4NJU",
"CreateTime": "2019-08-31T21:15:52.042Z"
}
],
"IsTruncated": false,
"MaxItems": 100,
"Quantity": 1
}
}
```
+ Para obter detalhes da API, consulte [ListInvalidations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-invalidations.html)em *Referência de AWS CLI Comandos*.
### `list-public-keys`
O código de exemplo a seguir mostra como usar `list-public-keys`.
**AWS CLI**
**Para listar chaves CloudFront públicas**
O exemplo a seguir obtém uma lista das chaves CloudFront públicas em sua AWS conta:
```
aws cloudfront list-public-keys
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-public-keys.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront distribuição**
O exemplo a seguir obtém uma lista das tags de uma CloudFront distribuição:
```
aws cloudfront list-tags-for-resource \
--resource arn:aws:cloudfront::123456789012:distribution/EDFDVBD6EXAMPLE
```
Saída:
```
{
"Tags": {
"Items": [
{
"Key": "DateCreated",
"Value": "2019-12-04"
},
{
"Key": "Name",
"Value": "Example name"
},
{
"Key": "Project",
"Value": "Example project"
}
]
}
}
```
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `sign`
O código de exemplo a seguir mostra como usar `sign`.
**AWS CLI**
**Para assinar um CloudFront URL**
O exemplo a seguir assina um CloudFront URL. Para assinar um URL, você precisa do ID do par de chaves (chamado de **ID da chave de acesso** no AWS Management Console) e da chave privada do par de CloudFront chaves do assinante confiável. Para obter mais informações sobre assinatura URLs, consulte Como [servir conteúdo privado com cookies assinados URLs e assinados](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) no *Amazon CloudFront Developer Guide*.
```
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
```
Saída:
```
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**
**Para marcar uma CloudFront distribuição**
O `tag-resource` exemplo a seguir adiciona duas tags à CloudFront distribuição 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.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover tags de uma CloudFront distribuição**
O exemplo a seguir remove duas tags de uma CloudFront distribuição 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 da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `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 de acesso de CloudFront origem**
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 do OAI é retornado na saída dos comandos create-cloud-front-origin -access-identity e -access-identities. list-cloud-front-origin Para obter o`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 obter detalhes da API, consulte [UpdateCloudFrontOriginAccessIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-cloud-front-origin-access-identity.html)em *Referência de AWS CLI Comandos*.
### `update-connection-group`
O código de exemplo a seguir mostra como usar `update-connection-group`.
**AWS CLI**
**Para atualizar um grupo de CloudFront conexão**
O `update-connection-group` exemplo a seguir desativa e IPv6 desativa um grupo de CloudFront conexão.
```
aws cloudfront update-connection-group \
--id cg_2yHsDkcPKeUlVkk3aEgLKcjABC \
--no-ipv6-enabled \
--no-enabled \
--if-match E3UN6WX5RRO2ABC
```
Saída:
```
{
"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 obter mais informações, consulte [Criar um grupo de conexão personalizado (opcional)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-connection-group.html) no *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateConnectionGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-connection-group.html)em *Referência de AWS CLI Comandos*.
### `update-distribution-tenant`
O código de exemplo a seguir mostra como usar `update-distribution-tenant`.
**AWS CLI**
**Para atualizar um inquilino CloudFront de distribuição**
O `update-distribution-tenant` exemplo a seguir atualiza um inquilino de CloudFront distribuição 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"
]
}
}
}
```
Saída:
```
{
"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 obter mais informações, consulte [Personalizações de locatários de distribuição](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/tenant-customization.html) no *Amazon CloudFront * Developer Guide.
+ Para obter detalhes da API, consulte [UpdateDistributionTenant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution-tenant.html)em *Referência de AWS CLI Comandos*.
### `update-distribution`
O código de exemplo a seguir mostra como usar `update-distribution`.
**AWS CLI**
**Exemplo 1: Para atualizar o objeto raiz padrão de uma CloudFront distribuição**
O exemplo a seguir atualiza o objeto raiz padrão `index.html` para a CloudFront distribuição com o ID`EDFDVBD6EXAMPLE`.
```
aws cloudfront update-distribution \
--id EDFDVBD6EXAMPLE \
--default-root-object index.html
```
Saída:
```
{
"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: Para atualizar uma CloudFront distribuição**
O exemplo a seguir desativa a CloudFront distribuição 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. Para obter o`ETag`, use o comando get-distribution ou get-distribution-config. 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
}
```
Saída:
```
{
"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
}
}
}
```
+ Para obter detalhes da API, consulte [UpdateDistribution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-distribution.html)em *Referência de AWS CLI Comandos*.
### `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 `update-domain-association` exemplo a seguir atualiza uma associação de domínio para um locatário de distribuição com ETag `E23ZP02F085ABC`.
```
aws cloudfront update-domain-association \
--domain example.com \
--target-resource DistributionTenantId=dt_2x9GhoK0TZRsohWzv1b9It8J1AB \
--if-match E23ZP02F085ABC
```
Saída:
```
{
"ETag": "ETVPDKIKX0ABC",
"Domain": "example.com",
"ResourceId": "dt_2x9GhoK0TZRsohWzv1b9It8J1AB"
}
```
Para obter 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 *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateDomainAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-domain-association.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
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 o`ETag`, use o comando get-field-level-encryption or 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"
}
]
}
}
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [UpdateFieldLevelEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-config.html)em *Referência de AWS CLI Comandos*.
### `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 CloudFront criptografia em nível de campo**
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 o`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"
]
}
}
]
}
}
```
Saída:
```
{
"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 obter detalhes da API, consulte [UpdateFieldLevelEncryptionProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/update-field-level-encryption-profile.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"DnsConfigurationList": [
{
"Domain": "example.com",
"Status": "valid-configuration"
}
]
}
```
Para obter 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 *Amazon CloudFront Developer Guide*.
+ Para obter detalhes da API, consulte [VerifyDnsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/verify-dns-configuration.html)em *Referência de AWS CLI Comandos*.