PowerScale : Comment utiliser la commande curl pour vérifier que l’API OneFS fonctionne correctement

Procédure

Utilisez la commande curl avec les informations d’identification « root » lors du test de l’API de configuration système ou de l’API d’accès au système de fichiers.

1. O créez une connexion SSH sur n’importe quel nœud du cluster et connectez-vous à l’aide du compte « root ».
2. Utilisez la commande curl comme décrit dans les sections API de configuration système ou API d’accès au système de fichiers ci-dessous. 
3. Si vous continuez à rencontrer des problèmes, contactez le support technique Isilon.

Pour plus d’informations sur les commandes et la syntaxe curl , reportez-vous à la page curl man.

Pour plus d’informations sur les demandes de l’API de configuration du système OneFS et la réponse attendue, consultez le Guide de référence de l’API de votre version OneFS correspondante. Liens vers les versions OneFS les plus courantes : APIde configuration système OneFS 8.2.2.0, OneFS 9.1.0, OneFS 9.5.0.0 et OneFS 9.7.0.0

Options courantes pour curl avec l’API de configuration du système 

Utilisation courante de curl avec l’API de configuration système

Vous trouverez ci-dessous des exemples de commandes curl courantes. Suivez une syntaxe similaire pour l’action que vous souhaitez effectuer.

• Récupération des informations (commandes GET) :
  
  Syntaxe générale : Utilisez les éléments suivants, où <nom d’utilisateur> est le nom d’utilisateur et <URL> est l’URL du nœud auquel vous vous connectez.

  # curl  -vk  -u "<username>" -H 'Content-type:application/json' -X GET '<URL>'

  
  
  Par exemple, pour obtenir la liste des partages SMB (Server Message Block), la commande ressemble à ce qui suit :

  # curl -vk -u "root" -H 'Content-type:application/json' -X GET 'https://10.11.1.1:8080/platform/1/protocols/smb/shares'

  
   
• Envoi d’informations (commandes POST ou PUT) :
  
  Syntaxe générale : Utilisez ce qui suit, où <username> est le nom d’utilisateur, <json-data> est la chaîne au format JSON et <URL> est l’URL du nœud auquel vous vous connectez.

  # curl  -vk  -u <username> -H 'Content-type:application/json' -X POST  -d '<json-data>' <URL>

  
  
  
  Par exemple, pour créer un nouveau partage SMB appelé papi-example avec le chemin d’accès / ifs/papi-example, la commande ressemble à ce qui suit :

  # curl -vk -u root -H "Content-type: application/json" -X POST -d '{ "name" : "papi-example", "path" : "/ifs/papi-example" }' 'https://10.11.1.1:8080/platform/1/protocols/smb/shares'

API d’accès au système de fichiers

Options courantes pour curl avec l’API d’accès au système de fichiers

Utilisation courante de curl avec l’API d’accès au système de fichiers

Vous trouverez ci-dessous des exemples de commandes curl courantes. Suivez une syntaxe similaire pour l’action à exécuter.

• Récupération des informations (commandes GET) :
  
  Syntaxe générale :

  # curl -vk -u "<username>" -X GET 'https://<node_IP>:8080/namespace/<access_point>'

  
  
  
  Par exemple, pour obtenir la liste de contenu de /ifs :

  # curl -vk -u "root" -X GET 'https://10.11.1.1:8080/namespace/ifs'

• Sending information (POST or PUT commands) :
  
  General syntax : Utilisez ce qui suit à l’aide de l’en-tête> correct pour le contenu variable<. Pour plus d’informations sur l’en-tête<> de contenu, consultez le Guide de référence de l’API OneFS

  # curl -vk -u "<username>" -H "<content header>" --data-binary @<source file path> -X PUT 'https://<node_IP>:8080/namespace/<access_point>/<destination file path>'

            Par exemple, pour copier un fichier de données de /tmp/testfile.jpg vers /ifs/papi-example, la commande ressemble à ce qui suit :

# curl -vk -u "root" -H "x-isi-ifs-target-type:object" --data-binary @/tmp/testfile.jpg -X PUT 'https://<node_IP>:8080/namespace/ifs/papi-example/testfile.jpg'