Organizações

As organizações são o recipiente para toda a gestão de:

• user and collaborator access
• conta de cobrança e métodos de pagamento
• toda a infraestrutura Equinix Metal™, subdividida em Projetos.

Tarefas como convidar colaboradores, visualizar faturas, implantar servidores ou usar características de rede são realizadas dentro de uma organização.

Se você se inscreveu no Equinix Metal como indivíduo, você se torna proprietário de uma organização vinculada à sua conta de usuário . Se você criar uma conta no Equinix Metal por meio de um convite, você será adicionado como usuário à organização que o convidou. Um usuário pode ser membro de várias organizações.

Suas Organizações

Console

Ao fazer login no console Equinix Metal, você pode encontrar todas as organizações das quais você é membro na página [Organizações.

Você pode alternar entre as organizações clicando no menu suspenso, selecionando uma da lista ou clicando em Gerenciar tudo.

CLI

Você pode obter uma lista de suas organizações com o comando metal organization get.

metal organization get 

API

Você pode obter uma lista de suas organizações enviando uma solicitar GET para o endpoint da API /organizations.

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

Configurações e funções da organização

Console

As informações gerais sobre uma organização encontram-se na aba Geral, incluindo o nome e o ID da organização. Cada organização possui um ID único, que é utilizado para referenciá-la na API e permite que o nome da organização seja alterado.

Proprietários e administradores podem adicionar endereços e-mail específicos para e-mails de manutenção e e-mails de denúncia de abuso. Se nenhum endereço e-mail for especificado, os e-mails serão enviados para o endereço e-mail do proprietário por padrão.

CLI

As informações sobre uma organização estão disponíveis com o comando metal organization get quando você especifica a organização com a flag --organization-id.

metal organization get --organization-id <org_UUID>

API

Da mesma forma, você pode recuperar informações da organização com uma solicitar GET para o endpoint /organizations/{id}.

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

As informações na resposta variam de acordo com sua função.

Se você for um Administrador de uma organização, você tem a capacidade de:

• Gerencie as informações e configurações na guia Geral.
• Gerencie usuários na equipe, suas funções e a quais projetos os colaboradores têm acesso .
• Acesse as informações de cobrança e gerencie os métodos de pagamento.
• Gerenciar os projetos da organização.
• Gerencie as reservas de servidor para sua organização.
• Deixe a organização.

Se você for um Gerente de IAM de uma organização, você tem a capacidade de:

• Gerencie as informações e configurações na guia Geral.
• Gerencie usuários na equipe, suas funções e a quais projetos os colaboradores têm acesso .
• Crie ou adicione um novo projeto(s).
• Acesse as taxas de uso da sua organização.
• Deixe a organização.

Se você for um Colaborador em uma organização, você:

• Veja e gerencie os projetos aos quais você tem acesso .
• Veja as reservas de hardware dos projetos aos quais você tem acesso .
• Deixe a organização.

Se você for um Colaborador Limitado em uma organização, você pode:

• Veja e gerencie os projetos aos quais você tem acesso, exceto informações de cobrança e preços.
• Veja as reservas de servidores dos projetos aos quais você tem acesso . No entanto, Colaboradores Limitados não podem solicitar mais servidores reservados.
• Deixe a organização.

Se você for um membro com faturamento de uma organização, você:

• Acesse as informações de cobrança e gerencie os métodos de pagamento.
• Deixe a organização.

Se você for proprietário de uma organização, você:

• Faça tudo o que foi mencionado acima, exceto sair de uma organização.
• Os proprietários são os únicos membros que podem excluir uma organização.

Adicionar membros da equipe a uma organização

Console

Se você for proprietário, administrador ou gerente do IAM, você convidar novos usuários para sua organização na guia Equipe da organização.

Clique em + Convidar novo membro para abrir um painel onde você pode adicionar um único membro ou vários de uma só vez.

Cada e-mail adicionado receberá uma resposta automática da nossa plataforma com um link de verificação (para aceitar ou recusar) o convite. Os usuários com convites pendentes aparecem na lista de Membros da Equipe, com a opção de reenviar o e-mail de convite ou copiar o link do convite.

API

Você também pode enviar convites com um POST para o endpoint /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 corporais -

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

Observação: a única maneira de criar novos usuários na sua organização é criar um convite e convidá-los.

Removendo um membro da equipe

Um proprietário ou administrador também pode gerenciar usuários na organização a partir da lista Membros da Equipe na guia Equipe. Selecione o usuário que você deseja remover da organização e clique em Excluir.

Organizações e Projetos

Projetos ficam um nível abaixo de Organizações e são usados ​​para agrupar infraestrutura logicamente. Projetos podem ter seus próprios conjuntos de usuários, como um subconjunto dos usuários de Organizações.

• Proprietários e administradores têm acesso a todos os projetos em uma organização
• Os colaboradores podem ter acesso aos Projetos atribuídos a eles individualmente.

Cada Projeto gera suas próprias contas a pagar, que são então cobradas da Organização todo mês.

Deixando uma organização

Você pode optar por sair de uma organização na guia Geral da organização. Clique em Sair do espaço de trabalho e confirme a saída na caixa de diálogo.

Ao você de uma organização, você não poderá acesso nenhuma das configurações ou projetos dela. Você precisará ser adicionado novamente por um Administrador ou Proprietário.

Excluindo uma organização

perigo

A exclusão de uma organização é permanente.

• Não é possível excluir uma organização que contenha projetos. É necessário excluir todos os projetos da organização antes de excluí-la.
• Não é possível excluir uma organização com cobranças pendentes. Todas as faturas geradas pelos projetos em uma organização devem ser pagas antes da exclusão da organização.
• Somente os proprietários da organização podem excluir a organização.

Console

Na guia Organizações Geral, clique em Excluir organização.

CLI

Você pode excluir uma organização na CLI com o comando metal organization delete.

metal organization delete --organization-id <org_UUID>

API

Na API, você pode excluir uma organização enviando uma solicitar DELETE para o endpoint /organizations/{id}.

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

Se sua organização não atender às condições para exclusão, será retornado um erro.