创建项目

在组织内，项目按逻辑将服务器、存储和网络基础设施分组。同一组织内可以共存多个项目，并且项目的所有使用量、月度费用和一次性费用都会汇总到该组织的结算账户中。

如果您注册了 Equinix Metal 帐户并创建了组织，您的第一个项目将自动在“项目设置”页面创建。如果您是在受邀加入一个没有项目的现有组织后创建帐户，则会进入该组织的“项目”选项卡。如果您是在受邀加入一个已有项目的现有组织后创建帐户，则会进入该项目的“管理服务器”页面。

组织的所有者和管理员可以创建新的项目。要创建项目，请执行以下操作：

Console

如果您目前正在处理某个项目，请从“项目”下拉菜单中选择“管理所有项目”，以导航到您组织的“项目”选项卡。

在组织的“项目”选项卡中，单击“添加新项目”。

在项目名称字段中，输入项目的名称。

点击“开始”。屏幕上会弹出通知消息，告知您项目已成功创建。您可以在“项目”选项卡中查看该项目。

CLI

您可以使用 metal project create 命令创建新项目。使用 --name 标志指定新项目的名称。您还可以选择使用 --organization-id 标志指定要创建项目的组织。

metal project create --name <string> --organization-id <org_UUID>

API

您可以通过向 /projects 端点发送 POST 请求来创建一个新项目。

curl -X POST \
    -H "Content-Type: application/json" \
    -H "X-Auth-Token: <API_TOKEN>" \
    "https://api.equinix.com/metal/v1/projects/" \
    -d '{
        "customdata": { },
        "name": "string",
        "organization_id": "<uuid>",
        "payment_method_id": "<uuid>"
    }'

"name" 是请求正文中唯一必填字段。

注意：入门级账户只能创建单个项目。如果您需要创建多个项目，请访问 https://console.equinix.com/support 或发送电子邮件至 support@equinixmetal.com 联系支持团队。

用户和项目

在“组织”页面，点击“团队”选项卡，即可管理哪些用户可以访问项目。组织成员以及拥有“协作者”或“有限协作者”角色的用户，可以逐个项目地分配项目访问权限。项目协作者可以访问、配置和管理项目的服务器及其他基础架构。 有关组织和角色的一般信息，请参阅组织页面。

邀请用户加入项目

Console

当你将用户添加到你的组织时，你就邀请用户成为你的项目的一部分。

如果您邀请某人作为管理员，他们将能够访问您组织中的所有项目。

如果您邀请某人作为合作者或有限合作者，您可以根据每个项目授予访问权限。

如果您邀请某人作为计费用户，他们将根本无法访问单个项目。

API

您还可以通过 API 邀请用户加入项目，方法是向 /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": "<valid_email_address>",
    "message": "<string>",
    "organization_id": "<uuid>",
    "roles": [
        "<string>"
    ],
    "projects_ids": [
        "<uuid>"
    ]
}'

身体参数：

• "invitee"（必填）- 要向其发送邀请的用户的电子邮件地址。
• "message"（可选）- 在电子邮件邀请中包含消息。
• "roles" - 一个数组，包含您希望分配给受邀者的角色。选项包括 "admin"、"collaborator"、"limited_collaborator" 或 "billing"。如果您邀请某人担任 "admin" 角色，他们将能够访问您组织中的所有项目。如果您邀请某人担任 "collaborator" 或 "limited_collaborator" 角色，您可以逐个项目地授予访问权限。如果您邀请某人担任 "billing" 角色，他们将无法访问单个项目。
• "projects_ids" - 用于按项目为协作者和有限协作者分配项目访问权限的项目 ID 数组。