CreateProtocolService - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Membuat layanan protokol untuk sistem file Cloud Parallel File Storage (CPFS). Proses pembuatan memakan waktu sekitar 5 hingga 10 menit.

Deskripsi operasi

Operasi ini hanya berlaku untuk sistem file CPFS.
Hanya CPFS versi 2.3.0 dan yang lebih baru yang mendukung layanan protokol. Anda dapat memanggil operasi DescribeFileSystems untuk mengkueri versi sistem file.
Spesifikasi layanan protokol.

Layanan protokol mencakup dua Jenis Protokol: General dan Cache. Dibandingkan dengan tipe General, tipe Cache menyediakan caching data hot spot. Saat cache terhit, bandwidth layanan protokol tipe Cache dapat melebihi bandwidth sistem file CPFS dan mencapai bandwidth maksimum yang dikonfigurasi untuk layanan protokol.
- General: Menyediakan akses protokol NFS dan target memasang tingkat folder untuk CPFS. Anda tidak perlu mengonfigurasi manajemen kluster Klien Portable Operating System Interface (POSIX). Fitur ini gratis.
- Cache: Menyediakan caching dalam memori di sisi server berdasarkan kebijakan LRU selain kemampuan tipe General. Saat data di-cache dalam memori, CPFS dapat menyediakan lebar pita jaringan internal yang lebih tinggi. Layanan protokol tipe Cache tersedia dalam dua spesifikasi: Cache L1 dan Cache L2, yang berbeda dalam lebar pita jaringan internal dan ukuran cache memori.
Catatan
Layanan protokol tipe Cache adalah layanan berbayar dan berada dalam pratinjau undangan. Untuk informasi tentang penagihan layanan protokol tipe Cache, lihat item yang dapat ditagih. Jika Anda memiliki masukan atau pertanyaan, bergabunglah dengan kelompok pengguna DingTalk (ID kelompok: 31045006299) untuk berkomunikasi dengan insinyur CPFS.
Jenis protokol.

Hanya NFSv3 yang didukung.
Prasyarat.

Sistem file CPFS harus telah dibuat dan berada dalam status Berjalan.
Informasi lainnya.
- Hanya satu layanan protokol yang dapat dibuat untuk setiap sistem file CPFS.
- Pembuatan layanan protokol mengonsumsi alamat IP pada vSwitch yang ditentukan (hingga 32 alamat IP). Pastikan vSwitch target memiliki resource alamat IP yang mencukupi.

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:CreateProtocolService

create

*FileSystem

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file.	cpfs-099394bd928c****
ProtocolSpec	string	Yes	Spesifikasi layanan protokol. Nilai valid: General (default). Valid values: CL2 : Cache L2. General : General. CL1 : Cache L1.	General
Throughput	integer	No	Bandwidth layanan protokol. Unit: MB/s.	8000
ProtocolType	string	Yes	Jenis protokol layanan protokol. Nilai valid: NFS (default). Hanya akses NFSv3 yang didukung.	NFS
Description	string	No	Deskripsi layanan protokol. Nilai ini ditampilkan sebagai "Nama layanan protokol" di Konsol. Batasan: Deskripsi harus memiliki panjang 2 hingga 128 karakter. Deskripsi harus diawali dengan huruf dan tidak dapat diawali dengan `http://` atau `https://`. Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).	此协议服务的描述。
VpcId	string	No	ID VPC layanan protokol. VPC harus sama dengan VPC sistem file. Jika tipe redundansi penyimpanan sistem file adalah penyimpanan redundan zona (ZRS), jangan atur parameter ini. Jika tidak, parameter ini wajib diisi.	vpc-2vct297b8157bth9z****
VSwitchId	string	No	ID vSwitch layanan protokol. Jika tipe redundansi penyimpanan sistem file adalah penyimpanan redundan zona (ZRS), jangan atur parameter ini. Jika tidak, parameter ini wajib diisi.	vsw-2vc3c2lybvdllxyq4****
DryRun	boolean	No	Apakah akan menjalankan dry run untuk permintaan ini. Dry run memeriksa validitas parameter dan dependensi tanpa benar-benar membuat instans atau menimbulkan biaya. Nilai valid: true: Mengirim permintaan pemeriksaan tanpa membuat layanan protokol. Item pemeriksaan mencakup apakah parameter wajib ditentukan, format permintaan, dan dependensi batas bisnis. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 dikembalikan, tetapi ProtocolServiceId kosong. false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, instans langsung dibuat.	false
ClientToken	string	No	Token Klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan Klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-42665544****

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	98696EF0-1607-4E9D-B01D-F20930B6****
ProtocolServiceId	string	ID kluster layanan protokol.	ptc-197ed6a00f2b****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "ProtocolServiceId": "ptc-197ed6a00f2b****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	MissingFileSystemId	FileSystemId is mandatory for this action.
400	MissingVpcId	VpcId is mandatory for this action.
400	MissingVSwitchId	VSwitchId is mandatory for this action.
403	InvalidProtocolSpec.NotSupported	The specified protocol spec does not supported.
403	InvalidNetworkType.NotSupported	The specified network type does not supported.
403	Instance.IncorrectStatus	The specified instance is in an incorrect status.
403	OperationDenied.ProtocolServiceExceedLimit	The protocol service amount exceed file system limit.
403	PermissionDenied.CapacityTooLow	Capacity of file system too low to subscribe protocol service.
403	PermissionDenied.ThroughputInvalid	Standard protocol service should not specified throughput.
403	PermissionDenied.ThroughputTooSmall	Throughput of protocol service too small.
403	PermissionDenied.ThroughputExceed	Throughput of protocol service must less than throughput of file system.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.
403	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
403	InvalidFset.InUse	Fset already used by other export.
403	InvalidFileSystemPath.InvalidCharacters	The specified filesystem path contains invalid characters.
403	MntPathConflict.InvalidParam	FilesetId and Path must and can only be specified one.
403	OperationDenied.TooManyDepth	The operation is denied due to Fsets path too deep.
403	OperationDenied.InvalidState	The operation is denied due to invalid file system state.
403	OperationDenied.NoProtocolServiceQuota	No protocol service quota.
403	OperationDenied.NotSupported	The operation is denied due to not supported.
403	PermissionDenied.CLThroughputInvalid	Throughput of caching protocol service is invalid.
403	InvalidVpcId.CrossVpcNotSupport.	Cross VPC not support.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidDescription.InvalidFormat	Description format is invalid.
404	InvalidVpcId.ConflictVpcCidr	Vpc cidr conflict with file system
404	InvalidAccessGroupName.NotFound	The specified access group does not exist.
404	InvalidAccessGroupName.NotAccessRule	There has no rule in access group.
404	OperationDenied.NoStock	The operation is denied due to no stock.
404	PathNotExistInFileSystem.InvalidParam	Given path does not exist in file system.
404	InvalidFsetId.NotFound	The specified Fileset ID does not exist.
404	InvalidParameter.VpcVswitchMismatch	Given vSwitch mismatch with given VPC.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.