Amazon S3 集成#

Amazon S3 集成可将你的 S3 存储桶连接到 Ultralytics Platform。你的图像会保留在存储桶中，Platform 会直接为图像编制索引，因此你可以浏览、标注图像并训练 YOLO 模型，无需上传副本。

创建只读 IAM 用户#

Platform 只会读取你的存储，不会写入、修改或删除你的对象。请使用具有仅列出和读取权限的专用 IAM 用户，切勿使用 root 凭据：

1. 在 AWS 控制台中，前往 IAM > Users，创建一个没有控制台访问权限的用户。

2. 为该用户附加一项策略，仅授予对你想连接的存储桶进行列出和读取的权限：

   {
       "Version": "2012-10-17",
       "Statement": [
           { "Effect": "Allow", "Action": "s3:ListAllMyBuckets", "Resource": "*" },
           {
               "Effect": "Allow",
               "Action": ["s3:ListBucket", "s3:GetObject"],
               "Resource": ["arn:aws:s3:::my-bucket", "arn:aws:s3:::my-bucket/*"]
           }
       ]
   }

   s3:ListAllMyBuckets 是可选项——它允许 Platform 自动发现你的存储桶，这样你就不必手动输入存储桶名称。

3. 打开该用户的 Security credentials 选项卡，创建一个 access key，然后复制访问密钥 ID 和秘密访问密钥。

连接到 Platform#

1. 前往 Settings > Integrations，然后在集成列表中选择 Amazon S3。
2. 输入访问密钥 ID、秘密访问密钥和存储桶所在区域（例如 us-east-1）。
3. 点击 Find available buckets，然后选择要连接的存储桶。如果策略不允许自动发现存储桶，请手动输入已知的存储桶名称。
4. 点击 Connect。Platform 会先验证其能否列出并读取每个所选存储桶，然后才保存任何内容。

你需要拥有工作区管理员或所有者角色，才能连接云存储。每个连接最多可关联 50 个存储桶，发现功能最多会列出密钥可访问的 300 个存储桶。

稍后使用同一个 IAM 用户重新连接时，会将新存储桶添加到现有集成中。只有在替换凭据仍能读取所有已连接的存储桶时，保存的凭据才会被替换。

从 S3 存储桶创建数据集#

1. 点击 New Dataset，然后打开 Cloud 标签页。
2. 选择一个已连接的存储桶，并浏览到包含数据的文件夹。
3. 确认文件夹，调整数据集名称，然后创建数据集。

Platform 会列出该文件夹一次，并为找到的内容建立索引：

• 图像 — .jpg、.jpeg、.png、.webp 和 .avif 对象会通过有大小限制的请求读取尺寸并建立索引。Platform 不会额外保存源图像的副本。
• 标签 — YOLO .txt 附属文件会解析为 Platform 标注，并按照标准的 images/ → labels/ 目录结构进行匹配，或与同一文件夹中的文件进行匹配。
• 元数据 — YAML 文件会提供类别名称和姿态关键点形状，与压缩包上传的处理方式完全相同。如果文件夹中有多个文件，则优先使用 data.yaml 和 data.yml。
• 任务 — 系统会根据部分标签文件判断任务，因此会依据标签形状识别分割、姿态和 OBB 文件夹，而不是依据你在对话框中选择的任务。
• 数据集划分 — 对象密钥中的 train、val 和 test 文件夹名称会自动分配数据集划分。

此后，该数据集的使用方式与其他数据集相同：你可以浏览并标注，将其设为公开或私有，与团队共享，并通过托管训练在其上训练。原始图像会按需流式传输，已建立索引的图像不会占用 Platform 的存储配额。

导入失败#

如果导入失败（例如文件夹为空、路径拼写错误或权限被撤销），数据集页面会显示错误。编辑者可以点击 Retry import，使用已保存的存储桶和文件夹重新启动导入，也可以创建一个指向正确路径的新数据集。

重试时会重新列出文件夹，而不是从中断处继续：首次尝试后添加的对象会被纳入，已不存在的对象则会从数据集中移除。

训练#

托管训练可通过常规训练流程进行。训练期间会使用 Platform 自己保存的已固定图像副本，你的 AWS 凭据绝不会暴露给训练工作负载。

断开连接#

断开连接会删除已存储的凭据，但不会触及 AWS 中的任何内容。基于这些存储桶创建的数据集仍会保留在你的工作区中，其类别、标签和标注也会保留，但在重新连接同一个 IAM 用户之前，无法加载、预览或用于训练其中的图像。

使用 REST API 和 GET /api/integrations/buckets 返回的集成 ID：

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

如果要直接从源头撤销访问权限，请在 AWS IAM 中停用或删除访问密钥。

当前限制#

由 S3 提供支持的数据集目前不支持需要由 Platform 保存图像副本的功能：自动标注、聚类分析、数据集克隆和不可变的版本快照。

删除由 S3 提供支持的数据集或其中的单张图像，只会移除 Platform 保存的引用，不会触及你的对象。

另请参阅 Google Cloud Storage 和 Azure Blob Storage 集成。

常见问题#