UpdateFileSystem

Memperbarui mode throughput atau jumlah throughput yang disediakan dari sistem file yang ada.

Sintaks Permintaan

PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json

{
   "ProvisionedThroughputInMibps": number,
   "ThroughputMode": "string"
}

URIParameter Permintaan

Permintaan menggunakan URI parameter 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 JSON format.

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 EFSKuota Amazon yang dapat Anda tingkatkan di Panduan EFS Pengguna Amazon.

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.

Data berikut dikembalikan dalam JSON format oleh layanan.

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 EFS penyimpanan di Panduan EFS Pengguna Amazon.

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

Amazon Resource Name (ARN) untuk sistem EFS file, 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, yang ditetapkan oleh AmazonEFS.

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 EFS Pengguna Amazon.

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.

HTTPKode Status: 400

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

HTTPKode Status: 404

IncorrectFileSystemLifeCycleState

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

HTTPKode Status: 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.

HTTPKode Status: 503

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

HTTPKode Status: 500

ThroughputLimitExceeded

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

HTTPKode Status: 400

TooManyRequests

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

HTTPKode Status: 429

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:

• AWS Antarmuka Baris Perintah

• AWS SDKuntuk. NET

• AWS SDKuntuk C ++

• AWS SDKuntuk Go v2

• AWS SDKuntuk Java V2

• AWS SDKuntuk JavaScript V3

• AWS SDKuntuk PHP V3

• AWS SDKuntuk Python

• AWS SDKpara Ruby V3