CreateAccessPoint - File Storage NAS - Alibaba Cloud Documentation Center

Membuat titik akses.

Deskripsi operasi

Saat Anda memanggil operasi CreateAccessPoint untuk membuat titik akses, beberapa resource dihasilkan secara asinkron. Setelah operasi CreateAccessPoint berhasil, jalankan operasi DescribeAccessPoints atau DescribeAccessPoint untuk mengkueri status titik akses. Memasang sistem file hanya setelah status titik akses menjadi Active. Jika tidak, operasi memasang dapat gagal.
Hanya sistem file General-purpose NAS NFS yang mendukung fitur ini.
Jika Anda mengaktifkan kebijakan RAM (EnabledRam), konfigurasikan izin RAM yang sesuai. Untuk informasi selengkapnya, lihat Manage access points.

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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file.	31a8e4****
AgenticSpaceId	string	No	ID AgenticSpace. Catatan Parameter ini wajib untuk sistem file Agentic.	agentic-229oypxjgpau2****
AccessGroup	string	No	Nama grup izin. Parameter ini wajib jika sistem file adalah sistem file General-purpose NAS. 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 Hanya didukung untuk sistem file Agentic.	/
EnabledRam	boolean	No	Apakah akan mengaktifkan kebijakan titik akses. Nilai valid: true: Diaktifkan. false (default): Tidak diaktifkan. Catatan Setelah Anda mengaktifkan kebijakan titik akses untuk titik akses, semua pengguna Resource Access Management (RAM) secara default ditolak aksesnya untuk memasang dan mengakses data melalui titik akses. Anda harus memberikan izin akses yang sesuai melalui otorisasi lalu memasang dan mengakses sistem file melalui titik akses. Setelah Anda menonaktifkan kebijakan titik akses, titik akses mengizinkan pemasangan anonim. Untuk informasi selengkapnya tentang cara mengonfigurasi izin titik akses, lihat Configure access point policies. Catatan Untuk sistem file Agentic, parameter ini harus diatur ke true.	false
OwnerUserId	integer	No	ID pengguna pemilik. Parameter ini wajib jika direktori RootDirectory tidak ada. Catatan Tidak didukung untuk sistem file Agentic.	1
OwnerGroupId	integer	No	ID kelompok pemilik. Parameter ini wajib jika direktori RootDirectory tidak ada. Catatan Tidak didukung untuk sistem file Agentic.	1
Permission	string	No	Izin POSIX. Nilai default: "0755". Nilai harus berupa angka oktal empat digit yang dimulai dengan 0. Parameter ini hanya 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: Tidak boleh kosong atau berupa string kosong. Panjangnya dapat mencapai 128 karakter. Tidak boleh diawali dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.	TestKey
Value	string	No	Nilai tag. Batasan: Tidak boleh kosong atau berupa string kosong. Panjangnya dapat mencapai 128 karakter. 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
400	InvalidRequest	The request is invalid.
403	InvalidProtocolType.NotSupported	The specified protocol type does not supported.
403	InvalidRamRole.NotExist	The specified RAM role does not exist.
403	InvalidRamRole.NoPermission	The specified RAM role does not have sufficient permission.
403	OperationDenied.AccessPointCountsExceeded	The maxium number of access point has reached its limits.
404	InvalidAccessGroup.NotFound	The specified AccessGroup does not exist.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidVpc.NotFound	The specified Vpc is not found.
404	InvalidVswitch.NotFound	The specified VSwitch does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.