本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
更新輸送量模式或現有檔案系統的佈建輸送量。
請求語法
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
-
說明檔案系統的防護。
- 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
-
如果指定的
FileSystemId
值不存在於請求者的 中,則傳回 AWS 帳戶。HTTP 狀態碼:404
- IncorrectFileSystemLifeCycleState
-
如果檔案系統的生命週期狀態不是「可用」,則傳回。
HTTP 狀態碼:409
- InsufficientThroughputCapacity
-
如果沒有足夠容量佈建其他輸送量,則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量,或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時,系統可能會傳回此值。請稍後再試。
HTTP 狀態碼:503
- InternalServerError
-
如果在伺服器端發生錯誤,則傳回。
HTTP 狀態碼:500
- ThroughputLimitExceeded
-
如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量,則傳回。
HTTP 狀態碼:400
- TooManyRequests
-
如果您在變更輸送量模式或降低佈建輸送量值之前未等待至少 24 小時,則傳回。
HTTP 狀態碼:429
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: