visualização
Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!
Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.
Esta página fornece uma referência completa para as ações do AWS S3 disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você realize operações em buckets e objetos do S3.
Pré-requisitos
Antes de usar as ações AWS na automação do fluxo de trabalho, certifique-se de ter:
- Uma conta da AWS com as permissões apropriadas.
- Credenciais da AWS configuradas (credenciais de usuário do IAM, ARN da função do IAM ou credenciais de sessão).
- As permissões IAM necessárias para os serviços específicos da AWS que você planeja usar.
Consulte Configurar credenciais AWS para obter informações sobre como criar usuários e funções do IAM e configurar credenciais estáticas e de sessão AWS para integração com as ações de automação de fluxo de trabalho AWS.
O método listObjectsV2 retorna alguns ou todos (até 1.000) os objetos em um bucket. É uma versão mais moderna e recomendada de list_objects.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
bucket | Obrigatório | Corda | "
" |
prefixo | Opcional | Corda | "
" |
maxKeys | Opcional | Inteiro |
|
continuationToken | Opcional | Corda |
|
parâmetro | Opcional | Mapa | |
seletores | Opcional | Lista |
|
Campo de entrada | Tipo |
|---|---|
EncodingType | Corda |
FetchOwner | Boleano |
StartAfter | Corda |
RequestPayer | Corda |
ExpectedBucketOwner | Corda |
OptionalObjectAttributes | Lista |
Delimiter | Corda |
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | objeto | A sintaxe de resposta pode ser consultada na documentação do list_objects_v2 - Boto3 1.40.52. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
O método deleteObject remove permanentemente um único objeto de um bucket. Para buckets versionados, esta operação insere um marcador de exclusão, que oculta o objeto sem excluí-lo permanentemente, a menos que um VersionId seja especificado.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
bucket | Obrigatório | Corda | "
" |
chave | Obrigatório | Corda | "
" |
parâmetro | Opcional | Mapa | |
seletores | Opcional | Lista |
|
Campo de entrada | Tipo |
|---|---|
RequestPayer | Corda |
BypassGovernanceRetention | Boleano |
ExpectedBucketOwner | Corda |
IfMatch | Corda |
IfMatchLastModifiedTime | Mapa |
IfMatchSize | Interno |
VersionId | Corda |
MFA | Corda |
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | objeto | A sintaxe da resposta pode ser consultada na documentação do Boto3 1.40.55 com o objeto `delete_object`. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Adiciona um objeto a um bucket. Amazon S3 é um sistema distribuído. Se receber várias requests de escrita para o mesmo objeto simultaneamente, sobrescreverá todos os objetos, exceto o último que foi escrito.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
bucket | Obrigatório | Corda | "
" |
chave | Obrigatório | Corda | "
" |
corpo | Obrigatório | Corda |
|
contentType | Obrigatório | Corda | "
" |
marcação | Opcional | Corda |
|
parâmetro | Opcional | Mapa | |
seletores | Opcional | Lista |
|
Campo de entrada | Tipo |
|---|---|
RequestPayer | Corda |
ACL | Corda |
CacheControl | Corda |
ContentDisposition | Corda |
ContentEncoding | Corda |
ContentLanguage | Corda |
ContentLength | Interno |
ContentMD5 | Corda |
ChecksumAlgorithm | Corda |
ChecksumCRC32 | Corda |
ChecksumCRC32C | Corda |
ChecksumCRC64NVME | Corda |
ChecksumSHA1 | Corda |
ChecksumSHA256 | Corda |
Expires | Mapa |
IfMatch | Corda |
IfNoneMatch | Corda |
GrantFullControl | Corda |
GrantRead | Corda |
GrantReadACP | Corda |
GrantWriteACP | Corda |
WriteOffsetBytes | Interno |
ServerSideEncryption | Corda |
StorageClass | Corda |
WebsiteRedirectLocation | Corda |
SSECustomerAlgorithm | Corda |
SSECustomerKey | Corda |
SSEKMSKeyId | Corda |
SSEKMSEncryptionContext | Corda |
BucketKeyEnabled | Boleano |
RequestPayer | Corda |
ObjectLockMode | Corda |
ObjectLockRetainUntilDate | Mapa |
ObjectLockLegalHoldStatus | Corda |
ExpectedBucketOwner | Corda |
Metadados | Mapa |
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | objeto | A sintaxe de resposta pode ser consultada na documentação do Boto3 1.40.59, que inclui o objeto put_object. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
Exemplo de fluxo de trabalho |
|---|
|
Na solicitação GetObject, especifique o nome completo da chave do objeto.
Campo de entrada | Opcionalidade | Tipo | Exemplo |
|---|---|---|---|
awsRoleArn | Opcional | Corda |
|
awsAccessKeyId | Opcional | Corda |
|
awsSecretAccessKey | Opcional | Corda |
|
awsSessionToken | Opcional | Corda |
|
região | Obrigatório | Corda |
|
bucket | Obrigatório | Corda | "
" |
chave | Obrigatório | Corda | "
" |
versionId | Opcional | Corda |
|
range | Opcional | Corda |
|
parâmetro | Opcional | Mapa | |
seletores | Opcional | Lista |
|
Importante
A ação falhará se o objeto tiver mais de 100 KB.
Campo de entrada | Tipo |
|---|---|
IfMatch | Corda |
IfModifiedSince | Mapa |
IfNoneMatch | Corda |
IfUnmodifiedSince | Mapa |
ResponseCacheControl | Corda |
ResponseContentDisposition | Corda |
ResponseContentEncoding | Corda |
ResponseContentLanguage | Corda |
ResponseContentType | Corda |
ResponseExpires | Mapa |
SSECustomerAlgorithm | Corda |
SSECustomerKey | Corda |
RequestPayer | Corda |
PartNumber | Interno |
ExpectedBucketOwner | Corda |
ChecksumMode | Corda |
Campo de saída | Tipo | Exemplo |
|---|---|---|
response | objeto | A sintaxe da resposta pode ser consultada na documentação do get_object - Boto3 1.40.59. |
sucesso | Boleano |
|
mensagem de erro | Corda |
|
name: s3-get-object description: 'Get an AWS S3 Object'
steps: - name: aws_s3_getObject_1 type: action action: aws.s3.getObject version: '1' inputs: awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role" region: "us-east-2" bucket: "examplebucket" key: "path/to/object.txt" next: end