PowerScale: OneFS API'nin düzgün çalıştığını doğrulamak için curl komutunu kullanma

Summary: Bu KB makalesi, doğrudan curl komutlarını kullanarak kümedeki Uygulama Programlama Arayüzü (API) sorunlarını gidermek için kullanışlıdır. Özel komut dosyaları veya uygulama koduyla ilgili sorunları ortadan kaldırmak için kullanın. ...

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

Giriş

OneFS API ile ilgili bir sorunla karşılaştığınızda diğer sorun giderme işlemlerini gerçekleştirmeden önce curl komutu çalıştırarak temel işlemlerin düzgün çalıştığını doğrulayın. Bu makalede, API işlemlerini test etmek için curl komutunu kullanmaya yönelik yönergeler yer almaktadır. Bu, çalıştırdığınız komutun doğru biçimde olduğunu doğrulamanıza yardımcı olur.

OneFS API, iki işlevsel alandan oluşur:

  • Sistem yapılandırma API'si (OneFS 7.1.0 ve önceki sürümlerde Platform API'si olarak bilinir)
Bu alan, küme yapılandırması, yönetimi ve izleme işlevselliğini etkinleştirir.
  • Dosya sistemi erişim API'si (OneFS 7.1.0 ve önceki sürümlerde ad alanı API'sine RESTful Access veya RAN API olarak bilinir)
Bu alan, kümedeki dosya ve dizinler üzerinde işlemlere olanak tanır.


İşlemler

Sistem Yapılandırması API'sini veya dosya sistemi erişim API'sini test ederken curl komutunu "root" kimlik bilgileriyle kullanın.

  1. Kümedeki herhangi bir düğümde bir SSH bağlantısı kurun ve "kök" hesabını kullanarak oturum açın.
  2. Aşağıdaki Sistem yapılandırması API'si veya Dosya Sistemi Erişimi API'si bölümlerinde açıklandığı şekilde curl komutunu kullanın. 
  3. Sorun yaşamaya devam ederseniz Isilon Teknik Destek ile iletişime geçin.

curl komutları ve sözdizimi hakkında ek bilgi için curl man sayfasına bakın.

OneFS Sistem yapılandırması API istekleri ve beklenen yanıt hakkında ek bilgi için ilgili OneFS sürümünüzün API referans rehberine bakın. En yaygın OneFS sürümleri için bağlantılar: OneFS 8.2.2.0, OneFS 9.1.0, OneFS 9.5.0.0 ve OneFS 9.7.0.0

Sistem yapılandırma API'si

Sistem yapılandırma API'si ile kıvrılma için yaygın seçenekler 

Seçenek Açıklama
-d  Belirtilen verileri bir POST isteğinde gönderir
-H Kullanmak için ek bir başlık belirtir
-k Güvenilmeyen SSL sitelerine bağlantıya izin verir (Isilon varsayılanı kendinden imzalı SSL sertifikaları için)
-u Kimlik doğrulama için kullanıcı adı Komutu çalıştırırken bu kullanıcının parolasını girmeniz istenir
-v Ayrıntılı çıktıyı belirtir
-X  İstek yöntemini belirtir (GET, PUT,POST vb.)

 

Sistem Yapılandırma API'si ile curl sözcüğünün yaygın kullanımı

Aşağıda yaygın curl komutlarına örnekler verilmiştir. Gerçekleştirmek istediğiniz eylem için benzer söz dizimini takip edin.

  • Bilgi alma (GET komutları):

    Genel söz dizimi: Aşağıdakileri kullanın; burada <kullanıcı adı> kullanıcı adıdır ve <URL> , bağlandığınız düğümün URL'sidir. 
    # curl  -vk  -u "<username>" -H 'Content-type:application/json' -X GET '<URL>'


    Örneğin, Sunucu İleti Bloğu (SMB) paylaşımlarının listesini almak için komut aşağıdakine benzer: 
    # curl -vk -u "root" -H 'Content-type:application/json' -X GET 'https://10.11.1.1:8080/platform/1/protocols/smb/shares'

     
  • Bilgi gönderme (POST veya PUT komutları):

    Genel söz dizimi: Aşağıdakileri kullanın; burada <kullanıcı adı>json-data>,< JSON biçimli dizedir ve <URL>, bağlandığınız düğümün URL'sidir. 
    # curl  -vk  -u <username> -H 'Content-type:application/json' -X POST  -d '<json-data>' <URL>



    Örneğin, /ifs/papi-example yoluna sahip papi-example adlı yeni bir SMB paylaşımı oluşturmak için komut aşağıdakine benzer: 
    # 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'

Dosya Sistemi erişimi API'si

Dosya sistemi erişim API'si ile curl için yaygın seçenekler

Seçenek Açıklama
-d  Belirtilen verileri bir POST isteğinde gönderir
--veri-ikili İkili dosyanın konumunu belirtir
-H Kullanmak için ek bir başlık belirtir
-k Güvenilmeyen SSL sitelerine (Isilon varsayılanı kendinden imzalı SSL sertifikaları) bağlantıya izin verir.
-u Kimlik doğrulama için kullanıcı adı, bu kullanıcının parolasını sağlamanız istenir.
-v Ayrıntılı çıktıyı belirtir 
-X  İstek yöntemini belirtir (GET, PUT,POST vb.)

 

Dosya sistemi erişim API'si ile curl sözcüğünün yaygın kullanımı

Aşağıda yaygın curl komutlarına örnekler verilmiştir. Eylemin gerçekleştirilmesi için benzer bir söz dizimi izleyin.

NOT
Dosya sistemi erişim API'si aracılığıyla kendi ad alanlarınızı oluşturabilirsiniz, ancak doğrulama için varsayılan ad alanını kullanmanız gerekir. Varsayılan ad alanı /namespace/ifs'dir.

  • Bilgi alma (GET komutları):

    Genel söz dizimi: 
    # curl -vk -u "<username>" -X GET 'https://<node_IP>:8080/namespace/<access_point>'



    Örneğin, /ifs içerik listesini almak için: 
    # curl -vk -u "root" -X GET 'https://10.11.1.1:8080/namespace/ifs'

 

  • Bilgi gönderme (POST veya PUT komutları):

    Genel sözdizimi: Değişken< içerik başlığı> için doğru olanı kullanarak aşağıdakileri kullanın. İçerik başlığı> hakkında bilgi için< OneFS API referans rehberine bakın 
    # curl -vk -u "<username>" -H "<content header>" --data-binary @<source file path> -X PUT 'https://<node_IP>:8080/namespace/<access_point>/<destination file path>'


            Örneğin, bir veri dosyasını /tmp/testfile.jpg konumundan /ifs/papi-example dizinine kopyalamak için komut aşağıdakine benzer:

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



Yukarıdaki tüm komutlar, API sorgularını çalıştırmak için Temel HTTP kimlik doğrulamasını kullanır. 

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.