Ejemplos de Amazon S3 con las Herramientas para PowerShell V4

Ejemplo 1: este comando copia el objeto “sample.txt” del bucket “test-files” al mismo bucket, pero con la nueva clave de “sample-copy.txt".

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txt

Ejemplo 2: este comando copia el objeto “sample.txt” del bucket “test-files” al mismo bucket “backup-files”, pero con la nueva clave de “sample-copy.txt".

Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucket

Ejemplo 3: este comando descarga el objeto “sample.txt” del bucket “test-files” a un archivo local con el nombre “local-sample.txt".

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt

Ejemplo 4: descarga el objeto individual en el archivo especificado. El archivo descargado se encuentra en c:\downloads\data\archive.zip

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloads

Ejemplo 5: descarga todos los objetos que coinciden con el prefijo de clave especificado en la carpeta local. La jerarquía de claves relativa se conservará como subcarpetas en la ubicación general de descarga.

Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloads

Ejemplo 1: El comando obtiene los detalles del propietario del objeto de S3.

Get-S3ACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select AccessControlList.Owner

Salida:

DisplayName Id
----------- --
testusername      9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544

Ejemplo 1: este comando devuelve todos los buckets de S.

Get-S3Bucket

Ejemplo 2: este comando devuelve un bucket denominado “test-files"

Get-S3Bucket -BucketName amzn-s3-demo-bucket

Ejemplo 1: este comando devuelve el valor Enabled si la configuración de aceleración de transferencia está habilitada para el bucket especificado.

Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'

Salida:

Value                                  
-----                                    
Enabled

Ejemplo 1: este comando devuelve los detalles del filtro de análisis con el nombre “testfilter” en el bucket de S3 indicado.

Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'

Ejemplo 1: este comando devuelve las primeras 100 configuraciones de análisis del bucket de S3 indicado.

Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando devuelve todas las reglas de cifrado del servidor asociadas al bucket determinado.

Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando devuelve los detalles del inventario con el nombre “testinventory” del bucket de S3 indicado.

Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'

Ejemplo 1: este comando devuelve las primeras 100 configuraciones de inventario del bucket de S3 indicado.

Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: Este comando devuelve la restricción de ubicación del bucket “amzn-s3-demo-bucket”, si existe una restricción.

Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'

Salida:

Value
-----
ap-south-1

Ejemplo 1: este comando devuelve el estado de registros del bucket especificado.

Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'

Salida:

TargetBucketName   Grants TargetPrefix
----------------   ------ ------------
testbucket1        {}     testprefix

Ejemplo 1: este comando devuelve los detalles del filro de métricas con el nombre “testfilter” del bucket de S3 indicado.

Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'

Ejemplo 1: en este ejemplo se recupera la configuración de notificaciones del bucket en cuestión

Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurations

Salida:

Id   Topic
--   -----
mimo arn:aws:sns:eu-west-1:123456789012:topic-1

Ejemplo 1: este comando muestra la política de bucket asociada al bucket de S3 indicado.

Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando devuelve el estado de política del bucket específico de S3 e indica si el bucket es público.

Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: Se devuelve la información de configuración de replicación establecida en el bucket denominado “amzn-s3-demo-bucket”.

Get-S3BucketReplication -BucketName amzn-s3-demo-bucket

Ejemplo 1: Se devuelve la configuración de pagos de solicitudes del bucket denominado “amzn-s3-demo-bucket”. De forma predeterminada, el propietario del bucket paga las descargas realizadas desde el bucket.

Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket

Ejemplo 1: este comando devuelve todas las etiquetas asociadas al bucket indicado.

Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando devuelve el estado del control de versiones con respecto al bucket indicado.

Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando devuelve los detalles de las configuraciones de sitio web estáticas del bucket de S3 indicado.

Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: Este comando devuelve un objeto que contiene todas las reglas de configuración de CORS correspondientes al bucket de S3 especificado.

Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.Rules

Salida:

AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example1.com}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {*}

AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example2.com}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {*}

AllowedMethods : {GET}
AllowedOrigins : {*}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {}

Ejemplo 1: En este ejemplo se recupera la configuración de ciclo de vida del bucket.

Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket

Salida:

Rules
-----
{Remove-in-150-days, Archive-to-Glacier-in-30-days}

Ejemplo 1: este comando recupera la información sobre todos los elementos del bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket

Ejemplo 2: este comando recupera la información sobre el elemento “sample.txt” del bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Ejemplo 3: este comando recupera la información sobre todos los elementos con el prefijo “sample” del bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample

Ejemplo 1: este comando devuelve el valor “Enabled” si la configuración de bloqueo de objetos está habilitada para el bucket de S3 indicado.

Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabled

