Exemplos do CloudFront que usam o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos do CloudFront que usam o Tools for PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o CloudFront.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Get-CFCloudFrontOriginAccessIdentity.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo retorna uma identidade do acesso de origem específica do Amazon CloudFront, especificada pelo parâmetro -Id. Embora o parâmetro -Id não seja obrigatório, se você não o especificar, nenhum resultado será retornado.

Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT

Saída:

      CloudFrontOriginAccessIdentityConfig    Id                                      S3CanonicalUserId
      ------------------------------------    --                                      -----------------
      Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT                          4b6e...

O código de exemplo a seguir mostra como usar Get-CFCloudFrontOriginAccessIdentityConfig.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo retorna informações de configuração sobre uma única identidade do acesso de origem do Amazon CloudFront, especificada pelo parâmetro -Id. Ocorrem erros se nenhum parâmetro -Id for especificado..

Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT

Saída:

      CallerReference                                             Comment
      ---------------                                             -------
      mycallerreference: 2/1/2011 1:16:32 PM                      Caller reference: 2/1/2011 1:16:32 PM

O código de exemplo a seguir mostra como usar Get-CFCloudFrontOriginAccessIdentityList.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo retorna uma lista de identidades do acesso de origem do Amazon CloudFront. Como o parâmetro -MaxItem especifica um valor de 2, os resultados incluem duas identidades.

Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2

Saída:

IsTruncated : True
Items       : {E326XXXXXXXXXT, E1YWXXXXXXX9B}
Marker      :
MaxItems    : 2
NextMarker  : E1YXXXXXXXXX9B
Quantity    : 2

O código de exemplo a seguir mostra como usar Get-CFDistribution.

Ferramentas para PowerShell V4

Exemplo 1: recupera as informações de uma distribuição específica.

Get-CFDistribution -Id EXAMPLE0000ID

  • Para ver detalhes da API, consulte GetDistribution na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar Get-CFDistributionConfig.

Ferramentas para PowerShell V4

Exemplo 1: recupera a configuração de uma distribuição específica.

Get-CFDistributionConfig -Id EXAMPLE0000ID

  • Para ver detalhes da API, consulte GetDistributionConfig na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar Get-CFDistributionList.

Ferramentas para PowerShell V4

Exemplo 1: retorno de distribuições.

Get-CFDistributionList

  • Para ver detalhes da API, consulte ListDistributions na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar New-CFDistribution.

Ferramentas para PowerShell V4

Exemplo 1: cria uma distribuição básica do CloudFront, configurada com registro em log e armazenamento em cache.

