Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tindakan
Tindakan berikut didukung:
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# 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)
# CreateFileSystem
Membuat sistem file baru yang kosong. Operasi ini memerlukan token pembuatan dalam permintaan yang digunakan Amazon EFS untuk memastikan pembuatan idempoten (memanggil operasi dengan token pembuatan yang sama tidak berpengaruh). Jika sistem file saat ini tidak ada yang dimiliki oleh pemanggil Akun AWS dengan token pembuatan yang ditentukan, operasi ini melakukan hal berikut:
+ Membuat sistem file baru yang kosong. Sistem file akan memiliki ID yang ditetapkan Amazon EFS, dan status siklus hidup awal. `creating`
+ Kembali dengan deskripsi sistem file yang dibuat.
Jika tidak, operasi ini mengembalikan `FileSystemAlreadyExists` kesalahan dengan ID dari sistem file yang ada.
**catatan**
Untuk kasus penggunaan dasar, Anda dapat menggunakan UUID yang dibuat secara acak untuk token pembuatan.
Operasi idempoten memungkinkan Anda untuk mencoba lagi `CreateFileSystem` panggilan tanpa risiko membuat sistem file tambahan. Ini bisa terjadi ketika panggilan awal gagal dengan cara yang membuatnya tidak pasti apakah sistem file benar-benar dibuat atau tidak. Contohnya mungkin batas waktu tingkat transport terjadi atau koneksi Anda disetel ulang. Selama Anda menggunakan token pembuatan yang sama, jika panggilan awal berhasil membuat sistem file, klien dapat mengetahui keberadaannya dari `FileSystemAlreadyExists` kesalahan.
Untuk informasi selengkapnya, lihat [Membuat sistem file](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) di *Panduan Pengguna Amazon EFS*.
**catatan**
`CreateFileSystem`Panggilan kembali saat status siklus hidup sistem file masih. `creating` Anda dapat memeriksa status pembuatan sistem file dengan memanggil [DescribeFileSystems](API_DescribeFileSystems.md) operasi, yang antara lain mengembalikan status sistem file.
Operasi ini menerima `PerformanceMode` parameter opsional yang Anda pilih untuk sistem file Anda. Kami merekomendasikan `generalPurpose` `PerformanceMode` untuk semua sistem file. `maxIO`Mode ini adalah tipe kinerja generasi sebelumnya yang dirancang untuk beban kerja yang sangat paralel yang dapat mentolerir latensi yang lebih tinggi daripada mode. `generalPurpose` `MaxIO`mode tidak didukung untuk sistem file One Zone atau sistem file yang menggunakan throughput Elastis.
Tidak `PerformanceMode` dapat diubah setelah sistem file dibuat. Untuk informasi selengkapnya, lihat [mode kinerja Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
Anda dapat mengatur mode throughput untuk sistem file menggunakan `ThroughputMode` parameter.
Setelah sistem file dibuat sepenuhnya, Amazon EFS menetapkan status siklus hidupnya`available`, di mana Anda dapat membuat satu atau beberapa target mount untuk sistem file di VPC Anda. Untuk informasi selengkapnya, lihat [CreateMountTarget](API_CreateMountTarget.md). Anda memasang sistem file Amazon EFS pada EC2 instance di VPC Anda dengan menggunakan target pemasangan. Untuk informasi selengkapnya, lihat [Amazon EFS: Cara Kerjanya](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:CreateFileSystem`.
Sistem file 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/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
Untuk sistem file One Zone, tentukan AWS Availability Zone untuk membuat sistem file. Gunakan format `us-east-1a` untuk menetapkan Availability Zone. Untuk informasi selengkapnya tentang sistem file One Zone, lihat [tipe sistem file EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) di *Panduan Pengguna Amazon EFS*.
Sistem file One Zone tidak tersedia di semua Availability Zone di Wilayah AWS mana Amazon EFS tersedia.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
Wajib: Tidak
** [Backup](#API_CreateFileSystem_RequestSyntax) **
Menentukan apakah backup otomatis diaktifkan pada sistem file yang Anda buat. Tetapkan nilainya `true` untuk mengaktifkan pencadangan otomatis. Jika Anda membuat sistem file One Zone, backup otomatis diaktifkan secara default. Untuk informasi selengkapnya, lihat [Pencadangan otomatis](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) di *Panduan Pengguna Amazon EFS*.
Default-nya adalah `false`. Namun, jika Anda menentukan`AvailabilityZoneName`, defaultnya adalah`true`.
AWS Backup tidak tersedia di semua Wilayah AWS tempat Amazon EFS tersedia.
Tipe: Boolean
Wajib: Tidak
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
Sebuah string hingga 64 karakter ASCII. Amazon EFS menggunakan ini untuk memastikan kreasi idempoten.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
Wajib: Ya
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
Nilai Boolean yang, jika BETUL, menciptakan sistem file terenkripsi. Saat membuat sistem file terenkripsi, Anda memiliki opsi untuk menentukan kunci yang ada ( AWS Key Management Service kunci KMS). Jika Anda tidak menentukan kunci KMS, maka kunci KMS default untuk Amazon EFS,`/aws/elasticfilesystem`, digunakan untuk melindungi sistem file terenkripsi.
Tipe: Boolean
Wajib: Tidak
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
ID kunci KMS yang ingin Anda gunakan untuk melindungi sistem file terenkripsi. Parameter ini diperlukan hanya jika Anda ingin menggunakan kunci KMS non-default. Jika parameter ini tidak ditentukan, kunci KMS default untuk Amazon EFS digunakan. Anda dapat menentukan ID kunci KMS menggunakan format berikut:
+ ID kunci - Pengidentifikasi unik dari kunci, misalnya `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ ARN - Amazon Resource Name (ARN) untuk kunci, misalnya `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ Alias kunci - Nama tampilan yang dibuat sebelumnya untuk kunci, misalnya `alias/projectKey1`.
+ ARN alias kunci - ARN untuk alias kunci, misalnya `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`.
[Jika Anda menggunakan`KmsKeyId`, Anda harus mengatur parameter:Encrypted ke true. CreateFileSystem](#efs-CreateFileSystem-request-Encrypted)
EFS hanya menerima kunci KMS simetris. Anda tidak dapat menggunakan kunci KMS asimetris dengan sistem file Amazon EFS.
Tipe: String
Batasan Panjang: Panjang maksimum 2048.
Pola: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
Wajib: Tidak
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
Mode performa sistem file. Kami merekomendasikan mode `generalPurpose` kinerja untuk semua sistem file. Sistem file yang menggunakan mode performa `maxIO` dapat menskalakan ke tingkat throughput dan operasi agregat per detik yang lebih tinggi dengan kompromi latensi yang sedikit lebih tinggi untuk sebagian besar operasi file. Mode performa tidak dapat diubah setelah sistem file dibuat. `maxIO`Mode ini tidak didukung pada sistem file One Zone.
Karena latensi per operasi yang lebih tinggi dengan Max I/O, sebaiknya gunakan mode kinerja Tujuan Umum untuk semua sistem file.
Default-nya adalah `generalPurpose`.
Tipe: String
Nilai yang Valid: `generalPurpose | maxIO`
Wajib: Tidak
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
Throughput, diukur dalam mebibytes per detik (MiBps), yang ingin Anda sediakan untuk sistem file yang Anda buat. Harus diisi jika `ThroughputMode` diatur ke `provisioned`. Nilai yang valid adalah 1-3414 MiBps, dengan batas atas tergantung pada Wilayah. Untuk meningkatkan batas ini, hubungi Dukungan. Untuk informasi selengkapnya, lihat [Kuota Amazon EFS yang dapat Anda tingkatkan](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) di *Panduan Pengguna Amazon EFS*.
Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
Wajib: Tidak
** [Tags](#API_CreateFileSystem_RequestSyntax) **
Gunakan untuk membuat satu tanda atau lebih yang terkait dengan sistem file. Setiap tanda adalah pasangan nilai-kunci yang ditentukan pengguna. Nama sistem file Anda pada pembuatan dengan menyertakan `"Key":"Name","Value":"{value}"` pasangan nilai-kunci. 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
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
Menentukan modus throughput untuk sistem file. Modenya bisa`bursting`,`provisioned`, atau`elastic`. Jika Anda mengatur `ThroughputMode` ke `provisioned`, Anda juga haru mengatur nilai `ProvisionedThroughputInMibps`. Setelah Anda membuat sistem file, Anda dapat mengurangi throughput Provisioned sistem file Anda atau mengubah antara mode throughput, dengan batasan waktu tertentu. Untuk informasi selengkapnya, lihat [Menentukan throughput dengan mode yang disediakan](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) di *Panduan Pengguna Amazon EFS*.
Default-nya adalah `bursting`.
Tipe: String
Nilai yang Valid: `bursting | provisioned | elastic`
Wajib: Tidak
## Sintaksis Respons
```
HTTP/1.1 201
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.
Layanan mengembalikan data berikut dalam format JSON.
** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **
Pengidentifikasi unik dan konsisten dari Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Misalnya, `use1-az1` adalah ID Availability Zone untuk Wilayah AWS us-east-1, dan memiliki lokasi yang sama di setiap. Akun AWS
Tipe: String
** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **
Menjelaskan AWS Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Untuk informasi selengkapnya, lihat [Menggunakan kelas penyimpanan EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) di *Panduan Pengguna Amazon EFS*.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **
Waktu sistem file dibuat, dalam hitungan detik (sejak 1970-01-01T 00:00:00 Z).
Tipe: Timestamp
** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **
String buram ditentukan dalam permintaan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **
Nilai Boolean yang, jika benar, menunjukkan bahwa sistem file dienkripsi.
Jenis: Boolean
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
Nama Sumber Daya Amazon (ARN) untuk sistem file EFS, dalam format. `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id ` Contoh dengan data sampel: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipe: String
** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) **
ID sistem file, yang ditetapkan oleh Amazon EFS.
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})$`
** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) **
Menjelaskan perlindungan pada sistem file.
Tipe: Objek [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
ID yang AWS KMS key digunakan untuk melindungi sistem file terenkripsi.
Tipe: String
Batasan Panjang: Panjang maksimum 2048.
Pola: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) **
Fase siklus hidup dari sistem file.
Tipe: String
Nilai yang Valid: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
Anda dapat menambahkan tag ke sistem file, termasuk `Name` tag. Untuk informasi selengkapnya, lihat [CreateFileSystem](#API_CreateFileSystem). Jika sistem file memiliki `Name` tag, Amazon EFS mengembalikan nilai di bidang ini.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
Pola: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **
Jumlah target mount saat ini yang dimiliki sistem file. Untuk informasi selengkapnya, lihat [CreateMountTarget](API_CreateMountTarget.md).
Jenis: Integer
Rentang yang Valid: Nilai minimum 0.
** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **
Akun AWS Yang menciptakan sistem file.
Tipe: String
Kendala Panjang: Panjang maksimum 14.
Pola: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **
Mode performa sistem file.
Tipe: String
Nilai yang Valid: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
Jumlah throughput yang disediakan, diukur dalam MiBps, untuk sistem file. Berlaku untuk sistem file menggunakan `ThroughputMode` set to`provisioned`.
Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **
Ukuran terukur terbaru yang diketahui (dalam byte) data yang disimpan dalam sistem file, di `Value` bidangnya, dan waktu di mana ukuran itu ditentukan di bidangnya`Timestamp`. `Timestamp`Nilainya adalah bilangan bulat detik sejak 1970-01-01T 00:00:00 Z. `SizeInBytes`Nilai tidak mewakili ukuran snapshot yang konsisten dari sistem file, tetapi pada akhirnya konsisten ketika tidak ada penulisan ke sistem file. Artinya, `SizeInBytes` mewakili ukuran sebenarnya hanya jika sistem file tidak dimodifikasi untuk jangka waktu lebih dari beberapa jam. Jika tidak, nilainya bukan ukuran yang tepat dari sistem file pada setiap titik waktu.
Tipe: Objek [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_CreateFileSystem_ResponseSyntax) **
Tag yang terkait dengan sistem file, disajikan sebagai array `Tag` objek.
Tipe: Array objek [Tag](API_Tag.md)
** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **
Menampilkan mode throughput sistem file. Untuk informasi selengkapnya, lihat [Mode throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) di *Panduan Pengguna Amazon EFS*.
Tipe: String
Nilai yang Valid: `bursting | provisioned | elastic`
## 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
** FileSystemAlreadyExists **
Dikembalikan jika sistem file yang Anda coba buat sudah ada, dengan token pembuatan yang Anda berikan.
** 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
** FileSystemLimitExceeded **
Dikembalikan jika Akun AWS telah membuat jumlah maksimum sistem file yang diizinkan per akun.
** 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
** InsufficientThroughputCapacity **
Dikembalikan jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan saat Anda mencoba membuat sistem file dalam mode throughput yang disediakan, saat Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau saat Anda mencoba mengubah sistem file yang ada dari Bursting Throughput ke mode Throughput Terprovsioned. Coba lagi nanti.
** 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: 503
** 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
** ThroughputLimitExceeded **
Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 telah tercapai. MiB/s
** 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
** UnsupportedAvailabilityZone **
Dikembalikan jika fungsionalitas Amazon EFS yang diminta tidak tersedia di Availability Zone yang ditentukan.
** 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 sistem file EFS terenkripsi
Contoh berikut mengirimkan permintaan POST untuk membuat sistem file di `us-west-2` Wilayah dengan backup otomatis diaktifkan. Permintaan ditentukan `myFileSystem1` sebagai token penciptaan untuk idempotensi.
#### Permintaan Sampel
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Contoh Respons
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### Buat sistem file EFS terenkripsi dengan ketersediaan One Zone
Contoh berikut mengirimkan permintaan POST untuk membuat sistem file di `us-west-2` Wilayah dengan backup otomatis diaktifkan. Sistem file akan memiliki penyimpanan One Zone di `us-west-2b` Availability Zone.
#### Permintaan Sampel
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### Contoh Respons
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## 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/CreateFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
Membuat target mount untuk sistem file. Anda kemudian dapat me-mount sistem file pada EC2 instance dengan menggunakan target mount. Untuk informasi selengkapnya tentang target pemasangan, lihat [Mengelola target pemasangan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
Untuk membuat target pemasangan untuk sistem file EFS, status siklus hidup sistem file harus. `available` Untuk informasi selengkapnya, lihat [DescribeFileSystems](API_DescribeFileSystems.md).
Setelah membuat target pemasangan, Amazon EFS mengembalikan respons yang menyertakan alamat IP `MountTargetId` dan (`IpAddress`atau`Ipv6Address`). Anda menggunakan alamat IP ini saat memasang sistem file dalam sebuah EC2 instance. Anda juga dapat menggunakan nama DNS target mount saat memasang sistem file. EC2 Instance tempat Anda memasang sistem file dengan menggunakan target mount dapat menyelesaikan nama DNS target mount ke alamat IP-nya. Untuk informasi selengkapnya, lihat [Cara kerja Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
Perhatikan bahwa Anda dapat membuat target mount untuk sistem file hanya dalam satu VPC, dan hanya ada satu target mount per Availability Zone. Untuk informasi selengkapnya, lihat [Membuat target pemasangan](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html).
Jika permintaan memenuhi persyaratan, Amazon EFS melakukan hal berikut:
+ Membuat target mount baru di subnet yang ditentukan.
+ Membuat antarmuka jaringan baru di subnet dengan folowing:
+ Deskripsi di `Mount target fsmt-id for file system fs-id ` ` fsmt-id ` mana ID target mount, dan ` fs-id ` merupakan`FileSystemId`.
+ `requesterManaged`Properti antarmuka jaringan diatur ke`true`, dan `requesterId` nilai diatur ke`EFS`.
Setiap target mount memiliki satu antarmuka jaringan yang dikelola pemohon yang EC2 sesuai. Setelah antarmuka jaringan dibuat, Amazon EFS menetapkan `NetworkInterfaceId` bidang dalam deskripsi target pemasangan ke ID antarmuka jaringan, dan alamat IP ke alamatnya. Jika pembuatan antarmuka jaringan gagal, seluruh `CreateMountTarget` operasi gagal.
**catatan**
`CreateMountTarget`Panggilan kembali hanya setelah membuat antarmuka jaringan, tetapi saat status target mount masih`creating`, Anda dapat memeriksa status pembuatan target mount dengan memanggil [DescribeMountTargets](API_DescribeMountTargets.md) operasi, yang antara lain mengembalikan status target mount.
Operasi ini memerlukan izin untuk tindakan berikut pada sistem file:
+ `elasticfilesystem:CreateMountTarget`
Operasi ini juga memerlukan izin untuk EC2 tindakan Amazon berikut:
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Minta Sintaks
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
ID sistem file yang akan digunakan untuk membuat target pemasangan.
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
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
Jika target `IpAddressType` untuk mount adalah IPv4 (`IPV4_ONLY`atau`DUAL_STACK`), maka tentukan IPv4 alamat yang akan digunakan. Jika Anda tidak menentukan`IpAddress`, Amazon EFS memilih alamat IP yang tidak digunakan dari subnet yang ditentukan untuk. `SubnetId`
Tipe: String
Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.
Pola: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
Wajib: Tidak
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
Jenis alamat IP untuk target pemasangan. Nilai yang mungkin adalah `IPV4_ONLY` (hanya IPv4 alamat), `IPV6_ONLY` (hanya IPv6 alamat), dan `DUAL_STACK` (dual-stack, keduanya IPv4 dan IPv6 alamat). Jika Anda tidak menentukan`IpAddressType`, maka `IPV4_ONLY` digunakan.
`IPAddressType`Harus cocok dengan jenis IP subnet. Selain itu, `IPAddressType` parameter mengesampingkan nilai yang ditetapkan sebagai alamat IP default untuk subnet di VPC. Misalnya, jika `IPAddressType` is `IPV4_ONLY` dan `AssignIpv6AddressOnCreation` is`true`, maka IPv4 digunakan untuk target mount. Untuk informasi selengkapnya, lihat [Memodifikasi atribut pengalamatan IP subnet Anda](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html).
Tipe: String
Nilai yang Valid: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
Wajib: Tidak
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
Jika target `IPAddressType` untuk mount adalah IPv6 (`IPV6_ONLY`atau`DUAL_STACK`), maka tentukan IPv6 alamat yang akan digunakan. Jika Anda tidak menentukan`Ipv6Address`, Amazon EFS memilih alamat IP yang tidak digunakan dari subnet yang ditentukan untuk. `SubnetId`
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 39.
Wajib: Tidak
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
Grup keamanan VPC IDs, dari formulir. `sg-xxxxxxxx` Ini harus untuk VPC yang sama dengan subnet yang ditentukan. Jumlah maksimum grup keamanan tergantung pada kuota akun. **Untuk informasi selengkapnya, lihat [Kuota VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) Amazon di *Panduan Pengguna Amazon VPC* (lihat tabel Grup Keamanan).** Jika Anda tidak menentukan grup keamanan, Amazon EFS menggunakan grup keamanan default untuk VPC subnet.
Tipe: Array string
Anggota Array: Jumlah maksimum 100 item.
Kendala Panjang: Panjang minimum 11. Panjang maksimum 43.
Pola: `^sg-[0-9a-f]{8,40}`
Wajib: Tidak
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
ID subnet yang diambahkan target pemasangan. Untuk sistem file One Zone, gunakan subnet yang terkait dengan Availability Zone sistem file. Jenis subnet harus tipe yang sama dengan`IpAddressType`.
Tipe: String
Kendala Panjang: Panjang minimum 15. Panjang maksimum 47.
Pola: `^subnet-[0-9a-f]{8,40}$`
Diperlukan: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
Pengidentifikasi unik dan konsisten dari Availability Zone tempat target mount berada. Misalnya, `use1-az1` adalah ID AZ untuk Wilayah us-east-1 dan memiliki lokasi yang sama di setiap wilayah. Akun AWS
Tipe: String
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
Nama Availability Zone di mana target mount berada. Availability Zones dipetakan secara independen ke nama masing-masing Akun AWS. Misalnya, Availability Zone `us-east-1a` untuk Anda Akun AWS mungkin bukan lokasi yang sama dengan `us-east-1a` yang lain Akun AWS.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
ID sistem file tempat target mount dimaksudkan.
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})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
IPv4 Alamat untuk target pemasangan.
Tipe: String
Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.
Pola: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
IPv6 Alamat untuk target pemasangan.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 39.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
Status siklus hidup target pemasangan.
Tipe: String
Nilai yang Valid: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
ID target pemasangan yang ditetapkan sistem.
Tipe: String
Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.
Pola: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
ID antarmuka jaringan yang dibuat Amazon EFS saat membuat target pemasangan.
Tipe: String
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
Akun AWS ID yang memiliki sumber daya.
Tipe: String
Kendala Panjang: Panjang maksimum 14.
Pola: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
ID subnet target mount.
Tipe: String
Kendala Panjang: Panjang minimum 15. Panjang maksimum 47.
Pola: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
ID virtual private cloud (VPC) tempat target mount dikonfigurasi.
Tipe: String
## Kesalahan
** AvailabilityZonesMismatch **
Dikembalikan jika Availability Zone yang ditentukan untuk target mount berbeda dari Availability Zone sistem file. Untuk informasi selengkapnya, lihat [Redundansi penyimpanan Regional dan Satu Zona](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs).
** 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
** 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
** IpAddressInUse **
Dikembalikan jika permintaan ditentukan alamat IP (`IpAddress`atau`Ipv6Address`) yang sudah digunakan di subnet.
** 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
** MountTargetConflict **
Dikembalikan jika target pemasangan akan melanggar salah satu batasan yang ditentukan berdasarkan target pemasangan sistem file yang ada.
** 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
** NetworkInterfaceLimitExceeded **
Akun panggilan telah mencapai batas untuk antarmuka jaringan elastis untuk spesifik Wilayah AWS. Hapus beberapa antarmuka jaringan atau minta kuota akun dinaikkan. **Untuk informasi selengkapnya, lihat [Kuota VPC Amazon](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) di *Panduan Pengguna Amazon VPC* (lihat entri Antarmuka **jaringan per Wilayah di tabel Antarmuka** jaringan).**
** 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
** NoFreeAddressesInSubnet **
Tidak `Ipv6Address` dikembalikan `IpAddress` atau disediakan dalam permintaan dan tidak ada alamat IP gratis di subnet yang ditentukan.
** 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
** SecurityGroupLimitExceeded **
Dikembalikan jika jumlah `SecurityGroups` yang ditentukan dalam permintaan lebih besar dari batas, yang didasarkan pada kuota akun. Hapus beberapa grup keamanan atau minta kuota akun dinaikkan. **Untuk informasi selengkapnya, lihat [Kuota VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) Amazon di *Panduan Pengguna Amazon VPC* (lihat tabel Grup Keamanan).**
** 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
** SecurityGroupNotFound **
Dikembalikan jika salah satu grup keamanan yang ditentukan tidak ada di virtual private cloud (VPC) subnet.
** 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
** SubnetNotFound **
Dikembalikan jika tidak ada subnet dengan ID `SubnetId` yang disediakan 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: 400
** UnsupportedAvailabilityZone **
Dikembalikan jika fungsionalitas Amazon EFS yang diminta tidak tersedia di Availability Zone yang ditentukan.
** 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 target pemasangan di IPv4 alamat yang tersedia di subnet
Permintaan berikut hanya menentukan sistem file dan subnet untuk target mount. Target dibuat pada IPv4 alamat yang tersedia di subnet yang ditentukan, dengan grup keamanan default yang terkait dengan VPC.
#### Permintaan Sampel
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Buat target pemasangan di IPv4 alamat tertentu
Permintaan berikut menentukan sistem file, subnet, grup keamanan, dan IPv4 alamat yang akan digunakan untuk target mount.
#### Permintaan Sampel
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Buat target pemasangan di IPv6 alamat tertentu
Permintaan berikut menentukan sistem file, subnet, grup keamanan, dan IPv6 alamat yang akan digunakan untuk target mount.
#### Permintaan Sampel
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Buat target pemasangan di IPv4 alamat yang tersedia di subnet dual-stack
Permintaan berikut menentukan sistem file, subnet, dan jenis alamat untuk target mount. Target dibuat pada IPv4 alamat yang tersedia pada subnet dual-stack yang ditentukan, dengan grup keamanan default yang terkait dengan VPC.
#### Permintaan Sampel
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### Buat target mount pada Ipv4 tertentu dan IPv6 alamat pada subnet dual-stack
Permintaan berikut menentukan sistem file, subnet, grup keamanan, IPv4 alamat, IPv6 alamat untuk target mount. Target dibuat pada yang ditentukan IPv4 dan IPv6 alamat pada subnet dual-stack.
#### Permintaan Sampel
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## 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/CreateMountTarget)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
Membuat konfigurasi replikasi ke sistem file EFS baru atau yang sudah ada. Untuk informasi selengkapnya, lihat [replikasi Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) di *Panduan Pengguna Amazon EFS*. Konfigurasi replikasi menentukan hal berikut:
+ **Sistem file sumber — Sistem** file EFS yang ingin Anda tiru.
+ **Sistem file tujuan** — Sistem file tujuan tempat sistem file sumber direplikasi. Hanya ada satu sistem file tujuan dalam konfigurasi replikasi.
**catatan**
Sistem file dapat menjadi bagian dari hanya satu konfigurasi replikasi.
Parameter tujuan untuk konfigurasi replikasi bergantung pada apakah Anda mereplikasi ke sistem file baru atau ke sistem file yang ada, dan jika Anda mereplikasi di seluruh. Akun AWS Untuk informasi selengkapnya, lihat [DestinationToCreate](API_DestinationToCreate.md).
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:CreateReplicationConfiguration`. Selain itu, izin lain diperlukan tergantung pada bagaimana Anda mereplikasi sistem file. Untuk informasi selengkapnya, lihat [Izin yang diperlukan untuk replikasi](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) di *Panduan Pengguna Amazon EFS*.
## Minta Sintaks
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
Menentukan sistem file Amazon EFS yang ingin Anda replikasi. Sistem file ini belum dapat menjadi sumber atau sistem file tujuan dalam konfigurasi replikasi lain.
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.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
Sebuah array objek konfigurasi tujuan. Hanya satu objek konfigurasi tujuan yang didukung.
Tipe: Array objek [DestinationToCreate](API_DestinationToCreate.md)
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **
Menjelaskan kapan konfigurasi replikasi dibuat.
Tipe: Timestamp
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
Sebuah array objek tujuan. Hanya satu objek tujuan yang didukung.
Tipe: Array objek [Destination](API_Destination.md)
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Nama Sumber Daya Amazon (ARN) dari sistem file EFS sumber asli dalam konfigurasi replikasi.
Tipe: String
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
Nama Sumber Daya Amazon (ARN) dari sistem file sumber saat ini dalam konfigurasi replikasi.
Tipe: String
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID dari sistem file Amazon EFS sumber yang sedang direplikasi.
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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
ID Akun AWS tempat sistem file sumber berada.
Tipe: String
Kendala Panjang: Panjang maksimum 14.
Pola: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
Wilayah AWS Di mana sistem file EFS sumber berada.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## 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
** ConflictException **
Dikembalikan jika sistem file sumber dalam replikasi dienkripsi tetapi sistem file tujuan tidak dienkripsi.
** 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
** FileSystemLimitExceeded **
Dikembalikan jika Akun AWS telah membuat jumlah maksimum sistem file yang diizinkan per akun.
** 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
** 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
** InsufficientThroughputCapacity **
Dikembalikan jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan saat Anda mencoba membuat sistem file dalam mode throughput yang disediakan, saat Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau saat Anda mencoba mengubah sistem file yang ada dari Bursting Throughput ke mode Throughput Terprovsioned. Coba lagi nanti.
** 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: 503
** 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
** ReplicationNotFound **
Dikembalikan jika sistem file yang ditentukan tidak memiliki konfigurasi replikasi.
** ErrorCode **
ReplicationNotFound
** 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
** ThroughputLimitExceeded **
Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 telah tercapai. MiB/s
** 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
** UnsupportedAvailabilityZone **
Dikembalikan jika fungsionalitas Amazon EFS yang diminta tidak tersedia di Availability Zone yang ditentukan.
** 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
** ValidationException **
Dikembalikan jika AWS Backup layanan tidak tersedia Wilayah AWS di mana permintaan dibuat.
** 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
## 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/CreateReplicationConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**catatan**
DEPRECATED - tidak digunakan lagi dan `CreateTags` tidak dipertahankan. Untuk membuat tag untuk resource EFS, gunakan aksi [TagResource](API_TagResource.md) API.
Membuat atau menimpa tag yang terkait dengan sistem file. Setiap tag adalah pasangan nilai kunci. Jika kunci tag yang ditentukan dalam permintaan sudah ada di sistem file, operasi ini menimpa nilainya dengan nilai yang disediakan dalam permintaan. Jika Anda menambahkan `Name` tag ke sistem file Anda, Amazon EFS mengembalikannya sebagai respons terhadap [DescribeFileSystems](API_DescribeFileSystems.md) operasi.
Operasi ini memerlukan izin untuk tindakan `elasticfilesystem:CreateTags`.
## Minta Sintaks
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
ID sistem file yang tagnya ingin Anda ubah (String). Operasi ini memodifikasi tag saja, bukan sistem file.
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.
** [Tags](#API_CreateTags_RequestSyntax) **
Array `Tag` objek untuk ditambahkan. Setiap `Tag` objek adalah pasangan kunci-nilai.
Tipe: Array objek [Tag](API_Tag.md)
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** 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
## 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/CreateTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
Menghapus titik akses yang ditentukan. Setelah penghapusan selesai, klien baru tidak dapat lagi terhubung ke titik akses. Klien yang terhubung ke titik akses pada saat penghapusan akan terus berfungsi sampai mereka mengakhiri koneksi mereka.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DeleteAccessPoint`.
## Minta Sintaks
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
ID titik akses yang ingin Anda hapus.
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})$`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** InternalServerError **
Kembali 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
## 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/DeleteAccessPoint)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
Menghapus sistem file, secara permanen memutuskan akses ke isinya. Setelah kembali, sistem file tidak ada lagi dan Anda tidak dapat mengakses konten apa pun dari sistem file yang dihapus.
Anda perlu menghapus target pemasangan yang terpasang ke sistem file secara manual sebelum Anda dapat menghapus sistem file EFS. Langkah ini dilakukan untuk Anda saat Anda menggunakan AWS konsol untuk menghapus sistem file.
**catatan**
Anda tidak dapat menghapus sistem file yang merupakan bagian dari konfigurasi replikasi EFS. Anda perlu menghapus konfigurasi replikasi terlebih dahulu.
Anda tidak dapat menghapus sistem file yang sedang digunakan. Artinya, jika sistem file memiliki target mount, Anda harus menghapusnya terlebih dahulu. Untuk informasi selengkapnya, lihat [DescribeMountTargets](API_DescribeMountTargets.md) dan [DeleteMountTarget](API_DeleteMountTarget.md).
**catatan**
`DeleteFileSystem`Panggilan kembali saat status sistem file masih`deleting`. Anda dapat memeriksa status penghapusan sistem file dengan memanggil [DescribeFileSystems](API_DescribeFileSystems.md) operasi, yang mengembalikan daftar sistem file di akun Anda. Jika Anda meneruskan ID sistem file atau token penciptaan untuk sistem file yang dihapus, [DescribeFileSystems](API_DescribeFileSystems.md) mengembalikan `404 FileSystemNotFound` kesalahan.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DeleteFileSystem`.
## Minta Sintaks
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
ID sistem file yang ingin Anda hapus.
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 tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** FileSystemInUse **
Dikembalikan jika sistem file memiliki target mount.
** 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
** 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
** 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
## Contoh
### Hapus sistem file
Contoh berikut mengirimkan permintaan DELETE ke `file-systems` endpoint (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) untuk menghapus sistem file yang ID-nya`fs-01234567`.
#### Permintaan Sampel
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 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/DeleteFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
Menghapus `FileSystemPolicy` untuk sistem file yang ditentukan. Default `FileSystemPolicy` akan berlaku setelah kebijakan yang ada dihapus. Untuk informasi selengkapnya tentang kebijakan sistem file default, lihat [Menggunakan Kebijakan Berbasis Sumber Daya dengan EFS](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html).
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DeleteFileSystemPolicy`.
## Minta Sintaks
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
Menentukan sistem file EFS untuk menghapus file. `FileSystemPolicy`
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 tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## 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
## 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/DeleteFileSystemPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
Menghapus target mount yang ditentukan.
Operasi ini secara paksa merusak setiap mount sistem file dengan menggunakan target mount yang sedang dihapus, yang dapat mengganggu instance atau aplikasi yang menggunakan mount tersebut. Untuk menghindari aplikasi terputus secara tiba-tiba, Anda dapat mempertimbangkan untuk melepas dudukan target pemasangan, jika memungkinkan. Operasi ini juga menghapus antarmuka jaringan terkait. Penulisan yang tidak berkomitmen mungkin hilang, tetapi melanggar target pemasangan menggunakan operasi ini tidak merusak sistem file itu sendiri. Sistem file yang Anda buat tetap ada. Anda dapat memasang EC2 instance di VPC Anda dengan menggunakan target pemasangan lain.
Operasi ini memerlukan izin untuk tindakan berikut pada sistem file:
+ `elasticfilesystem:DeleteMountTarget`
**catatan**
`DeleteMountTarget`Panggilan kembali saat status target mount diam`deleting`. Anda dapat memeriksa penghapusan target mount dengan memanggil [DescribeMountTargets](API_DescribeMountTargets.md) operasi, yang menampilkan daftar deskripsi target mount untuk sistem file yang diberikan.
Operasi ini juga memerlukan izin untuk EC2 tindakan Amazon berikut pada antarmuka jaringan target pemasangan:
+ `ec2:DeleteNetworkInterface`
## Minta Sintaks
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
ID target mount untuk dihapus (String).
Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.
Pola: `^fsmt-[0-9a-f]{8,40}$`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** DependencyTimeout **
Layanan habis waktu mencoba memenuhi permintaan, dan klien harus mencoba panggilan lagi.
** 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: 504
** 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
** MountTargetNotFound **
Dikembalikan jika tidak ada target mount dengan ID yang ditentukan ditemukan di pemanggil. 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
## Contoh
### Hapus target pemasangan sistem file
Contoh berikut mengirimkan permintaan DELETE untuk menghapus target mount tertentu.
#### Permintaan Sampel
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/DeleteMountTarget)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
Menghapus konfigurasi replikasi. Menghapus konfigurasi replikasi mengakhiri proses replikasi. Setelah konfigurasi replikasi dihapus, sistem file tujuan menjadi `Writeable` dan perlindungan penimpaan replikasi diaktifkan kembali. Untuk informasi selengkapnya, lihat [Menghapus konfigurasi replikasi](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html).
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DeleteReplicationConfiguration`.
## Minta Sintaks
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
Saat mereplikasi di seluruh Akun AWS atau di seluruh Wilayah AWS, Amazon EFS menghapus konfigurasi replikasi dari akun sumber dan tujuan atau Region (`ALL_CONFIGURATIONS`) secara default. Jika ada masalah konfigurasi atau izin yang mencegah Amazon EFS menghapus konfigurasi replikasi dari kedua sisi, Anda dapat menggunakan `LOCAL_CONFIGURATION_ONLY` mode untuk menghapus konfigurasi replikasi hanya dari sisi lokal (akun atau Wilayah tempat penghapusan dilakukan).
Hanya gunakan `LOCAL_CONFIGURATION_ONLY` mode jika Amazon EFS tidak dapat menghapus konfigurasi replikasi di akun sumber dan tujuan atau Wilayah. Menghapus konfigurasi lokal membuat konfigurasi di akun lain atau Wilayah tidak dapat dipulihkan.
Selain itu, jangan gunakan mode ini untuk akun yang sama, replikasi wilayah yang sama karena hal itu menghasilkan kesalahan pengecualian. BadRequest
Nilai Valid: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
ID dari sistem file sumber dalam konfigurasi replikasi.
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 tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** 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
** ReplicationNotFound **
Dikembalikan jika sistem file yang ditentukan tidak memiliki konfigurasi replikasi.
** ErrorCode **
ReplicationNotFound
** 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
## 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/DeleteReplicationConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**catatan**
DEPRECATED - tidak digunakan lagi dan `DeleteTags` tidak dipertahankan. Untuk menghapus tag dari sumber daya EFS, gunakan tindakan [UntagResource](API_UntagResource.md) API.
Menghapus tag yang ditentukan dari sistem file. Jika `DeleteTags` permintaan menyertakan kunci tag yang tidak ada, Amazon EFS mengabaikannya dan tidak menyebabkan kesalahan. Untuk informasi selengkapnya tentang tag dan batasan terkait, lihat [Pembatasan tag](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) di *Panduan AWS Manajemen Penagihan dan Biaya Pengguna*.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DeleteTags`.
## Minta Sintaks
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
ID sistem file yang tagnya ingin Anda hapus (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
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
Daftar kunci tag untuk dihapus.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Diperlukan: Ya
## Sintaksis Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** 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
## 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/DeleteTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# DescribeAccessPoints
Mengembalikan deskripsi titik akses Amazon EFS tertentu jika `AccessPointId` disediakan. Jika Anda memberikan EFS`FileSystemId`, EFS akan mengembalikan deskripsi semua titik akses untuk sistem file tersebut. Anda dapat memberikan salah satu `AccessPointId` atau a `FileSystemId` dalam permintaan, tetapi tidak keduanya.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DescribeAccessPoints`.
## Minta Sintaks
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(Opsional) Menentukan titik akses EFS untuk dijelaskan dalam tanggapan; saling eksklusif dengan. `FileSystemId`
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})$`
** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **
(Opsional) Jika Anda menyediakan`FileSystemId`, EFS mengembalikan semua titik akses untuk sistem file tersebut; saling eksklusif dengan`AccessPointId`.
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})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(Opsional) Saat mengambil semua titik akses untuk sistem file, Anda dapat secara opsional menentukan `MaxItems` parameter untuk membatasi jumlah objek yang dikembalikan dalam respons. Nilai default-nya adalah 100.
Rentang yang Valid: Nilai minimum 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
`NextToken`hadir jika responsnya diberi halaman. Anda dapat menggunakan `NextMarker` dalam permintaan berikutnya untuk mengambil halaman berikutnya dari deskripsi titik akses.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"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"
}
]
}
],
"NextToken": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
Array deskripsi titik akses.
Tipe: Array objek [AccessPointDescription](API_AccessPointDescription.md)
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
Hadir jika ada lebih banyak titik akses daripada yang dikembalikan dalam respons. Anda dapat menggunakan NextMarker dalam permintaan berikutnya untuk mengambil deskripsi tambahan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** 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
## 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/DescribeAccessPoints)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
# DescribeAccountPreferences
Mengembalikan pengaturan preferensi akun untuk Akun AWS yang terkait dengan pengguna yang membuat permintaan, saat ini Wilayah AWS.
## Minta Sintaks
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(Opsional) Saat mengambil preferensi akun, Anda dapat menentukan `MaxItems` parameter secara opsional untuk membatasi jumlah objek yang dikembalikan dalam respons. Nilai default-nya adalah 100.
Tipe: Integer
Rentang yang Valid: Nilai minimum 1.
Wajib: Tidak
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(Opsional) Anda dapat menggunakan `NextToken` permintaan berikutnya untuk mengambil halaman Akun AWS preferensi berikutnya jika payload respons diberi paginasi.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
Diperlukan: Tidak
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) **
Hadir jika ada lebih banyak catatan daripada yang dikembalikan dalam respons. Anda dapat menggunakan `NextToken` dalam permintaan berikutnya untuk mengambil deskripsi tambahan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
Menjelaskan pengaturan preferensi ID sumber daya untuk Akun AWS yang terkait dengan pengguna yang membuat permintaan, saat ini Wilayah AWS.
Tipe: Objek [ResourceIdPreference](API_ResourceIdPreference.md)
## Kesalahan
** 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
## 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/DescribeAccountPreferences)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
Mengembalikan kebijakan cadangan untuk sistem file EFS yang ditentukan.
## Minta Sintaks
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
Menentukan sistem file EFS mana untuk mengambil file. `BackupPolicy`
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 tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
Menjelaskan kebijakan pencadangan sistem file, yang menunjukkan apakah pencadangan otomatis diaktifkan atau dimatikan.
Tipe: Objek [BackupPolicy](API_BackupPolicy.md)
## 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
** 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
** PolicyNotFound **
Dikembalikan jika kebijakan IAM atau kebijakan sumber daya yang ditentukan tidak dapat ditemukan atau diakses. Bergantung pada tindakan yang dilakukan, kesalahan juga dapat dikembalikan jika kebijakan sistem file default berlaku untuk sistem file EFS atau jika tidak ada kebijakan cadangan yang ditentukan.
** 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
** ValidationException **
Dikembalikan jika AWS Backup layanan tidak tersedia Wilayah AWS di mana permintaan dibuat.
** 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
## 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/DescribeBackupPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
Mengembalikan `FileSystemPolicy` untuk sistem file EFS tertentu.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DescribeFileSystemPolicy`.
## Minta Sintaks
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
Menentukan sistem file EFS mana yang akan mengambil untuk. `FileSystemPolicy`
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 tidak memiliki isi permintaan.
## Sintaks 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_DescribeFileSystemPolicy_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_DescribeFileSystemPolicy_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
** 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
** PolicyNotFound **
Dikembalikan jika kebijakan IAM atau kebijakan sumber daya yang ditentukan tidak dapat ditemukan atau diakses. Bergantung pada tindakan yang dilakukan, kesalahan juga dapat dikembalikan jika kebijakan sistem file default berlaku untuk sistem file EFS atau jika tidak ada kebijakan cadangan yang ditentukan.
** 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
## Contoh
### Contoh
Contoh ini menggambarkan salah satu penggunaan. DescribeFileSystemPolicy
#### Permintaan Sampel
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### Contoh Respons
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333: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/DescribeFileSystemPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
Mengembalikan deskripsi sistem file Amazon EFS tertentu jika sistem file `CreationToken` atau `FileSystemId` disediakan. Jika tidak, ia mengembalikan deskripsi semua sistem file yang dimiliki oleh pemanggil Akun AWS di titik Wilayah AWS akhir yang Anda panggil.
Saat mengambil semua deskripsi sistem file, Anda dapat menentukan `MaxItems` parameter secara opsional untuk membatasi jumlah deskripsi dalam respons. Nomor ini secara otomatis diatur ke 100. Jika lebih banyak deskripsi sistem file tetap ada, Amazon EFS mengembalikan`NextMarker`, token buram, dalam respons. Dalam hal ini, Anda harus mengirim permintaan berikutnya dengan parameter `Marker` permintaan yang diatur ke nilai`NextMarker`.
Untuk mengambil daftar deskripsi sistem file Anda, operasi ini digunakan dalam proses iteratif, di mana `DescribeFileSystems` dipanggil pertama tanpa `Marker` dan kemudian operasi terus memanggilnya dengan `Marker` parameter diatur ke nilai `NextMarker` dari dari respon sebelumnya sampai respon memiliki tidak. `NextMarker`
Urutan sistem file yang dikembalikan dalam respons satu `DescribeFileSystems` panggilan dan urutan sistem file yang dikembalikan di seluruh respons iterasi multi-panggilan tidak ditentukan.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DescribeFileSystems`.
## Minta Sintaks
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(Opsional) Membatasi daftar ke sistem file dengan token penciptaan ini (String). Anda menentukan token pembuatan saat membuat sistem file Amazon EFS.
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(Opsional) ID dari sistem file yang deskripsinya ingin Anda ambil (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})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(Opsional) Token pagination buram dikembalikan dari `DescribeFileSystems` operasi sebelumnya (String). Jika ada, menentukan untuk melanjutkan daftar dari mana panggilan kembali telah ditinggalkan.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(Opsional) Menentukan jumlah maksimum sistem file untuk kembali dalam respon (integer). Nomor ini secara otomatis diatur ke 100. Responsnya diberi halaman 100 per halaman jika Anda memiliki lebih dari 100 sistem file.
Rentang yang Valid: Nilai minimum 1.
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
],
"Marker": "string",
"NextMarker": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
Array deskripsi sistem file.
Tipe: Array objek [FileSystemDescription](API_FileSystemDescription.md)
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
Hadir jika disediakan oleh pemanggil dalam permintaan (String).
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
Hadir jika ada lebih banyak sistem file daripada dikembalikan dalam respons (String). Anda dapat menggunakan `NextMarker` dalam permintaan berikutnya untuk mengambil deskripsi.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
## 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
** InternalServerError **
Kembali 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
## Contoh
### Ambil daftar 10 sistem file
Contoh berikut mengirimkan permintaan GET ke `file-systems` endpoint (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`). Permintaan menentukan parameter `MaxItems` query untuk membatasi jumlah deskripsi sistem file untuk 10.
#### Permintaan Sampel
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 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/DescribeFileSystems)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
Mengembalikan `LifecycleConfiguration` objek saat ini untuk sistem file EFS tertentu. Manajemen siklus hidup menggunakan `LifecycleConfiguration` objek untuk mengidentifikasi kapan harus memindahkan file antar kelas penyimpanan. Untuk sistem file tanpa `LifecycleConfiguration` objek, panggilan mengembalikan array kosong dalam respons.
Operasi ini memerlukan izin untuk `elasticfilesystem:DescribeLifecycleConfiguration` operasi.
## Minta Sintaks
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
ID dari sistem file yang `LifecycleConfiguration` objeknya ingin Anda ambil (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
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **
Array kebijakan manajemen siklus hidup. EFS mendukung maksimal satu kebijakan per sistem file.
Tipe: Array objek [LifecyclePolicy](API_LifecyclePolicy.md)
Anggota Array: Jumlah maksimum 3 item.
## 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
** 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
## Contoh
### Mengambil konfigurasi siklus hidup untuk sistem file
Permintaan berikut mengambil `LifecycleConfiguration` objek untuk sistem file tertentu.
#### Permintaan Sampel
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 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/DescribeLifecycleConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
Mengembalikan deskripsi semua target mount saat ini, atau target mount tertentu, untuk sistem file. Saat meminta semua target mount saat ini, urutan target mount yang dikembalikan dalam respons tidak ditentukan.
Operasi ini memerlukan izin untuk `elasticfilesystem:DescribeMountTargets` tindakan, baik pada ID sistem file yang Anda tentukan`FileSystemId`, atau pada sistem file target mount yang Anda tentukan. `MountTargetId`
Perintah CLI yang sesuai adalah. `describe-mount-targets`
## Minta Sintaks
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(Opsional) ID titik akses yang target mount yang ingin Anda daftarkan. Itu harus dimasukkan dalam permintaan Anda jika `MountTargetId` ada `FileSystemId` atau tidak termasuk dalam permintaan Anda. Menerima ID titik akses atau ARN sebagai input.
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})$`
** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **
(Opsional) ID dari sistem file yang target mount Anda ingin daftar (String). Itu harus dimasukkan dalam permintaan Anda jika `AccessPointId` atau `MountTargetId` tidak termasuk. Menerima ID sistem file atau ARN sebagai input.
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})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(Opsional) Token pagination buram dikembalikan dari `DescribeMountTargets` operasi sebelumnya (String). Jika ada, ini menentukan untuk melanjutkan daftar dari mana panggilan kembali sebelumnya ditinggalkan.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(Opsional) Jumlah maksimum target pemasangan untuk kembali dalam respons. Saat ini, nomor ini secara otomatis diatur ke 10, dan nilai lainnya diabaikan. Respons diberi paginasi pada 100 per halaman jika Anda memiliki lebih dari 100 target pemasangan.
Rentang yang Valid: Nilai minimum 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(Opsional) ID dari target mount yang ingin Anda jelaskan (String). Itu harus dimasukkan dalam permintaan Anda jika `FileSystemId` tidak termasuk. Menerima ID target mount atau ARN sebagai input.
Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.
Pola: `^fsmt-[0-9a-f]{8,40}$`
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Marker](#API_DescribeMountTargets_ResponseSyntax) **
Jika permintaan termasuk`Marker`, respon mengembalikan nilai dalam bidang ini.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
Mengembalikan target mount sistem file sebagai array `MountTargetDescription` objek.
Tipe: Array objek [MountTargetDescription](API_MountTargetDescription.md)
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
Jika ada nilai, ada lebih banyak target mount untuk dikembalikan. Dalam permintaan berikutnya, Anda dapat memberikan nilai ini `Marker` dalam permintaan Anda untuk mengambil set target mount berikutnya.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** 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
** MountTargetNotFound **
Dikembalikan jika tidak ada target mount dengan ID yang ditentukan ditemukan di pemanggil. 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
## Contoh
### Ambil deskripsi target mount yang dibuat untuk sistem file
Permintaan berikut mengambil deskripsi target mount yang dibuat untuk sistem file yang ditentukan.
#### Permintaan Sampel
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 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/DescribeMountTargets)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
Mengembalikan grup keamanan yang saat ini berlaku untuk target mount. Operasi ini mengharuskan antarmuka jaringan target pemasangan telah dibuat dan status siklus hidup target pemasangan tidak. `deleted`
Operasi ini memerlukan izin untuk tindakan berikut:
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`tindakan pada sistem file target mount.
+ `ec2:DescribeNetworkInterfaceAttribute`aksi pada antarmuka jaringan target mount.
## Minta Sintaks
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
ID target mount yang grup keamanannya ingin Anda ambil.
Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.
Pola: `^fsmt-[0-9a-f]{8,40}$`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
Berbagai kelompok keamanan.
Tipe: Array string
Anggota Array: Jumlah maksimum 100 item.
Kendala Panjang: Panjang minimum 11. Panjang maksimum 43.
Pola: `^sg-[0-9a-f]{8,40}`
## 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
** IncorrectMountTargetState **
Dikembalikan jika target pemasangan tidak dalam keadaan yang benar untuk operasi.
** 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
** MountTargetNotFound **
Dikembalikan jika tidak ada target mount dengan ID yang ditentukan ditemukan di pemanggil. 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
## Contoh
### Mengambil grup keamanan yang berlaku untuk sistem file
Contoh berikut mengambil grup keamanan yang berlaku untuk antarmuka jaringan yang terkait dengan target mount.
#### Permintaan Sampel
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 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/DescribeMountTargetSecurityGroups)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
Mengambil konfigurasi replikasi untuk sistem file tertentu. Jika sistem file tidak ditentukan, semua konfigurasi replikasi untuk Akun AWS in Wilayah AWS diambil.
## Minta Sintaks
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
Anda dapat mengambil konfigurasi replikasi untuk sistem file tertentu dengan memberikan ID sistem file-nya. Untuk replikasi lintas akun, lintas wilayah, akun hanya dapat menjelaskan konfigurasi replikasi untuk sistem file di Wilayahnya sendiri.
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})$`
** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **
(Opsional) Untuk membatasi jumlah objek yang dikembalikan dalam respons, Anda dapat menentukan `MaxItems` parameternya. Nilai default-nya adalah 100.
Rentang yang Valid: Nilai minimum 1.
** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **
`NextToken`hadir jika responsnya diberi halaman. Anda dapat menggunakan `NextToken` permintaan berikutnya untuk mengambil halaman output berikutnya.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) **
Anda dapat menggunakan `NextToken` dari respons sebelumnya dalam permintaan berikutnya untuk mengambil deskripsi tambahan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
Kumpulan konfigurasi replikasi yang dikembalikan.
Tipe: Array objek [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md)
## 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
** 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
** ReplicationNotFound **
Dikembalikan jika sistem file yang ditentukan tidak memiliki konfigurasi replikasi.
** ErrorCode **
ReplicationNotFound
** 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
** ValidationException **
Dikembalikan jika AWS Backup layanan tidak tersedia Wilayah AWS di mana permintaan dibuat.
** 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
## 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/DescribeReplicationConfigurations)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# DescribeTags
**catatan**
DEPRECATED - `DescribeTags` Tindakan ini tidak digunakan lagi dan tidak dipertahankan. Untuk melihat tag yang terkait dengan sumber daya EFS, gunakan tindakan `ListTagsForResource` API.
Mengembalikan tag yang terkait dengan sistem file. Urutan tag yang dikembalikan dalam respons satu `DescribeTags` panggilan dan urutan tag yang dikembalikan di seluruh respons iterasi beberapa panggilan (saat menggunakan pagination) tidak ditentukan.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DescribeTags`.
## Minta Sintaks
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
ID dari sistem file yang tag set Anda ingin mengambil.
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
** [Marker](#API_DescribeTags_RequestSyntax) **
(Opsional) Token pagination buram dikembalikan dari `DescribeTags` operasi sebelumnya (String). Jika ada, ini menentukan untuk melanjutkan daftar dari mana panggilan sebelumnya ditinggalkan.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(Opsional) Jumlah maksimum tag sistem file untuk dikembalikan dalam respons. Saat ini, nomor ini secara otomatis diatur ke 100, dan nilai lainnya diabaikan. Responsnya diberi halaman 100 per halaman jika Anda memiliki lebih dari 100 tag.
Rentang yang Valid: Nilai minimum 1.
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Marker](#API_DescribeTags_ResponseSyntax) **
Jika permintaan menyertakan a`Marker`, respons mengembalikan nilai itu di bidang ini.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
Jika ada nilai, ada lebih banyak tag untuk dikembalikan. Dalam permintaan berikutnya, Anda dapat memberikan nilai `NextMarker` sebagai nilai `Marker` parameter dalam permintaan berikutnya untuk mengambil set tag berikutnya.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
Mengembalikan tag yang terkait dengan sistem file sebagai array `Tag` objek.
Tipe: Array objek [Tag](API_Tag.md)
## 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
** 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
## Contoh
### Mengambil tag yang terkait dengan sistem file
Permintaan berikut mengambil tag (pasangan kunci-nilai) yang terkait dengan sistem file yang ditentukan.
#### Permintaan Sampel
```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288
{
"Tags":[
{
"Key":"Name",
"Value":"my first file system"
},
{
"Key":"Fleet",
"Value":"Development"
},
{
"Key":"Developer",
"Value":"Alice"
}
]
}
```
## 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/DescribeTags)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# ListTagsForResource
Daftar semua tag untuk sumber daya EFS tingkat atas. Anda harus memberikan ID sumber daya yang ingin Anda ambil tag.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:DescribeAccessPoints`.
## Minta Sintaks
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(Opsional) Menentukan jumlah maksimum objek tag untuk kembali dalam respon. Nilai default-nya adalah 100.
Rentang yang Valid: Nilai minimum 1.
** [NextToken](#API_ListTagsForResource_RequestSyntax) **
(Opsional) Anda dapat menggunakan `NextToken` permintaan berikutnya untuk mengambil halaman berikutnya dari deskripsi titik akses jika payload respons diberi paginasi.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
Menentukan sumber daya EFS yang ingin Anda ambil tag untuk. Anda dapat mengambil tag untuk sistem file EFS dan titik akses menggunakan titik akhir API ini.
Batasan Panjang: Panjang maksimum 128.
Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [NextToken](#API_ListTagsForResource_ResponseSyntax) **
`NextToken`hadir jika payload respons diberi paginasi. Anda dapat menggunakan `NextToken` permintaan berikutnya untuk mengambil halaman berikutnya dari deskripsi titik akses.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
Array tag untuk sumber daya EFS tertentu.
Tipe: Array objek [Tag](API_Tag.md)
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** 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
## 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/ListTagsForResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
Memodifikasi kumpulan grup keamanan yang berlaku untuk target mount.
Saat Anda membuat target pemasangan, Amazon EFS juga membuat antarmuka jaringan baru. Untuk informasi selengkapnya, lihat [CreateMountTarget](API_CreateMountTarget.md). Operasi ini menggantikan grup keamanan yang berlaku untuk antarmuka jaringan yang terkait dengan target pemasangan, dengan yang `SecurityGroups` disediakan dalam permintaan. Operasi ini mengharuskan antarmuka jaringan target pemasangan telah dibuat dan status siklus hidup target pemasangan tidak. `deleted`
Operasi memerlukan izin untuk tindakan berikut:
+ `elasticfilesystem:ModifyMountTargetSecurityGroups`tindakan pada sistem file target mount.
+ `ec2:ModifyNetworkInterfaceAttribute`aksi pada antarmuka jaringan target mount.
## Minta Sintaks
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
ID target mount yang grup keamanannya ingin Anda ubah.
Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.
Pola: `^fsmt-[0-9a-f]{8,40}$`
Wajib: Ya
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
Array grup keamanan VPC. IDs
Tipe: Array string
Anggota Array: Jumlah maksimum 100 item.
Kendala Panjang: Panjang minimum 11. Panjang maksimum 43.
Pola: `^sg-[0-9a-f]{8,40}`
Diperlukan: Tidak
## Sintaksis Respons
```
HTTP/1.1 204
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 204 dengan isi HTTP kosong.
## 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
** IncorrectMountTargetState **
Dikembalikan jika target pemasangan tidak dalam keadaan yang benar untuk operasi.
** 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
** MountTargetNotFound **
Dikembalikan jika tidak ada target mount dengan ID yang ditentukan ditemukan di pemanggil. 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
** SecurityGroupLimitExceeded **
Dikembalikan jika jumlah `SecurityGroups` yang ditentukan dalam permintaan lebih besar dari batas, yang didasarkan pada kuota akun. Hapus beberapa grup keamanan atau minta kuota akun dinaikkan. **Untuk informasi selengkapnya, lihat [Kuota VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) Amazon di *Panduan Pengguna Amazon VPC* (lihat tabel Grup Keamanan).**
** 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
** SecurityGroupNotFound **
Dikembalikan jika salah satu grup keamanan yang ditentukan tidak ada di virtual private cloud (VPC) subnet.
** 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
### Ganti grup keamanan target mount
Contoh berikut menggantikan grup keamanan yang berlaku untuk antarmuka jaringan yang terkait dengan target mount.
#### Permintaan Sampel
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### Contoh Respons
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/ModifyMountTargetSecurityGroups)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
Gunakan operasi ini untuk mengatur preferensi akun saat ini Wilayah AWS untuk menggunakan sumber daya panjang 17 karakter (63 bit) atau 8 karakter pendek (32 bit) IDs untuk sistem file EFS baru dan memasang sumber daya target. Semua sumber daya yang IDs ada tidak terpengaruh oleh perubahan apa pun yang Anda buat. Anda dapat menyetel preferensi ID selama periode keikutsertaan saat EFS beralih ke sumber daya yang panjang. IDs Untuk informasi selengkapnya, lihat [Mengelola sumber daya Amazon EFS IDs](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html).
**catatan**
Mulai Oktober 2021, Anda akan menerima kesalahan jika Anda mencoba mengatur preferensi akun untuk menggunakan ID sumber daya format 8 karakter pendek. Hubungi AWS dukungan jika Anda menerima kesalahan dan harus menggunakan IDs kependekan dari sistem file dan memasang sumber daya target.
## Minta Sintaks
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
Menentukan preferensi ID sumber daya EFS yang akan disetel untuk pengguna Akun AWS, saat ini Wilayah AWS, baik `LONG_ID` (17 karakter), atau `SHORT_ID` (8 karakter).
Mulai Oktober 2021, Anda akan menerima kesalahan saat menyetel preferensi akun ke`SHORT_ID`. Hubungi AWS dukungan jika Anda menerima kesalahan dan harus menggunakan IDs kependekan dari sistem file dan memasang sumber daya target.
Tipe: String
Nilai yang Valid: `LONG_ID | SHORT_ID`
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
Menjelaskan jenis sumber daya dan preferensi ID-nya untuk pengguna Akun AWS, saat ini Wilayah AWS.
Tipe: Objek [ResourceIdPreference](API_ResourceIdPreference.md)
## 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
** 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
## 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/PutAccountPreferences)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
Memperbarui kebijakan cadangan sistem file. Gunakan tindakan ini untuk memulai atau menghentikan pencadangan otomatis sistem file.
## Minta Sintaks
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
Menentukan sistem file EFS mana yang akan memperbarui kebijakan pencadangan.
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.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
Kebijakan cadangan termasuk dalam `PutBackupPolicy` permintaan.
Tipe: Objek [BackupPolicy](API_BackupPolicy.md)
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
Menjelaskan kebijakan pencadangan sistem file, yang menunjukkan apakah pencadangan otomatis diaktifkan atau dimatikan.
Tipe: Objek [BackupPolicy](API_BackupPolicy.md)
## 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
** ValidationException **
Dikembalikan jika AWS Backup layanan tidak tersedia Wilayah AWS di mana permintaan dibuat.
** 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
## 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/PutBackupPolicy)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# 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)
# PutLifecycleConfiguration
Gunakan tindakan ini untuk mengelola penyimpanan untuk sistem file Anda. A `LifecycleConfiguration` terdiri dari satu atau lebih `LifecyclePolicy` objek yang mendefinisikan sebagai berikut:
+ **`TransitionToIA`**— Kapan harus memindahkan file dalam sistem file dari penyimpanan utama (kelas penyimpanan standar) ke penyimpanan Akses Jarang (IA).
+ **`TransitionToArchive`**— Kapan harus memindahkan file dalam sistem file dari kelas penyimpanan mereka saat ini (baik IA atau penyimpanan Standar) ke penyimpanan Arsip.
Sistem file tidak dapat bertransisi ke penyimpanan Arsip sebelum beralih ke penyimpanan IA. Oleh karena itu, TransitionToArchive tidak boleh diatur atau harus lebih lambat dari TransitionTo IA.
**catatan**
Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.
+ **`TransitionToPrimaryStorageClass`**— Apakah akan memindahkan file dalam sistem file kembali ke penyimpanan utama (kelas penyimpanan standar) setelah diakses di penyimpanan IA atau Arsip.
Untuk informasi selengkapnya, lihat [Mengelola penyimpanan sistem file](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
Setiap sistem file Amazon EFS mendukung satu konfigurasi siklus hidup, yang berlaku untuk semua file dalam sistem file. Jika `LifecycleConfiguration` objek sudah ada untuk sistem file yang ditentukan, `PutLifecycleConfiguration` panggilan memodifikasi konfigurasi yang ada. `PutLifecycleConfiguration`Panggilan dengan `LifecyclePolicies` array kosong di badan permintaan menghapus semua yang ada`LifecycleConfiguration`. Dalam permintaan, tentukan yang berikut ini:
+ ID untuk sistem file yang Anda aktifkan, nonaktifkan, atau modifikasi manajemen siklus hidup.
+ `LifecyclePolicies`Array `LifecyclePolicy` objek yang menentukan kapan harus memindahkan file ke penyimpanan IA, ke penyimpanan Arsip, dan kembali ke penyimpanan utama.
**catatan**
Amazon EFS mengharuskan setiap `LifecyclePolicy` objek hanya memiliki satu transisi, sehingga `LifecyclePolicies` array perlu terstruktur dengan `LifecyclePolicy` objek terpisah. Lihat contoh permintaan di bagian berikut untuk informasi selengkapnya.
Operasi ini memerlukan izin untuk `elasticfilesystem:PutLifecycleConfiguration` operasi.
Untuk menerapkan `LifecycleConfiguration` objek ke sistem file terenkripsi, Anda memerlukan AWS Key Management Service izin yang sama seperti ketika Anda membuat sistem file terenkripsi.
## Minta Sintaks
```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
ID dari sistem file tempat Anda membuat `LifecycleConfiguration` objek (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
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
Sebuah array `LifecyclePolicy` objek yang mendefinisikan `LifecycleConfiguration` objek sistem file. `LifecycleConfiguration`Objek menginformasikan manajemen siklus hidup berikut ini:
+ **`TransitionToIA`**— Kapan harus memindahkan file dalam sistem file dari penyimpanan utama (kelas penyimpanan standar) ke penyimpanan Akses Jarang (IA).
+ **`TransitionToArchive`**— Kapan harus memindahkan file dalam sistem file dari kelas penyimpanan mereka saat ini (baik IA atau penyimpanan Standar) ke penyimpanan Arsip.
Sistem file tidak dapat bertransisi ke penyimpanan Arsip sebelum beralih ke penyimpanan IA. Oleh karena itu, TransitionToArchive tidak boleh diatur atau harus lebih lambat dari TransitionTo IA.
**catatan**
Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.
+ **`TransitionToPrimaryStorageClass`**— Apakah akan memindahkan file dalam sistem file kembali ke penyimpanan utama (kelas penyimpanan standar) setelah diakses di penyimpanan IA atau Arsip.
Saat menggunakan perintah `put-lifecycle-configuration` CLI atau tindakan `PutLifecycleConfiguration` API, Amazon EFS mengharuskan setiap `LifecyclePolicy` objek hanya memiliki satu transisi. Ini berarti bahwa dalam badan permintaan, `LifecyclePolicies` harus terstruktur sebagai array `LifecyclePolicy` objek, satu objek untuk setiap transisi penyimpanan. Lihat contoh permintaan di bagian berikut untuk informasi selengkapnya.
Tipe: Array objek [LifecyclePolicy](API_LifecyclePolicy.md)
Anggota Array: Jumlah maksimum 3 item.
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **
Array kebijakan manajemen siklus hidup. EFS mendukung maksimal satu kebijakan per sistem file.
Tipe: Array objek [LifecyclePolicy](API_LifecyclePolicy.md)
Anggota Array: Jumlah maksimum 3 item.
## 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
## Contoh
### Buat konfigurasi siklus hidup
Contoh berikut membuat `LifecyclePolicy` objek menggunakan `PutLifecycleConfiguration` tindakan. Contoh ini membuat kebijakan siklus hidup yang menginstruksikan EFS untuk melakukan hal berikut:
+ Pindahkan semua file dalam sistem file yang belum diakses di penyimpanan Standar dalam 30 hari terakhir ke penyimpanan IA.
+ Pindahkan semua file dalam sistem file yang belum diakses di penyimpanan Standar dalam 90 hari terakhir ke penyimpanan Arsip.
+ Pindahkan file kembali ke penyimpanan Standar setelah diakses di penyimpanan IA atau Arsip. Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.
Untuk informasi selengkapnya, lihat [kelas penyimpanan EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) dan [Mengelola penyimpanan sistem file](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).
#### Permintaan Sampel
```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
### Contoh Permintaan CLI put-lifecycle-configuration
Contoh ini menggambarkan salah satu penggunaan. PutLifecycleConfiguration
#### Permintaan Sampel
```
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
```
#### Contoh Respons
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### Nonaktifkan manajemen siklus hidup
Contoh berikut menonaktifkan manajemen siklus hidup untuk sistem file yang ditentukan.
#### Permintaan Sampel
```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
#### Contoh Respons
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## 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/PutLifecycleConfiguration)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
# TagResource
Membuat tag untuk sumber daya EFS. Anda dapat membuat tag untuk sistem file EFS dan titik akses menggunakan operasi API ini.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:TagResource`.
## Minta Sintaks
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [ResourceId](#API_TagResource_RequestSyntax) **
ID yang menentukan sumber daya EFS yang ingin Anda buat tag.
Batasan Panjang: Panjang maksimum 128.
Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Wajib: Ya
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [Tags](#API_TagResource_RequestSyntax) **
Array `Tag` objek untuk ditambahkan. Setiap `Tag` objek adalah pasangan kunci-nilai.
Tipe: Array objek [Tag](API_Tag.md)
Wajib: Ya
## Sintaksis Respons
```
HTTP/1.1 200
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** 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
## Contoh
### Buat Tag pada Sistem File
Permintaan berikut membuat tiga tag (`"key1"`,`"key2"`, dan`"key3"`) pada sistem file yang ditentukan.
#### Permintaan Sampel
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### Contoh Respons
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 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/TagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
Menghapus tag dari sumber daya EFS. Anda dapat menghapus tag dari sistem file EFS dan titik akses menggunakan operasi API ini.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:UntagResource`.
## Minta Sintaks
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [ResourceId](#API_UntagResource_RequestSyntax) **
Menentukan sumber daya EFS yang ingin Anda hapus tag dari.
Batasan Panjang: Panjang maksimum 128.
Pola: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
Wajib: Ya
** [TagKeys](#API_UntagResource_RequestSyntax) **
Kunci pasangan tag nilai kunci yang ingin Anda hapus dari sumber daya EFS yang ditentukan.
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
** AccessPointNotFound **
Dikembalikan jika `AccessPointId` 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
** 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
** 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
## 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/UntagResource)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# UpdateFileSystem
Memperbarui mode throughput atau jumlah throughput yang disediakan dari sistem file yang ada.
## Minta Sintaks
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
ID sistem file yang ingin Anda perbarui.
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.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(Opsional) Throughput, diukur dalam mebibytes per detik (MiBps), yang ingin Anda sediakan untuk sistem file yang Anda buat. Harus diisi jika `ThroughputMode` diatur ke `provisioned`. Nilai yang valid adalah 1-3414 MiBps, dengan batas atas tergantung pada Wilayah. Untuk meningkatkan batas ini, hubungi Dukungan. Untuk informasi selengkapnya, lihat [Kuota Amazon EFS yang dapat Anda tingkatkan](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) di *Panduan Pengguna Amazon EFS*.
Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
Wajib: Tidak
** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **
(Opsional) Memperbarui mode throughput sistem file. Jika Anda tidak memperbarui mode throughput Anda, Anda tidak perlu memberikan nilai ini dalam permintaan Anda. Jika Anda mengubah `ThroughputMode` ke`provisioned`, Anda juga harus menetapkan nilai untuk`ProvisionedThroughputInMibps`.
Tipe: String
Nilai yang Valid: `bursting | provisioned | elastic`
Wajib: Tidak
## Sintaksis Respons
```
HTTP/1.1 202
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"CreationTime": number,
"CreationToken": "string",
"Encrypted": boolean,
"FileSystemArn": "string",
"FileSystemId": "string",
"FileSystemProtection": {
"ReplicationOverwriteProtection": "string"
},
"KmsKeyId": "string",
"LifeCycleState": "string",
"Name": "string",
"NumberOfMountTargets": number,
"OwnerId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"SizeInBytes": {
"Timestamp": number,
"Value": number,
"ValueInArchive": number,
"ValueInIA": number,
"ValueInStandard": number
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 202.
Layanan mengembalikan data berikut dalam format JSON.
** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) **
Pengidentifikasi unik dan konsisten dari Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Misalnya, `use1-az1` adalah ID Availability Zone untuk Wilayah AWS us-east-1, dan memiliki lokasi yang sama di setiap. Akun AWS
Tipe: String
** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **
Menjelaskan AWS Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Untuk informasi selengkapnya, lihat [Menggunakan kelas penyimpanan EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) di *Panduan Pengguna Amazon EFS*.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **
Waktu sistem file dibuat, dalam hitungan detik (sejak 1970-01-01T 00:00:00 Z).
Tipe: Timestamp
** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **
String buram ditentukan dalam permintaan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `.+`
** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **
Nilai Boolean yang, jika benar, menunjukkan bahwa sistem file dienkripsi.
Jenis: Boolean
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
Nama Sumber Daya Amazon (ARN) untuk sistem file EFS, dalam format. `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id ` Contoh dengan data sampel: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`
Tipe: String
** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) **
ID sistem file, yang ditetapkan oleh Amazon EFS.
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})$`
** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) **
Menjelaskan perlindungan pada sistem file.
Tipe: Objek [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
ID yang AWS KMS key digunakan untuk melindungi sistem file terenkripsi.
Tipe: String
Batasan Panjang: Panjang maksimum 2048.
Pola: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`
** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) **
Fase siklus hidup dari sistem file.
Tipe: String
Nilai yang Valid: `creating | available | updating | deleting | deleted | error`
** [Name](#API_UpdateFileSystem_ResponseSyntax) **
Anda dapat menambahkan tag ke sistem file, termasuk `Name` tag. Untuk informasi selengkapnya, lihat [CreateFileSystem](API_CreateFileSystem.md). Jika sistem file memiliki `Name` tag, Amazon EFS mengembalikan nilai di bidang ini.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
Pola: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **
Jumlah target mount saat ini yang dimiliki sistem file. Untuk informasi selengkapnya, lihat [CreateMountTarget](API_CreateMountTarget.md).
Jenis: Integer
Rentang yang Valid: Nilai minimum 0.
** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **
Akun AWS Yang menciptakan sistem file.
Tipe: String
Kendala Panjang: Panjang maksimum 14.
Pola: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **
Mode performa sistem file.
Tipe: String
Nilai yang Valid: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
Jumlah throughput yang disediakan, diukur dalam MiBps, untuk sistem file. Berlaku untuk sistem file menggunakan `ThroughputMode` set to`provisioned`.
Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **
Ukuran terukur terbaru yang diketahui (dalam byte) data yang disimpan dalam sistem file, di `Value` bidangnya, dan waktu di mana ukuran itu ditentukan di bidangnya`Timestamp`. `Timestamp`Nilainya adalah bilangan bulat detik sejak 1970-01-01T 00:00:00 Z. `SizeInBytes`Nilai tidak mewakili ukuran snapshot yang konsisten dari sistem file, tetapi pada akhirnya konsisten ketika tidak ada penulisan ke sistem file. Artinya, `SizeInBytes` mewakili ukuran sebenarnya hanya jika sistem file tidak dimodifikasi untuk jangka waktu lebih dari beberapa jam. Jika tidak, nilainya bukan ukuran yang tepat dari sistem file pada setiap titik waktu.
Tipe: Objek [FileSystemSize](API_FileSystemSize.md)
** [Tags](#API_UpdateFileSystem_ResponseSyntax) **
Tag yang terkait dengan sistem file, disajikan sebagai array `Tag` objek.
Tipe: Array objek [Tag](API_Tag.md)
** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **
Menampilkan mode throughput sistem file. Untuk informasi selengkapnya, lihat [Mode throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) di *Panduan Pengguna Amazon EFS*.
Tipe: String
Nilai yang Valid: `bursting | provisioned | elastic`
## 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
** InsufficientThroughputCapacity **
Dikembalikan jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan saat Anda mencoba membuat sistem file dalam mode throughput yang disediakan, saat Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau saat Anda mencoba mengubah sistem file yang ada dari Bursting Throughput ke mode Throughput Terprovsioned. Coba lagi nanti.
** 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: 503
** 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
** ThroughputLimitExceeded **
Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 telah tercapai. MiB/s
** 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
** TooManyRequests **
Dikembalikan jika Anda tidak menunggu setidaknya 24 jam sebelum mengubah mode throughput, atau mengurangi nilai Throughput yang Disediakan.
** 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/UpdateFileSystem)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
# UpdateFileSystemProtection
Memperbarui perlindungan pada sistem file.
Operasi ini memerlukan izin utuk tindakan `elasticfilesystem:UpdateFileSystemProtection`.
## Minta Sintaks
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
ID sistem file yang akan diperbarui.
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.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
Status perlindungan penimpaan replikasi sistem file.
+ `ENABLED`— Sistem file tidak dapat digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file dapat ditulis. Perlindungan penimpaan replikasi secara default`ENABLED`.
+ `DISABLED`— Sistem file dapat digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file hanya-baca dan hanya dapat dimodifikasi oleh replikasi EFS.
+ `REPLICATING`— Sistem file digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file hanya-baca dan hanya dimodifikasi hanya oleh replikasi EFS.
Jika konfigurasi replikasi dihapus, perlindungan penimpaan replikasi sistem file diaktifkan kembali dan sistem file menjadi dapat ditulis.
Tipe: String
Nilai yang Valid: `ENABLED | DISABLED | REPLICATING`
Wajib: Tidak
## Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
Status perlindungan penimpaan replikasi sistem file.
+ `ENABLED`— Sistem file tidak dapat digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file dapat ditulis. Perlindungan penimpaan replikasi secara default`ENABLED`.
+ `DISABLED`— Sistem file dapat digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file hanya-baca dan hanya dapat dimodifikasi oleh replikasi EFS.
+ `REPLICATING`— Sistem file digunakan sebagai sistem file tujuan dalam konfigurasi replikasi. Sistem file hanya-baca dan hanya dimodifikasi oleh replikasi EFS.
Jika konfigurasi replikasi dihapus, perlindungan penimpaan replikasi sistem file diaktifkan kembali, sistem file menjadi dapat ditulis.
Tipe: String
Nilai yang Valid: `ENABLED | DISABLED | REPLICATING`
## 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
** InsufficientThroughputCapacity **
Dikembalikan jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan saat Anda mencoba membuat sistem file dalam mode throughput yang disediakan, saat Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau saat Anda mencoba mengubah sistem file yang ada dari Bursting Throughput ke mode Throughput Terprovsioned. Coba lagi nanti.
** 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: 503
** 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
** ReplicationAlreadyExists **
Dikembalikan jika sistem file sudah termasuk dalam konfigurasi replikasi. >
** 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
** ThroughputLimitExceeded **
Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 telah tercapai. MiB/s
** 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
** TooManyRequests **
Dikembalikan jika Anda tidak menunggu setidaknya 24 jam sebelum mengubah mode throughput, atau mengurangi nilai Throughput yang Disediakan.
** 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/UpdateFileSystemProtection)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)