UpdateFileSystem - Amazon Elastic File System

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

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

Diperlukan: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

ProvisionedThroughputInMibps

(Opsional) Menetapkan jumlah throughput yang disediakan, di MiB/s, untuk sistem file. Nilai yang valid adalah 1–1024. Jika Anda mengubah mode throughput untuk disediakan, Anda juga harus menyediakan jumlah throughput yang disediakan. Diperlukan jikaThroughputModediubah menjadiprovisionedpada pembaruan.

Jenis: Double

Rentang yang Valid: Nilai minimum 1,0.

Diperlukan: Tidak

ThroughputMode

(Opsional) Memperbarui mode throughput sistem file. Jika Anda tidak memperbarui mode throughput, Anda tidak perlu memberikan nilai ini dalam permintaan Anda. Jika Anda mengubahThroughputModekepadaprovisioned, Anda juga harus menetapkan nilai untukProvisionedThroughputInMibps.

Jenis: Rangkaian

Nilai Valid: bursting | provisioned

Diperlukan: 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", "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": 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

Pengenal unik dan konsisten dari Availability Zone di mana kelas penyimpanan One Zone. Misalnya,use1-az1adalah ID Availability ZoneWilayah AWS, dan memiliki lokasi yang sama di setiapAkun AWS.

Jenis: String

AvailabilityZoneName

MendeskripsikanAWSAvailability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file yang menggunakan kelas penyimpanan One Zone. Untuk informasi selengkapnya, lihatMenggunakan kelas penyimpanan EFSdiPanduan Pengguna Amazon EFS.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: .+

CreationTime

Waktu sistem file dibuat, dalam hitungan detik (sejak 1970-01-01T 00:00:00 Z).

Jenis: Timestamp

CreationToken

String buram ditentukan dalam permintaan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: .+

Encrypted

Nilai Boolean yang, jika true, menunjukkan bahwa sistem file dienkripsi.

Jenis: Boolean

FileSystemArn

Amazon Resource Name (ARN) untuk sistem file EFS, dalam formatarn: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

Jenis: String

FileSystemId

ID sistem file, ditetapkan oleh Amazon EFS.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

KmsKeyId

ID dariAWS KMS keydigunakan untuk melindungi sistem file terenkripsi.

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

Tahap siklus hidup sistem file.

Jenis: Rangkaian

Nilai Valid: creating | available | updating | deleting | deleted | error

Name

Anda dapat menambahkan tag ke sistem file, termasukNametag. Untuk informasi selengkapnya, lihat CreateFileSystem. Jika sistem file memilikiNameTag, Amazon EFS mengembalikan nilai dalam bidang ini.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

Jumlah saat ini target mount yang dimiliki sistem file. Untuk informasi selengkapnya, lihat CreateMountTarget.

Jenis: Bulat

Rentang yang Valid: Nilai minimum 0.

OwnerId

ParameterAkun AWSyang menciptakan sistem file. Jika sistem file dibuat oleh pengguna IAM, akun induk yang merupakan pemilik.

Jenis: String

Batasan Panjang: Panjang maksimum 14.

Pola: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

Mode performa sistem file.

Jenis: Rangkaian

Nilai Valid: generalPurpose | maxIO

ProvisionedThroughputInMibps

Jumlah throughput yang disediakan, diukur dalam MiB/dtk, untuk sistem file. Berlaku untuk sistem fileThroughputModeset keprovisioned.

Jenis: Double

Rentang yang Valid: Nilai minimum 1,0.

SizeInBytes

Ukuran meteran terbaru yang diketahui (dalam byte) data yang tersimpan dalam sistem file, di dalamnyaValuelapangan, dan waktu di mana ukuran itu ditentukan dalamTimestampbidang. ParameterTimestampnilai adalah jumlah integer detik sejak 1970-01-01T 00:00:00 Z. ParameterSizeInBytesnilai tidak mewakili ukuran snapshot konsisten dari sistem file, tetapi akhirnya konsisten ketika tidak ada menulis ke sistem file. Itu adalah,SizeInBytesmewakili ukuran aktual hanya jika sistem file tidak dimodifikasi untuk jangka waktu lebih lama dari beberapa jam. Jika tidak, nilainya bukan ukuran yang tepat bahwa sistem file pada setiap titik waktu.

Tipe: Objek FileSystemSize

Tags

Tag yang terkait dengan sistem file, disajikan sebagai arrayTagbenda.

Jenis: ArrayTagobjek

ThroughputMode

Menampilkan mode throughput sistem file. Untuk informasi selengkapnya, lihatMode throughputdiPanduan Pengguna Amazon EFS.

Jenis: Rangkaian

Nilai Valid: bursting | provisioned

Kesalahan

BadRequest

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

Kode Status HTTP: 400

FileSystemNotFound

Kembali jika ditentukanFileSystemIdnilai tidak ada di pemohonAkun AWS.

Kode Status HTTP: 404

IncorrectFileSystemLifeCycleState

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

Kode Status HTTP: 409

InsufficientThroughputCapacity

Kembali jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan ketika Anda mencoba membuat sistem file dalam mode throughput yang disediakan, ketika Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau ketika Anda mencoba mengubah sistem file yang ada dari Meledak Throughput ke mode Throughput yang Disediakan. Coba lagi nanti.

Kode Status HTTP: 503

InternalServerError

Kembali jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

ThroughputLimitExceeded

Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 MiB/s telah tercapai.

Kode Status HTTP: 400

TooManyRequests

Kembali jika Anda tidak menunggu setidaknya 24 jam sebelum mengubah mode throughput, atau mengurangi nilai Throughput yang Disediakan.

Kode Status HTTP: 429

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API di salah satu bahasaAWSSDK, lihat yang berikut ini: