UpdateFileSystem

更新輸送量模式或現有檔案系統的佈建輸送量。

請求語法


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

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

URI 請求參數

請求會使用下列 URI 參數。

FileSystemId

您要更新的檔案系統 ID。

長度限制：長度上限為 128。

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

必要：是

請求主體

請求接受採用 JSON 格式的下列資料。

ProvisionedThroughputInMibps

(選用) 您要為所建立檔案系統佈建的輸送量 (以 MiB/s 為單位)。若將 ThroughputMode 設為 provisioned，則為必要項目。有效值為 1 - 3414 MiBps，上限視「地區」而定。若要提高此限制，請聯絡支援。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的您可以增加的 Amazon EFS 配額。

類型：Double

有效範圍：最小值為 1.0。

必要：否

ThroughputMode

(選用) 更新檔案系統的輸送量模式。如果您不更新輸送量模式，則不需要在請求中提供此值。若您正在將 ThroughputMode 設為 provisioned，您也必須為 ProvisionedThroughputInMibps 設定值。

類型：字串

有效值:bursting | provisioned | elastic

必要：否

回應語法


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"
}

回應元素

如果動作成功，則服務傳回 HTTP 202 回應。

服務會傳回下列 JSON 格式的資料。

AvailabilityZoneId

檔案系統所在可用區域的唯一且一致的識別碼僅對單區域有效。例如， use1-az1 是 us-east-1 的可用區域 ID AWS 區域，而且在每個中都有相同的位置 AWS 帳戶。

類型：字串

AvailabilityZoneName

描述檔案系統所在的 AWS 可用區域，且僅適用於單區域檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的使用 EFS 儲存類別。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：.+

CreationTime

建立檔案系統的時間，以秒為單位 (自 1970-01-01T00:00:00Z 以來)。

類型：Timestamp

CreationToken

請求中指定的不透明字串。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：.+

Encrypted

布林值，若為 true，指出加密檔案系統。

類型：布林值

FileSystemArn

Amazon EFS 檔案系統的 Amazon Resource Name (ARN)，格式為 arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id。示例資料範例：arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567

類型：字串

FileSystemId

由 Amazon EFS 指派的檔案系統 ID。

類型：字串

長度限制：長度上限為 128。

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

FileSystemProtection

說明檔案系統的防護。

類型：FileSystemProtectionDescription 物件

KmsKeyId

AWS KMS key 用於保護加密檔案系統的 ID。

類型：字串

長度限制：長度上限為 2048。

模式：^([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

檔案系統的生命周期階段。

類型：字串

Name

您可以將標籤 (包括 Name 標籤) 新增至檔案系統。如需詳細資訊，請參閱CreateFileSystem。如果檔案系統有 Name 標籤，Amazon EFS 會傳回此欄位中的值。

類型：字串

長度限制：長度上限為 256。

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

NumberOfMountTargets

檔案系統目前擁有的掛載目標數。如需詳細資訊，請參閱CreateMountTarget。

類型：整數

有效範圍：最小值為 0。

OwnerId

AWS 帳戶建立檔案系統的。

類型：字串

長度限制：長度上限為 14。

模式：^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

檔案系統的效能模式。

類型：字串

有效值:generalPurpose | maxIO

ProvisionedThroughputInMibps

檔案系統的佈建輸送量總量 (以 MiBps 為單位)。對使用 ThroughputMode 設定為 provisioned 的檔案系統有效。

類型：Double

有效範圍：最小值為 1.0。

SizeInBytes

儲存在檔案系統、Value 欄位中的資料最新已知計量大小 (以位元組為單位)，以及在 Timestamp 欄位中決定該大小的時間。Timestamp 值是自 1970-01-01T00:00:00Z 以來的整數秒數。SizeInBytes 值不代表檔案系統的一致快照集大小，但是在沒有寫入檔案系統時，它最終會保持一致。也就是說，只有超過幾個小時未修改檔案系統，SizeInBytes 才能表示實際大小。否則，該值并不能代表檔案系統在任何時間點的確切大小。

類型：FileSystemSize 物件

Tags

與檔案系統相關聯的標籤以 Tag 物件陣列形式呈現出來。

類型：Tag 物件陣列

ThroughputMode

顯示檔案系統的輸送量模式。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的輸送量模式。

類型：字串

有效值:bursting | provisioned | elastic

錯誤

BadRequest

如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：400

FileSystemNotFound

如果指定的FileSystemId值不存在於請求者的中，則傳回 AWS 帳戶。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：404

IncorrectFileSystemLifeCycleState

如果檔案系統的生命週期狀態不是「可用」，則傳回。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：409

InsufficientThroughputCapacity

如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：503

InternalServerError

如果在伺服器端發生錯誤，則傳回。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：500

ThroughputLimitExceeded

如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：400

TooManyRequests

如果您在變更輸送量模式或降低佈建輸送量值之前未等待至少 24 小時，則傳回。

ErrorCode: 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。
Message: 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。

HTTP 狀態碼：429

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

UntagResource

UpdateFileSystemProtection