View a markdown version of this page

CloudFront esempi di utilizzo di Tools for V4 PowerShell - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CloudFront esempi di utilizzo di Tools for V4 PowerShell

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V4 con. CloudFront

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni 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

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

Strumenti per PowerShell V4

Esempio 1: questo esempio restituisce un'identità di accesso Amazon CloudFront origin specifica, 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...

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

Strumenti per V4 PowerShell

Esempio 1: questo esempio restituisce informazioni di configurazione su una singola identità di accesso Amazon CloudFront origin, 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

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

Strumenti per V4 PowerShell

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

Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2

Output:

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

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

Strumenti per V4 PowerShell

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

Get-CFDistribution -Id EXAMPLE0000ID

  • Per i dettagli sull'API, vedere GetDistribution in AWS Strumenti per PowerShell Cmdlet Reference (V4).

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

Strumenti per V4 PowerShell

Esempio 1: recupera la configurazione di una distribuzione specifica.

Get-CFDistributionConfig -Id EXAMPLE0000ID

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

Strumenti per V4 PowerShell

Esempio 1: restituisce le distribuzioni.

Get-CFDistributionList

  • Per i dettagli sull'API, vedere ListDistributions in AWS Strumenti per PowerShell Cmdlet Reference (V4).

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

Strumenti per V4 PowerShell

Esempio 1: crea una CloudFront distribuzione di base, configurata con registrazione e caching. 

$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 i dettagli sull'API, vedere CreateDistribution in AWS Strumenti per PowerShell Cmdlet Reference (V4).

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

Strumenti per V4 PowerShell

Esempio 1: questo esempio crea una nuova invalidazione per una distribuzione con l’ID EXAMPLENSTXAXE. CallerReference È 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 Paths_Quantity parametro - è 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 i dettagli sull'API, vedere CreateInvalidation in AWS Strumenti per PowerShell Cmdlet Reference (V4).

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

Strumenti per V4 PowerShell

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 i dettagli sull'API, vedere New-CFSignedCookie in AWS Strumenti per PowerShell Cmdlet Reference (V4).

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

Strumenti per V4 PowerShell

Esempio 1: crea un URL firmato per la risorsa specificata utilizzando una policy di accesso predefinita. L’URL sarà valido per un’ora. Un System.Uri oggetto 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 i dettagli sull'API, vedere New-CFSignedUrl in AWS Strumenti per PowerShell Cmdlet Reference (V4).