PowerScale: Sådan bruger du curl-kommandoen til at kontrollere, at OneFS API fungerer korrekt

Summary: Denne KB-artikel er nyttig til fejlfinding af API-problemer (Application Programming Interface) mod klyngen direkte ved hjælp af krøllekommandoer. Brug den til at udelukke problemer med brugerdefinerede scripts eller applikationskode. ...

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

Indledning

Når du støder på et problem med OneFS API, skal du kontrollere, at grundlæggende handlinger fungerer korrekt, ved at køre en curl-kommando , før du foretager anden fejlfinding. Denne artikel indeholder instruktioner til brug af curl-kommandoen til at teste API-handlinger. Det hjælper med at kontrollere, at den kommando, du kører, er i det korrekte format.

OneFS API består af to funktionsområder:

  • Systemkonfigurations-API (kendt i OneFS 7.1.0 og tidligere som Platform API)
Dette område muliggør klyngekonfiguration, administration og overvågningsfunktionalitet.
  • Filsystemadgangs-API (kendt i OneFS 7.1.0 og tidligere som RESTful Access to the namespace API eller RAN API)
Dette område muliggør handlinger på filer og mapper i klyngen.


Procedure

Brug curl-kommandoen med "root" -legitimationsoplysninger, når du tester enten System Configuration API eller filsystemets adgangs-API.

  1. Open en SSH-forbindelse på en hvilken som helst node i klyngen, og log ind ved hjælp af "root" -kontoen.
  2. Brug curl-kommandoen som beskrevet i afsnittene System configuration API eller File System Access API nedenfor. 
  3. Hvis du fortsat oplever problemer, skal du kontakte Isilons tekniske support.

For yderligere information om krøllekommandoer og syntaks, se curl man-siden.

Du kan finde yderligere oplysninger om anmodninger om OneFS-systemkonfigurations-API og forventet svar i API-referencevejledningen for din respektive OneFS-version. Links til de mest almindelige OneFS-versioner: Systemkonfigurations-API til OneFS 8.2.2.0, OneFS 9.1.0, OneFS 9.5.0.0 og OneFS 9.7.0.0

Almindelige muligheder for krølle med systemkonfigurations-API'en 

MULIGHEDER Beskrivelse
-d  Sender angivne data i en POST-anmodning
-H Angiver en ekstra overskrift, der skal bruges
-k Tillader forbindelse til SSL-websteder, der ikke er tillid til (for Isilons selvsignerede SSL-standardcertifikater)
-u Brugernavn til godkendelse Når du kører kommandoen, bliver du bedt om at angive adgangskoden for denne bruger
-v Angiver detaljeret output
-X  Angiver anmodningsmetode (GET, PUT,POST osv.)

 

Almindelig brug af curl med System Configuration API

Følgende er eksempler på almindelige krøllekommandoer . Følg lignende syntaks for den handling, du vil udføre.

  • Hentning af oplysninger (GET-kommandoer):

    Generel syntaks: Brug følgende, hvor <brugernavn> er brugernavnet, og <URL> er URL-adressen på den node, du opretter forbindelse til. 
    # curl  -vk  -u "<username>" -H 'Content-type:application/json' -X GET '<URL>'


    Hvis du f.eks. vil have en liste over SMB-delinger (Server Message Block), ser kommandoen ud som følgende: 
    # curl -vk -u "root" -H 'Content-type:application/json' -X GET 'https://10.11.1.1:8080/platform/1/protocols/smb/shares'

     
  • Afsendelse af oplysninger (POST- eller PUT-kommandoer):

    Generel syntaks: Brug følgende, hvor <brugernavn> er brugernavnet, json-data> er den JSON-formaterede streng, og URL er URL-adressen på den node,< du opretter forbindelse til.>< 
    # curl  -vk  -u <username> -H 'Content-type:application/json' -X POST  -d '<json-data>' <URL>



    Hvis du f.eks. vil oprette en ny SMB-deling kaldet papi-example med stien /ifs/papi-example, ser kommandoen ud som følgende: 
    # 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 til filsystemadgang

Almindelige muligheder for krølle med filsystemets adgangs-API

MULIGHEDER Beskrivelse
-d  Sender angivne data i en POST-anmodning
--data-binær Angiver placeringen af den binære fil
-H Angiver en ekstra overskrift, der skal bruges
-k Tillader forbindelse til SSL-websteder, der ikke er tillid til (Isilons selvsignerede SSL-standardcertifikater).
-u Brugernavn til godkendelse, bliver du bedt om at angive adgangskoden for denne bruger.
-v Angiver detaljeret output 
-X  Angiver anmodningsmetode (GET, PUT,POST osv.)

 

Almindelig brug af curl med filsystemets adgangs-API

Følgende er eksempler på almindelige krøllekommandoer . Følg en lignende syntaks for handlingen at udføre.

SEDDEL
Du kan oprette dine egne navneområder via filsystemets adgangs-API, men du skal bruge standardnavneområdet til bekræftelse. Standardnavneområdet er /navneområde/hvis.

  • Hentning af oplysninger (GET-kommandoer):

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



    Hvis du f.eks. vil have indholdsfortegnelsen /ifs: 
    # curl -vk -u "root" -X GET 'https://10.11.1.1:8080/namespace/ifs'

 

  • Afsendelse af oplysninger (POST- eller PUT-kommandoer):

    Generel syntaks: Brug følgende ved at bruge det korrekte til overskriften> med variabelt< indhold. Du kan finde oplysninger om <indholdsoverskriften> i OneFS API-referencevejledningen 
    # curl -vk -u "<username>" -H "<content header>" --data-binary @<source file path> -X PUT 'https://<node_IP>:8080/namespace/<access_point>/<destination file path>'


            Hvis du f.eks. vil kopiere en datafil fra /tmp/testfile.jpg til /ifs/papi-example, ser kommandoen ud som følger:

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



Alle ovenstående kommandoer bruger grundlæggende HTTP-godkendelse til at køre API-forespørgsler. 

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.