DescribeDataFlows - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Mengkueri informasi alur data sistem file CPFS.

Deskripsi operasi

Hanya CPFS versi 2.2.0 dan lebih baru serta CPFS for Lingjun versi 2.4.0 dan lebih baru yang mendukung alur data. Anda dapat melihat informasi versi pada halaman detail sistem file di Konsol.
Untuk kunci filter (Filters), FsetIds, DataFlowIds, SourceStorage, ThroughputList, dan Status memerlukan pencocokan eksak. FileSystemPath, Description, dan SourceStoragePath mendukung Pencocokan kabur.
Kueri gabungan didukung.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

nas:DescribeDataFlows

list

*DataFlow

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file. CPFS: harus dimulai dengan `cpfs-`, misalnya cpfs-125487**. CPFS for Lingjun: harus dimulai dengan `bmcpfs-`, misalnya bmcpfs-0015**.	cpfs-099394bd928c****
Filters	array<object>	No	Kunci filter untuk mengkueri alur data.
	object	No
Key	string	No	Nama kunci filter. Nilai valid: DataFlowIds: memfilter berdasarkan ID alur data. FsetIds: memfilter berdasarkan ID Fileset. FileSystemPath: memfilter berdasarkan jalur Fileset dalam sistem file CPFS. SourceStorage: memfilter berdasarkan jalur akses penyimpanan sumber. ThroughputList: memfilter berdasarkan bandwidth transmisi alur data. Description: memfilter berdasarkan deskripsi Fileset. Status: memfilter berdasarkan status alur data. Valid values: FileSystemPath : memfilter berdasarkan jalur Fileset dalam sistem file CPFS. Status : memfilter berdasarkan status alur data. SourceStorage : memfilter berdasarkan jalur akses penyimpanan sumber. Description : memfilter berdasarkan deskripsi Fileset. SourceStoragePath : memfilter berdasarkan jalur akses penyimpanan sumber. ThroughputList : memfilter berdasarkan bandwidth transmisi alur data. DataFlowIds : memfilter berdasarkan ID alur data. FsetIds : memfilter berdasarkan ID Fileset.	FsetIds.
Value	string	No	Nilai kunci filter. Parameter ini tidak mendukung wildcard. Jika Key diatur ke DataFlowIds, Value diatur ke ID alur data atau sebagian dari ID alur data. Anda dapat menentukan satu atau beberapa ID alur data. Maksimal 10 ID alur data dapat ditentukan. Contoh: `df-194433a5be31**` atau `df-194433a512a2,df-234533a5be31`. Jika Key diatur ke FsetIds, Value diatur ke ID Fileset atau sebagian dari ID Fileset. Anda dapat menentukan satu atau beberapa ID Fileset. Maksimal 10 ID Fileset dapat ditentukan. Contoh: `fset-1902718ea0ae` atau `fset-235718ea0ae,fset-5122718ea0ae**`. Jika Key diatur ke FileSystemPath, Value diatur ke jalur atau sebagian dari jalur dalam sistem file CPFS. Panjang nilai harus 1 hingga 1024 karakter. Jika Key diatur ke SourceStorage, Value diatur ke jalur akses penyimpanan sumber. Panjang maksimal adalah 1024 karakter. Jika Key diatur ke ThroughputList, Value diatur ke bandwidth transmisi alur data. Kueri gabungan didukung. Jika Key diatur ke Description, Value diatur ke deskripsi atau sebagian dari deskripsi alur data. Jika Key diatur ke Status, Value diatur ke status alur data. Jika Key diatur ke SourceStoragePath, Value diatur ke jalur akses penyimpanan sumber atau sebagian dari jalur akses. Panjang maksimal adalah 1024 karakter.	FsetIds.
NextToken	string	No	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika hasil yang dikembalikan terpotong, gunakan NextToken untuk memperoleh konten mulai dari titik pemotongan.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
MaxResults	integer	No	Jumlah hasil untuk setiap kueri. Nilai valid: 10 hingga 100. Nilai default: 20.	20

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	2D69A58F-345C-4FDE-88E4-BF518948****
NextToken	string	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika hasil yang dikembalikan terpotong, gunakan NextToken untuk memperoleh konten mulai dari titik pemotongan.	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=
DataFlowInfo	object
DataFlow	array<object>	Koleksi informasi alur data.
	array<object>
