Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # CreateAccessPoint Menciptakan titik akses EFS. Titik akses adalah tampilan khusus aplikasi ke dalam sistem file EFS yang menerapkan pengguna dan grup sistem operasi, serta jalur sistem file, untuk setiap permintaan sistem file yang dibuat melalui titik akses. Pengguna dan grup sistem operasi menimpa informasi identitas apa pun yang disediakan oleh klien NFS. Jalur sistem file dipaparkan sebagai direktori root titik akses. Aplikasi yang menggunakan titik akses hanya dapat mengakses data di direktori aplikasi sendiri dan subdirektori apa pun. Sistem file dapat memiliki maksimum 10.000 titik akses kecuali Anda meminta peningkatan. Untuk mempelajari selengkapnya, lihat [Memasang sistem file menggunakan titik akses EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html). **catatan** Jika beberapa permintaan untuk membuat titik akses pada sistem file yang sama dikirim secara berurutan, dan sistem file mendekati batas titik akses, Anda mungkin mengalami respons pelambatan untuk permintaan ini. Ini untuk memastikan bahwa sistem file tidak melebihi batas titik akses yang dinyatakan. Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:CreateAccessPoint`. Titik akses dapat ditandai pada pembuatan. Jika tag ditentukan dalam tindakan pembuatan, IAM melakukan otorisasi tambahan pada `elasticfilesystem:TagResource` tindakan untuk memverifikasi apakah pengguna memiliki izin untuk membuat tag. Oleh karena itu, Anda harus memberikan izin eksplisit untuk menggunakan tindakan. `elasticfilesystem:TagResource` Untuk informasi selengkapnya, lihat [Memberikan izin untuk menandai sumber daya selama pembuatan](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## Minta Sintaks ``` POST /2015-02-01/access-points HTTP/1.1 Content-type: application/json { "ClientToken": "string", "FileSystemId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parameter Permintaan URI Permintaan tidak menggunakan parameter URI apa pun. ## Isi Permintaan Permintaan menerima data berikut dalam format JSON. ** [ClientToken](#API_CreateAccessPoint_RequestSyntax) ** Serangkaian hingga 64 karakter ASCII yang digunakan Amazon EFS untuk memastikan pembuatan idempoten. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64. Pola: `.+` Wajib: Ya ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** ID dari sistem file EFS yang menyediakan akses ke titik akses. Tipe: String Batasan Panjang: Panjang maksimum 128. Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` Wajib: Ya ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) ** Pengguna dan grup sistem operasi diterapkan ke semua permintaan sistem file yang dibuat menggunakan titik akses. Tipe: Objek [PosixUser](API_PosixUser.md) Wajib: Tidak ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** Menentukan direktori pada sistem file EFS yang diekspos oleh titik akses sebagai direktori root sistem file Anda ke klien NFS menggunakan titik akses. Klien yang menggunakan jalur akses hanya dapat mengakses direktori root dan di bawahnya. Jika `RootDirectory` > yang `Path` ditentukan tidak ada, Amazon EFS membuatnya dan menerapkan `CreationInfo` pengaturan saat klien terhubung ke titik akses. Saat menentukan a`RootDirectory`, Anda harus memberikan`Path`, dan. `CreationInfo` Amazon EFS membuat direktori root hanya jika Anda telah menyediakan CreationInfo: OwnUid, ownGid, dan izin untuk direktori tersebut. Jika Anda tidak memberikan informasi ini, Amazon EFS tidak membuat direktori root. Jika direktori root tidak ada, upaya untuk memasang menggunakan titik akses akan gagal. Tipe: Objek [RootDirectory](API_RootDirectory.md) Wajib: Tidak ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** Membuat tag yang terkait dengan titik akses. Setiap tag adalah pasangan kunci-nilai, setiap kunci harus unik. Untuk informasi selengkapnya, lihat [Menandai AWS sumber daya](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) di *Panduan Referensi AWS Umum*. Tipe: Array objek [Tag](API_Tag.md) Wajib: Tidak ## Sintaksis Respons ``` HTTP/1.1 200 Content-type: application/json { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) ** Nama Sumber Daya Amazon (ARN) unik yang terkait dengan titik akses. Tipe: String Batasan Panjang: Panjang maksimum 128. Pola: `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** ID titik akses, yang ditetapkan oleh Amazon EFS. Tipe: String Batasan Panjang: Panjang maksimum 128. Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) ** String buram ditentukan dalam permintaan untuk memastikan pembuatan yang idempotensi. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64. Pola: `.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** ID dari sistem file EFS di mana titik akses berlaku. Tipe: String Batasan Panjang: Panjang maksimum 128. Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) ** Mengidentifikasi fase siklus hidup dari titik akses. Tipe: String Nilai yang Valid: `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** Nama titik akses. Ini adalah nilai `Name` tag. Tipe: String ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** Mengidentifikasi Akun AWS yang memiliki sumber daya titik akses. Tipe: String Kendala Panjang: Panjang maksimum 14. Pola: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) ** Identitas POSIX lengkap, termasuk ID pengguna, ID grup, dan grup sekunder IDs pada titik akses yang digunakan untuk semua operasi file oleh klien NFS menggunakan titik akses. Tipe: Objek [PosixUser](API_PosixUser.md) ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** Direktori pada sistem file EFS yang diekspos oleh titik akses sebagai direktori root ke klien NFS menggunakan titik akses. Tipe: Objek [RootDirectory](API_RootDirectory.md) ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** Tag yang terkait dengan titik akses, disajikan sebagai array objek Tag. Tipe: Array objek [Tag](API_Tag.md) ## Kesalahan ** AccessPointAlreadyExists ** Dikembalikan jika titik akses yang Anda coba buat sudah ada, dengan token pembuatan yang Anda berikan dalam permintaan. ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 409 ** AccessPointLimitExceeded ** Dikembalikan jika Akun AWS telah menciptakan jumlah maksimum titik akses yang diizinkan per sistem file. Untuk informasi lebih lanjut, lihat. [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region) ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 403 ** BadRequest ** Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang. ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 400 ** FileSystemNotFound ** Dikembalikan jika `FileSystemId` nilai yang ditentukan tidak ada di pemohon. Akun AWS ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Dikembalikan jika status siklus hidup sistem file tidak “tersedia”. ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 409 ** InternalServerError ** Dikembalikan jika terjadi kesalahan di sisi server. ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 500 ** ThrottlingException ** Dikembalikan ketika tindakan `CreateAccessPoint` API dipanggil terlalu cepat dan jumlah Titik Akses pada sistem file mendekati [batas 120](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region). ** ErrorCode ** Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. ** Message ** Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan. Kode Status HTTP: 429 ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: + [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)