AWS S3 작업

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 출시 전 정책 에 따라 미리보기 프로그램의 일부로 제공됩니다.

이 페이지는 작업우 자동화 작업 카탈로그에서 사용할 수 있는 AWS S3 작업에 대한 포괄적인 참조 정보를 제공합니다. 이러한 작업을 통해 S3 버킷 및 객체 작업을 수행할 수 있습니다.

전제 조건

블리자드 자동화에서 AWS 작업을 사용하기 전에 다음 사항이 있는지 확인하세요.

적절한 권한이 있는 AWS 계정.
AWS 자격 증명이 구성되었습니다(IAM 사용자 자격 증명, IAM 역할 ARN 또는 세션 자격 증명).
사용하려는 특정 AWS 서비스에 필요한 IAM 권한입니다.

IAM 사용자 및 IAM 역할을 만드는 방법과 펠로우 자동화 AWS 작업과 통합하기 위한 정적 및 세션 AWS 자격 증명을 설정하는 방법에 대한 자세한 내용은 AWS 자격 증명 설정을 참조하세요.

listObjectsV2 메서드는 버킷에 있는 객체 중 일부 또는 전체(최대 1,000개)를 반환합니다. list_objects 의 보다 현대적이고 권장되는 버전입니다.

입력 필드	선택성	유형	예시
awsRoleArn	선택 과목	문자열	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	선택 과목	문자열	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	선택 과목	문자열	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	선택 과목	문자열	`${{ :secrets:<awsSessionToken> }}`
지역	필수의	문자열	`"us-east-2"`
버킷	필수의	문자열	" `examplebucket` "
접두사	선택 과목	문자열	" `path/to/folder/` "
maxKeys	선택 과목	정수	`100`
continuationToken	선택 과목	문자열	`some-token`
매개변수	선택 과목	지도	`{ "Delimiter": "/" }`
선택기	선택 과목	목록	`[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]`

입력 필드	유형
EncodingType	문자열
FetchOwner	부울
StartAfter	문자열
RequestPayer	문자열
ExpectedBucketOwner	문자열
OptionalObjectAttributes	목록
Delimiter	문자열

출력 필드	유형	예시
response	물체	{ 'IsTruncated': True\|False, 'Contents': [ { 'Key': 'string', 'LastModified': datetime(2015, 1, 1), 'ETag': 'string', 'ChecksumAlgorithm': [ 'CRC32'\|'CRC32C'\|'SHA1'\|'SHA256'\|'CRC64NVME', ], 'ChecksumType': 'COMPOSITE'\|'FULL_OBJECT', 'Size': 123, 'StorageClass': 'STANDARD'\|'REDUCED_REDUNDANCY'\|'GLACIER'\|'STANDARD_IA'\|'ONEZONE_IA'\|'INTELLIGENT_TIERING'\|'DEEP_ARCHIVE'\|'OUTPOSTS'\|'GLACIER_IR'\|'SNOW'\|'EXPRESS_ONEZONE'\|'FSX_OPENZFS', 'Owner': { 'DisplayName': 'string', 'ID': 'string' }, 'RestoreStatus': { 'IsRestoreInProgress': True\|False, 'RestoreExpiryDate': datetime(2015, 1, 1) } }, ], 'Name': 'string', 'Prefix': 'string', 'Delimiter': 'string', 'MaxKeys': 123, 'CommonPrefixes': [ { 'Prefix': 'string' }, ], 'EncodingType': 'url', 'KeyCount': 123, 'ContinuationToken': 'string', 'NextContinuationToken': 'string', 'StartAfter': 'string', 'RequestCharged': 'requester' } 응답 구문은 list_objects_v2 - Boto3 1.40.52 설명서에서 참조할 수 있습니다.
성공	부울	`success: true \| false`
오류 메시지	문자열	`errorMessage: "Parameter validation failed:\nInvalid bucket name \"s3-activity-test \": Bucket name must match the regex \"^[a-zA-Z0-9.\\-_]{1,255}$\" or be an ARN matching the regex \"^arn:(aws).:(s3\|s3-object-lambda):[a-z\\-0-9]:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\\-.]{1,63}$\|^arn:(aws).*:s3-outposts:[a-z\\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\\-]{1,63}$\""`

출력 필드

유형

예시

response

물체

