huawei-cloud-obs-bucket-create

华为云 OBS 存储桶创建技能

概述

此技能用于在华为云对象存储服务（OBS）上创建存储桶。它提供简单的交互式存储桶创建流程，包括存储桶名称验证、区域选择、访问权限配置及其他高级选项。

适用场景：

• 在华为云 OBS 上创建新存储桶
• 设置存储桶访问权限和策略
• 配置存储桶区域和存储类别
• 根据规范验证存储桶名称
• 批量创建多个存储桶

前提条件

1. 已安装华为云 CLI 工具

必需检查：华为云 CLI（hcloud / KooCLI）>= 3.2.0

# Check if installed
hcloud version

如果尚未安装，或版本低于 3.2.0，请参阅 cli-installation-guide.md 了解 KooCLI 安装方法。 KooCLI 内置 obsutil 工具，如果 KooCLI 版本检查通过，则可以跳过 obsutil 检查。

2. 已配置华为云凭证

• 有效的华为云 OBS 凭证（AK/SK 模式）

# View configuration
hcloud obs ls -s

# Configuration file location ~/.obsutilconfig

如果尚未配置华为云凭证，请提示用户执行以下命令：

# Configure Huawei Cloud credentials
hcloud OBS config -i="<Your AK>" -k="<Your SK>" -e="obs.<Region>.myhuaweicloud.com"

华为云 OBS 凭证不会继承华为云凭证，需要单独设置。

• 安全规则：
  • 🚫 不要以明文形式直接输入 AK/SK 值。
  • 🚫 切勿泄露 AK/SK 值，也不要从 hcloud 配置文件中提取 AK/SK。
  • ✅ 仅使用 hcloud configure list 检查凭证状态。

核心工作流

bucket-name 是创建 OBS 存储桶的必填条件。如果上下文中未指定存储桶名称，请提示用户需要提供具体的存储桶名称，无需其他文字提示。

步骤 1：验证存储桶名称

存储桶名称规则如下：

1. 长度为 3-63 个字符，以数字或字母开头，可使用小写字母、数字、"-"、"."。
2. 不允许使用 IP 地址格式。
3. 不能以 "-" 或 "." 开头或结尾。
4. 不允许连续使用两个 "."（例如："my..bucket"）。
5. "." 和 "-" 不允许相邻（例如："my-.bucket" 和 "my.-bucket"）。"

如果存储桶名称不符合规范，请提醒用户重新设置存储桶名称。

步骤 2：选择区域

从上下文中获取要创建的 OBS 存储桶所在区域。如果未指定区域，则默认使用 ~/.obsutilconfig 文件中的 "endpoint" 参数作为区域。 返回提示文本：

存储桶成功创建后，无法更改区域，请谨慎选择。您要在 ${region} 创建存储桶

步骤 3：创建存储桶

# Create with recommended configuration
hcloud OBS mb obs://bucket-name [-acl=xxx] [-location=xxx] [-fs] [-az=xxx] [-sc=xxx]

# Batch create multiple buckets. Script exit code 6 from Huawei Cloud CLI is normal behavior, not an execution error
./scripts/batch_create_buckets.sh <bucket-name-prefix> <regions>

步骤 4：验证是否成功（可选）

# List all buckets to confirm creation success
hcloud OBS ls

# Check bucket properties
hcloud OBS stat obs://bucket-name

如果存储桶列表中包含本次创建的存储桶名称，并且正常输出存储桶信息，则提示创建成功并列出存储桶的基本信息。

核心命令

创建存储桶

hcloud OBS mb obs://bucket-name [-acl=xxx] [-location=xxx] [-fs] [-az=xxx] [-sc=xxx]

选项	描述	可能的值
-acl=xxx	访问控制列表	private、public-read、public-read-write
-location=xxx	区域	cn-north-4、cn-east-2 等
-az=xxx	可用区	multi-az
-sc=xxx	默认存储类别	standard、warm、cold、deep-archive

列出存储桶

hcloud OBS ls

查看存储桶属性

hcloud OBS stat obs://${bucket-name}

参数确认

必需参数

• bucket-name：存储桶名称，必须符合 OBS 命名规范（3-63 个字符，使用小写字母、数字、连字符、句点，且不能以连字符或句点开头或结尾）

可选参数

• region：区域代码，例如 cn-north-4（华北-北京 4）、cn-east-2（华东-上海 2）
• acl：访问权限，默认为 private
• storage-class：存储类别，默认为 standard
• az：可用区，默认为单可用区，可设置为 multi-az（多可用区）

最佳实践

1. 命名规范：使用有意义的存储桶名称，例如 project-name-environment-purpose-20250527
2. 区域选择：选择距离用户最近的区域以降低延迟。北京 4（cn-north-4）是常用区域
3. 访问控制：默认使用私有 ACL，仅在需要时开放公共读取
4. 存储类别：根据访问频率选择：
   • 标准存储（standard）：频繁访问的数据
   • 低频访问存储（warm）：不常访问的数据
   • 归档存储（cold）：很少访问的数据
   • 深度归档存储（deep-archive）：极少访问的数据
5. 批量创建：使用 batch_create_buckets.sh 脚本批量创建多个存储桶
6. 版本控制：考虑启用存储桶版本控制，以防止意外删除

注意事项

1. 存储桶名称唯一性：存储桶名称在 Huawei Cloud OBS 中全球唯一，不能与其他用户的名称重复
2. 区域不可变更：创建后无法更改存储桶所在区域
3. 费用：存储桶免费，但存储数据、请求和流量会产生费用
4. 安全性：不要在脚本中硬编码 AK/SK，请使用环境变量或配置文件
5. 权限：确保执行命令的用户拥有足够的 OBS 权限
6. 网络：确保网络可以访问 Huawei Cloud OBS 服务端点
7. 配额：检查账户的 OBS 存储桶数量配额
8. 删除保护：重要存储桶可以启用删除保护，防止意外删除

参考文档

文档	描述
KooCLI 安装指南	KooCLI 安装指南
常见错误及解决方法	错误排查