Salida:

Value
-----
Enabled

Ejemplo 1: Este comando devuelve los metadatos del objeto con la clave “ListTrusts.txt” en el bucket de S3 especificado.

Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'

Salida:

Headers                                       : Amazon.S3.Model.HeadersCollection
Metadata                                      : Amazon.S3.Model.MetadataCollection
DeleteMarker                                  : 
AcceptRanges                                  : bytes
ContentRange                                  : 
Expiration                                    : 
RestoreExpiration                             : 
RestoreInProgress                             : False
LastModified                                  : 01/01/2020 08:02:05
ETag                                          : "d000011112a222e333e3bb4ee5d43d21"
MissingMeta                                   : 0
VersionId                                     : null
Expires                                       : 01/01/0001 00:00:00
WebsiteRedirectLocation                       : 
ServerSideEncryptionMethod                    : AES256
ServerSideEncryptionCustomerMethod            : 
ServerSideEncryptionKeyManagementServiceKeyId : 
ReplicationStatus                             : 
PartsCount                                    : 
ObjectLockLegalHoldStatus                     : 
ObjectLockMode                                : 
ObjectLockRetainUntilDate                     : 01/01/0001 00:00:00
StorageClass                                  : 
RequestCharged                                :

Ejemplo 1: el comando devuelve el modo y la fecha hasta que se retenga el objeto.

Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'

Ejemplo 1: el ejemplo devuelve las etiquetas asociadas al objeto presentes en el bucket de S3 indicado.

Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'

Salida:

Key  Value
---  -----
test value

Ejemplo 1: El comando devuelve la URL previamente firmada de una clave y una fecha de caducidad especificadas.

Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'

Ejemplo 2: El comando devuelve la URL previamente firmada de un bucket de directorio con la clave y la fecha de caducidad especificadas.