FileSystemId	string	ID sistem file.	cpfs-099394bd928c****
DataFlowId	string	ID alur data.	df-194433a5be31****
Description	string	Deskripsi alur data. Batasan: Deskripsi harus memiliki panjang 2 hingga 128 karakter. Deskripsi harus dimulai dengan huruf atau karakter Mandarin dan tidak boleh dimulai dengan `http://` atau `https://`. Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), atau tanda hubung (-).	Bucket01 data flow.
CreateTime	string	Waktu pembuatan Fileset. Waktu mengikuti standar ISO 8601 dalam format `yyyy-MM-ddTHH:mm:ssZ`. Catatan Hanya CPFS yang didukung.	2021-09-30T10:08:08Z
UpdateTime	string	Waktu terakhir Fileset diperbarui. Waktu mengikuti standar ISO 8601 dalam format `yyyy-MM-ddTHH:mm:ssZ`. Catatan Hanya CPFS yang didukung.	2021-09-30T10:08:08Z
Status	string	Status alur data. Nilai valid: Starting: Alur data sedang dibuat atau dimulai. Running: Alur data telah dibuat dan berjalan normal. Updating: Alur data sedang dimodifikasi, seperti meningkatkan bandwidth transmisi atau mengubah interval pembaruan otomatis. Deleting: Alur data sedang dihapus. Stopping: Alur data sedang dihentikan. Stopped: Alur data telah dihentikan. Misconfigured: Konfigurasi alur data tidak normal. Misalnya, penyimpanan sumber tidak dapat diakses, atau bandwidth transmisi terlalu rendah untuk menyelesaikan pembaruan otomatis.	Running.
ErrorMessage	string	Paket error. Nilai valid: None (default): Alur data dalam keadaan normal. SourceStorageUnreachable: Jalur akses penyimpanan sumber tidak ditemukan. ThroughputTooLow: Bandwidth alur data terlalu rendah.	SourceStorageUnreachable.
SourceSecurityType	string	Tipe perlindungan keamanan penyimpanan sumber. Jika penyimpanan sumber harus diakses melalui perlindungan keamanan, tentukan tipe perlindungan keamanan. Nilai valid: None (default): Penyimpanan sumber tidak memerlukan perlindungan keamanan untuk akses. SSL: Akses dilindungi oleh Sertifikat SSL.	SSL.
SourceStorage	string	Jalur akses penyimpanan sumber. Format: `<storage type>://[<account id>:]<path>`. Di mana: storage type: Hanya OSS yang didukung. account id: UID akun tempat penyimpanan sumber berada. path: Nama Bucket OSS. Hanya huruf kecil, angka, dan tanda hubung (-) yang didukung. Nama harus dimulai dan diakhiri dengan huruf kecil atau angka. Panjang nama harus 8 hingga 128 karakter. Nama harus dienkode dalam UTF-8. Nama tidak boleh dimulai dengan http:// atau https://. Catatan Bucket OSS harus merupakan bucket yang ada di Wilayah. Hanya CPFS for Lingjun versi 2.6.0 dan yang lebih baru yang mendukung parameter account id.	oss://178321033379****:bucket-01
SourceStoragePath	string	Jalur akses dalam bucket penyimpanan sumber. Catatan Hanya CPFS for Lingjun yang didukung.	/prefix/
FsetId	string	ID Fileset. Catatan Hanya CPFS yang didukung.	fset-1902718ea0ae****
FsetDescription	string	Deskripsi pembaruan otomatis. Catatan Hanya CPFS yang didukung.	AutoUpdate01
FileSystemPath	string	Jalur Fileset dalam sistem file CPFS. Batasan: Panjang jalur harus 2 hingga 1024 karakter. Jalur harus dienkode dalam UTF-8. Jalur harus dimulai dan diakhiri dengan garis miring (/). Direktori harus berupa direktori Fileset pada CPFS. Catatan Hanya CPFS yang didukung.	/a/b/c/
AutoRefresh	object
AutoRefresh	array<object>	Koleksi informasi Kebijakan pembaruan otomatis. Catatan Hanya CPFS yang didukung.
	object