{
      'IsTruncated': True|False,
      'Contents': [
          {
              'Key': 'string',
              'LastModified': datetime(2015, 1, 1),
              'ETag': 'string',
              'ChecksumAlgorithm': [
                  'CRC32'|'CRC32C'|'SHA1'|'SHA256'|'CRC64NVME',
              ],
              'ChecksumType': 'COMPOSITE'|'FULL_OBJECT',
              'Size': 123,
              'StorageClass': 'STANDARD'|'REDUCED_REDUNDANCY'|'GLACIER'|'STANDARD_IA'|'ONEZONE_IA'|'INTELLIGENT_TIERING'|'DEEP_ARCHIVE'|'OUTPOSTS'|'GLACIER_IR'|'SNOW'|'EXPRESS_ONEZONE'|'FSX_OPENZFS',
              'Owner': {
                  'DisplayName': 'string',
                  'ID': 'string'
              },
              'RestoreStatus': {
                  'IsRestoreInProgress': True|False,
                  'RestoreExpiryDate': datetime(2015, 1, 1)
              }
          },
      ],
      'Name': 'string',
      'Prefix': 'string',
      'Delimiter': 'string',
      'MaxKeys': 123,
      'CommonPrefixes': [
          {
              'Prefix': 'string'
          },
      ],
      'EncodingType': 'url',
      'KeyCount': 123,
      'ContinuationToken': 'string',
      'NextContinuationToken': 'string',
      'StartAfter': 'string',
      'RequestCharged': 'requester'
  }

응답 구문은 list_objects_v2 - Boto3 1.40.52 설명서에서 참조할 수 있습니다.

성공

부울

success: true | false

오류 메시지

문자열

errorMessage: "Parameter validation failed:\nInvalid bucket name \"s3-activity-test \": Bucket name must match the regex \"^[a-zA-Z0-9.\\-_]{1,255}$\" or be an ARN matching the regex \"^arn:(aws).:(s3|s3-object-lambda):[a-z\\-0-9]:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\\-.]{1,63}$|^arn:(aws).*:s3-outposts:[a-z\\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\\-]{1,63}$\""

워크플로 예
`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 continuationToken: "some-token" next: end`

워크플로 예

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
          continuationToken: "some-token"
      next: end

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

입력 필드	선택성	유형	예시
awsRoleArn	선택 과목	문자열	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	선택 과목	문자열	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	선택 과목	문자열	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	선택 과목	문자열	`${{ :secrets:<awsSessionToken> }}`
지역	필수의	문자열	`"us-east-2"`
버킷	필수의	문자열	" `examplebucket` "
열쇠	필수의	문자열	" `path/to/object.txt` "
매개변수	선택 과목	지도	`{ "RequestPayer": "test", "BypassGovernanceRetention": false "VersionId":"testVersion", "MFA":"Test" }`
선택기	선택 과목	목록	`[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]`

출력 필드	유형	예시
response	물체
성공	부울	`success: true \| false`
오류 메시지	문자열	`errorMessage: "Parameter validation failed:\nInvalid bucket name \"s3-activity-test \": Bucket name must match the regex \"^[a-zA-Z0-9.\\-_]{1,255}$\" or be an ARN matching the regex \"^arn:(aws).:(s3\|s3-object-lambda):[a-z\\-0-9]:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\\-.]{1,63}$\|^arn:(aws).*:s3-outposts:[a-z\\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\\-]{1,63}$\""`

워크플로 예
`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`

워크플로 예

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

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

입력 필드	선택성	유형	예시
awsRoleArn	선택 과목	문자열	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	선택 과목	문자열	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	선택 과목	문자열	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	선택 과목	문자열	`${{ :secrets:<awsSessionToken> }}`
지역	필수의	문자열	`"us-east-2"`
버킷	필수의	문자열	" `examplebucket` "
열쇠	필수의	문자열	" `path/to/object.txt` "
몸	필수의	문자열	`file content`
contentType	필수의	문자열	" `plain/text` "
태그 지정	선택 과목	문자열	`"key1=value1"`
매개변수	선택 과목	지도	`{ "ServerSideEncryption": "AES256", "Metadata": { 'metadata1': 'value1', 'metadata2': 'value2', } }`
선택기	선택 과목	목록	`[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]`

입력 필드	유형
RequestPayer	문자열
ACL	문자열
CacheControl	문자열
ContentDisposition	문자열
ContentEncoding	문자열
ContentLanguage	문자열
ContentLength	Int
ContentMD5	문자열
ChecksumAlgorithm	문자열
ChecksumCRC32	문자열
체크섬CRC32C	문자열
체크섬CRC64NVME	문자열
체크섬SHA1	문자열
체크섬SHA256	문자열
만료	지도
IfMatch	문자열
IfNoneMatch	문자열
GrantFullControl	문자열
그랜트리드	문자열
GrantReadACP	문자열
그랜트라이트ACP	문자열
쓰기 오프셋 바이트	Int
서버 측 암호화	문자열
스토리지 클래스	문자열
웹사이트 리디렉션 위치	문자열
SSECustomerAlgorithm	문자열
SSE고객키	문자열
SSEKMSKeyId	문자열
SSEKMS 암호화 컨텍스트	문자열
버킷키 활성화됨	부울
RequestPayer	문자열
객체 잠금 모드	문자열
ObjectLockRetainUntilDate	지도
객체 잠금 법적 보류 상태	문자열
ExpectedBucketOwner	문자열
메타데이터	지도

