CreateAccessPoint - File Storage NAS - Alibaba Cloud Documentation Center

Membuat titik akses.

Deskripsi operasi

Saat Anda memanggil operasi CreateAccessPoint untuk membuat titik akses, beberapa Sumber daya dibuat secara asinkron. Setelah operasi CreateAccessPoint berhasil, panggil operasi DescribeAccessPoints atau DescribeAccessPoint untuk mengkueri status titik akses. Pasang sistem file hanya setelah status titik akses menjadi Active. Jika tidak, operasi pemasangan dapat gagal.
Hanya sistem file NAS General-purpose yang menggunakan Protokol NFS yang mendukung fitur ini.
Jika Anda mengaktifkan kebijakan RAM (EnabledRam), konfigurasikan izin RAM yang sesuai. Untuk informasi lebih lanjut, lihat Mengelola titik akses.

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

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file.	31a8e4****
AgenticSpaceId	string	No	ID AgenticSpace. Catatan Parameter ini wajib diisi untuk sistem file Agentic.	agentic-229oypxjgpau2****
AccessGroup	string	No	Nama grup izin. Parameter ini wajib diisi jika sistem file adalah sistem file NAS General-purpose. Grup izin default: DEFAULT_VPC_GROUP_NAME (grup izin default untuk VPC). Catatan Tidak didukung untuk sistem file Agentic.	DEFAULT_VPC_GROUP_NAME
VswId	string	Yes	ID vSwitch.	vsw-2zevmwkwyztjuoffg****
VpcId	string	Yes	ID virtual private cloud (VPC).	vpc-2zesj9afh3y518k9o****
AccessPointName	string	No	Nama titik akses.	test
RootDirectory	string	No	Direktori root titik akses. Nilai default: "/". Jika direktori titik akses tidak ada, Anda juga harus menentukan parameter OwnerUserId dan OwnerGroupId. Catatan Tidak didukung untuk sistem file Agentic.	/
EnabledRam	boolean	No	Apakah akan mengaktifkan kebijakan RAM. Nilai valid: true: diaktifkan. false (default): tidak diaktifkan. Catatan Setelah Anda mengaktifkan kebijakan RAM titik akses, semua pengguna Resource Access Management (RAM) ditolak aksesnya untuk memasang dan mengakses data melalui titik akses secara default. Anda harus memberikan izin akses yang sesuai melalui otorisasi dan memasang sistem file melalui titik akses. Setelah Anda menonaktifkan kebijakan RAM, titik akses mengizinkan pemasangan anonim. Untuk informasi lebih lanjut tentang cara mengonfigurasi izin titik akses, lihat Mengonfigurasi kebijakan titik akses. Catatan Untuk sistem file Agentic, parameter ini harus diatur ke true.	false
OwnerUserId	integer	No	ID pengguna pemilik. Parameter ini wajib diisi jika direktori RootDirectory tidak ada. Catatan Tidak didukung untuk sistem file Agentic.	1
OwnerGroupId	integer	No	ID kelompok pemilik. Parameter ini wajib diisi jika direktori RootDirectory tidak ada. Catatan Tidak didukung untuk sistem file Agentic.	1
Permission	string	No	Izin POSIX. Nilai default: "0755". Batasan: Nilai harus berupa angka oktal empat digit yang dimulai dengan 0. Parameter ini berlaku setelah Anda menentukan parameter OwnerUserId dan OwnerGroupId. Catatan Tidak didukung untuk sistem file Agentic.	0755
PosixUserId	integer	No	ID pengguna POSIX. Catatan Tidak didukung untuk sistem file Agentic.	123
PosixGroupId	integer	No	ID kelompok POSIX. Catatan Tidak didukung untuk sistem file Agentic.	123
PosixSecondaryGroupIds	string	No	ID kelompok sekunder. Pisahkan beberapa ID kelompok dengan koma (,). Catatan Tidak didukung untuk sistem file Agentic.	123,345
Tag	array<object>	No	Daftar tag titik akses.
	object	No	Daftar tag titik akses.
Key	string	No	Kunci tag. Batasan: Kunci tag tidak boleh kosong atau berupa string kosong. Panjang kunci tag maksimal 128 karakter. Kunci tag tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.	TestKey
Value	string	No	Nilai tag. Batasan: Nilai tag tidak boleh kosong atau berupa string kosong. Panjang nilai tag maksimal 128 karakter. Nilai tag tidak boleh mengandung http:// atau https://.	TestValue

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	98696EF0-1607-4E9D-B01D-F20930B6****
AccessPoint	object	Titik akses.
AccessPointDomain	string	Nama domain titik akses.	ap-ie15ydanoz.001014**-w**.cn-hangzhou.nas.aliyuncs.com
AccessPointId	string	ID titik akses.	ap-ie15yd****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****\n",
  "AccessPoint": {
    "AccessPointDomain": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
    "AccessPointId": "ap-ie15yd****"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidRequest	The request is invalid.	Permintaan tidak valid.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.	Jenis protokol yang ditentukan tidak didukung.
403	InvalidRamRole.NotExist	The specified RAM role does not exist.	Peran RAM yang ditentukan tidak ada.
403	InvalidRamRole.NoPermission	The specified RAM role does not have sufficient permission.	Peran RAM yang ditentukan tidak memiliki izin yang cukup.
403	OperationDenied.AccessPointCountsExceeded	The maxium number of access point has reached its limits.	Jumlah titik akses untuk sistem file saat ini telah mencapai batas atas.
404	InvalidAccessGroup.NotFound	The specified AccessGroup does not exist.	Kelompok izin yang ditentukan tidak ada atau telah dihapus.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Sistem file yang ditentukan tidak ada.
404	InvalidVpc.NotFound	The specified Vpc is not found.	VPC yang ditentukan tidak ada. Buat VPC terlebih dahulu.
404	InvalidVswitch.NotFound	The specified VSwitch does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.