[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true
      Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'

Ejemplo 1: el comando devuelve la configuración de bloqueo de acceso público del bucket de S3 indicado.

Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: Este comando devuelve los metadatos sobre todas las versiones de los objetos en el bucket de S3 especificado.

Get-S3Version -BucketName 'amzn-s3-demo-bucket'

Salida:

IsTruncated         : False
KeyMarker           : 
VersionIdMarker     : 
NextKeyMarker       : 
NextVersionIdMarker : 
Versions            : {EC2.txt, EC2MicrosoftWindowsGuide.txt, ListDirectories.json, ListTrusts.json}
Name                : amzn-s3-demo-bucket
Prefix              : 
MaxKeys             : 1000
CommonPrefixes      : {}
Delimiter           :

Ejemplo 1: Con este comando se crea un nuevo bucket privado denominado “sample-bucket”.

New-S3Bucket -BucketName amzn-s3-demo-bucket

Ejemplo 2: Con este comando se crea un nuevo bucket denominado “sample-bucket” con permisos de lectura y escritura.

New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWrite

Ejemplo 3: Con este comando se crea un nuevo bucket denominado “sample-bucket” con permisos de lectura y escritura.

New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnly

Ejemplo 4: Con este comando se crea un nuevo bucket de directorio denominado “amzn-s3-demo-bucket--use1-az5--x-s3” con PutBucketConfiguration.

$bucketConfiguration = @{
      BucketInfo = @{
          DataRedundancy = 'SingleAvailabilityZone'
          Type = 'Directory'
      }
      Location = @{
          Name = 'usw2-az1'
          Type = 'AvailabilityZone'
      }
    }
New-S3Bucket -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -BucketConfiguration $bucketConfiguration -Region us-west-2

Ejemplo 1: este comando recupera el elemento “sample.txt” del bucket “test-files” y lo guarda en un archivo denominado “local-sample.txt” en la ubicación actual. No es necesario que el archivo “local-sample.txt” exista para poder llamar a este comando.

Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt

Ejemplo 2: este comando recupera el directorio virtual “DIR” del bucket “test-files” y lo guarda en una carpeta denominada “Local-DIR” en la ubicación actual. No es necesario que la carpeta “Local-DIR” exista para poder llamar a este comando.

Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIR

Ejemplo 3: descarga todos los objetos cuyas claves terminan en “.json” de los buckets con “config” en el nombre del bucket a los archivos de la carpeta especificada. Las claves de objeto se utilizan para establecer los nombres de los archivos.

Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjects

Ejemplo 1: este comando elimina todos los objetos y las versiones de los objetos del bucket “test-files” y, a continuación, elimina el bucket. El comando solicitará una confirmación antes de continuar. Añada el conmutador -Force para suprimir la confirmación. Tenga en cuenta que los buckets que no estén vacíos no se pueden eliminar.

Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent

Ejemplo 1: el comando elimina el filtro de análisis con el nombre “testfilter” en el bucket de S3 indicado.

Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'

Ejemplo 1: esto deshabilita el cifrado habilitado para el bucket de S3 proporcionado.

Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketEncryption (DeleteBucketEncryption)" on target "s3casetestbucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Ejemplo 1: este comando elimina el inventario denominado “testInventoryName” correspondiente al bucket de S3 en cuestión.

Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketInventoryConfiguration (DeleteBucketInventoryConfiguration)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Ejemplo 1: el comando elimina el filtro de métricas con el nombre “testmetrics” en el bucket de S3 indicado.

Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'

Ejemplo 1: el comando elimina la política de bucket asociada al bucket de S3 indicado.

Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: Se elimina la configuración de replicación asociada al bucket denominado “amzn-s3-demo-bucket”. Tenga en cuenta que esta operación necesita permiso para la acción s3:DeleteReplicationConfiguration. Se le solicitará la confirmación antes de continuar con la operación; para suprimir la confirmación, utilice el conmutador -Force.

Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket

Ejemplo 1: este comando elimina todas las etiquetas asociadas al bucket de S3 indicado.

Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketTagging (DeleteBucketTagging)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Ejemplo 1: este comando deshabilita la propiedad de alojamiento de sitios web estáticos del bucket de S3 indicado.

Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketWebsite (DeleteBucketWebsite)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Ejemplo 1: Este comando elimina la configuración de CORS para el bucket de S3 especificado.

Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3CORSConfiguration (DeleteCORSConfiguration)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Ejemplo 1: El comando elimina todas las reglas de ciclo de vida del bucket de S3 especificado.

Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'

Ejemplo 1: este comando anula las cargas multiparte creadas hace menos de 5 días.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5

Ejemplo 2: este comando anula las cargas multiparte creadas antes del 2 de enero de, 2014.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"

Ejemplo 3: este comando anula las cargas multiparte creadas antes del 2 de enero de 2014 a las, 2014, 10:45:37.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"

Ejemplo 1: este comando elimina el objeto “sample.txt” del bucket “test-files". Antes de ejecutar el comando, se le solicitará que lo confirme; para suprimir el mensaje, utilice el conmutador -Force.

Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Ejemplo 2: este comando elimina la versión especificada del objeto “sample.txt” del bucket “test-files”, suponiendo que el bucket se haya configurado para habilitar las versiones de los objetos.

Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqt

Ejemplo 3: este comando elimina los objetos “sample1.txt”, “sample2.txt” y “sample3.txt” del bucket “test-files” como una sola operación por lotes. La respuesta del servicio mostrará una lista de todas las claves procesadas, independientemente del estado de éxito o error de la eliminación. Para obtener únicamente los errores de las claves que el servicio no ha podido procesar, añada el parámetro -ReportErrorsOnly (este parámetro también se puede especificar con el alias -Quiet.

Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )

Ejemplo 4: este ejemplo utiliza una expresión en línea con el parámetro -KeyCollection para obtener las claves de los objetos que se van a eliminar. Get-S3Object devuelve una colección de instancias de Amazon.S3.Model.S3Object, cada una de las cuales tiene un elemento clave de tipo cadena que identifica el objeto.

Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)

Ejemplo 5: este ejemplo obtiene todos los objetos que tienen un prefijo de clave “prefijo/subprefijo” en el bucket y los elimina. Tenga en cuenta que los objetos entrantes se procesan de uno en uno. En el caso de colecciones grandes, plantéese la posibilidad de pasarlas al parámetro -InputObject (alias -S3ObjectCollection) del cmdlet para permitir que la eliminación se realice por lotes con una sola llamada al servicio.

Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -Force

Ejemplo 6: en este ejemplo, se canaliza al cmdlet para su eliminación una colección de instancias de Amazon.S3.Model.S3ObjectVersion que representan marcadores de eliminación. Tenga en cuenta que los objetos entrantes se procesan de uno en uno. En el caso de colecciones grandes, plantéese la posibilidad de pasarlas al parámetro -InputObject (alias -S3ObjectCollection) del cmdlet para permitir que la eliminación se realice por lotes con una sola llamada al servicio.

