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

(選擇性) 您要為您建立的檔案系統佈建的輸送量 (以每秒 MB (MiBps) 為單位。若將 ThroughputMode 設為 provisioned，則為必要項目。有效值為 1-3414 MiBps，上限取決於地區。若要提高此限制，請聯絡 AWS Support。如需詳細資訊，請參閱《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 AWS 區域 區域的「可用區域」 ID，並在每一個 AWS 帳戶 帳戶的位置都相同。

類型：字串

AvailabilityZoneName

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

類型：字串

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

模式：.+

CreationTime

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

類型：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

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

類型：字串

有效值:creating | available | updating | deleting | deleted | error

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

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

HTTP 狀態碼：400

FileSystemNotFound

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

HTTP 狀態碼：404

IncorrectFileSystemLifeCycleState

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

HTTP 狀態碼：409

InsufficientThroughputCapacity

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

HTTP 狀態碼：503

InternalServerError

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

HTTP 狀態碼：500

ThroughputLimitExceeded

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

HTTP 狀態碼：400

TooManyRequests

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

HTTP 狀態碼：429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：

• AWS 命令列介面

• 適用於 .NET 的 AWS 軟體開發套件

• 適用於 C++ 的 AWS 開發套件

• 適用於 Go 的 AWS 軟體開發套件

• 適用於 Java 的 AWS 軟體開發套件第 2 版

• AWS適用於 JavaScript V3 的 SDK

• 適用於 PHP 的 AWS 軟體開發套件第 3 版

• 適用於 Python 的 AWS 開發套件

• 適用於 Ruby 的 AWS 軟體開發套件第 3 版