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})$
Wajib: Ya
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- ProvisionedThroughputInMibps
-
(Opsional) Throughput, diukur dalam mebibytes per detik (MiBps), yang ingin Anda sediakan untuk sistem file yang Anda buat. Harus diisi jika
ThroughputMode
diatur keprovisioned
. 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 di Panduan Pengguna Amazon EFS.Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
Wajib: Tidak
- ThroughputMode
-
(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
keprovisioned
, Anda juga harus menetapkan nilai untukProvisionedThroughputInMibps
.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
-
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 AWSTipe: String
- AvailabilityZoneName
-
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 di Panduan Pengguna Amazon EFS.
Tipe: 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).
Tipe: Timestamp
- CreationToken
-
String buram ditentukan dalam permintaan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
.+
- Encrypted
-
Nilai Boolean yang, jika benar, menunjukkan bahwa sistem file dienkripsi.
Jenis: Boolean
- FileSystemArn
-
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
-
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
-
Menjelaskan perlindungan pada sistem file.
Tipe: Objek FileSystemProtectionDescription
- KmsKeyId
-
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
-
Fase siklus hidup dari sistem file.
Tipe: String
Nilai yang Valid:
creating | available | updating | deleting | deleted | error
- Name
-
Anda dapat menambahkan tag ke sistem file, termasuk
Name
tag. Untuk informasi selengkapnya, lihat CreateFileSystem. Jika sistem file memilikiName
tag, Amazon EFS mengembalikan nilai di bidang ini.Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
- NumberOfMountTargets
-
Jumlah target mount saat ini yang dimiliki sistem file. Untuk informasi selengkapnya, lihat CreateMountTarget.
Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 0.
- OwnerId
-
Akun AWS Yang menciptakan sistem file.
Tipe: String
Kendala Panjang: Panjang maksimum 14.
Pola:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- PerformanceMode
-
Mode performa sistem file.
Tipe: String
Nilai yang Valid:
generalPurpose | maxIO
- ProvisionedThroughputInMibps
-
Jumlah throughput yang disediakan, diukur dalam MiBps, untuk sistem file. Berlaku untuk sistem file menggunakan
ThroughputMode
set toprovisioned
.Tipe: Ganda
Rentang Valid: Nilai minimum 1.0.
- SizeInBytes
-
Ukuran terukur terbaru yang diketahui (dalam byte) data yang disimpan dalam sistem file, di
Value
bidangnya, dan waktu di mana ukuran itu ditentukan di bidangnyaTimestamp
.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
- Tags
-
Tag yang terkait dengan sistem file, disajikan sebagai array
Tag
objek.Tipe: Array objek Tag
- ThroughputMode
-
Menampilkan mode throughput sistem file. Untuk informasi selengkapnya, lihat Mode throughput 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.
Kode Status HTTP: 400
- FileSystemNotFound
-
Dikembalikan jika
FileSystemId
nilai yang ditentukan tidak ada di pemohon. Akun AWSKode Status HTTP: 404
- IncorrectFileSystemLifeCycleState
-
Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.
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.
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
-
Dikembalikan 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 ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: