AWS S3アクション

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビュープログラムの一部として提供されています。

このページでは、ワークフロー自動化アクションカタログで使用できる AWS S3 アクションの包括的なリファレンスを提供します。これらのアクションにより、S3 バケットとオブジェクトの操作が可能になります。

前提条件

ワークフロー自動化で AWS アクションを使用する前に、次の点を確認してください。

適切な権限を持つ AWS アカウント。
設定された AWS 認証情報 (IAM ユーザー認証情報、IAM ロール ARN、またはセッション認証情報)。
使用する予定の特定のAWSサービスに必要な IAM 権限。

IAM ユーザーおよび IAM ロールを作成する方法、およびワークフローオートメーションAWSアクションと統合するための静的 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	弦
ChecksumCRC32C	弦
ChecksumCRC64NVME	弦
ChecksumSHA1	弦
ChecksumSHA256	弦
Expires	地図
IfMatch	弦
IfNoneMatch	弦
GrantFullControl	弦
GrantRead	弦
GrantReadACP	弦
GrantWriteACP	弦
WriteOffsetBytes	Int
ServerSideEncryption	弦
StorageClass	弦
WebsiteRedirectLocation	弦
SSECustomerAlgorithm	弦
SSECustomerKey	弦
SSEKMSKeyId	弦
SSEKMSEncryptionContext	弦
BucketKeyEnabled	ブール値
RequestPayer	弦
ObjectLockMode	弦
ObjectLockRetainUntilDate	地図
ObjectLockLegalHoldStatus	弦
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"`
range	オプション	弦	`bytes=0-99`
パラメーター	オプション	地図	`{ "ChecksumMode": "ENABLED", "ExpectedBucketOwner": "test-user" }`
セレクター	オプション	リスト	`[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]`

重要

オブジェクトが 100kb を超える場合、アクションは失敗します。

入力フィールド	タイプ
IfMatch	弦
IfModifiedSince	地図
IfNoneMatch	弦
IfUnmodifiedSince	地図
ResponseCacheControl	弦
ResponseContentDisposition	弦
ResponseContentEncoding	弦
ResponseContentLanguage	弦
ResponseContentType	弦
ResponseExpires	地図
SSECustomerAlgorithm	弦
SSECustomerKey	弦
RequestPayer	弦
PartNumber	Int
ExpectedBucketOwner	弦
ChecksumMode	弦

出力フィールド	タイプ	例
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バケットにオブジェクトを追加する

レスポンス構文

オブジェクトを取得

レスポンス構文

前提条件