$origin = New-Object Amazon.CloudFront.Model.Origin
$origin.DomainName = "amzn-s3-demo-bucket.s3.amazonaws.com"
$origin.Id = "UniqueOrigin1"
$origin.S3OriginConfig = New-Object Amazon.CloudFront.Model.S3OriginConfig
$origin.S3OriginConfig.OriginAccessIdentity = ""
New-CFDistribution `
      -DistributionConfig_Enabled $true `
      -DistributionConfig_Comment "Test distribution" `
      -Origins_Item $origin `
      -Origins_Quantity 1 `
      -Logging_Enabled $true `
      -Logging_IncludeCookie $true `
      -Logging_Bucket amzn-s3-demo-logging-bucket.s3.amazonaws.com `
      -Logging_Prefix "help/" `
      -DistributionConfig_CallerReference Client1 `
      -DistributionConfig_DefaultRootObject index.html `
      -DefaultCacheBehavior_TargetOriginId $origin.Id `
      -ForwardedValues_QueryString $true `
      -Cookies_Forward all `
      -WhitelistedNames_Quantity 0 `
      -TrustedSigners_Enabled $false `
      -TrustedSigners_Quantity 0 `
      -DefaultCacheBehavior_ViewerProtocolPolicy allow-all `
      -DefaultCacheBehavior_MinTTL 1000 `
      -DistributionConfig_PriceClass "PriceClass_All" `
      -CacheBehaviors_Quantity 0 `
      -Aliases_Quantity 0

  • Para ver detalhes da API, consulte CreateDistribution na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar New-CFInvalidation.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo cria uma nova invalidação em uma distribuição com um ID de EXAMPLENSTXAXE. O CallerReference é um ID exclusivo escolhido pelo usuário; nesse caso, é usado um carimbo de data/hora representando 15 de maio de 2019 às 9h. A variável $Paths armazena três caminhos para arquivos de imagem e mídia que o usuário não deseja como parte do cache distribuído. O valor do parâmetro -Paths_Quantity é o número total de caminhos especificados no parâmetro -Paths_Item.

$Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4"
New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3

Saída:

Invalidation                         Location                                                                                          
------------                         --------                                                                                          
Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H

  • Para ver detalhes da API, consulte CreateInvalidation na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

O código de exemplo a seguir mostra como usar New-CFSignedCookie.

Ferramentas para PowerShell V4

Exemplo 1: cria um cookie assinado para o recurso especificado usando uma política predefinida. O cookie será válido por um ano.

$params = @{
	"ResourceUri"="http://xyz.cloudfront.net/image1.jpeg"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=(Get-Date).AddYears(1)
}
New-CFSignedCookie @params

Saída:

Expires
-------
[CloudFront-Expires, 1472227284]

Exemplo 2: cria um cookie assinado para os recursos especificados usando uma política personalizada. O cookie será validado em 24 horas e expirará uma semana depois.

$start = (Get-Date).AddHours(24)
$params = @{
	"ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=$start.AddDays(7)
    "ActiveFrom"=$start
}

New-CFSignedCookie @params

Saída:

Policy
------
[CloudFront-Policy, eyJTd...wIjo...

Exemplo 3: cria um cookie assinado para os recursos especificados usando uma política personalizada. O cookie será válido em 24 horas e expirará uma semana depois. O acesso aos recursos é restrito ao intervalo de IP especificado.

$start = (Get-Date).AddHours(24)
$params = @{
	"ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=$start.AddDays(7)
    "ActiveFrom"=$start
	"IpRange"="192.0.2.0/24"
}

New-CFSignedCookie @params

Saída:

Policy                                                                                                                                         ------                                                                                                                                         [CloudFront-Policy, eyJTd...wIjo...

  • Para obter detalhes da API, consulte New-CFSignedCookie em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar New-CFSignedUrl.

Ferramentas para PowerShell V4

Exemplo 1: cria um URL assinado para o recurso especificado usando uma política predefinida. O URL será válido por uma hora. Um objeto System.Uri contendo o URL assinado é emitido para o pipeline.

$params = @{
	"ResourceUri"="https://cdn.example.com/index.html"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=(Get-Date).AddHours(1)
}
New-CFSignedUrl @params

Exemplo 2: cria um URL assinado para o recurso especificado usando uma política personalizada. O URL será válido em 24 horas e expirará uma semana depois.

$start = (Get-Date).AddHours(24)
$params = @{
	"ResourceUri"="https://cdn.example.com/index.html"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=(Get-Date).AddDays(7)
    "ActiveFrom"=$start
}
New-CFSignedUrl @params

Exemplo 3: cria um URL assinado para o recurso especificado usando uma política personalizada. O URL será válido em 24 horas e expirará uma semana depois. O acesso ao recurso é restrito ao intervalo de IP especificado.

$start = (Get-Date).AddHours(24)
$params = @{
	"ResourceUri"="https://cdn.example.com/index.html"
	"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
	"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
	"ExpiresOn"=(Get-Date).AddDays(7)
    "ActiveFrom"=$start
    "IpRange"="192.0.2.0/24"	
}
New-CFSignedUrl @params

  • Para obter detalhes da API, consulte New-CFSignedUrl em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).