UpdateFileSystem--文件存储 NAS-火山引擎

文档中心

导航

UpdateFileSystem

最近更新时间：2023.10.17 14:47:15首次发布时间：2023.07.10 11:11:52

调用 UpdateFileSystem 接口更新文件系统信息。

请求参数

参数	类型	是否必选	示例值	描述
FileSystemId	String	是	enas-cnbja8cecb87****	文件系统 ID。
FileSystemName	String	否	test	文件系统名称。命名规范如下：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需要在 1~128 个字符内。
Description	String	否	Just-for-test	文件系统描述信息。
ProjectName	String	否	default	文件系统所属项目。
Tags	Array of Tag	否	详情请参见请求示例	需要添加的标签信息。

参数	类型	是否必选	示例值	描述
Key	String	是	tagkey	标签键。
Type	String	是	Custom	标签类型，说明如下： `Custom`: 用户自定义标签。 `System`: 系统标签。
Value	String	是	tagvalue	标签值。

返回参数

无。

示例

请求示例

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 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	AlreadyExists.FileSystemName	The specified name of the file system already exists.	指定的文件系统名称已存在。
404	NotFound.FileSystem	The specified file system does not exist.	指定的文件系统不存在。
404	NotFound.Project	The specified project does not exist.	指定的项目不存在。
412	OperationDenied.FileSystemBusy	The specified operation is denied as the file system is busy.	指定的操作被拒绝，文件系统正在执行其他操作。
412	OperationDenied.FileSystemStatus	The specified operation is denied as the status of the file system does not support the request.	指定的操作被拒绝，文件系统当前状态不支持该请求。
500	InternalError	Service has some internal errors, please retry later or contact the admin.	内部错误，请稍后重试或提交工单处理。