UpdateFileSystem - 更新文件系统--文件存储 NAS-火山引擎

文档中心

立即注册

导航

UpdateFileSystem - 更新文件系统

最近更新时间：2025.04.27 17:14:17首次发布时间：2023.07.10 11:11:52

更新文件系统实例信息

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateFileSystem	要执行的操作，取值：UpdateFileSystem。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
AutoExpand	Boolean	否	false	是否开启自动扩容策略，取值说明如下： `true`：开启自动扩容策略。 `false`：不开启自动扩容策略。
AutoExpandLimit	Integer	否	100	自动扩容策略扩容上限(GiB)。
AutoExpandStep	Integer	否	5	自动扩容策略扩容步长(GiB)。
AutoExpandThreshold	Integer	否	60%	自动扩容策略扩容阈值(%)。
FileSystemId	String	是	enas-cnbja8cecb87****	文件系统 ID。
FileSystemName	String	否	test	文件系统名称。命名规范如下：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需要在 1~128 个字符内。
Description	String	否	Just-for-test	文件系统描述信息。
ProjectName	String	否	default	文件系统所属项目。
Tags	Array of Object	否	详情请参见示例值	需要添加的标签信息。

返回参数

无。

请求示例

POST /?Action=UpdateFileSystem&Version=2022-01-01 HTTP/1.1
Host: filenas.volcengineapi.com
Authorization: HMAC-SHA256 Credential=AKLTOGJhY2E1NTdkZGFmNDg0Yjk0ZDFiNjE5Y2NjZjI****/20230907/cn-beijing/filenas/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=7f1119a75111535b1d6e7929700f22e1474af0fb4fe26c59f5ac5cdba0cc****
Content-Type: application/json; charset=utf-8
X-Content-Sha256: 567112abe45bd6a09504fd244237f14c0ba120491da0d35097afd54d87bd****
X-Date: 20230907T124910Z
{
    "FileSystemId" : "enas-cnbja8cecb87****",
    "Description" : "API测试",
    "Tags": [
        {
             "Key": "key",
             "Value": "value",
             "Type": "Custom"
        }
     ]
}

返回示例

{
    "ResponseMetadata":{
        "RequestId":"92983677-0255-4ea0-a084-0b5e45a093e3",
        "Action":"UpdateFileSystem",
        "Version":"2022-01-01",
        "Service":"FileNAS",
        "Region":"cn-beijing"
    },
    "Result":{
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter format is invalid.	参数格式无效。
400	MissingParameter.FileSystemId	The required parameter FileSystemId is not supplied.	文件系统 ID 不能为空。
400	InvalidParameter.FileSystemName	The specified parameter FileSystemName is invalid.	指定的文件系统名称不合法。
400	InvalidParameter.Description	The specified parameter Description is invalid.	指定的描述信息不合法。
400	InvalidParameter.ProjectName	The specified parameter ProjectName is invalid.	指定的项目名称不合法。
400	InvalidParameter.TagKey	The specified parameter TagKey is invalid.	指定的标签键不合法。
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	指定的标签值不合法。
403	OperationDenied.FileSystemUnhealthy	The specified FileSystem is unhealthy.	文件系统非健康状态。
423	OperationDenied.FileSystemBusy	The specified FileSystem is busy.	文件系统繁忙。
500	InternalError	An internal error has occurred.	内部错误。