PutFileSystemPolicy - Sistem File Elastis Amazon
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

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 EFS file Amazon. Kebijakan sistem file adalah kebijakan IAM berbasis sumber daya 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 API operasi ini. EFSkebijakan sistem file 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 EFS file default.

catatan

EFSkebijakan sistem file memiliki batas 20.000 karakter.

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:PutFileSystemPolicy.

Sintaks Permintaan

PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json

{
   "BypassPolicyLockoutSafetyCheck": boolean,
   "Policy": "string"
}

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

FileSystemId

ID sistem EFS file 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 JSON format.

BypassPolicyLockoutSafetyCheck

(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, IAM prinsipal yang membuat permintaan untuk membuat PutFileSystemPolicy permintaan future pada sistem file ini. Setel BypassPolicyLockoutSafetyCheck ke True hanya ketika Anda bermaksud untuk mencegah IAM prinsipal yang membuat permintaan dari membuat PutFileSystemPolicy permintaan berikutnya pada sistem file ini. Nilai default-nya adalah False.

Tipe: Boolean

Wajib: Tidak

Policy

FileSystemPolicyYang Anda ciptakan. Menerima definisi kebijakan yang JSON diformat. EFSkebijakan sistem file memiliki batas 20.000 karakter. Untuk mengetahui selengkapnya tentang elemen yang membentuk kebijakan sistem file, lihat Kebijakan berbasis sumber daya di Amazon. 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.

Data berikut dikembalikan dalam JSON format oleh layanan.

FileSystemId

Menentukan sistem EFS file yang FileSystemPolicy berlaku.

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

JSONDiformat FileSystemPolicy untuk sistem EFS file.

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

HTTPKode Status: 400

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

HTTPKode Status: 404

IncorrectFileSystemLifeCycleState

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

HTTPKode Status: 409

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

HTTPKode Status: 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.

HTTPKode Status: 400

Contoh

Buat sebuah EFS FileSystemPolicy

Permintaan berikut membuat FileSystemPolicy yang memungkinkan semua AWS prinsipal untuk me-mount sistem EFS file 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 ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: