AWS S3 작업

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS S3 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 Amazon S3 버킷의 객체를 나열, 검색, 업로드 및 삭제하십시오.

전제 조건

사전 요구 사항 및 자격 증명 설정에 대해서는 AWS 자격 증명 설정을 참조하십시오.

버킷에 있는 객체 목록을 표시합니다.

작업 식별자는 aws.s3.listObjectsV2입니다.

버킷에 있는 객체의 일부 또는 전체(최대 1,000개)를 메타데이터와 함께 반환합니다. listObjects의 권장 버전입니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 타겟 버킷의 AWS 리전입니다.	`us-east-2`
`bucket`	문자열	필수 항목입니다. 객체를 나열할 S3 버킷의 이름입니다.	`examplebucket`
`prefix`	문자열	선택 사항. 이 접두사로 시작하는 키로 응답을 제한합니다.	`path/to/folder/`
`maxKeys`	정수	선택 사항. 반환할 키의 최대 수(최대 1,000개).	`100`
`continuationToken`	문자열	선택 사항. 결과의 다음 페이지를 가져오기 위한 이전 응답의 토큰입니다.	`some-token`
`parameters`	지도	선택 사항. API 호출에 전달할 추가 boto3 파라미터입니다.	`{"Delimiter": "/"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

추가 선택적 boto3 필드(EncodingType, FetchOwner, StartAfter, RequestPayer, ExpectedBucketOwner, OptionalObjectAttributes, Delimiter)는 parameters 입력을 통해 사용할 수 있습니다. 자세한 내용은 list_objects_v2 boto3 참조를 확인하십시오.

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	list_objects_v2 boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"Parameter validation failed: Invalid bucket name"`

산출

유형

예시

response

물체

list_objects_v2 boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"Parameter validation failed: Invalid bucket name"

예제 워크플로우

name: aws-s3-list-objects-v2
description: 'List Objects in an AWS S3 Bucket'
steps:
  - name: aws_s3_listObjectsV2_1
    type: action
    action: aws.s3.listObjectsV2
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: "us-east-2"
      bucket: "examplebucket"
      prefix: "path/to/folder/"
      maxKeys: 100
    next: end

버킷에서 객체를 삭제합니다

작업 식별자는 aws.s3.deleteObject입니다.

버킷에서 단일 객체를 영구적으로 제거합니다. 버전이 지정된 버킷의 경우, 이 작업은 삭제 마커를 삽입하여 VersionId이(가) 지정되지 않는 한 객체를 영구적으로 삭제하지 않고 숨깁니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 타겟 버킷의 AWS 리전입니다.	`us-east-2`
`bucket`	문자열	필수 항목입니다. 객체가 포함된 S3 버킷의 이름입니다.	`examplebucket`
`key`	문자열	필수 항목입니다. 삭제할 객체의 전체 키(경로)입니다.	`path/to/object.txt`
`parameters`	지도	선택 사항. API 호출에 전달할 추가 boto3 파라미터입니다.	`{"VersionId": "testVersion", "MFA": "Test"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

추가적인 선택적 boto3 필드(RequestPayer, BypassGovernanceRetention, ExpectedBucketOwner, IfMatch, VersionId, MFA)는 parameters 입력을 통해 사용할 수 있습니다. 자세한 내용은 delete_object boto3 참조를 확인하십시오.

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	delete_object boto3 참조 를 확인하십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"Parameter validation failed: Invalid bucket name"`

산출

유형

예시

response

물체

delete_object boto3 참조

를 확인하십시오.

success

부울

true

또는

false

errorMessage

문자열

"Parameter validation failed: Invalid bucket name"

예제 워크플로우

name: aws-s3-delete-object
description: 'Delete an AWS S3 Object'
steps:
  - name: aws_s3_deleteObject_1
    type: action
    action: aws.s3.deleteObject
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: "us-west-2"
      bucket: "my-bucket"
      key: "path/to/object.txt"
    next: end

버킷에 객체 추가

작업 식별자는 aws.s3.putObject입니다.

버킷에 객체를 추가합니다. Amazon S3는 분산 시스템입니다 ― 동일한 객체에 대해 동시에 여러 쓰기 requests를 수신하면 마지막에 작성된 객체를 제외한 모든 객체를 덮어씁니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 타겟 버킷의 AWS 리전입니다.	`us-east-2`
`bucket`	문자열	필수 항목입니다. 객체를 업로드할 S3 버킷의 이름입니다.	`examplebucket`
`key`	문자열	필수 항목입니다. 버킷에 있는 객체의 전체 키(경로)입니다.	`path/to/object.txt`
`body`	문자열	필수 항목입니다. 업로드할 객체 데이터입니다.	`file content`
`contentType`	문자열	필수 항목입니다. 객체의 표준 MIME 유형입니다.	`plain/text`
`tagging`	문자열	선택 사항. 객체에 적용할 URL 인코딩된 태그 세트입니다.	`key1=value1`
`parameters`	지도	선택 사항. API 호출에 전달할 추가 boto3 파라미터입니다.	`{"ServerSideEncryption": "AES256", "Metadata": {"metadata1": "value1"}}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

parameters 입력을 통해 추가적인 선택적 boto3 필드를 사용할 수 있습니다. 전체 목록은 put_object boto3 참조를 확인해 주십시오.

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	put_object boto3 참조 를 확인해 주십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"An error occurred (NoSuchBucket) when calling the PutObject operation: The specified bucket does not exist"`

산출

유형

예시

response

물체

put_object boto3 참조

를 확인해 주십시오.

success

부울

true

또는

false

errorMessage

문자열

"An error occurred (NoSuchBucket) when calling the PutObject operation: The specified bucket does not exist"

예제 워크플로우

name: s3-put-object
description: 'Put an AWS S3 Object'
steps:
  - name: aws_s3_putObject_1
    type: action
    action: aws.s3.putObject
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: "us-east-2"
      bucket: "examplebucket"
      key: "path/to/object.txt"
      body: "Hello world"
      contentType: "plain/text"
      tagging: "key1=value1"
    next: end

버킷에서 객체를 검색합니다.

작업 식별자는 aws.s3.getObject입니다.

Amazon S3에서 객체를 가져옵니다. 요청에서 객체의 전체 키 이름을 지정하십시오.

중요

객체가 100 KB보다 크면 이 액션은 실패합니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 타겟 버킷의 AWS 리전입니다.	`us-east-2`
`bucket`	문자열	필수 항목입니다. 객체가 포함된 S3 버킷의 이름입니다.	`examplebucket`
`key`	문자열	필수 항목입니다. 가져올 객체의 전체 키(경로)입니다.	`path/to/object.txt`
`versionId`	문자열	선택 사항. 조회할 객체의 버전 ID입니다. 생략할 경우 현재 버전이 반환됩니다.	`some-version-id`
`range`	문자열	선택 사항. 객체의 특정 바이트 범위를 가져오기 위한 HTTP range 헤더입니다.	`bytes=0-99`
`parameters`	지도	선택 사항. API 호출에 전달할 추가 boto3 파라미터입니다.	`{"ChecksumMode": "ENABLED"}`
`selectors`	목록	선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.	`[{"name": "response", "expression": ".response"}]`

추가적인 선택적 boto3 필드는 parameters 입력을 통해 사용할 수 있습니다. 전체 목록은 get_object boto3 참조를 확인하십시오.

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	get_object boto3 참조 를 확인해 주십시오.
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"An error occurred (InvalidArgument) when calling the GetObject operation: Invalid version id specified"`

산출

유형

예시

response

물체

get_object boto3 참조

를 확인해 주십시오.

success

부울

true

또는

false

errorMessage

문자열

"An error occurred (InvalidArgument) when calling the GetObject operation: Invalid version id specified"

예제 워크플로우

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

사용자의 편의를 위해 제공되는 기계 번역입니다.

전제 조건.css-21sua1{background:none;border:none;width:0;padding:0;}

버킷에 있는 객체 목록을 표시합니다.

버킷에서 객체를 삭제합니다

버킷에 객체 추가

버킷에서 객체를 검색합니다.

중요

전제 조건