(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -Force

Ejemplo 7: este script muestra cómo eliminar por lotes un conjunto de objetos (en este caso, marcadores de eliminación) mediante la creación de una matriz de objetos para utilizarlos con el parámetro -KeyAndVersionCollection.

$keyVersions = @()
$markers = (Get-S3Version -BucketName $BucketName).Versions | Where {$_.IsDeleteMarker -eq "True"}
foreach ($marker in $markers) { $keyVersions += @{ Key = $marker.Key; VersionId = $marker.VersionId } }
Remove-S3Object -BucketName $BucketName -KeyAndVersionCollection $keyVersions -Force

Ejemplo 1: este comando elimina todas las etiquetas asociadas con el objeto con la clave “testfile.txt” en el bucket de S3 indicado.

Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3ObjectTagSet (DeleteObjectTagging)" on target "testfile.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y
testfile.txt

Ejemplo 1: este comando desactiva la configuración de bloqueo de acceso público para el bucket en cuestión.

Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'

Salida:

amzn-s3-demo-bucket

Ejemplo 1: este comando habilita el cifrado AES256 predeterminado del servidor con claves administradas de Amazon S3 (SSE-S3) en el bucket indicado.

$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}}
Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig

Ejemplo 1: Este comando devuelve True si el bucket existe y False en caso contrario. El comando devuelve True aunque el bucket no pertenezca al usuario.

Test-S3Bucket -BucketName amzn-s3-demo-bucket

Ejemplo 1: este comando habilita la aceleración de transferencia para el bucket de S3 indicado.

$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled')
Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal

Ejemplo 1: este ejemplo configura la configuración del tema de SNS para el evento ObjectRemovedDelete de S3 y se habilita la notificación para el bucket de S3 indicado

$topic =  [Amazon.S3.Model.TopicConfiguration] @{
  Id = "delete-event"
  Topic = "arn:aws:sns:eu-west-1:123456789012:topic-1"
  Event = [Amazon.S3.EventType]::ObjectRemovedDelete
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -TopicConfiguration $topic

Ejemplo 2: este ejemplo habilita las notificaciones de ObjectCreatedAll para el bucket indicado y las envía a la función de Lambda.

$lambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = "s3:ObjectCreated:*"
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:rdplock"
  Id = "ObjectCreated-Lambda"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".pem"}
      )
    }
  }
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $lambdaConfig

Ejemplo 3: este ejemplo crea 2 configuraciones de Lambda diferentes sobre la base de un sufijo clave diferente y las configura en un solo comando.

#Lambda Config 1

$firstLambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = "s3:ObjectCreated:*"
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifynet"
  Id = "ObjectCreated-dada-ps1"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".ps1"}
      )
    }
  }
}

#Lambda Config 2

$secondlambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = [Amazon.S3.EventType]::ObjectCreatedAll
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifyssm"
  Id = "ObjectCreated-dada-json"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".json"}
      )
    }
  }
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $firstLambdaConfig,$secondlambdaConfig

Ejemplo 1: En este ejemplo se establece una configuración de replicación con una sola regla que permite replicar en el bucket “amzn-s3-demo-bucket” cualquier objeto nuevo creado con el prefijo de nombre de clave “TaxDocs” en el bucket “amzn-s3-demo-bucket”.

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1
}

Write-S3BucketReplication @params

Ejemplo 2: En este ejemplo se establece una configuración de replicación con varias reglas que permiten replicar en el bucket “amzn-s3-demo-bucket” cualquier objeto nuevo creado con el prefijo de nombre de clave “TaxDocs” u “OtherDocs”. Los prefijos de claves no deben superponerse.

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$rule2 = New-Object Amazon.S3.Model.ReplicationRule
$rule2.ID = "Rule-2"
$rule2.Status = "Enabled"
$rule2.Prefix = "OtherDocs"
$rule2.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1,$rule2
}

Write-S3BucketReplication @params

Ejemplo 3: En este ejemplo se actualiza la configuración de replicación en el bucket especificado para deshabilitar la regla que controla la replicación de objetos con el prefijo de nombre de clave “TaxDocs” en el bucket “amzn-s3-demo-bucket”.

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Disabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1
}

Write-S3BucketReplication @params

Ejemplo 1: Se actualiza la configuración de pago de solicitudes del bucket denominado “amzn-s3-demo-bucket”, de modo que se cobren las descargas del bucket a la persona que las solicite. De forma predeterminada, el propietario del bucket paga las descargas. Para volver a establecer el pago de la solicitud al modo predeterminado, use “BucketOwner” para el parámetro RequestPaymentConfiguration_Payer.

Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester

