huawei-cloud-obs-bucket-create

Huawei Cloud OBS バケット作成スキル

概要

このスキルは、Huawei Cloud Object Storage Service（OBS）でバケットを作成するために使用します。バケット名の検証、リージョンの選択、アクセス権限の設定、その他の高度なオプションを含む、シンプルで対話的なバケット作成プロセスを提供します。

適用シナリオ：

• Huawei Cloud OBS で新しいバケットを作成する
• バケットのアクセス権限とポリシーを設定する
• バケットのリージョンとストレージクラスを設定する
• 仕様に照らしてバケット名を検証する
• 複数のバケットを一括作成する

前提条件

1. Huawei Cloud CLI ツールのインストール

必須確認項目：Huawei Cloud CLI（hcloud / KooCLI）>= 3.2.0

# Check if installed
hcloud version

インストールされていない場合、またはバージョンが 3.2.0 より古い場合は、KooCLI のインストールについて cli-installation-guide.md を参照してください。 KooCLI には obsutil ツールが組み込まれているため、KooCLI のバージョン確認に合格した場合は、obsutil の確認を省略できます。

2. Huawei Cloud 認証情報の設定

• 有効な Huawei Cloud OBS 認証情報（AK/SK 方式）

# View configuration
hcloud obs ls -s

# Configuration file location ~/.obsutilconfig

Huawei Cloud 認証情報が設定されていない場合は、次のコマンドを実行するようユーザーに促してください。

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

Huawei Cloud OBS の認証情報は Huawei Cloud の認証情報を引き継がないため、個別に設定する必要があります。

• セキュリティルール：
  • 🚫 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 のインストールガイド
一般的なエラーと解決策	エラーのトラブルシューティング