組織・団体
組織は、すべての管理を行うための容器である:
共同作業者の招待、請求書の閲覧、サーバーのデプロイ、ネットワーク機能の使用などのタスクは、組織の内部で行われる。
個人としてエクイニクスメタルに登録した場合、お客様はユーザーアカウントに関連付けられた組織のオーナーになります。招待によってエクイニクスメタルアカウントを作成した場合、招待元の組織にユーザーとして追加されます。ユーザーは多くの組織のメンバーになることができます。
あなたの組織
- Console
- CLI
- API
Equinix Metalコンソールにログインすると、Organizationsページに所属するすべての組織が表示されます。

ドロップダウンをクリックするか、リストから 1 つを選択するか、[Manage All] をクリックすると、組織を切り替えることができます。

metal organization getコマンドで組織のリストを取得できます。
metal organization get
/organizations API エンドポイントに GET リクエストを送信すると、組織のリストを取得できます。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/
組織の設定と役割
- Console
- CLI
- API
組織に関する一般的な情報は、組織名と ID を含む General タブにあります。各組織は、API で組織を参照するために使用され、組織の名前を変更することができます一意の ID を持っています。

オーナーと管理者は、メンテナンス 電子メールと不正使用電子メールのために特定の電子メールアドレスを追加することができます。メールアドレスが指定されていない場合、メールはデフォルトでオーナーのメールアドレスに送信されます。
組織に関する情報は、--organization-id フラグで組織を指定すると、metal organization get コマンドで利用できます。
metal organization get --organization-id <org_UUID>
同様に、/organizations/{id} エンドポイントへの GET リクエストで組織情報を取得できます。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/{id}
回答に含まれる情報は、あなたの役割によって異なります。
組織のAdmin であれば、次のようなことが可能です:
- General_タブの情報と設定を管理します。
- チーム内のユーザー、その役割、共同作業者がアクセスできるプロジェクトを管理します。
- 請求情報にアクセスし、支払い方法を管理します。
- 組織のプロジェクトを管理します。
- お客様の組織のサーバー予約を管理します。
- 組織を去る。
IAM Manager 組織のマネージャーであれば、次のようなことができます:
- General_タブの情報と設定を管理します。
- チーム内のユーザー、その役割、共同作業者がアクセスできるプロジェクトを管理します。
- 新しいプロジェクトを作成または追加する。
- あなたの組織の利用料金にアクセスしてください。
- 組織を去る。
Collaborator 組織の一員であれば、以下のことが可能です:
Limited Collaborator 組織に所属している場合、以下のことが可能です:
- 課金および価格情報を除き、アクセス権が付与された プロジェクト を参照および管理できます。
- アクセスできるプロジェクトのサーバー予約を参照してください。ただし、リミテッドコラボレーターは、より多くの予約サーバーをリクエストすることはできません。
- 組織を去る。
Billing 組織のメンバーであれば、以下のことが可能です:
- 請求情報にアクセスし、支払い方法を管理します。
- 組織を去る。
組織のオーナー であれば、以下のことが可能です:
- 組織を去ること以外は、上記のすべてを行う。
- オーナーは、組織を削除できる唯一のメンバーです。
組織にチームメンバーを追加する
- Console
- API
オーナー、管理者、または IAM マネージャーの場合、組織の Team タブで新しいユーザーを組織に招待できます。

+ Invite New Member をクリックするとパネルが表示され、1人または複数のメンバーを一度に追加できます。

追加された各メールには、当社のプラットフォームから招待の確認リンク(承認/拒否のいずれか)が自動返信されます。招待が完了していないユーザーは、_チームメンバー_のリストに表示され、招待メールを再送するか、招待リンクをコピーすることができます。
/organizations/{id}/invitations エンドポイントに POST で招待を送信することもできます。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/organizations/{id}/invitations" \
-d '{
"invitee": "string",
"message": "string",
"roles": [
"string"
],
"projects_ids": [
"string"
]
}
}'
ボディ・パラメーター
"invitee"(required) - The email address of the user you are inviting to your organization."message"(optional) - An optional message to the user that is sent in the invite."roles"(required) - The role you are assigning to the new user. Options are: "admin", "collaborator", "limited collaborator", or "billing"."projects_ids"(optional) - If you want to invite the user to one or more projects in your organization, you can specify them in a list of project IDs.
注:組織内で新規ユーザーを作成する唯一の方法は、招待状を作成して招待することです。
チームメンバーの解任
オーナーまたは管理者は、[チーム]タブの[チームメンバー]リストから組織内のユーザーを管理することもできます。組織から削除したいユーザーを選択し、削除 をクリックします。

組織とプロジェクト
プロジェクトは、インフラストラクチャを論理的にグループ化するために使用されます。プロジェクトは、組織のユーザーのサブセットとして、独自のユーザーセットを持つことができます。
- オーナーと管理者は、組織内のすべてのプロジェクトにアクセスできます。
- 共同作業者は、プロジェクトごとに割り当てられたプロジェクトにアクセスすることができます。
各プロジェクトは、毎月組織に請求される独自の請求書を作成する。
組織を去る
組織の_General_ タブから、組織から離脱することを選択できます。Leave workspace をクリックし、確認ダイアログでクリックします。

一度組織を離れると、その組織の設定やプロジェクトにアクセスできなくなります。管理者またはオーナーが再度追加する必要があります。
組織の削除
組織の削除は永久に続く。
- プロジェクトを含む組織は削除できません。組織を削除する前に、その組織からすべてのプロジェクトを削除する必要があります。
- 未払いの請求がある組織を削除することはできません。組織を削除する前に、組織内のプロジェクトによって生成されたすべての請求書を支払う必要があります。
- 組織を削除できるのは、組織の所有者のみです。
- Console
- CLI
- API
Organizations _General_タブで、Delete Organization をクリックします。

CLI では metal organization delete コマンドで組織を削除できます。
metal organization delete --organization-id <org_UUID>
API では、/organizations/{id} エンドポイントに DELETE リクエストを送信することで、組織を削除できます。
curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/{id}
あなたの組織が削除の条件を満たしていない場合は、エラーが返されます。