Organisations

Les organisations sont le conteneur de toute la gestion de:

• user and collaborator access
• compte de facturation et modes de paiement
• toute l'infrastructure Equinix Metal™, subdivisée en Projets.

Des tâches telles que l’invitation de collaborateurs, la consultation de factures, le déploiement de serveurs ou l’utilisation de fonctionnalités réseau sont effectuées au sein d’une organisation.

Si vous vous êtes inscrit à Equinix Metal en tant que particulier, vous devenez propriétaire d'une organisation liée à votre compte utilisateur. Si vous créez un compte Equinix Metal via une invitation, vous êtes ajouté comme utilisateur à l'organisation qui vous a invité. Un utilisateur peut être membre de plusieurs organisations.

Vos organisations

Console

Lorsque vous vous connectez à la console Equinix Metal, vous pouvez trouver toutes les organisations dont vous êtes membre sur la page Organizations.

Vous pouvez passer d'une organisation à l'autre en cliquant sur le menu déroulant, en en sélectionnant une dans la liste ou en cliquant sur Gérer tout.

CLI

Vous pouvez obtenir une liste de vos organisations avec la commande metal organization get.

metal organization get 

API

Vous pouvez obtenir une liste de vos organisations en envoyant une requête GET au point de terminaison API /organizations.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/

Paramètres et rôles de l'organisation

Console

Les renseignements généraux concernant une organisation se trouvent dans l'onglet Général, y compris son nom et son identifiant. Chaque organisation possède un identifiant unique, utilisé pour la référencer dans l'API et pour la renommer.

Les propriétaires et les administrateurs peuvent ajouter des adresses courriel spécifiques pour les courriels de maintenance et les courriels de signalement d'abus. Si aucune adresse courriel n'est spécifiée, les courriels seront envoyés par défaut à l'adresse courriel du propriétaire.

CLI

Les renseignements concernant une organisation sont disponibles avec la commande metal organization get lorsque vous spécifiez l'organisation avec l'indicateur --organization-id.

metal organization get --organization-id <org_UUID>

API

De même, vous pouvez récupérer des informations sur l'organisation avec une requête GET au point de terminaison /organizations/{id}.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/{id}

Les informations contenues dans la réponse varieront en fonction de votre rôle.

Si vous êtes un administrateur d'une organisation, vous avez la possibilité de:

• Gérez les informations et les paramètres de l'onglet Général.
• Gérez les utilisateurs de l'équipe, leurs rôles et les projets auxquels les collaborateurs ont accès.
• Accédez aux informations de facturation et gérez les modes de paiement.
• Gérer les projets de l'organisation.
• Gérez les réservations de serveur pour votre organisation.
• Quitter l'organisation.

Si vous êtes responsable IAM d'une organisation, vous avez la possibilité de:

• Gérez les informations et les paramètres de l'onglet Général.
• Gérez les utilisateurs de l'équipe, leurs rôles et les projets auxquels les collaborateurs ont accès.
• Créer ou ajouter un ou plusieurs nouveaux projets.
• Accédez aux frais d’utilisation de votre organisation.
• Quitter l'organisation.

Si vous êtes un collaborateur au sein d'une organisation, vous pouvez:

• Consultez et gérez les projets auxquels vous avez accès.
• Consultez les réservations matérielles des projets auxquels vous avez accès.
• Quitter l'organisation.

Si vous êtes un collaborateur limité au sein d'une organisation, vous pouvez:

• Consultez et gérez les projets auxquels vous avez accès, à l'exception des informations de facturation et de prix.
• Consultez les réservations de serveurs des projets auxquels vous avez accès. Cependant, les collaborateurs limités ne peuvent pas demander de serveurs réservés supplémentaires.
• Quitter l'organisation.

Si vous êtes membre facturier d'une organisation, vous pouvez:

• Accédez aux informations de facturation et gérez les modes de paiement.
• Quitter l'organisation.

Si vous êtes propriétaire d'une organisation, vous pouvez:

• Faites tout ce qui précède, sauf quitter une organisation.
• Les propriétaires sont les seuls membres qui peuvent supprimer une organisation.

Ajout de membres d'équipe à une organisation

Console

Si vous êtes propriétaire, administrateur ou gestionnaire IAM, vous pouvez inviter de nouveaux utilisateurs à se joindre à votre organisation via l'onglet Équipe de l'organisation.

Cliquez sur + Inviter un nouveau membre pour afficher un panneau vous permettant d'ajouter un seul membre ou plusieurs à la fois.

Chaque adresse courriel ajoutée recevra une réponse automatique de notre plateforme contenant un lien de vérification (pour accepter ou refuser l'invitation). Les utilisateurs ayant des invitations en attente apparaissent dans la liste des Membres de l'équipe, avec la possibilité de retourner le courriel d'invitation ou de copier leur lien d'invitation.

API

Vous pouvez aussi envoyer des invitations avec un 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": "string",
            "message": "string",
            "roles": [
                "string"
            ],
            "projects_ids": [
                "string"
            ]
        }
    }'

Paramètres corporels -

• "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.

Remarque: la seule façon de créer de nouveaux utilisateurs dans votre organisation est de créer une invitation et de les inviter.

Suppression d'un membre de l'équipe

Un propriétaire ou un administrateur peut également gérer les utilisateurs de l'organisation à partir de la liste « Membres de l'équipe » de l'onglet « Équipe ». Sélectionnez l'utilisateur que vous voulez supprimer de l'organisation, puis cliquez sur « Supprimer ».

Organisations et projets

Les projets se situent un niveau inférieur aux organisations et permettent de regrouper logiquement l'infrastructure. Les projets peuvent avoir leurs propres groupes d'utilisateurs, en tant que sous-ensemble des utilisateurs des organisations.

• Les propriétaires et les administrateurs ont accès à tous les projets d'une organisation
• Les collaborateurs peuvent avoir accès aux projets qui leur sont attribués projet par projet.

Chaque projet génère ses propres factures qui sont ensuite facturées à l'organisation chaque mois.

Quitter une organisation

Vous pouvez quitter une organisation à partir de l'onglet Général de l'organisation. Cliquez sur Quitter l'espace de travail, puis suivez les instructions de confirmation.

Une fois que vous quittez une organisation, vous ne pouvez plus accéder à ses paramètres ni à ses projets. Vous devrez être réintégré par un administrateur ou un propriétaire.

Supprimer une organisation

danger

La suppression d’une organisation est définitive.

• Vous ne pouvez pas supprimer une organisation contenant des projets. Vous devez supprimer tous les projets de l'organisation avant de la supprimer.
• Vous ne pouvez pas supprimer une organisation ayant des frais impayés. Toutes les factures générées par les projets d'une organisation doivent être réglées avant la suppression de l'organisation.
• Seuls les propriétaires d'organisation peuvent supprimer l'organisation.

Console

Dans l'onglet Général de la section Organisations, cliquez sur Supprimer l'organisation.

CLI

Vous pouvez supprimer une organisation dans l'interface de ligne de commande avec la commande metal organization delete.

metal organization delete --organization-id <org_UUID>

API

Dans l'API, vous pouvez supprimer une organisation en envoyant une requête DELETE au point de terminaison /organizations/{id}.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/organizations/{id}

Si votre organisation ne remplit pas les conditions de suppression, elle renverra une erreur.