PowerScale: OneFS-ohjelmointirajapinnan oikean toiminnan tarkistaminen curl-komennolla

Summary: Tästä tietämyskannan artikkelista on apua klusterin ohjelmointirajapinnan (API) ongelmien vianmäärityksessä suoraan curl-komennoilla. Sen avulla voit sulkea pois mukautettuihin komentosarjoihin tai sovelluskoodiin liittyvät ongelmat. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Johdanto

Kun OneFS-ohjelmointirajapinnassa ilmenee ongelma, varmista että perustoiminnot toimivat oikein suorittamalla curl-komento ennen muuta vianmääritystä. Tässä artikkelissa on ohjeet curl-komennon käyttämiseen ohjelmointirajapinnan toimintojen testaamiseen. Se auttaa varmistamaan, että suorittamasi komento on oikeassa muodossa.

OneFS-ohjelmointirajapinta koostuu kahdesta toiminnallisesta alueesta:

  • Järjestelmän määrityksen API (OneFS 7.1.0:ssa ja sitä aiemmissa versioissa nimellä Platform API)
Tämä alue mahdollistaa klusterin määritys-, hallinta- ja valvontatoiminnot.
  • Tiedostojärjestelmän käytön ohjelmointirajapinta (OneFS 7.1.0 -versiossa ja aiemmissa nimitilan ohjelmointirajapinnan RESTful Access eli RAN API)
Tämä alue mahdollistaa klusterin tiedostojen ja hakemistojen käytön.


Toimenpide

Käytä curl-komentoa root-tunnistetiedoilla, kun testaat joko System Configuration APIa tai tiedostojärjestelmän käytön ohjelmointirajapintaa.

  1. Omuodosta SSH-yhteys johonkin klusterin solmuun ja kirjaudu root-tilillä.
  2. Käytä curl-komentoa alla olevissa System configuration API - tai File System Access API -osissa kuvatulla tavalla. 
  3. Jos ongelmat jatkuvat, ota yhteys Isilonin tekniseen tukeen.

Lisätietoja kiharakomennoista ja syntaksista on curl man -sivulla.

Lisätietoja OneFS-järjestelmän määrityksen ohjelmointirajapintapyynnöistä ja odotetuista vastauksista on oman OneFS-version ohjelmointirajapinnan viiteoppaassa. Linkit yleisimpiin OneFS-versioihin: Järjestelmän määrityksen API OneFS 8.2.2.0, OneFS 9.1.0, OneFS 9.5.0.0 ja OneFS 9.7.0.0

Yleiset käpristymisvaihtoehdot järjestelmän kokoonpanon sovellusliittymällä 

Asetus Kuvaus
-d  Lähettää määritetyt tiedot POST-pyynnössä
-H Määrittää käytettävän ylimääräisen ylätunnisteen
-k Sallii yhteyden ei-luotettuihin SSL-sivustoihin (Isilonin oletusarvoiset itse allekirjoitetut SSL-varmenteet)
-u Käyttäjänimi todennusta varten Kun suoritat komennon, saat kehotteen antaa salasana tälle käyttäjälle
-v Määrittää yksityiskohtaisen tuloksen
-X  Määrittää pyyntömenetelmän (GET,PUT, POST ja niin edelleen)

 

Kiharan yleinen käyttö järjestelmän kokoonpanon ohjelmointirajapinnan kanssa

Seuraavassa on esimerkkejä yleisistä kiharakomennoista . Noudata suoritettavan toiminnon syntaksia.

  • Tietojen noutaminen (GET-komennot):

    Yleinen syntaksi: Käytä seuraavaa, jossa <käyttäjänimi on käyttäjänimi> ja <URL-osoite> on sen solmun URL-osoite, johon olet muodostamassa yhteyttä. 
    # curl  -vk  -u "<username>" -H 'Content-type:application/json' -X GET '<URL>'


    Esimerkiksi SMB (Server Message Block) -jakojen luettelon hakemiseksi komento näyttää seuraavanlaiselta: 
    # curl -vk -u "root" -H 'Content-type:application/json' -X GET 'https://10.11.1.1:8080/platform/1/protocols/smb/shares'

     
  • Tietojen lähettäminen (POST- tai PUT-komennot):

    Yleinen syntaksi: Käytä seuraavaa, jossa <käyttäjänimi> on käyttäjänimi, <json-data> on JSON-muotoinen merkkijono ja <URL> on sen solmun URL-osoite, johon olet muodostamassa yhteyttä. 
    # curl  -vk  -u <username> -H 'Content-type:application/json' -X POST  -d '<json-data>' <URL>



    Jos esimerkiksi haluat luoda uuden SMB-jaon nimeltä papi-example , jonka polku on /ifs/papi-example, komento näyttää seuraavanlaiselta: 
    # 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'

Tiedostojärjestelmän käytön ohjelmointirajapinta

Yleiset käpristymisvaihtoehdot tiedostojärjestelmän käytön ohjelmointirajapinnalla

Asetus Kuvaus
-d  Lähettää määritetyt tiedot POST-pyynnössä
--data-binääri Määrittää binääritiedoston sijainnin
-H Määrittää käytettävän ylimääräisen ylätunnisteen
-k Sallii yhteyden ei-luotettuihin SSL-sivustoihin (Isilonin oletusarvoiset itse allekirjoitetut SSL-varmenteet).
-u Käyttäjänimi todennusta varten, sinua pyydetään antamaan tämän käyttäjän salasana.
-v Määrittää yksityiskohtaisen tuloksen 
-X  Määrittää pyyntömenetelmän (GET,PUT, POST ja niin edelleen)

 

Curlin yleinen käyttö tiedostojärjestelmän pääsyrajapinnan kanssa

Seuraavassa on esimerkkejä yleisistä kiharakomennoista . Noudata toiminnossa samanlaista syntaksia.

MUISTIINPANO
Voit luoda omia nimitiloja tiedostojärjestelmän käytön ohjelmointirajapinnan kautta, mutta sinun tulee käyttää oletusarvoista nimitilaa vahvistukseen. Oletusarvoinen nimitila on /namespace/ifs.

  • Tietojen noutaminen (GET-komennot):

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



    Voit esimerkiksi saada /ifs-sisältöluettelon: 
    # curl -vk -u "root" -X GET 'https://10.11.1.1:8080/namespace/ifs'

 

  • Tietojen lähettäminen (POST- tai PUT-komennot):

    Yleinen syntaksi: Käytä seuraavaa käyttämällä muuttuvan <sisältöotsikon> oikeaa kirjainta. Lisätietoja sisältöotsikosta<> on OneFS-ohjelmointirajapinnan viiteoppaassa 
    # curl -vk -u "<username>" -H "<content header>" --data-binary @<source file path> -X PUT 'https://<node_IP>:8080/namespace/<access_point>/<destination file path>'


            Jos esimerkiksi haluat kopioida datatiedoston /tmp/testfile.jpg-tiedostostahakemistoon /ifs/papi-example, komento näyttää seuraavanlaiselta:

# 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'



Kaikki yllä olevat komennot käyttävät HTTP-perustodennusta API-kyselyjen suorittamiseen. 

Affected Products

PowerScale OneFS

Products

PowerScale OneFS
Article Properties
Article Number: 000011287
Article Type: How To
Last Modified: 08 Oct 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.