PutS3Object 2025.5.31.15¶
Pacote¶
org.apache.nifi | nifi-aws-nar
Descrição¶
Grava o conteúdo de um FlowFile como um objeto S3 em um bucket S3 da Amazon.
Requisito de entrada¶
REQUIRED
Oferece suporte a propriedades dinâmicas confidenciais¶
falso
Propriedades¶
Propriedade |
Descrição |
|---|---|
Serviço de provedor de credenciais AWS |
O Controller Service que é usado para obter o provedor de credenciais AWS |
Bucket |
O bucket S3 para interagir |
Controle de cache |
Define o cabeçalho HTTP Cache-Control indicando as diretivas de cache do objeto associado. Várias diretivas são separadas por vírgulas. |
Tempo limite de comunicação |
O tempo de espera para estabelecer uma conexão com o AWS ou receber dados do AWS antes de atingir o tempo limite. |
Disposição do conteúdo |
Define o cabeçalho HTTP Content-Disposition indicando se o conteúdo deve ser exibido em linha ou se deve ser baixado. Os valores possíveis são “inline” ou “attachment”. Se essa propriedade não for especificada, a disposição do conteúdo do objeto será definida como nome de arquivo. Quando “attachment” é selecionado, “; filename=” mais a chave do objeto são automaticamente anexados para formar o valor final “attachment; filename=»filename.jpg»”. |
Tipo de conteúdo |
Define o cabeçalho HTTP Content-Type indicando o tipo de conteúdo armazenado no objeto associado. O valor desse cabeçalho é um tipo MIME padrão. O cliente AWS S3 Java tentará determinar o tipo de conteúdo correto se ainda não tiver sido definido. Os usuários são responsáveis por garantir que um tipo de conteúdo adequado seja definido ao fazer upload de fluxos. Se nenhum tipo de conteúdo for fornecido e não puder ser determinado pelo nome do arquivo, será usado o tipo de conteúdo padrão “application/octet-stream”. |
URL de substituição do ponto de extremidade |
URL do ponto de extremidade a ser usado em vez do padrão do AWS, incluindo esquema, host, porta e caminho. As bibliotecas AWS selecionam um URL de ponto de extremidade com base na região AWS, mas essa propriedade substitui o URL do ponto de extremidade selecionado, permitindo o uso com outros pontos de extremidade compatíveis com S3. |
Regra de tempo de expiração |
|
Serviço de recurso de arquivo |
O serviço de recurso de arquivo que fornece acesso ao recurso local a ser transferido |
Lista de usuários FullControl |
Uma lista separada por vírgulas de IDs de usuários Amazon ou endereços de e-mail que especifica quem deve ter o controle total de um objeto |
Tamanho da parte Multipart |
Especifica o tamanho da peça para uso quando a PutS3Multipart Upload API é usada. Os FlowFiles serão divididos em partes desse tamanho para o processo de upload, mas a última parte enviada pode ser menor, pois não é preenchida. O intervalo válido é de 50MB a 5GB. |
Limite multipart |
Especifica o limite de tamanho do arquivo para alternar da PutS3Object API para PutS3MultipartUpload API. Os FlowFiles maiores que esse limite serão enviados usando o processo multipart com estado. O intervalo válido é de 50MB a 5GB. |
Intervalo AgeOff de upload multipart |
Especifica o intervalo em que os uploads multipart existentes no AWS S3 serão avaliados quanto à idade. Quando o processador for acionado, ele iniciará a avaliação do ageoff se esse intervalo tiver sido excedido. |
Limite de idade máxima para upload multipart |
Especifica a idade máxima para uploads multipart existentes no AWS S3. Quando ocorrer o processo de ageoff, qualquer upload mais antigo que esse limite será abortado. |
Chave do objeto |
A chave do objeto S3 a ser usada. Isso é análogo a um nome de arquivo nos sistemas de arquivo tradicionais. |
Proprietário |
O ID Amazon a ser usado para o proprietário do objeto |
Lista de usuários ACL de leitura |
Uma lista separada por vírgulas de IDs de usuário da Amazon ou endereços de e-mail que especifica quem deve ter permissões para ler a lista de controle de acesso de um objeto |
Lista de usuários com permissão de leitura |
Uma lista separada por vírgulas de IDs de usuários Amazon ou endereços de e-mail que especifica quem deve ter acesso de leitura a um objeto |
Região |
A região AWS à qual você deve se conectar. |
Fonte de transferência de recursos |
A fonte do conteúdo a ser transferido |
Serviço de contexto SSL |
Especifica um serviço de contexto SSL opcional que, se fornecido, será usado para criar conexões |
Substituição do signatário |
A biblioteca AWS S3 usa a Signature Version 4 por padrão, mas essa propriedade permite que você especifique o signatário da versão 2 para oferecer suporte a serviços compatíveis com S3 mais antigos ou até mesmo para conectar sua própria implementação de signatário personalizado. |
Classe de armazenamento |
|
Lista de usuários ACL de gravação |
Uma lista separada por vírgulas de IDs de usuário Amazon ou endereços de e-mail que especifica quem deve ter permissões para alterar a lista de controle de acesso de um objeto |
Lista de usuários com permissão de gravação |
Uma lista separada por vírgulas de IDs de usuário Amazon ou endereços de e-mail que especifica quem deve ter acesso de gravação para um objeto |
canned-acl |
ACL pré-definida da Amazon para um dos seguintes objetos: BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; será ignorada se qualquer outra propriedade de ACL/permissão/proprietário for especificada |
custom-signer-class-name |
Nome de classe totalmente qualificado da classe do assinador personalizado. O assinador deve implementar a interface com.amazonaws.auth.Signer. |
custom-signer-module-location |
Lista separada por vírgulas de caminhos para arquivos e/ou diretórios que contêm o arquivo JAR do assinador personalizado e suas dependências (se houver). |
encryption-service |
Especifica o Controller Service de criptografia usado para configurar solicitações. PutS3Object: para fins de compatibilidade com versões anteriores, esse valor é ignorado quando a opção “Criptografia do lado do servidor” é definida. FetchS3Object: só precisa ser configurado no caso das criptografias Chave de cliente do lado do servidor, KMS do lado do lado do cliente e Chave de cliente do lado do lado do cliente. |
proxy-configuration-service |
Especifica o serviço de Controller Service de configuração de proxy para a realização de proxy de solicitações de rede. |
s3-object-remove-tags-prefix |
Se definido como “True”, o valor fornecido para “Object Tags Prefix” (Prefixo de tags de objeto) será removido do(s) atributo(s) e, em seguida, considerado como o nome da tag. Por exemplo: se o FlowFile de entrada tiver os atributos tagS3country, tagS3PII e o prefixo for definido como “tagS3”, os valores de tag correspondentes serão “country” e “PII“ |
s3-object-tags-prefix |
Especifica o prefixo que seria verificado nos atributos do FlowFile de entrada, e o nome e o valor do atributo correspondente seriam considerados como o nome e o valor da tag do objeto S3 de saída, respectivamente. Por exemplo: se o FlowFile de entrada contiver os atributos tagS3country, tagS3PII, o prefixo da tag a ser especificado será “tagS3” |
s3-temporary-directory-multipart |
Diretório no qual, para uploads multipart, o processador salvará localmente o estado de rastreamento do ID de upload e as partes carregadas que devem ser fornecidas para concluir o upload. |
server-side-encryption |
Especifica o algoritmo usado para a criptografia do lado do servidor. |
use-chunked-encoding |
Ativa/desativa a codificação em partes para solicitações de upload. Defina-o como falso somente se seu ponto de extremidade não for compatível com o upload em partes. |
use-path-style-access |
O acesso no estilo de caminho pode ser aplicado definindo essa propriedade como verdadeiro. Defina-o como verdadeiro se seu ponto de extremidade não for compatível com solicitações do tipo virtual-hosted, apenas com solicitações do tipo path. |
Relações¶
Nome |
Descrição |
|---|---|
failure |
Se o processador não puder processar um determinado FlowFile, ele será encaminhado para essa relação. |
success |
FlowFiles são encaminhados para essa relação após terem sido processados com sucesso. |
Grava atributos¶
Nome |
Descrição |
|---|---|
s3.url |
O URL que pode ser usado para acessar o objeto S3 |
s3.bucket |
O bucket S3 onde o objeto foi colocado no S3 |
s3.key |
A chave S3 onde o objeto foi armazenado no S3 |
s3.contenttype |
O tipo de conteúdo S3 do objeto S3 que foi colocado no S3 |
s3.version |
A versão do objeto S3 colocada no S3 |
s3.exception |
O nome da classe da exceção gerada durante a execução do processador |
s3.additionalDetails |
O S3 forneceu detalhes da operação com falha |
s3.statusCode |
O código de erro HTTP (se disponível) da operação com falha |
s3.errorCode |
O moniker S3 da operação com falha |
s3.errorMessage |
A mensagem de exceção S3 da operação com falha |
s3.etag |
A ETag do objeto S3 |
s3.contentdisposition |
A disposição do conteúdo do objeto S3 colocado no S3 |
s3.cachecontrol |
O cabeçalho de controle de cache do objeto S3 |
s3.uploadId |
O uploadId usado para fazer o upload do objeto ao S3 |
s3.expiration |
Uma forma legível para humanos da data de expiração do objeto S3, se houver uma definida |
s3.sseAlgorithm |
O algoritmo de criptografia do lado do servidor do objeto |
s3.usermetadata |
Um formulário legível para humanos dos metadados do usuário do objeto S3, se algum tiver sido definido |
s3.encryptionStrategy |
O nome da estratégia de criptografia, se alguma tiver sido definida |