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 ke provisioned. Nilai yang valid adalah 1-3414 MiBps, dengan batas atas tergantung pada Wilayah. Untuk meningkatkan batas ini, hubungi AWS Support. 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.

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

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

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).

Tipe: Timestamp

CreationToken

String buram ditentukan dalam permintaan.

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

Jenis: String

FileSystemId

ID sistem file, yang 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})$

FileSystemProtection

Menjelaskan perlindungan pada sistem file.

Tipe: Objek FileSystemProtectionDescription

KmsKeyId

ID yang AWS KMS key digunakan 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

Fase siklus hidup dari sistem file.

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

Jenis: String

Kendala Panjang: Panjang maksimum 14.

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

PerformanceMode

Mode performa sistem file.

Jenis: 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. TimestampNilainya adalah bilangan bulat detik sejak 1970-01-01T 00:00:00 Z. SizeInBytesNilai 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.

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

Kode 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

Dikembalikan 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 AWS SDK khusus bahasa, lihat berikut ini:

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3