Use a API de gerenciamento de grade
Você pode executar tarefas de gerenciamento do sistema usando a API REST do Grid Management em vez da interface de usuário do Grid Manager. Por exemplo, você pode querer usar a API para automatizar operações ou criar várias entidades, como usuários, mais rapidamente.
Recursos de nível superior
A API de gerenciamento de grade fornece os seguintes recursos de nível superior:
-
/grid
: O acesso é restrito aos usuários do Grid Manager e é baseado nas permissões de grupo configuradas. -
/org
: O acesso é restrito a usuários que pertencem a um grupo LDAP local ou federado para uma conta de locatário. Para obter detalhes, consulte "Use uma conta de inquilino" . -
/private
: O acesso é restrito aos usuários do Grid Manager e é baseado nas permissões de grupo configuradas. As APIs privadas estão sujeitas a alterações sem aviso prévio. Os endpoints privados do StorageGRID também ignoram a versão da API da solicitação.
Emitir solicitações de API
A API de gerenciamento de grade usa a plataforma de API de código aberto Swagger. O Swagger fornece uma interface de usuário intuitiva que permite que desenvolvedores e não desenvolvedores realizem operações em tempo real no StorageGRID com a API.
A interface de usuário do Swagger fornece detalhes completos e documentação para cada operação de API.
-
Você está conectado ao Grid Manager usando um"navegador da web compatível" .
-
Você tem"permissões de acesso específicas" .
|
Todas as operações de API que você realiza usando a página de documentação da API são operações ativas. Tenha cuidado para não criar, atualizar ou excluir dados de configuração ou outros dados por engano. |
-
No cabeçalho do Grid Manager, selecione o ícone de ajuda e selecione Documentação da API.
-
Para executar uma operação com a API privada, selecione Ir para a documentação da API privada na página da API de gerenciamento do StorageGRID .
As APIs privadas estão sujeitas a alterações sem aviso prévio. Os endpoints privados do StorageGRID também ignoram a versão da API da solicitação.
-
Selecione a operação desejada.
Ao expandir uma operação de API, você pode ver as ações HTTP disponíveis, como GET, PUT, UPDATE e DELETE.
-
Selecione uma ação HTTP para ver os detalhes da solicitação, incluindo a URL do ponto de extremidade, uma lista de quaisquer parâmetros obrigatórios ou opcionais, um exemplo do corpo da solicitação (quando necessário) e as respostas possíveis.
-
Determine se a solicitação requer parâmetros adicionais, como um ID de grupo ou usuário. Então, obtenha esses valores. Talvez seja necessário emitir uma solicitação de API diferente primeiro para obter as informações necessárias.
-
Determine se você precisa modificar o corpo da solicitação de exemplo. Se sim, você pode selecionar Modelo para saber os requisitos de cada campo.
-
Selecione Experimentar.
-
Forneça quaisquer parâmetros necessários ou modifique o corpo da solicitação conforme necessário.
-
Selecione Executar.
-
Revise o código de resposta para determinar se a solicitação foi bem-sucedida.