출력 필드	유형	예시
response	물체	{ 'Expiration': 'string', 'ETag': 'string', 'ChecksumCRC32': 'string', 'ChecksumCRC32C': 'string', 'ChecksumCRC64NVME': 'string', 'ChecksumSHA1': 'string', 'ChecksumSHA256': 'string', 'ChecksumType': 'COMPOSITE'\|'FULL_OBJECT', 'ServerSideEncryption': 'AES256'\|'aws:fsx'\|'aws:kms'\|'aws:kms:dsse', 'VersionId': 'string', 'SSECustomerAlgorithm': 'string', 'SSECustomerKeyMD5': 'string', 'SSEKMSKeyId': 'string', 'SSEKMSEncryptionContext': 'string', 'BucketKeyEnabled': True\|False, 'Size': 123, 'RequestCharged': 'requester' } 응답 구문은 put_object를 참조할 수 있습니다 - Boto3 1.40.59 설명서
성공	부울	`success: true \| false`
오류 메시지	문자열	`errorMessage: "An error occurred (NoSuchBucket) when calling the PutObject operation: The specified bucket does not exist"`

출력 필드

유형

예시

response

물체

{
  'Expiration': 'string',
  'ETag': 'string',
  'ChecksumCRC32': 'string',
  'ChecksumCRC32C': 'string',
  'ChecksumCRC64NVME': 'string',
  'ChecksumSHA1': 'string',
  'ChecksumSHA256': 'string',
  'ChecksumType': 'COMPOSITE'|'FULL_OBJECT',
  'ServerSideEncryption': 'AES256'|'aws:fsx'|'aws:kms'|'aws:kms:dsse',
  'VersionId': 'string',
  'SSECustomerAlgorithm': 'string',
  'SSECustomerKeyMD5': 'string',
  'SSEKMSKeyId': 'string',
  'SSEKMSEncryptionContext': 'string',
  'BucketKeyEnabled': True|False,
  'Size': 123,
  'RequestCharged': 'requester'
  }

응답 구문은 put_object를 참조할 수 있습니다 - Boto3 1.40.59 설명서

성공