RefreshPath	string	Direktori pembaruan otomatis. CPFS hanya secara otomatis memeriksa apakah data sumber dalam direktori ini telah diperbarui dan secara otomatis mengimpor data yang diperbarui. Batasan: Panjang jalur harus 2 hingga 1024 karakter. Jalur harus dienkode dalam UTF-8. Jalur harus dimulai dan diakhiri dengan garis miring (/). Catatan Direktori harus merupakan direktori yang ada pada CPFS dan harus berada dalam Fileset yang telah mengaktifkan alur data.	/prefix1/prefix2/
AutoRefreshPolicy	string	Kebijakan pembaruan otomatis. Setelah data sumber diperbarui, kebijakan ini menentukan bagaimana pembaruan data diimpor ke CPFS. Nilai valid: None: Pembaruan data dari sumber tidak diimpor secara otomatis ke CPFS. Anda dapat menggunakan Tugas alur data untuk mengimpor pembaruan data dari sumber. ImportChanged: Pembaruan data dari sumber diimpor secara otomatis ke CPFS. Catatan Hanya CPFS yang didukung.	None.
AutoRefreshInterval	integer	Interval pembaruan otomatis. CPFS memeriksa direktori untuk pembaruan data pada interval ini. Jika ada pembaruan data, Tugas pembaruan otomatis dimulai. Unit: menit. Nilai valid: 5 hingga 526600. Nilai default: 10. Catatan Hanya CPFS yang didukung.	10
Throughput	integer	Bandwidth transmisi maksimum alur data. Unit: MB/s. Nilai valid: 600 1200 1500 Catatan Bandwidth transmisi alur data harus kurang dari bandwidth I/O sistem file. Hanya CPFS yang didukung.	600

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****",
  "NextToken": "TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=",
  "DataFlowInfo": {
    "DataFlow": [
      {
        "FileSystemId": "cpfs-099394bd928c****",
        "DataFlowId": "df-194433a5be31****",
        "Description": "Bucket01 data flow.",
        "CreateTime": "2021-09-30T10:08:08Z",
        "UpdateTime": "2021-09-30T10:08:08Z",
        "Status": "Running.",
        "ErrorMessage": "SourceStorageUnreachable.",
        "SourceSecurityType": "SSL.",
        "SourceStorage": "oss://178321033379****:bucket-01",
        "SourceStoragePath": "/prefix/",
        "FsetId": "fset-1902718ea0ae****",
        "FsetDescription": "AutoUpdate01",
        "FileSystemPath": "/a/b/c/",
        "AutoRefresh": {
          "AutoRefresh": [
            {
              "RefreshPath": "/prefix1/prefix2/"
            }
          ]
        },
        "AutoRefreshPolicy": "None.",
        "AutoRefreshInterval": 10,
        "Throughput": 600
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalCharacters	The parameter contains illegal characters.	Parameter tidak valid.
400	MissingFileSystemId	FileSystemId is mandatory for this action.	Parameter FileSystemId tidak ditentukan.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.	Operasi saat ini tidak mendukung versi sistem file ini.
403	OperationDenied.DataFlowNotSupported	The operation is not supported.	Sistem file tidak mendukung dataflow.
404	InvalidFilterValue	The specified parameter Filter.1.Value is invalid.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Sistem file yang ditentukan tidak ada.
404	InvalidFilterParam	The specified Filter.N.Key is invalid.	Parameter Filter.N.Key yang ditentukan tidak valid.
404	InvalidParameter.InvalidMaxResults	The specified MaxResults is invalid.	MaxResults yang ditentukan tidak valid.
404	InvalidParameter.InvalidNextToken	The specified NextToken is invalid.	NextToken yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.