PutS3Object 2025.10.2.19¶
번들¶
org.apache.nifi | nifi-aws-nar
설명¶
FlowFile 의 내용을 Amazon S3 버킷에 S3 오브젝트로 씁니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
AWS 자격 증명 공급자 서비스 |
AWS 자격 증명 공급자를 획득하는 데 사용되는 컨트롤러 서비스 |
버킷 |
상호 작용할 S3 버킷 |
캐시 제어 |
연결된 오브젝트의 캐시 지시어를 나타내는 Cache-Control HTTP 헤더를 설정합니다. 여러 지시문을 쉼표로 구분합니다. |
Canned ACL |
BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private 중 하나의 오브젝트에 대한 Amazon Canned ACL 은 다른 ACL/permission/owner 속성이 지정되면 무시됩니다. |
통신 시간 제한 |
AWS 에 연결을 설정하거나 AWS 에서 데이터를 수신하기 위해 시간 초과 전에 대기해야 하는 시간입니다. |
내용 처리 |
Sets the Content-Disposition HTTP header indicating if the content is intended to be displayed inline or should be downloaded. Possible values are ‘inline’ or ‘attachment’. If this property is not specified, object ‘s content-disposition will be set to filename. When’ attachment ‘is selected,’; filename=’plus object key are automatically appended to form final value’ attachment; filename=”filename.jpg”’. |
Content Type |
Sets the Content-Type HTTP header indicating the type of content stored in the associated object. The value of this header is a standard MIME type. AWS S3 Java client will attempt to determine the correct content type if one hasn’t been set yet. Users are responsible for ensuring a suitable content type is set when uploading streams. If no content type is provided and cannot be determined by the filename, the default content type “application/octet-stream” will be used. |
Custom Signer Class Name |
Fully qualified class name of the custom signer class. The signer must implement com.amazonaws.auth. Signer interface. |
Custom Signer Module Location |
사용자 지정 서명자의 JAR 파일 및 종속성(있는 경우)을 포함하는 파일 및/또는 디렉터리 경로를 쉼표로 구분한 목록입니다. |
Encryption Service |
요청을 구성하는 데 사용되는 암호화 서비스 컨트롤러를 지정합니다. PutS3Object: 이전 버전과의 호환성을 위해 ‘서버 측 암호화’가 설정된 경우 이 값은 무시됩니다. FetchS3Object: 서버 측 고객 키, 클라이언트 측 KMS 및 클라이언트 측 고객 키 암호화의 경우에만 구성해야 합니다. |
Endpoint Override URL |
스키마, 호스트, 포트, 경로 등 기본값인 AWS 대신 사용할 엔드포인트 URL 을 설정합니다. AWS 라이브러리는 AWS 리전을 기반으로 엔드포인트 URL 을 선택하지만, 이 속성은 선택한 엔드포인트 URL 을 재정의하여 다른 S3 호환 엔드포인트와 함께 사용할 수 있도록 합니다. |
만료 시간 규칙 |
|
파일 리소스 서비스 |
전송할 로컬 리소스에 대한 액세스를 제공하는 파일 리소스 서비스 |
FullControl User List |
쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록으로, 오브젝트에 대한 모든 권한을 가져야 하는 사용자를 지정합니다 |
다중 부품 크기 |
PutS3Multipart Upload API 를 사용할 때 사용할 파트 크기를 지정합니다. 플로우 파일은 업로드 프로세스를 위해 이 크기의 청크로 분할되지만, 마지막 전송 부분은 패딩되지 않으므로 더 작을 수 있습니다. 유효한 범위는 50MB ~ 5GB 입니다. |
다중 파트 임계값 |
Specifies the file size threshold for switch from the PutS3Object API to the PutS3MultipartUpload API. Flow files bigger than this limit will be sent using the stateful multipart process. The valid range is 50MB to 5GB. |
멀티파트 업로드 AgeOff 간격 |
Specifies the interval at which existing multipart uploads in AWS S3 will be evaluated for ageoff. When processor is triggered it will initiate the ageoff evaluation if this interval has been exceeded. |
멀티파트 업로드 최대 수명 임계값 |
Specifies the maximum age for existing multipart uploads in AWS S3. When the ageoff process occurs, any upload older than this threshold will be aborted. |
오브젝트 키 |
사용할 S3 오브젝트 키입니다. 이는 기존 파일 시스템의 파일 이름과 유사합니다. |
Object Tags Prefix |
Specifies the prefix which would be scanned against the incoming FlowFile ‘s attributes and the matching attribute’s name and value would be considered as the outgoing S3 object ‘s Tag name and Tag value respectively. For Ex: If the incoming FlowFile carries the attributes tagS3country, tagS3PII, the tag prefix to be specified would be’ tagS3’ |
소유자 |
오브젝트의 소유자에게 사용할 Amazon ID |
Read ACL User List |
오브젝트에 대한 액세스 제어 목록을 읽을 수 있는 권한을 가진 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
Read Permission User List |
오브젝트에 대한 읽기 액세스 권한을 가져야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소의 목록입니다 |
리전 |
연결할 AWS 리전입니다. |
Remove Tag Prefix |
‘true’로 설정하면 ‘오브젝트 태그 접두사’에 제공된 값이 특성에서 제거된 후 태그 이름으로 간주됩니다. 예: 수신되는 FlowFile 에 tagS3country, tagS3PII 특성이 있고 접두사가 ‘tagS3’로 설정된 경우 해당 태그 값은 ‘country’ 및 ‘PII’가 됩니다 |
리소스 전송 소스 |
전송할 내용의 출처 |
SSL 컨텍스트 서비스 |
공급자가 제공하는 경우 연결을 만드는 데 사용할 선택적 SSL 컨텍스트 서비스를 지정합니다 |
Server Side Encryption |
서버 측 암호화에 사용되는 알고리즘을 지정합니다. |
Signer Override |
AWS S3 라이브러리는 기본적으로 서명 버전 4를 사용하지만 이 속성을 사용하면 버전 2 서명자를 지정하여 이전 S3 호환 서비스를 지원하거나 사용자 정의 서명자 구현을 플러그인할 수도 있습니다. |
저장소 클래스 |
|
Temporary Directory Multipart State |
멀티파트 업로드의 경우 프로세서가 업로드를 추적하는 상태를 로컬로 저장하는 디렉터리 ID 및 업로드를 완료하려면 둘 다 제공해야 하는 업로드된 파트가 있는 디렉터리입니다. |
Use Chunked Encoding |
업로드 요청에 대한 청크 인코딩을 활성화/비활성화합니다. 엔드포인트가 청크 업로드를 지원하지 않는 경우에만 false으로 설정합니다. |
Use Path Style Access |
이 속성을 true로 설정하여 경로 스타일 액세스를 적용할 수 있습니다. 엔드포인트가 가상 호스트 스타일 요청을 지원하지 않고 경로 스타일 요청만 지원하는 경우 true로 설정합니다. |
Write ACL User List |
오브젝트에 대한 액세스 제어 목록을 변경할 권한이 있어야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
Write Permission User List |
오브젝트에 대한 쓰기 권한을 가져야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
프록시 구성 서비스 |
네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다. |
관계¶
이름 |
설명 |
|---|---|
실패 |
프로세서가 지정된 FlowFile 을 처리할 수 없는 경우 이 관계로 라우팅됩니다. |
성공 |
FlowFiles 은 성공적으로 처리된 후 이 관계로 라우팅됩니다. |
Writes 특성¶
이름 |
설명 |
|---|---|
s3.url |
S3 오브젝트에 액세스하는 데 사용할 수 있는 URL |
s3.bucket |
오브젝트를 S3에 넣은 S3 버킷 |
s3.key |
오브젝트를 S3에 넣은 위치 내의 S3 키입니다 |
s3.contenttype |
S3에 넣은 S3 오브젝트의 S3 내용 유형입니다 |
s3.version |
S3에 넣은 S3 오브젝트의 버전입니다 |
s3.exception |
프로세서 실행 중에 throw된 예외의 클래스 이름입니다 |
s3.additionalDetails |
S3가 실패한 작업에서 세부 정보를 제공했습니다 |
s3.statusCode |
실패한 작업의 HTTP 오류 코드(사용 가능한 경우) |
s3.errorCode |
실패한 작업의 S3 명칭 |
s3.errorMessage |
실패한 작업의 S3 예외 메시지 |
s3.etag |
S3 오브젝트의 ETag 입니다. |
s3.contentdisposition |
S3에 넣은 S3 오브젝트의 내용 처분입니다 |
s3.cachecontrol |
S3 오브젝트의 캐시 제어 헤더 |
s3.uploadId |
오브젝트를 S3에 업로드하는 데 사용된 uploadId |
s3.expiration |
S3 오브젝트의 만료일이 설정된 경우 사람이 읽을 수 있는 형식의 만료일입니다 |
s3.sseAlgorithm |
오브젝트의 서버 측 암호화 알고리즘입니다 |
s3.usermetadata |
S3 오브젝트의 사용자 메타데이터(설정된 경우)의 사람이 읽을 수 있는 형식입니다 |
s3.encryptionStrategy |
설정된 암호화 전략의 이름(있는 경우) |