组织机构
组织是所有管理的容器:
邀请合作者、查看发票、部署服务器或使用网络功能等任务都是在组织内部完成的。
如果您以个人身份注册Equinix Metal ,您将成为与您的用户账户绑定的组织的所有者。如果您通过邀请创建Equinix Metal账户,您将被添加为邀请您的组织的用户。一个用户可以是多个组织的成员。
您的组织
- Console
- CLI
- API
您可以使用 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。每个组织都有一个唯一的 ID,用于在 API 中引用该组织,并允许重命名组织。

所有者和管理员可以添加用于接收维护邮件和举报邮件的特定邮箱地址。如果未指定邮箱地址,邮件默认发送到所有者的邮箱地址。
使用 metal organization get 命令,并指定 --organization-id 标志,即可获取有关该组织的信息。
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}
响应中的信息将根据您的角色而有所不同。
如果您是组织的管理员,您拥有以下权限:
如果您是组织的身份和访问管理 (IAM) 经理,您拥有以下权限:
- 在“常规”选项卡上管理信息和设置。
- 管理团队中的用户、他们的角色以及合作者有权访问的项目。
- 创建或添加新项目。
- 了解您组织的使用费。
- 离开组织。
如果您是组织中的合作者,您可以:
如果您是组织中的有限合作者,您可以:
如果您是某个组织的计费成员,您可以:
- 访问账单信息并管理付款方式。
- 离开组织。
如果您是某个组织的所有者,您可以:
- 除了离开组织之外,做上述所有事情。
- 所有者是唯一可以删除组织的成员。
将团队成员添加到组织
- Console
- API
如果您是所有者、管理员或 IAM 管理员,您可以在组织的“团队”选项卡上邀请新用户加入您的组织。

点击**+邀请新成员**,即可打开一个面板,您可以在其中添加单个成员或一次添加多个成员。

每添加一个邮箱地址,我们的平台都会自动回复一封包含验证链接(用于接受/拒绝邀请)的邮件。有未处理的邀请的用户会出现在“团队成员”列表中,可以选择重新发送邀请邮件或复制邀请链接。
您还可以向 /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.
注意:在您的组织中创建新用户的唯一方法是创建邀请并邀请他们。
移除团队成员
所有者或管理员还可以从“团队”选项卡中的“团队成员”列表中管理组织中的用户。选择要从组织中移除的用户,然后单击“删除”。

组织和项目
项目位于组织之下一级,用于对基础设施进行逻辑分组。项目可以拥有自己的用户组,作为组织用户的子集。
- 所有者和管理员可以访问组织中的所有项目
- 合作者可以逐个项目地访问分配给他们的项目。
每个项目都会生成自己的可计费项目,然后每月向组织收取费用。
离开组织
您可以从组织的“常规”选项卡中选择离开组织。单击“离开工作区”,然后单击确认对话框。

离开组织后,您将无法访问该组织的任何设置或项目。您需要由管理员或所有者重新添加。
删除组织
删除组织是永久性的。
- 您无法删除包含项目的组织。您必须先删除该组织中的所有项目,然后才能删除该组织。
- 您无法删除有未结费用的组织。您必须先支付组织内项目生成的所有发票,然后才能删除该组织。
- 只有组织所有者可以删除组织。
- Console
- CLI
- API
在“组织_常规_”选项卡上,单击“删除组织”。

您可以使用 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}
如果您的组织不符合删除条件,则会返回错误。

