SuperAPI AI 工具集

awsflow-s3

部署与运维

查看项目

更新于 10-16 10:35

技能介绍

awsflow-s3 是 necatiarslan/awsflow 中的一个技能,用于通过 awsflow 的 S3Tool 管理 Amazon S3 桶和对象。官方说明指出,当用户询问 S3 桶或对象、想要列出/上传/下载/复制/删除 S3 对象、需要检查桶配置(加密、版本控制、生命周期等)、想用 S3 Select SQL 查询 CSV/JSON/Parquet 文件、想打开交互式 S3 Explorer 视图、需要检查桶策略/通知/复制设置,或想创建/删除桶及更新桶设置时,可使用本技能。

主要能力(对象操作):ListBuckets 列出账号中所有 S3 桶;ListObjectsV2 按 Prefix、Delimiter、MaxKeys、ContinuationToken、StartAfter 等参数列出桶内对象;ListObjectVersions 在启用版本控制的桶中列出对象版本;HeadBucket 检查桶是否存在及是否有访问权限;HeadObject 在不下载的情况下获取对象元数据;GetObject 下载或读取对象内容,支持 DownloadToTemp 与 AsText;PutObject 上传内容到对象,支持 Body、ContentType、Metadata;DeleteObject 删除对象,可指定 VersionId;CopyObject 在桶内或桶间复制对象,支持 Metadata 与 MetadataDirective;SelectObjectContent 使用 SQL 表达式查询 CSV/JSON/Parquet 内容,需要 Expression、ExpressionType、InputSerialization、OutputSerialization;GetObjectAttributes 获取指定对象属性(ETag、Checksum、ObjectParts、StorageClass、ObjectSize);GetObjectLegalHold 与 GetObjectRetention 分别获取对象的法定保留状态与保留设置。

主要能力(桶配置与生命周期):CreateBucket 创建桶,DeleteBucket 删除空桶;PutBucketVersioning 启用或暂停版本控制;PutBucketEncryption 设置默认桶加密;PutBucketLifecycleConfiguration 设置生命周期规则;PutBucketTagging 设置桶标签;PutBucketPolicy 与 DeleteBucketPolicy 设置或删除桶策略;PutObjectTagging 与 DeleteObjectTagging 设置或移除对象标签;读取类命令包括 GetBucketLocation、GetBucketEncryption、GetBucketVersioning、GetBucketLifecycleConfiguration、GetBucketReplication、GetBucketLogging、GetBucketTagging、GetBucketCors、GetBucketWebsite、GetBucketAccelerateConfiguration、GetBucketRequestPayment、GetBucketPolicy、GetBucketNotificationConfiguration;OpenS3Explorer 可打开交互式 S3 Explorer 视图,支持 Bucket、Key、Prefix 参数。

使用方式:通过 S3Tool 执行 S3 命令,官方说明强调始终提供 params 对象,示例格式为 { "command": "命令名", "params": { ... } }。各命令的必填与可选参数见技能文档,命令示例中给出了参数结构与取值方式。

相关服务:文档提到 S3 与 SNS/SQS/Lambda(通过 GetBucketNotificationConfiguration 查看事件通知目标)、CloudTrail(S3 数据事件记录到 CloudTrail 并可在 CloudWatch Logs 查看)、Glue(Glue 爬虫编目 S3 数据,Glue 作业读写 S3)、EMR(EMR 集群使用 S3 作为输入输出数据,EMRFS)、CloudFormation(S3 桶常由 CloudFormation 堆栈管理)、IAM(桶策略与 IAM 策略控制访问,可用 IAMTool SimulatePrincipalPolicy 测试)存在关联。对于文件和文件夹的批量上传/下载,官方提示使用 S3FileOperationsTool(见 awsflow-s3-fileops 技能)。

适用场景与限制:适用于需要查询、上传、下载、复制、删除 S3 对象,或检查、创建、删除桶及更新桶设置的场景。删除桶需要桶为空。SelectObjectContent 需要提供输入与输出序列化配置。关于计费、价格、平台支持、权限前提及效果等信息,资料未提供,暂未确认。