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 Amazon S3 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 Amazon S3.
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 Copy-S3Object.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando copia o objeto “sample.txt” do bucket “test-files” para o mesmo bucket, mas com uma nova chave de “sample-copy.txt".
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txtExemplo 2: este comando copia o objeto “sample.txt” do bucket “test-files” para o bucket “backup-files” com uma nova chave de “sample-copy.txt".
Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucketExemplo 3: este comando baixa o objeto “sample.txt” do bucket “test-files” em um arquivo local com o nome “local-sample.txt".
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txtExemplo 4: um único objeto é baixado no arquivo especificado. O arquivo baixado encontra-se em c:\downloads\data\archive.zip
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloadsExemplo 5: todos os objetos que correspondem ao prefixo de chave especificado são baixados na pasta local. A hierarquia relativa de chaves será preservada como subpastas no local geral do download.
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloads-
Para obter detalhes da API, consulte CopyObject em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3ACL.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando obtém os detalhes do proprietário do objeto do S3.
Get-S3ACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select AccessControlList.OwnerSaída:
DisplayName Id ----------- -- testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544-
Para obter detalhes da API, consulte GetACL em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3Bucket.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna todos os buckets do S.
Get-S3BucketExemplo 2: este comando retorna um bucket denominado “test-files"
Get-S3Bucket -BucketName amzn-s3-demo-bucket-
Para obter detalhes da API, consulte ListBuckets em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketAccelerateConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: se as configurações de aceleração de transferência estiverem habilitadas para o bucket especificado, este comando retornará o valor Habilitado.
Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'Saída:
Value ----- Enabled-
Para obter detalhes da API, consulte GetBucketAccelerateConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketAnalyticsConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna os detalhes do filtro de análise com o nome “testfilter” no bucket do S3 em questão.
Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'-
Para obter detalhes da API, consulte GetBucketAnalyticsConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketAnalyticsConfigurationList.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna as cem primeiras análises do bucket do S3 em questão.
Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte ListBucketAnalyticsConfigurations em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketEncryption.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna todas as regras de criptografia do lado do servidor associadas ao bucket em questão.
Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketEncryption em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketInventoryConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna os detalhes do inventário denominado “testinventory” para o bucket do S3 em questão.
Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'-
Para obter detalhes da API, consulte GetBucketInventoryConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketInventoryConfigurationList.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna as cem primeiras configurações de inventário do bucket do S3 em questão.
Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte ListBucketInventoryConfigurations em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketLocation.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retornará a restrição de localização do bucket “amzn-s3-demo-bucket”, se houver uma restrição.
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'Saída:
Value ----- ap-south-1-
Para obter detalhes da API, consulte GetBucketLocation em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketLogging.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna o status de registro em log do bucket especificado.
Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'Saída:
TargetBucketName Grants TargetPrefix ---------------- ------ ------------ testbucket1 {} testprefix-
Para obter detalhes da API, consulte GetBucketLogging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketMetricsConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna detalhes sobre o filtro de métricas denominado “testfilter” para o bucket do S3 em questão.
Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'-
Para obter detalhes da API, consulte GetBucketMetricsConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketNotification.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo recupera a configuração de notificação do bucket em questão
Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurationsSaída:
Id Topic -- ----- mimo arn:aws:sns:eu-west-1:123456789012:topic-1-
Para obter detalhes da API, consulte GetBucketNotification em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketPolicy.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando gera a política de bucket associada ao bucket do S3 em questão.
Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketPolicy em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketPolicyStatus.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna o status da política do bucket do S3 em questão, indicando se o bucket é público.
Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketPolicyStatus em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketReplication.
- Ferramentas para PowerShell V4
-
Exemplo 1: retorna as informações da configuração de replicação definida no bucket chamado “amzn-s3-demo-bucket”.
Get-S3BucketReplication -BucketName amzn-s3-demo-bucket-
Para obter detalhes da API, consulte GetBucketReplication em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketRequestPayment.
- Ferramentas para PowerShell V4
-
Exemplo 1: retorna as informações da configuração de pagamento de solicitação do bucket chamado “amzn-s3-demo-bucket”. Por padrão, o proprietário do bucket paga pelos downloads feitos no bucket.
Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket-
Para obter detalhes da API, consulte GetBucketRequestPayment em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketTagging.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna todas as tags associadas ao bucket em questão.
Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketTagging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketVersioning.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna o status de versionamento referente ao bucket em questão.
Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketVersioning em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3BucketWebsite.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna os detalhes das configurações do site estático do bucket do S3 em questão.
Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetBucketWebsite em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3CORSConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna um objeto que contém todas as regras de configuração do CORS correspondentes ao bucket do S3 em questão.
Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.RulesSaída:
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 : {}-
Para obter detalhes da API, consulte GetCORSConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3LifecycleConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo recupera a configuração do ciclo de vida do bucket.
Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucketSaída:
Rules ----- {Remove-in-150-days, Archive-to-Glacier-in-30-days}-
Para obter detalhes da API, consulte GetLifecycleConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3Object.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando recupera as informações sobre todos os itens no bucket “test-files".
Get-S3Object -BucketName amzn-s3-demo-bucketExemplo 2: este comando recupera as informações sobre o item “sample.txt” do bucket “test-files".
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txtExemplo 3: este comando recupera as informações sobre todos os itens com prefixo “sample” do bucket “test-files".
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample-
Para ver detalhes da API, consulte ListObjects na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).
-
O código de exemplo a seguir mostra como usar Get-S3ObjectLockConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: se a configuração do Bloqueio de Objetos estiver habilitada para o bucket do S3 em questão, este comando retornará o valor “Habilitado.
Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabledSaída:
Value ----- Enabled-
Para obter detalhes da API, consulte GetObjectLockConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3ObjectMetadata.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna os metadados do objeto com a chave “ListTrusts.txt” no bucket do S3 em questão.
Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'Saída:
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 :-
Para obter detalhes da API, consulte GetObjectMetadata em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3ObjectRetention.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando retorna o modo e a data até a qual o objeto ficará retido.
Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'-
Para obter detalhes da API, consulte GetObjectRetention em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3ObjectTagSet.
- Ferramentas para PowerShell V4
-
Exemplo 1: o exemplo retorna as tags associadas ao objeto presente no bucket do S3 em questão.
Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'Saída:
Key Value --- ----- test value-
Para obter detalhes da API, consulte GetObjectTagging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3PreSignedURL.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando retorna um URL pré-assinado para uma chave especificada e uma data de validade.
Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'Exemplo 2: o comando retorna um URL pré-assinado para um bucket de diretório com a chave especificada e uma data de validade.
[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'-
Para obter detalhes da API, consulte GetPreSignedURL em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3PublicAccessBlock.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando retorna a configuração do Bloqueio de Acesso Público do bucket do S3 em questão.
Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte GetPublicAccessBlock em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-S3Version.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retorna os metadados sobre todas as versões dos objetos no bucket do S3 indicado.
Get-S3Version -BucketName 'amzn-s3-demo-bucket'Saída:
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 :-
Para obter detalhes da API, consulte ListVersions em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar New-S3Bucket.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando cria um bucket privado chamado “sample-bucket".
New-S3Bucket -BucketName amzn-s3-demo-bucketExemplo 2: este comando cria um bucket chamado “sample-bucket” com permissões de leitura e gravação.
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWriteExemplo 3: este comando cria um novo bucket chamado “sample-bucket” com permissões somente leitura.
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnlyExemplo 4: este comando cria um bucket de diretório chamado “amzn-s3-demo-bucket--use1-az5--x-s3” com 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-
Para obter detalhes da API, consulte PutBucket em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Read-S3Object.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando recupera o item “sample.txt” do bucket “test-files” e o salva em um arquivo chamado “local-sample.txt” no local atual. O arquivo “local-sample.txt” não precisa existir antes de esse comando ser chamado.
Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txtExemplo 2: este comando recupera o diretório virtual “DIR” do bucket “test-files” e o salva em uma pasta chamada “Local-DIR” no local atual. O arquivo “Local-DIR” não precisa existir antes de esse comando ser chamado.
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIRExemplo 3: baixa todos os objetos com chaves terminadas em “.json” de buckets com “config” no respectivo nome em arquivos na pasta especificada. As chaves do objeto são usadas para definir o nome dos arquivos.
Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjects-
Para obter detalhes da API, consulte GetObject em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3Bucket.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove todos os objetos e versões de objetos do bucket “test-files” e, em seguida, exclui o bucket. O comando solicitará a confirmação antes de continuar. Adicione a opção -Force para ignorar a confirmação. Observe que os buckets que não estão vazios não podem ser excluídos.
Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent-
Para obter detalhes da API, consulte DeleteBucket em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketAnalyticsConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando remove o filtro de análise com o nome “testfilter” no bucket do S3 em questão.
Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'-
Para obter detalhes da API, consulte DeleteBucketAnalyticsConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketEncryption.
- Ferramentas para PowerShell V4
-
Exemplo 1: isso desabilita a criptografia habilitada para o bucket do S3 fornecido.
Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'Saída:
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-
Para obter detalhes da API, consulte DeleteBucketEncryption em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketInventoryConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove o inventário denominado “testInventoryName” correspondente ao bucket do S3 em questão.
Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'Saída:
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-
Para obter detalhes da API, consulte DeleteBucketInventoryConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketMetricsConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando remove o filtro de métricas com o nome “testmetrics” no bucket do S3 em questão.
Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'-
Para obter detalhes da API, consulte DeleteBucketMetricsConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketPolicy.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando remove a política de bucket associada ao bucket do S3 em questão.
Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte DeleteBucketPolicy em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketReplication.
- Ferramentas para PowerShell V4
-
Exemplo 1: exclui a configuração de replicação associada ao bucket chamado “amzn-s3-demo-bucket”. Observe que essa operação exige permissão para a ação s3:DeleteReplicationConfiguration. Será solicitada uma confirmação antes que a operação continue. Para ignorar a confirmação, use a opção -Force.
Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket-
Para obter detalhes da API, consulte DeleteBucketReplication em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketTagging.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove todas as tags associadas ao bucket do S3 em questão.
Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'Saída:
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-
Para obter detalhes da API, consulte DeleteBucketTagging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3BucketWebsite.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando desabilita a propriedade de hospedagem de site estático do bucket do S3 em questão.
Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'Saída:
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-
Para obter detalhes da API, consulte DeleteBucketWebsite em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3CORSConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove a configuração CORS do bucket do S3 indicado.
Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'Saída:
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-
Para obter detalhes da API, consulte DeleteCORSConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3LifecycleConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando remove todas as regras do ciclo de vida do bucket do S3 indicado.
Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'-
Para obter detalhes da API, consulte DeleteLifecycleConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3MultipartUpload.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando interrompe os carregamentos fracionados criados há mais de cinco dias.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5Exemplo 2: este comando interrompe os carregamentos fracionados criados antes de 2 de janeiro de, 2014.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"Exemplo 3: este comando interrompe os carregamentos fracionados criados antes de 2 de janeiro de 2014, às, 2014, 10:45:37.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"-
Para obter detalhes da API, consulte AbortMultipartUpload em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3Object.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove o objeto “sample.txt” do bucket “test-files". Será solicitada uma confirmação antes que o comando seja executado. Para ignorar a solicitação, use a opção -Force.
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txtExemplo 2: este comando remove a versão especificada do objeto “sample.txt” do bucket “test-files”, supondo que o bucket tenha sido configurado para habilitar versões de objetos.
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqtExemplo 3: este comando remove objetos “sample1.txt”, “sample2.txt” e “sample3.txt” do bucket “test-files” como uma operação em lote única. A resposta do serviço listará todas as chaves processadas, independentemente do status de êxito ou erro da exclusão. Para obter somente erros de chaves que não puderam ser processadas pelo serviço, adicione o parâmetro -ReportErrorsOnly (esse parâmetro também pode ser especificado com o alias -Quiet.
Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )Exemplo 4: este exemplo usa uma expressão em linha com o parâmetro -KeyCollection para obter as chaves dos objetos a serem excluídos. Get-S3Object retorna um conjunto de instâncias Amazon.S3.Model.S3Object, cada uma com um membro de chave do tipo string identificando o objeto.
Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)Exemplo 5: este exemplo obtém todos os objetos que têm um prefixo de chave “prefix/subprefix” no bucket e os exclui. Observe que os objetos de entrada são processados um de cada vez. Para conjuntos grandes, considere a possibilidade de passar o conjunto para o parâmetro -InputObject (alias -S3ObjectCollection) do cmdlet para permitir que a exclusão ocorra em lote com uma única chamada ao serviço.
Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -ForceExemplo 6: este exemplo envia um conjunto de instâncias Amazon.S3.Model.S3ObjectVersion que representam marcadores de exclusão do cmdlet para exclusão. Observe que os objetos de entrada são processados um de cada vez. Para conjuntos grandes, considere a possibilidade de passar o conjunto para o parâmetro -InputObject (alias -S3ObjectCollection) do cmdlet para permitir que a exclusão ocorra em lote com uma única chamada ao serviço.
(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -ForceExemplo 7: este script mostra como realizar uma exclusão em lote de um conjunto de objetos (nesse caso, marcadores de exclusão) construindo uma matriz de objetos a serem usados com o 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-
Para obter detalhes da API, consulte DeleteObjects em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3ObjectTagSet.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando remove todas as tags associadas ao objeto com a chave “testfile.txt” no bucket do S3 em questão.
Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'Saída:
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-
Para obter detalhes da API, consulte DeleteObjectTagging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-S3PublicAccessBlock.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando desativa a configuração do Bloqueio de Acesso Público do bucket em questão.
Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'Saída:
amzn-s3-demo-bucket-
Para obter detalhes da API, consulte DeletePublicAccessBlock em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Set-S3BucketEncryption.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando habilita a criptografia padrão do lado do servidor AES256 com chaves gerenciadas do Amazon S3 (SSE-S3) no bucket em questão.
$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}} Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig-
Para obter detalhes da API, consulte PutBucketEncryption em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Test-S3Bucket.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando retornará True se o bucket existir; do contrário, False. O comando retornará True mesmo se o bucket não pertencer ao usuário.
Test-S3Bucket -BucketName amzn-s3-demo-bucket-
Para obter detalhes da API, consulte Test-S3Bucket em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketAccelerateConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando habilita a aceleração de transferência do bucket do S3 em questão.
$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled') Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal-
Para obter detalhes da API, consulte PutBucketAccelerateConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketNotification.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo define a configuração do tópico do SNS para o evento ObjectRemovedDelete do S3 e habilita a notificação para o bucket do S3 em questão
$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 $topicExemplo 2: este exemplo habilita notificações de ObjectCreatedAll para o bucket em questão, enviando-as à função do 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 $lambdaConfigExemplo 3: este exemplo cria duas configurações diferentes do Lambda com base em diferentes sufixos de chave e configura ambas em um único 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-
Para obter detalhes da API, consulte PutBucketNotification em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketReplication.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo define uma configuração de replicação com uma única regra que permite a replicação para o bucket “amzn-s3-demo-bucket” de qualquer novo objeto criado com o prefixo de nome de chave “TaxDocs” no 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 @paramsExemplo 2: este exemplo define uma configuração de replicação com várias regras que permitem a replicação para o bucket “amzn-s3-demo-bucket” de qualquer novo objeto criado com o prefixo de nome de chave “TaxDocs” ou “OtherDocs”. Os prefixos de chave não devem se sobrepor.
$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 @paramsExemplo 3: este exemplo atualiza a configuração de replicação no bucket especificado para desabilitar a regra que controla a replicação de objetos com o prefixo de nome de chave “TaxDocs” para o 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-
Para obter detalhes da API, consulte PutBucketReplication em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketRequestPayment.
- Ferramentas para PowerShell V4
-
Exemplo 1: atualiza a configuração de pagamento de solicitação do bucket denominado “amzn-s3-demo-bucket” para que a pessoa que está solicitando downloads pelo bucket seja cobrada pelo download. Por padrão, o proprietário do bucket paga pelos downloads. Para definir o pagamento de solicitação de volta ao padrão, use “BucketOwner” para o parâmetro RequestPaymentConfiguration_Payer.
Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester-
Para obter detalhes da API, consulte PutBucketRequestPayment em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketTagging.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando aplica duas tags a um bucket denominado
cloudtrail-test-2018(uma tag com uma chave de Stage e um valor de Test e uma tag com uma chave de Environment e um valor de Alpha). Para verificar se as tags foram adicionadas ao bucket, executeGet-S3BucketTagging -BucketName bucket_name. Os resultados devem mostrar as tags que você aplicou ao bucket no primeiro comando. Observe queWrite-S3BucketTaggingsubstitui todo o conjunto de tags existente em um bucket. Para adicionar ou excluir tags individuais, execute os cmdlets da API de grupos de recursos e marcação:Add-RGTResourceTageRemove-RGTResourceTag. Também e possível usar o editor de tags no Console de Gerenciamento da AWS para gerenciar as tags de bucket do S3.Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )Exemplo 2: este comando envia um bucket denominado
cloudtrail-test-2018para o cmdletWrite-S3BucketTagging. Ele aplica as tags Stage:Production e Department:Finance ao bucket. Observe queWrite-S3BucketTaggingsubstitui todo o conjunto de tags existente em um bucket.Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )-
Para obter detalhes da API, consulte PutBucketTagging em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketVersioning.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando habilita o versionamento do bucket do S3 em questão.
Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled-
Para obter detalhes da API, consulte PutBucketVersioning em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3BucketWebsite.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando habilita a hospedagem de sites para o bucket em questão com o documento de índice como “index.html” e o documento de erro como “error.html'.
Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'-
Para obter detalhes da API, consulte PutBucketWebsite em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3LifecycleConfiguration.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo grava/substitui a configuração fornecida no $NewRule. Essa configuração garante limitar os objetos do escopo com determinados valores de prefixo e tag.
$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 $NewRuleExemplo 2: esse exemplo define várias regras com filtragem. $ArchiveRule define os objetos a serem arquivados em 30 dias no Glacier e 120 no DeepArchive. $ExpireRule expira as versões atual e anterior em 150 dias para objetos com prefixo “py” e tag:key “archieved” definida como “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-
Para obter detalhes da API, consulte PutLifecycleConfiguration em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3Object.
- Ferramentas para PowerShell V4
-
Exemplo 1: este comando carrega o arquivo único “local-sample.txt” no Amazon S3, criando um objeto com a chave “sample.txt” no bucket “test-files".
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txtExemplo 2: este comando carrega o arquivo único “sample.txt” no Amazon S3, criando um objeto com a chave “sample.txt” no bucket “test-files". Quando o parâmetro -Key não é fornecido, usa-se o nome do arquivo como chave do objeto do S.
Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txtExemplo 3: este comando carrega o arquivo único “local-sample.txt” no Amazon S3, criando um objeto com a chave “prefix/to/sample.txt” no bucket “test-files".
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txtExemplo 4: este comando carrega todos os arquivos no subdiretório “Scripts” no bucket “test-files” e aplica o prefixo de chave comum “SampleScripts” a cada objeto. Cada arquivo carregado terá uma chave “SampleScripts/filename”, em que “filename” varia.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\Exemplo 5: este comando carrega todos os arquivos *.ps1 no diretório local “Scripts” no bucket “test-files” e aplica o prefixo de chave comum “SampleScripts” a cada objeto. Cada arquivo carregado terá uma chave “SampleScripts/filename.ps1”, em que “filename” varia.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1Exemplo 6: este comando cria um objeto do S3 contendo a string de conteúdo especificada com a chave “sample.txt'.
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"Exemplo 7: este comando carrega o arquivo especificado (o nome do arquivo é usado como chave) e aplica as tags especificadas ao novo objeto.
Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}Exemplo 8: este comando carrega recursivamente a pasta especificada e aplica as tags especificadas a todos os novos objetos.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}-
Para obter detalhes da API, consulte PutObject em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-S3ObjectRetention.
- Ferramentas para PowerShell V4
-
Exemplo 1: o comando habilita o modo de retenção de governança até a data “31st Dec 2019 00:00:00” para o objeto “testfile.txt” no bucket do S3 em questão.
Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"-
Para obter detalhes da API, consulte PutObjectRetention em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-