PutFileSystemPolicy - Amazon Elastic File System

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

PutFileSystemPolicy

Berlaku Amazon EFSFileSystemPolicyuntuk sistem file Amazon EFS. Kebijakan sistem file adalah kebijakan berbasis sumber daya IAM dan dapat berisi beberapa pernyataan kebijakan. Sistem file selalu memiliki tepat satu kebijakan sistem file, yang dapat berupa kebijakan default atau set kebijakan eksplisit atau diperbarui menggunakan operasi API ini. Kebijakan sistem file EFS memiliki batas karakter 20.000. Ketika kebijakan eksplisit diatur, kebijakan tersebut akan menggantikan kebijakan default. Untuk informasi selengkapnya tentang kebijakan sistem file default, lihatKebijakan Sistem File EFS Default.

catatan

Kebijakan sistem file EFS memiliki batas karakter 20.000.

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

ID untuk sistem file EFS yang ingin Anda buat atau updateFileSystemPolicyuntuk.

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})$

Diperlukan: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

BypassPolicyLockoutSafetyCheck

(Opsional) Sebuah boolean yang menentukan apakah atau tidak untuk memotongFileSystemPolicypemeriksaan keamanan lockout. Pemeriksaan keamanan lockout menentukan apakah kebijakan dalam permintaan akan mengunci, atau mencegah, kepala sekolah IAM yang membuat permintaan dari membuat masa depanPutFileSystemPolicypermintaan pada sistem file ini. SETBypassPolicyLockoutSafetyCheckkepadaTruehanya ketika Anda berniat untuk mencegah kepala sekolah IAM yang membuat permintaan dari membuat berikutnyaPutFileSystemPolicypermintaan pada sistem file ini. Nilai default-nya adalah False.

Jenis: Boolean

Diperlukan: Tidak

Policy

ParameterFileSystemPolicyyang Anda buat. Menerima definisi kebijakan JSON diformat. Kebijakan sistem file EFS memiliki batas karakter 20.000. Untuk mengetahui lebih lanjut tentang elemen yang membentuk kebijakan sistem file, lihatKebijakan berbasis sumber daya EFS.

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

Menentukan sistem file EFS yangFileSystemPolicyberlaku.

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

JSON diformatFileSystemPolicyuntuk sistem file EFS.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 20000.

Pola: [\s\S]+

Kesalahan

BadRequest

Dikembalikan jika permintaan tersebut cacat atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter yang diperlukan hilang.

Kode Status HTTP: 400

FileSystemNotFound

Kembali jika ditentukanFileSystemIdnilai tidak ada di pemohonAkun AWS.

Kode Status HTTP: 404

IncorrectFileSystemLifeCycleState

Kembali jika status siklus hidup sistem file tidak “tersedia”.

Kode Status HTTP: 409

InternalServerError

Kembali jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

InvalidPolicyException

Mengembalikan jikaFileSystemPolicycacat atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter yang diperlukan hilang. Kembali dalam kasus kesalahan pemeriksaan keamanan lockout kebijakan.

Kode Status HTTP: 400

Contoh

Buat FileSystemPolicy EFS

Permintaan berikut membuatFileSystemPolicyyang memungkinkan semuaAWSkepala sekolah untuk me-mount sistem file EFS yang ditentukan dengan izin baca dan tulis.

Sampel Permintaan

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 dari spesifik bahasaAWSSDK, lihat berikut ini: