Esempi per CloudFront con Strumenti per PowerShell V5

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con CloudFront.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

L’esempio di codice seguente mostra come utilizzare Get-CFCloudFrontOriginAccessIdentity.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce l’identità di accesso origine di Amazon CloudFront specificata dal parametro -Id. Sebbene il parametro -Id non sia obbligatorio, se non lo si specifica non viene restituito alcun risultato.


Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT

Output:


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

Per informazioni dettagliate sull’API, consulta GetCloudFrontOriginAccessIdentity nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-CFCloudFrontOriginAccessIdentityConfig.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce informazioni di configurazione relative all’identità di accesso origine di Amazon CloudFront specificata dal parametro -Id. Si verificano errori se non viene specificato alcun parametro -Id.


Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT

Output:


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

Per informazioni dettagliate sull’API, consulta GetCloudFrontOriginAccessIdentityConfig nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-CFCloudFrontOriginAccessIdentityList.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce un elenco delle identità di accesso origine di Amazon CloudFront. Poiché il parametro -MaxItem è impostato su 2, i risultati includono due identità.


Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2

Output:


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

Per informazioni dettagliate sull’API, consulta ListCloudFrontOriginAccessIdentities nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-CFDistribution.

Strumenti per PowerShell V5

Esempio 1: recupera le informazioni relative a una distribuzione specifica.


Get-CFDistribution -Id EXAMPLE0000ID

Per informazioni dettagliate sull’API, consulta GetDistribution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-CFDistributionConfig.

Strumenti per PowerShell V5

Esempio 1: recupera la configurazione di una distribuzione specifica.


Get-CFDistributionConfig -Id EXAMPLE0000ID

Per informazioni dettagliate sull’API, consulta GetDistributionConfig nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-CFDistributionList.

Strumenti per PowerShell V5

Esempio 1: restituisce le distribuzioni.


Get-CFDistributionList

Per informazioni dettagliate sull’API, consulta ListDistributions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-CFDistribution.

Strumenti per PowerShell V5

Esempio 1: crea una distribuzione CloudFront di base, configurata con registrazione di log e memorizzazione nella 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

Per informazioni dettagliate sull’API, consulta CreateDistribution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-CFInvalidation.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea una nuova invalidazione per una distribuzione con l’ID EXAMPLENSTXAXE. Il valore CallerReference corrisponde a un ID univoco scelto dall’utente. In questo caso, viene utilizzato un timestamp che rappresenta il 15 maggio 2019 alle 9:00. La variabile $Paths archivia tre percorsi di immagini e file multimediali che l’utente non desidera vengano inseriti nella cache distribuita. Il valore del parametro -Paths_Quantity è il numero totale di percorsi specificati nel parametro -Paths_Item.


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

Output:


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

Per informazioni dettagliate sull’API, consulta CreateInvalidation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-CFSignedCookie.

Strumenti per PowerShell V5

Esempio 1: crea un cookie firmato per la risorsa specificata utilizzando una policy di accesso predefinita. Il cookie sarà valido per un anno.


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

Output:


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

Esempio 2: crea un cookie firmato per le risorse specificate utilizzando una policy personalizzata. Il cookie sarà valido tra 24 ore e scadrà una settimana dopo.


$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

Output:


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

Esempio 3: crea un cookie firmato per le risorse specificate utilizzando una policy personalizzata. Il cookie sarà valido tra 24 ore e scadrà una settimana dopo. L’accesso alle risorse è limitato all’intervallo IP specificato.


$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

Output:


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

Per informazioni dettagliate sull’API, consulta New-CFSignedCookie nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-CFSignedUrl.

Strumenti per PowerShell V5

Esempio 1: crea un URL firmato per la risorsa specificata utilizzando una policy di accesso predefinita. L’URL sarà valido per un’ora. Un oggetto System.Uri contenente l’URL firmato viene emesso nella pipeline.


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

Esempio 2: crea un URL firmato per la risorsa specificata utilizzando una policy personalizzata. L’URL sarà valido tra 24 ore e scadrà una settimana dopo.


$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

Esempio 3: crea un URL firmato per la risorsa specificata utilizzando una policy personalizzata. L’URL sarà valido tra 24 ore e scadrà una settimana dopo. L’accesso alla risorsa è limitato all’intervallo IP specificato.


$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

Per informazioni dettagliate sull’API, consulta New-CFSignedUrl nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CloudFormation

CloudTrail