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.

Endpoints de API Swift compatíveis

Colaboradores
PDFs

O StorageGRID oferece suporte aos seguintes endpoints da API Swift: O URL de informações, o URL de autenticação e o URL de armazenamento.

URL de informações

Você pode determinar os recursos e limitações da implementação do StorageGRID Swift emitindo uma solicitação GET para o URL base do Swift com o caminho /info.

https://FQDN | Node IP:Swift Port/info/

No pedido:

  • FQDN é o nome de domínio totalmente qualificado.

  • Node IP É o endereço IP do nó de armazenamento ou do nó de gateway na rede StorageGRID.

  • Swift Port É o número de porta usado para conexões Swift API no nó de armazenamento ou nó de gateway.

Por exemplo, o seguinte URL de informações solicitaria informações de um nó de armazenamento com o endereço IP de 10.99.106.103 e usando a porta 18083.

https://10.99.106.103:18083/info/

A resposta inclui os recursos da implementação Swift como um dicionário JSON. Uma ferramenta cliente pode analisar a resposta JSON para determinar os recursos da implementação e usá-los como restrições para operações de armazenamento subsequentes.

A implementação do StorageGRID do Swift permite o acesso não autenticado ao URL de informações.

URL de autenticação

Um cliente pode usar o URL de autenticação Swift para autenticar como usuário de conta de locatário.

https://FQDN | Node IP:Swift Port/auth/v1.0/

Você deve fornecer o ID da conta do locatário, o nome de usuário e a senha como parâmetros nos X-Auth-User cabeçalhos e X-Auth-Key da solicitação, da seguinte forma:

X-Auth-User: Tenant_Account_ID:Username

X-Auth-Key: Password

Nos cabeçalhos de solicitação:

  • Tenant_Account_ID É o ID de conta atribuído pelo StorageGRID quando o locatário Swift foi criado. Esse é o mesmo ID de conta de locatário usado na página de login do Gerenciador do Locatário.

  • Username É o nome de um usuário do locatário que foi criado no Gerenciador do Locatário. Esse usuário deve pertencer a um grupo que tenha a permissão Swift Administrator. O usuário raiz do locatário não pode ser configurado para usar a API REST do Swift.

    Se a Federação de identidade estiver ativada para a conta de locatário, forneça o nome de usuário e a senha do usuário federado do servidor LDAP. Em alternativa, forneça o nome de domínio do utilizador LDAP. Por exemplo:

    X-Auth-User: Tenant_Account_ID:Username@Domain_Name

  • Password é a senha para o usuário do locatário. As senhas de usuário são criadas e gerenciadas no Gerenciador do locatário.

A resposta a uma solicitação de autenticação bem-sucedida retorna um URL de armazenamento e um token de autenticação, como segue:

X-Storage-Url: https://FQDN | Node_IP:Swift_Port/v1/Tenant_Account_ID

X-Auth-Token: token

X-Storage-Token: token

Por padrão, o token é válido por 24 horas a partir do tempo de geração.

Os tokens são gerados para uma conta de locatário específica. Um token válido para uma conta não autoriza um usuário a acessar outra conta.

URL de armazenamento

Um aplicativo cliente pode emitir chamadas de API REST Swift para executar operações de conta, contentor e objeto com suporte em um nó de gateway ou nó de storage. As solicitações de armazenamento são endereçadas ao URL de armazenamento retornado na resposta de autenticação. A solicitação também deve incluir o cabeçalho X-Auth-Token e o valor retornado da solicitação de autenticação.

https://FQDN | IP:Swift_Port/v1/Tenant_Account_ID

[/container][/object]

X-Auth-Token: token

Alguns cabeçalhos de resposta de armazenamento que contêm estatísticas de uso podem não refletir números precisos para objetos modificados recentemente. Pode levar alguns minutos para que números precisos apareçam nesses cabeçalhos.

Os cabeçalhos de resposta a seguir para operações de conta e contentor são exemplos daqueles que contêm estatísticas de uso:

  • X-Account-Bytes-Used

  • X-Account-Object-Count

  • X-Container-Bytes-Used

  • X-Container-Object-Count

Informações relacionadas

"Configurar contas de inquilino e conexões"

"Operações de conta"

"Operações de contêiner"

"Operações de objetos"