PutS3Object 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-aws-nar
설명¶
FlowFile 의 내용을 Amazon S3 버킷에 S3 오브젝트로 씁니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
AWS 자격 증명 공급자 서비스 |
AWS 자격 증명 공급자를 획득하는 데 사용되는 컨트롤러 서비스 |
버킷 |
상호 작용할 S3 버킷 |
캐시 제어 |
연결된 오브젝트의 캐시 지시어를 나타내는 Cache-Control HTTP 헤더를 설정합니다. 여러 지시문을 쉼표로 구분합니다. |
통신 시간 제한 |
AWS 에 연결을 설정하거나 AWS 에서 데이터를 수신하기 위해 시간 초과 전에 대기해야 하는 시간입니다. |
내용 처리 |
내용이 인라인으로 표시될지 다운로드해야 하는지 여부를 나타내는 내용-배치 HTTP 헤더를 설정합니다. 가능한 값은 ‘inline’ 또는 ‘attachment’입니다. 이 속성을 지정하지 않으면 오브젝트의 내용 처리가 파일 이름으로 설정됩니다. ‘첨부파일’을 선택하면 ‘; filename=’과 오브젝트 키가 자동으로 추가되어 최종 값 ‘첨부파일; 파일 이름=”filename.jpg“‘가 됩니다. |
Content Type |
연결된 오브젝트에 저장된 내용의 유형을 나타내는 Content-Type HTTP 헤더를 설정합니다. 이 헤더의 값은 표준 MIME 유형입니다. AWS S3 Java 클라이언트는 아직 설정되지 않은 경우 올바른 내용 유형을 확인하려고 시도합니다. 사용자는 스트림을 업로드할 때 적절한 내용 유형이 설정되어 있는지 확인할 책임이 있습니다. 내용 유형이 제공되지 않고 파일 이름으로 확인할 수 없는 경우 기본 내용 유형인 “애플리케이션/8진수 스트림”이 사용됩니다. |
Endpoint Override URL |
스키마, 호스트, 포트, 경로 등 기본값인 AWS 대신 사용할 엔드포인트 URL 을 설정합니다. AWS 라이브러리는 AWS 리전을 기반으로 엔드포인트 URL 을 선택하지만, 이 속성은 선택한 엔드포인트 URL 을 재정의하여 다른 S3 호환 엔드포인트와 함께 사용할 수 있도록 합니다. |
만료 시간 규칙 |
|
파일 리소스 서비스 |
전송할 로컬 리소스에 대한 액세스를 제공하는 파일 리소스 서비스 |
FullControl User List |
쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록으로, 오브젝트에 대한 모든 권한을 가져야 하는 사용자를 지정합니다 |
다중 부품 크기 |
PutS3Multipart Upload API 를 사용할 때 사용할 파트 크기를 지정합니다. 플로우 파일은 업로드 프로세스를 위해 이 크기의 청크로 분할되지만, 마지막 전송 부분은 패딩되지 않으므로 더 작을 수 있습니다. 유효한 범위는 50MB ~ 5GB 입니다. |
다중 파트 임계값 |
PutS3Object API 에서 PutS3MultipartUpload API 로 변환하기 위한 파일 크기 임계값을 지정합니다. 이 제한보다 큰 플로우 파일은 상태 저장 멀티파트 프로세스를 사용하여 전송됩니다. 유효한 범위는 50MB ~ 5GB 입니다. |
멀티파트 업로드 AgeOff 간격 |
AWS S3의 기존 멀티파트 업로드가 에이지오프를 위해 평가되는 간격을 지정합니다. 프로세서가 트리거될 때 이 간격을 초과하면 에이지오프 평가가 시작됩니다. |
멀티파트 업로드 최대 수명 임계값 |
AWS S3에서 기존 멀티파트 업로드의 최대 기간을 지정합니다. 에이지오프 프로세스가 발생하면 이 임계값보다 오래된 업로드는 모두 중단됩니다. |
오브젝트 키 |
사용할 S3 오브젝트 키입니다. 이는 기존 파일 시스템의 파일 이름과 유사합니다. |
소유자 |
오브젝트의 소유자에게 사용할 Amazon ID |
Read ACL User List |
오브젝트에 대한 액세스 제어 목록을 읽을 수 있는 권한을 가진 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
Read Permission User List |
오브젝트에 대한 읽기 액세스 권한을 가져야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소의 목록입니다 |
리전 |
연결할 AWS 리전입니다. |
리소스 전송 소스 |
전송할 내용의 출처 |
SSL 컨텍스트 서비스 |
공급자가 제공하는 경우 연결을 만드는 데 사용할 선택적 SSL 컨텍스트 서비스를 지정합니다 |
Signer Override |
AWS S3 라이브러리는 기본적으로 서명 버전 4를 사용하지만 이 속성을 사용하면 버전 2 서명자를 지정하여 이전 S3 호환 서비스를 지원하거나 사용자 정의 서명자 구현을 플러그인할 수도 있습니다. |
저장소 클래스 |
|
Write ACL User List |
오브젝트에 대한 액세스 제어 목록을 변경할 권한이 있어야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
Write Permission User List |
오브젝트에 대한 쓰기 권한을 가져야 하는 사용자를 지정하는 쉼표로 구분된 Amazon 사용자 ID 또는 이메일 주소 목록입니다 |
canned-acl |
BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private 중 하나의 오브젝트에 대한 Amazon Canned ACL 은 다른 ACL/permission/owner 속성이 지정되면 무시됩니다. |
custom-signer-class-name |
사용자 지정 서명자 클래스의 정규화된 클래스 이름입니다. 서명자는 com.amazonaws.auth.Signer 인터페이스를 구현해야 합니다. |
custom-signer-module-location |
사용자 지정 서명자의 JAR 파일 및 종속성(있는 경우)을 포함하는 파일 및/또는 디렉터리 경로를 쉼표로 구분한 목록입니다. |
encryption-service |
요청을 구성하는 데 사용되는 암호화 서비스 컨트롤러를 지정합니다. PutS3Object: 이전 버전과의 호환성을 위해 ‘서버 측 암호화’가 설정된 경우 이 값은 무시됩니다. FetchS3Object: 서버 측 고객 키, 클라이언트 측 KMS 및 클라이언트 측 고객 키 암호화의 경우에만 구성해야 합니다. |
프록시 구성 서비스 |
네트워크 요청을 프록시할 프록시 구성 컨트롤러 서비스를 지정합니다. |
s3-object-remove-tags-prefix |
‘true’로 설정하면 ‘오브젝트 태그 접두사’에 제공된 값이 특성에서 제거된 후 태그 이름으로 간주됩니다. 예: 수신되는 FlowFile 에 tagS3country, tagS3PII 특성이 있고 접두사가 ‘tagS3’로 설정된 경우 해당 태그 값은 ‘country’ 및 ‘PII’가 됩니다 |
s3-object-tags-prefix |
수신 FlowFile 의 특성에 대해 스캔할 접두사를 지정하고 일치하는 특성의 이름과 값을 각각 송신 S3 오브젝트의 태그 이름과 태그 값으로 간주합니다. 예: 수신되는 FlowFile 에 tagS3country, tagS3PII 라는 특성이 있는 경우 지정할 태그 접두사는’tagS3’입니다 |
s3-temporary-directory-multipart |
멀티파트 업로드의 경우 프로세서가 업로드를 추적하는 상태를 로컬로 저장하는 디렉터리 ID 및 업로드를 완료하려면 둘 다 제공해야 하는 업로드된 파트가 있는 디렉터리입니다. |
서버 측 암호화 |
서버 측 암호화에 사용되는 알고리즘을 지정합니다. |
사용-청크 인코딩 |
업로드 요청에 대한 청크 인코딩을 활성화/비활성화합니다. 엔드포인트가 청크 업로드를 지원하지 않는 경우에만 false으로 설정합니다. |
사용 경로 스타일 액세스 |
이 속성을 true로 설정하여 경로 스타일 액세스를 적용할 수 있습니다. 엔드포인트가 가상 호스트 스타일 요청을 지원하지 않고 경로 스타일 요청만 지원하는 경우 true로 설정합니다. |
관계¶
이름 |
설명 |
|---|---|
실패 |
프로세서가 지정된 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 |
설정된 암호화 전략의 이름(있는 경우) |