Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # PutFileSystemPolicy Menerapkan Amazon EFS `FileSystemPolicy` ke sistem file Amazon EFS. Kebijakan sistem file adalah kebijakan berbasis sumber daya IAM dan dapat berisi beberapa pernyataan kebijakan. Sistem file selalu memiliki persis satu kebijakan sistem file, yang dapat berupa kebijakan default atau kumpulan kebijakan eksplisit atau diperbarui menggunakan operasi API ini. Kebijakan sistem file EFS memiliki batas 20.000 karakter. Ketika kebijakan eksplisit disetel, kebijakan tersebut akan mengesampingkan kebijakan default. Untuk informasi selengkapnya tentang kebijakan sistem file default, lihat [Kebijakan sistem file EFS default](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy). **catatan** Kebijakan sistem file EFS memiliki batas 20.000 karakter. Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:PutFileSystemPolicy`. ## Minta Sintaks ``` PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1 Content-type: application/json { "BypassPolicyLockoutSafetyCheck": boolean, "Policy": "string" } ``` ## Parameter Permintaan URI Permintaan menggunakan parameter URI berikut. ** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) ** ID sistem file EFS yang ingin Anda buat atau perbarui `FileSystemPolicy` untuk. 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 ## Isi Permintaan Permintaan menerima data berikut dalam format JSON. ** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) ** (Opsional) Boolean yang menentukan apakah akan melewati pemeriksaan keamanan `FileSystemPolicy` lockout atau tidak. Pemeriksaan keamanan penguncian menentukan apakah kebijakan dalam permintaan akan mengunci, atau mencegah, prinsipal IAM yang membuat permintaan dari membuat `PutFileSystemPolicy` permintaan future pada sistem file ini. Setel `BypassPolicyLockoutSafetyCheck` ke `True` hanya ketika Anda bermaksud untuk mencegah prinsipal IAM yang membuat permintaan dari membuat `PutFileSystemPolicy` permintaan berikutnya pada sistem file ini. Nilai default-nya adalah `False`. Tipe: Boolean Wajib: Tidak ** [Policy](#API_PutFileSystemPolicy_RequestSyntax) ** `FileSystemPolicy`Yang Anda ciptakan. Menerima definisi kebijakan berformat JSON. Kebijakan sistem file EFS memiliki batas 20.000 karakter. Untuk mengetahui selengkapnya tentang elemen yang membentuk kebijakan sistem file, lihat [Kebijakan berbasis sumber daya dalam Amazon](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies) EFS. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 20000. Pola: `[\s\S]+` Diperlukan: Ya ## Sintaksis Respons ``` HTTP/1.1 200 Content-type: application/json { "FileSystemId": "string", "Policy": "string" } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) ** Menentukan sistem file EFS yang `FileSystemPolicy` 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})$` ** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) ** JSON diformat `FileSystemPolicy` untuk sistem file EFS. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 20000. Pola: `[\s\S]+` ## Kesalahan ** 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 ** InvalidPolicyException ** Dikembalikan jika cacat atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter yang diperlukan hilang. `FileSystemPolicy` Dikembalikan jika terjadi kesalahan pemeriksaan keamanan penguncian kebijakan. ** 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 ## Contoh ### Buat EFS FileSystemPolicy Permintaan berikut membuat sebuah `FileSystemPolicy` yang memungkinkan semua AWS prinsipal untuk me-mount sistem file EFS yang ditentukan dengan izin baca dan tulis. #### Permintaan Sampel ``` PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1 { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, } ] } ``` #### Contoh Respons ``` { "Version": "2012-10-17", "Id": "1", "Statement": [ { "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444", "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, "Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567" } ] } ``` ## 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/PutFileSystemPolicy) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)