Isilon: Usando a API do OneFS com exportações NFS
Summary: Este artigo fornece um código de exemplo que mostra como usar a ferramenta curl para acessar a API do OneFS para gerenciar exportações NFS.
Symptoms
Cause
Resolution
O código de exemplo a seguir mostra como usar a ferramenta curl para acessar a API do OneFS para gerenciar exportações NFS.
Você pode modificar esse código de exemplo para seu próprio uso substituindo o endereço IP de exemplo 1.2.3.4 pelo endereço IP ou nome do host do cluster, ou por 'localhost' se estiver executando esses comandos localmente em um nó do cluster. Além disso, você deve substituir user1 e password1 pelas informações de conta apropriadas para o cluster.
Exportação NFS
Nos exemplos a seguir, solicitações são enviadas à API do OneFS para listar, criar, atualizar e excluir exportações NFS no sistema.
- O argumento --insecure (-k) permite a conexão por meio de SSL sem certificados.
- O argumento --verbose (-v) exibe os cabeçalhos completos da solicitação e resposta HTTP.
- O argumento --basic especifica a autenticação básica. O código de exemplo a seguir mostra como acessar o OneFS
O exemplo de criação abaixo pressupõe que um caminho /ifs/example_path existe em seu sistema e que o usuário que envia a solicitação tem o privilégio ISI_PRIV_NFS.
Listar todas as exportações NFS (GET)
Comandos de exemplo:curl https://1.2.3.4:8080/platform/1/protocols/nfs/exports --insecure --basic --user user1:password1 --verbose
Liste todas as exportações NFS com recuo amigável ao leitor canalizando o corpo da resposta por meio do módulo da ferramenta Python json.
curl https://1.2.3.4:8080/platform/1/protocols/nfs/exports --insecure --basic --user user1:password1 | python -m json.tool
Criar uma nova exportação (POST)
curl https://1.2.3.4:8080/platform/1/protocols/nfs/exports -k -u user1:password1 -v --data '{"paths": ["/ifs/example_path"]}'
Modificar uma exportação (PUT)
Observe que o corpo de resposta do POST acima deve conter o ID da exportação recém-criada. No exemplo a seguir, o ID de exportação é '2'.
curl https://1.2.3.4:8080/platform/1/protocols/nfs/exports/2 -X PUT -k -u user1:password1 -v --data '{"description": "Um exemplo de exportação."}'
Excluir uma exportação (DELETE)
Este comando excluirá a exportação com o ID '2'.
curl https://1.2.3.4:8080/platform/1/protocols/nfs/exports/2 -X DELETE -k -u user1:password1 -v