mcloud-organizations

Cloud CLI：組織コマンド

mcloud organizations コマンドを実行して、Cloud の組織を一覧表示および取得します。

制約事項

• organizations list には個人認証（ブラウザーログインまたは個人用アクセスキー）が必要です。このコマンドでは、組織アクセスキーを使用すると 401 が返されます。
• 組織アクセスキーを使用して MCLOUD_TOKEN で認証している場合は、代わりに mcloud whoami --json を使用して組織 ID を取得してください。

コマンド

organizations list

アカウントからアクセスできるすべての組織を一覧表示します。

mcloud organizations list --json

オプション：

• --json — JSON 形式で出力します

organizations get

ID を指定して単一の組織を取得します。メタデータ、サブスクリプションの詳細、メンバーを返します。

mcloud organizations get <organization-id> --json

引数：

• organization — 組織 ID（必須）

オプション：

• -o/--organization <id> — アクティブなコンテキストの組織を上書きします（引数と一致する必要があります）
• --json — JSON 形式で出力します

組織のフィールド（JSON）

フィールド	説明
id	組織 ID
name	組織の表示名
billing_email	請求先の連絡用メールアドレス
status	active またはそれ以外
members	id、role、user.email を含むメンバーオブジェクトの配列
subscription	現在のプラン、期間、is_active フラグ
account_holder	請求アカウント所有者の詳細

例

# List all organizations
mcloud organizations list --json

# Set context to first organization
ORGANIZATION_ID=$(
  mcloud organizations list --json \
    | jq -r '.[0].id'
)
mcloud use --organization "$ORGANIZATION_ID"

# Find organization ID by name
ORGANIZATION_ID=$(
  mcloud organizations list --json \
    | jq -r '.[] | select(.name == "My Organization") | .id'
)

# Get organization details (subscription, members)
mcloud organizations get org_123 --json

# List member emails
mcloud organizations get org_123 --json \
  | jq -r '.members[].user.email'

# Check subscription plan
mcloud organizations get org_123 --json \
  | jq '{plan: .subscription.plan.name, status: .subscription.is_active}'