Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # 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)