全部产品
Search
文档中心

文件存储 NAS:CreateLifecycleRetrieveJob - 创建数据取回任务

更新时间:Jun 25, 2026

创建一个数据取回任务。

接口说明

  • 仅通用型 NAS 文件系统支持该功能。

  • 每个阿里云账号在同一地域最多允许存在 20 个运行中状态的数据取回任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

nas:CreateLifecycleRetrieveJob

create

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

请求参数

名称

类型

必填

描述

示例值

FileSystemId

string

文件系统 ID。

31a8e4****

Paths

array

指定取回的目录或文件路径列表。最多 10 个路径。

Paths.1=/pathway/doc1,Paths.2=/pathway/doc2

string

指定取回的目录或文件。

必须以正斜线(/)开头,并且是挂载点中真实存在的路径。

/pathway/doc1

StorageType

string

分级存储类型。

  • InfrequentAccess(默认值):低频存储。

  • Archive:归档存储。

枚举值:

  • Archive :

    归档存储

  • InfrequentAccess :

    低频存储

InfrequentAccess

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

BC7C825C-5F65-4B56-BEF6-98C56C7C****

JobId

string

数据取回任务 ID。

lrj-nfstest-ia-160****853-hshvw

示例

正常返回示例

JSON格式

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "JobId": "lrj-nfstest-ia-160****853-hshvw"
}

错误码

HTTP status code

错误码

错误信息

描述

400 OperationDenied.FileSystemNotSupportedForLifecycle The file system does not support lifecycle. 指定的文件系统不支持生命周期管理。
400 OperationDenied.EncryptedFileSystemNotSupportedForLifecycle The encrypted file system does not support lifecycle. 加密的文件系统不支持生命周期管理。
400 OperationDenied.LifecycleRetrieveJobCountLimitExceeded The maximum number of LifecycleRetrieveJobs is exceeded. 数据取回任务数量达到上限。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的文件系统不存在。
404 InvalidParameter.PathNotExist The specified path does not exist. 指定的路径不存在。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情