부울

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`

워크플로 예

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

GetObject 요청에서 개체의 전체 키 이름을 지정합니다.

입력 필드	선택성	유형	예시
awsRoleArn	선택 과목	문자열	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	선택 과목	문자열	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	선택 과목	문자열	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	선택 과목	문자열	`${{ :secrets:<awsSessionToken> }}`
지역	필수의	문자열	`"us-east-2"`
버킷	필수의	문자열	" `examplebucket` "
열쇠	필수의	문자열	" `path/to/object.txt` "
버전 ID	선택 과목	문자열	`"some-version-id"`
범위	선택 과목	문자열	`bytes=0-99`
매개변수	선택 과목	지도	`{ "ChecksumMode": "ENABLED", "ExpectedBucketOwner": "test-user" }`
선택기	선택 과목	목록	`[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]`

중요

객체가 100kb를 넘으면 작업이 실패합니다.

입력 필드	유형
IfMatch	문자열
수정된 경우	지도
IfNoneMatch	문자열
IfUnmodifiedSince	지도
응답 캐시 제어	문자열
응답내용처분	문자열
응답 콘텐츠 인코딩	문자열
응답내용언어	문자열
응답 콘텐츠 유형	문자열
응답 만료	지도
SSECustomerAlgorithm	문자열
SSE고객키	문자열
RequestPayer	문자열
부품 번호	Int
ExpectedBucketOwner	문자열
체크섬 모드	문자열

출력 필드	유형	예시
response	물체	{ 'Body': StreamingBody(), 'DeleteMarker': True\|False, 'AcceptRanges': 'string', 'Expiration': 'string', 'Restore': 'string', 'LastModified': datetime(2015, 1, 1), 'ContentLength': 123, 'ETag': 'string', 'ChecksumCRC32': 'string', 'ChecksumCRC32C': 'string', 'ChecksumCRC64NVME': 'string', 'ChecksumSHA1': 'string', 'ChecksumSHA256': 'string', 'ChecksumType': 'COMPOSITE'\|'FULL_OBJECT', 'MissingMeta': 123, 'VersionId': 'string', 'CacheControl': 'string', 'ContentDisposition': 'string', 'ContentEncoding': 'string', 'ContentLanguage': 'string', 'ContentRange': 'string', 'ContentType': 'string', 'Expires': datetime(2015, 1, 1), 'ExpiresString': 'string', 'WebsiteRedirectLocation': 'string', 'ServerSideEncryption': 'AES256'\|'aws:fsx'\|'aws:kms'\|'aws:kms:dsse', 'Metadata': { 'string': 'string' }, 'SSECustomerAlgorithm': 'string', 'SSECustomerKeyMD5': 'string', 'SSEKMSKeyId': 'string', 'BucketKeyEnabled': True\|False, 'StorageClass': 'STANDARD'\|'REDUCED_REDUNDANCY'\|'STANDARD_IA'\|'ONEZONE_IA'\|'INTELLIGENT_TIERING'\|'GLACIER'\|'DEEP_ARCHIVE'\|'OUTPOSTS'\|'GLACIER_IR'\|'SNOW'\|'EXPRESS_ONEZONE'\|'FSX_OPENZFS', 'RequestCharged': 'requester', 'ReplicationStatus': 'COMPLETE'\|'PENDING'\|'FAILED'\|'REPLICA'\|'COMPLETED', 'PartsCount': 123, 'TagCount': 123, 'ObjectLockMode': 'GOVERNANCE'\|'COMPLIANCE', 'ObjectLockRetainUntilDate': datetime(2015, 1, 1), 'ObjectLockLegalHoldStatus': 'ON'\|'OFF' } 응답 구문은 get_object - Boto3 1.40.59 문서에서 참조할 수 있습니다.
성공	부울	`success: true \| false`
오류 메시지	문자열	`errorMessage: "An error occurred (InvalidArgument) when calling the GetObject operation: Invalid version id specified"`

출력 필드

유형

예시

response

물체

{
  'Body': StreamingBody(),
  'DeleteMarker': True|False,
  'AcceptRanges': 'string',
  'Expiration': 'string',
  'Restore': 'string',
  'LastModified': datetime(2015, 1, 1),
  'ContentLength': 123,
  'ETag': 'string',
  'ChecksumCRC32': 'string',
  'ChecksumCRC32C': 'string',
  'ChecksumCRC64NVME': 'string',
  'ChecksumSHA1': 'string',
  'ChecksumSHA256': 'string',
  'ChecksumType': 'COMPOSITE'|'FULL_OBJECT',
  'MissingMeta': 123,
  'VersionId': 'string',
  'CacheControl': 'string',
  'ContentDisposition': 'string',
  'ContentEncoding': 'string',
  'ContentLanguage': 'string',
  'ContentRange': 'string',
  'ContentType': 'string',
  'Expires': datetime(2015, 1, 1),
  'ExpiresString': 'string',
  'WebsiteRedirectLocation': 'string',
  'ServerSideEncryption': 'AES256'|'aws:fsx'|'aws:kms'|'aws:kms:dsse',
  'Metadata': {
      'string': 'string'
  },
  'SSECustomerAlgorithm': 'string',
  'SSECustomerKeyMD5': 'string',
  'SSEKMSKeyId': 'string',
  'BucketKeyEnabled': True|False,
  'StorageClass': 'STANDARD'|'REDUCED_REDUNDANCY'|'STANDARD_IA'|'ONEZONE_IA'|'INTELLIGENT_TIERING'|'GLACIER'|'DEEP_ARCHIVE'|'OUTPOSTS'|'GLACIER_IR'|'SNOW'|'EXPRESS_ONEZONE'|'FSX_OPENZFS',
  'RequestCharged': 'requester',
  'ReplicationStatus': 'COMPLETE'|'PENDING'|'FAILED'|'REPLICA'|'COMPLETED',
  'PartsCount': 123,
  'TagCount': 123,
  'ObjectLockMode': 'GOVERNANCE'|'COMPLIANCE',
  'ObjectLockRetainUntilDate': datetime(2015, 1, 1),
  'ObjectLockLegalHoldStatus': 'ON'|'OFF'
  }

응답 구문은 get_object - Boto3 1.40.59 문서에서 참조할 수 있습니다.

성공

부울

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

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

시사

전제 조건

AWS S3 버킷의 객체 나열

작업 카탈로그에서 고려되지 않는 선택 사항인 입력 목록

응답 구문

객체 삭제

작업 카탈로그에서 고려되지 않는 선택 사항인 입력 목록

응답 구문

AWS S3 버킷에 객체를 추가합니다.

액션 카탈로그에서 고려되지 않는 선택 사항인 입력 목록입니다. 의 일부가 되어야 합니다

응답 구문

객체 가져오기

중요

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

응답 구문

입력 필드	유형
RequestPayer	문자열
BypassGovernanceRetention	부울
ExpectedBucketOwner	문자열
IfMatch	문자열
IfMatchLastModifiedTime	지도
IfMatchSize	Int
VersionId	문자열
MFA	문자열

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

AWS S3 작업

시사

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

응답 구문

객체 삭제

응답 구문

AWS S3 버킷에 객체를 추가합니다.

응답 구문

객체 가져오기

응답 구문

전제 조건