Skip to main content
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Entendendo a API de gerenciamento do locatário

Colaboradores
PDFs

Você pode executar tarefas de gerenciamento do sistema usando a API REST do Gerenciamento do locatário em vez da interface de usuário do Gerenciador do locatário. Por exemplo, você pode querer usar a API para automatizar operações ou criar várias entidades, como usuários, mais rapidamente.

A API de gerenciamento do Tenant 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 interajam com a API. A interface do usuário Swagger fornece detalhes completos e documentação para cada operação da API.

Para acessar a documentação do Swagger para a API de gerenciamento do locatário:

Passos

  1. Inicie sessão no Gestor do Locatário.

  2. Selecione Ajuda Documentação da API no cabeçalho do Gerenciador do Locatário.

Operações da API

A API de Gerenciamento do Tenant organiza as operações de API disponíveis nas seguintes seções:

  • * Conta* — operações na conta de locatário atual, incluindo obter informações de uso do armazenamento.

  • Auth — operações para realizar autenticação de sessão do usuário.

    A API de gerenciamento do locatário suporta o esquema de autenticação de token do portador. Para um login de locatário, você fornece um nome de usuário, senha e AccountID no corpo JSON da solicitação de autenticação (ou seja, POST /api/v3/authorize ). Se o usuário for autenticado com êxito, um token de segurança será retornado. Esse token deve ser fornecido no cabeçalho de solicitações de API subsequentes ("autorização: Token portador").

    Consulte ""proteção contra falsificação de solicitação entre sites"" para obter informações sobre como melhorar a segurança de autenticação.

    Observação Se o logon único (SSO) estiver ativado para o sistema StorageGRID, você deverá executar etapas diferentes para autenticar. Consulte ""autenticar na API se o logon único estiver ativado"" nas instruções de administração do StorageGRID.

  • Config — operações relacionadas à versão do produto e versões da API de Gerenciamento do locatário. Você pode listar a versão de lançamento do produto e as principais versões da API suportadas por essa versão.

  • Containers — operações em baldes S3 ou contentores Swift, como segue:

    Protocolo Permissão permite

    S3

    • Criação de buckets compatíveis e não compatíveis

    • Modificação das configurações de conformidade legadas

    • Definir o controle de consistência para operações executadas em objetos

    • Criando, atualizando e excluindo a configuração CORS de um bucket

    • Ativar e desativar as atualizações da última hora de acesso para objetos

    • Gerenciamento das configurações dos serviços da plataforma, incluindo replicação do CloudMirror, notificações e integração de pesquisa (notificação de metadados)

    • Eliminar buckets vazios

    Rápido

    Definir o nível de consistência usado para contentores

  • Disabled-features — operações para visualizar recursos que podem ter sido desativados.

  • Endpoints — operações para gerenciar um endpoint. Os endpoints permitem que um bucket do S3 use um serviço externo para replicação, notificações ou integração de pesquisa do StorageGRID CloudMirror.

  • Groups — operações para gerenciar grupos de locatários locais e recuperar grupos de locatários federados de uma origem de identidade externa.

  • Identity-source — operações para configurar uma fonte de identidade externa e sincronizar manualmente informações de grupo federado e de usuário.

  • Regions — operações para determinar quais regiões foram configuradas para o sistema StorageGRID.

  • S3 — operações para gerenciar chaves de acesso S3 para usuários arrendatários.

  • S3-object-lock — operações para determinar como o bloqueio global de objetos S3 (conformidade) é configurado para o sistema StorageGRID.

  • Usuários — operações para visualizar e gerenciar usuários de inquilinos.

Detalhes da operação

Quando você expande cada operação da API, você pode ver sua ação HTTP, URL do endpoint, uma lista de todos os parâmetros necessários ou opcionais, um exemplo do corpo da solicitação (quando necessário) e as possíveis respostas.

Exemplo mostrando a operação GET Groups na Swagger API

Emissão de solicitações de API

Importante Todas as operações de API que você executa usando a página da Web do API Docs são operações ativas. Tenha cuidado para não criar, atualizar ou excluir dados de configuração ou outros dados por engano.
Passos

  1. Clique na ação HTTP para ver os detalhes da solicitação.

  2. Determine se a solicitação requer parâmetros adicionais, como um grupo ou ID de usuário. Em seguida, obtenha esses valores. Talvez você precise emitir uma solicitação de API diferente primeiro para obter as informações de que precisa.

  3. Determine se você precisa modificar o corpo de solicitação de exemplo. Em caso afirmativo, você pode clicar em modelo para aprender os requisitos para cada campo.

  4. Clique em Experimente.

  5. Forneça quaisquer parâmetros necessários ou modifique o corpo do pedido conforme necessário.

  6. Clique em Executar.

  7. Revise o código de resposta para determinar se a solicitação foi bem-sucedida.

Informações relacionadas

"Proteção contra falsificação de solicitação entre sites (CSRF)"

"Administrar o StorageGRID"