Ejemplo 1: este comando aplica dos etiquetas a un bucket denominado cloudtrail-test-2018, una etiqueta con una clave de Stage y un valor de Test, y una etiqueta con una clave de Environment y un valor de Alpha. Para comprobar que las etiquetas se han añadido al bucket, ejecute Get-S3BucketTagging -BucketName bucket_name. Los resultados deben mostrar las etiquetas que ha aplicado al bucket en el primer comando. Tenga en cuenta que Write-S3BucketTagging sobrescribe todo el conjunto de etiquetas existente en un bucket. Para añadir o eliminar etiquetas individuales, ejecute los cmdlets Resource Groups y Tagging API, Add-RGTResourceTag y Remove-RGTResourceTag. Como alternativa, puede utilizar el editor de etiquetas de la consola de administración de AWS para administrar las etiquetas del bucket de S3.

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )

Ejemplo 2: este comando canaliza un bucket denominado cloudtrail-test-2018 al cmdlet de Write-S3BucketTagging. Aplica las etiquetas Stage:Production y Department:Finance al bucket. Tenga en cuenta que Write-S3BucketTagging sobrescribe todo el conjunto de etiquetas existente en un bucket.

Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )

Ejemplo 1: el comando habilita el control de versiones para el bucket de S3 indicado.

Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled

Ejemplo 1: el comando habilita el alojamiento de sitios web para el bucket indicado con el documento de índice como “index.html” y el documento de error como “error.html'.

Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'

Ejemplo 1: En este ejemplo se escribe o se reemplaza la configuración proporcionada en $NewRule. Esta configuración garantiza que se limiten los objetos del ámbito con valores de prefijo y etiqueta determinados.

$NewRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  @{
			Days=  50
		}
		Id =  "Test-From-Write-cmdlet-1"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands=  @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "non-use"
							"Value" = "yes"
						}
					}
				)
			}
		}
		"Status"= 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 75
		}
	}
    
	Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $NewRule

Ejemplo 2: En este ejemplo se establecen varias reglas con el filtrado. $ArchiveRule establece los objetos para que se archiven en 30 días en Glacier y 120 en DeepArchive. $ExpireRule hace que caduque tanto la versión actual como la anterior en 150 días para los objetos con el prefijo “py” y la tag:key “archieved” establecida en “yes”.

$ExpireRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  @{
			Days=  150
		}
		Id =  "Remove-in-150-days"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands=  @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "archived"
							"Value" = "yes"
						}
					}
				)
			}
		}
		Status= 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 150
		}
	}

	$ArchiveRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  $null
		Id =  "Archive-to-Glacier-in-30-days"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands= @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "reviewed"
							"Value" = "yes"
						}
					}
				)
			}
		}
		Status = 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 75
		}
		Transitions = @(
			@{
				Days = 30
				"StorageClass"= 'Glacier'
			},
			@{
				Days = 120
				"StorageClass"= [Amazon.S3.S3StorageClass]::DeepArchive
			}
		)
	}

	Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $ExpireRule,$ArchiveRule

Ejemplo 1: este comando carga el archivo único “local-sample.txt” a Amazon S3 y crea un objeto con la clave “sample.txt” en el bucket “test-files".

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txt

Ejemplo 2: este comando carga el archivo único “sample.txt” a Amazon S3 y crea un objeto con la clave “sample.txt” en el bucket “test-files". Si no se proporciona el parámetro -Key, el nombre del archivo se utiliza como clave de objeto de S.

Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txt

Ejemplo 3: este comando carga el archivo único “local-sample.txt” a Amazon S3 y crea un objeto con la clave “prefix/to/sample.txt” en el bucket “test-files".

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txt

Ejemplo 4: este comando carga todos los archivos del subdirectorio “Scripts” al bucket “test-files” y aplica el prefijo de clave común “SampleScripts” a cada objeto. Cada archivo cargado tendrá una clave de “SampleScripts/filename”, donde “filename” varia.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\

Ejemplo 5: este comando carga todos los archivos *.ps1 en el director local “Scripts” al bucket “test-files” y aplica el prefijo de clave común “SampleScripts” a cada objeto. Cada archivo cargado tendrá una clave de “SampleScripts/filename.ps1”, donde “filename” varia.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1

Ejemplo 6: este comando crea un nuevo objeto S3 que contiene la cadena de contenido especificada con la clave “sample.txt'.

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"

Ejemplo 7: este comando carga el archivo especificado (el nombre del archivo se usa como clave) y aplica las etiquetas especificadas al nuevo objeto.

Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}

Ejemplo 8: este comando carga de forma recursiva la carpeta especificada y aplica las etiquetas especificadas a todos los objetos nuevos.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}

Ejemplo 1: el comando habilita el modo de retención de gobierno hasta la fecha “31 de diciembre de 2019 a las 00:00:00” para el objeto “testfile.txt” del bucket de S3 indicado.

Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"