Création d'un projet

Au sein d'une organisation, les projets regroupent logiquement les serveurs, le stockage et l'infrastructure réseau. Plusieurs projets peuvent cohabiter au sein d'une même organisation, et l'ensemble de l'utilisation, des frais mensuels et des frais uniques d'un projet sont répercutés sur le compte de facturation de l'organisation.

Si vous vous êtes inscrit à un compte Equinix Metal et avez créé une organisation, votre premier projet est automatiquement créé pour vous à partir de la page Paramètres du projet. Si vous avez créé un compte après avoir été invité dans une organisation existante qui n'a pas de projets, vous accédez à l'onglet Projects de l'organisation. Si vous avez créé un compte après avoir été invité dans une organisation existante qui a des projets, vous êtes redirigé vers la page Gestion des serveurs de l'organisation pour le projet.

Les propriétaires et les administrateurs d'une organisation peuvent créer de nouveaux projets. Pour créer un projet, procédez comme suit :

Console

Si vous travaillez actuellement sur un projet, sélectionnez Manage All Projects dans le menu déroulant Project pour accéder à l'onglet Project de votre organisation.

Dans l'onglet Projet de votre organisation, cliquez sur Add New.

Dans le champ Nom du projet, saisissez un nom pour votre projet.

Cliquez sur Let's go. Un message de notification s'affiche pour vous informer que le projet a été créé avec succès. Vous pouvez visualiser le projet à partir de l'onglet Projets.

CLI

Vous pouvez créer un nouveau projet avec la commande metal project create. Spécifiez le nom du nouveau projet à l'aide de l'indicateur --name. En option, vous pouvez également spécifier l'organisation dans laquelle le projet doit être créé à l'aide de l'indicateur --organization-id.

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

API

Vous pouvez créer un nouveau projet en envoyant une requête POST au point de terminaison /projects.

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" est le seul champ obligatoire dans le corps de la demande.

Remarque : les comptes de démarrage n'ont pas la possibilité de créer plus d'un projet. Si vous avez besoin de créer plusieurs projets, contactez l'assistance à https://console.equinix.com/support ou envoyez un courriel à support@equinixmetal.com.

Utilisateurs et projets

Les utilisateurs qui sont membres de votre organisation et les utilisateurs qui ont le rôle de collaborateur ou de collaborateur limité peuvent se voir attribuer l'accès aux projets sur une base projet par projet. Les collaborateurs d'un projet sont autorisés à accéder à ses serveurs et autres infrastructures, à les approvisionner et à les gérer. Pour obtenir des informations générales sur les organisations et les rôles, consultez la page Organisations.

Inviter un utilisateur à un projet

Console

Vous invitez un utilisateur à faire partie de votre projet lorsque vous l'ajoutez à votre organisation (../identity-access-management/organizations.mdx#adding-team-members-to-an-organization).

Si vous invitez quelqu'un en tant qu'administrateur, il pourra accéder à tous les projets de votre organisation.

Si vous invitez quelqu'un en tant que collaborateur ou collaborateur limité, vous pouvez lui accorder un accès projet par projet.

Si vous invitez quelqu'un en tant qu'utilisateur de facturation, il ne pourra pas du tout accéder aux projets individuels.

API

Vous pouvez également inviter un utilisateur à participer à un projet par l'intermédiaire de l'API, en envoyant une requête POST au point de terminaison /organizations/{id}/invitations.

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>"
    ]
}'

Paramètres du corps :

• "invitee" (required) - An email address for the user you are sending an invite to.
• "message" (optional) - Include a message in the email invitation.
• "roles" - An array containing the role you would like to assign to your invitee. Options are "admin", "collaborator", "limited_collaborator" or "billing". If you invite someone as an "admin", they will be able to access all the Projects in your Organization. If you invite someone as a "collaborator" or "limited_collaborator", you can grant access on a Project-by-Project basis. If you invite someone as a "billing" user, they will not be able to access individual Projects.
• "projects_ids" - An array of Project IDs to assign access to Projects on a project-by-project basis for collaborators and limited collaborators.