Organizaciones

Las organizaciones son el contenedor de toda la gestión de:

• user and collaborator access
• cuenta de facturación y formas de pago
• toda la infraestructura Equinix Metal™, subdividida en Proyectos.

Tareas como invitar a colaboradores, consultar facturas, desplegar servidores o utilizar funciones de red se realizan dentro de una organización.

Si se registró en Equinix Metal como particular, se le convierte en propietario de una organización vinculada a su cuenta de usuario. Si crea una cuenta de Equinix Metal a través de una invitación, se le añade como usuario a la organización que le invitó. Un usuario puede ser miembro de muchas organizaciones.

Sus organizaciones

Console

Cuando inicie sesión en la consola de Equinix Metal, podrá encontrar todas las organizaciones de las que es miembro en la página Organizaciones.

Puede cambiar de una organización a otra haciendo clic en el menú desplegable, seleccionando una de la lista o haciendo clic en Gestionar todas.

CLI

Puede obtener una lista de sus Organizaciones con el comando metal organization get.

metal organization get 

API

Puede obtener una lista de sus organizaciones enviando una solicitud GET al punto final de la API /organizations.

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

Configuración de la organización y funciones

Console

La información general sobre una Organización se encuentra en la pestaña General, incluyendo el nombre y el ID de la Organización. Cada Organización tiene un ID único, que se utiliza para hacer referencia a la organización en la API y permite cambiar el nombre de la Organización.

Los propietarios y administradores pueden añadir direcciones de correo electrónico específicas para los correos electrónicos de mantenimiento y los correos electrónicos de abuso. Si no se especifica ninguna dirección de correo electrónico, los correos irán a la dirección de correo electrónico del Propietario por defecto.

CLI

La información sobre una organización está disponible con el comando metal organization get cuando se especifica la organización con la bandera --organization-id.

metal organization get --organization-id <org_UUID>

API

Del mismo modo, puede recuperar información sobre la organización con una solicitud GET al punto final /organizations/{id}.

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

La información de la respuesta variará en función de su función.

Si usted es un Admin de una organización tiene la capacidad de:

• Gestione la información y los ajustes en la pestaña General.
• Gestione los usuarios del equipo, sus funciones y los proyectos a los que tienen acceso los colaboradores.
• Acceda a la información de facturación y gestione los métodos de pago.
• Gestione los [proyectos] de la organización (../projects/managing-a-project.mdx).
• Gestione las reservas de servidores de su organización.
• Deja la organización.

Si usted es un IAM Manager de una organización tiene la capacidad de:

• Gestione la información y los ajustes en la pestaña General.
• Gestione los usuarios del equipo, sus funciones y los proyectos a los que tienen acceso los colaboradores.
• Crear o añadir un nuevo proyecto(s).
• Acceda a las tarifas de uso de su organización.
• Deja la organización.

Si usted es un Colaborador en una organización puede:

• Vea y gestione los proyectos a los que tiene acceso.
• Consulte las reservas de hardware de los proyectos a los que tiene acceso.
• Deja la organización.

Si usted es un Colaborador Limitado en una organización puede:

• Vea y gestione los proyectos a los que se le ha concedido acceso, excepto la información sobre facturación y precios.
• Consulte las reservas de servidores de los proyectos a los que tiene acceso. Sin embargo, los Colaboradores Limitados no pueden realizar solicitudes de más servidores reservados.
• Deja la organización.

Si usted es Facturación miembro de una organización puede:

• Acceda a la información de facturación y gestione los métodos de pago.
• Deja la organización.

Si usted es un Propietario de una organización puede:

• Hacer todo lo anterior, excepto dejar una organización.
• Los propietarios son los únicos miembros que pueden eliminar una organización.

Añadir miembros de un equipo a una organización

Console

Si es propietario, administrador o gestor de IAM, puede invitar a nuevos usuarios a su organización en la pestaña Equipo de la organización.

Haga clic en + Invitar a un nuevo miembro para que aparezca un panel en el que podrá añadir un único miembro o varios a la vez.

Cada correo electrónico añadido recibirá una respuesta automática de nuestra plataforma con un enlace de verificación (para aceptar/rechazar) la invitación. Los usuarios con invitaciones pendientes aparecen en la lista de Miembros del equipo, con la opción de reenviar el correo electrónico de invitación o copiar su enlace de invitación.

API

También puede enviar invitaciones con un POST al punto final /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"
            ]
        }
    }'

Parámetros corporales -

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

Nota: la única forma de crear nuevos usuarios en su organización es crear una invitación e invitarlos.

Baja de un miembro del equipo

Un Propietario o Administrador también puede gestionar usuarios de la organización desde la lista Miembros del equipo de la pestaña Equipo. Seleccione el usuario al que desea eliminar de la organización y haga clic en Eliminar.

Organizaciones y proyectos

Los proyectos se sitúan un nivel por debajo de las organizaciones y se utilizan para agrupar lógicamente las infraestructuras. Los proyectos pueden tener sus propios conjuntos de usuarios, como subconjunto de los usuarios de las organizaciones.

• Los propietarios y administradores tienen acceso a todos los proyectos de una organización.
• Los colaboradores pueden acceder a los proyectos que se les asignen proyecto por proyecto.

Cada proyecto genera su propia factura, que se factura a la Organización cada mes.

Dejar una organización

Puede optar por abandonar una organización desde la pestaña General de la Organización. haga clic en Abandonar espacio de trabajo, y haga clic a través del diálogo de confirmación.

Una vez que abandone una organización, no podrá acceder a ninguno de los ajustes o proyectos de la organización. Tendrá que volver a ser añadido por un administrador o propietario.

Eliminar una organización

peligro

La eliminación de una organización es permanente.

• No puede eliminar una organización que contenga proyectos. Tienes que eliminar todos los proyectos de la organización antes de borrarla.
• No puede eliminar una organización que tenga cargos pendientes. Todas las facturas generadas por los proyectos de una organización deben pagarse antes de eliminar la organización.
• Sólo los Propietarios de la organización pueden eliminarla.

Console

En la pestaña Organizaciones General, haga clic en Eliminar organización.

CLI

Puede eliminar una Organización en la CLI con el comando metal organization delete.

metal organization delete --organization-id <org_UUID>

API

En la API, puede eliminar una organización enviando una solicitud DELETE al punto final /organizations/{id}.

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

Si su organización no cumple las condiciones para la eliminación, devolverá un error.