Creates a data retrieval job.

Description

You can run a maximum of 20 data retrieval jobs in one region within an Alibaba Cloud account.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateLifecycleRetrieveJob

The operation that you want to perform.

Set the value to CreateLifecycleRetrieveJob.

FileSystemId String Yes 31a8e4****

The ID of the file system.

Paths.N RepeatList Supported Paths.1=/pathway/doc1,Paths.2=/pathway/doc2

Specifies the directory or file whose data you want to retrieve.

The path must be prefixed by a forward slash (/). It must be a path that exists in the mount target. N represents the number of directories or files. Valid values of N: 1 to 10.

Response parameters

Parameter Type Example Description
JobId String lrj-nfstest-ia-160****853-hshvw

The ID of the data retrieval job.

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

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreateLifecycleRetrieveJob
&FileSystemId=31a8e4****
&Paths.1=Paths.1=/pathway/doc1,Paths.2=/pathway/doc2
&<Common Request Parameters>

Sample success responses

XML format

<RequestId>BC7C825C-5F65-4B56-BEF6-98C56C7C****</RequestId>
<JobId>lrj-nfstest-ia-160****853-hshvw</JobId>

JSON format

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

Error codes

HttpCode Error code Error message Required
400 OperationDenied.FileSystemNotSupportedForLifecycle The file system does not support lifecycle. The error message returned because the specified file system does not support lifecycle management.
400 OperationDenied.EncryptedFileSystemNotSupportedForLifecycle The encrypted file system does not support lifecycle. The error message returned because an encrypted file system does not support lifecycle management.
400 OperationDenied.LifecycleRetrieveJobCountLimitExceeded The maximum number of LifecycleRetrieveJobs is exceeded. The error message returned because the maximum number of data retrieval jobs is reached.
404 InvalidFileSystem.NotFound The specified file system does not exist. The error message returned because the specified file system does not exist.
404 InvalidParameter.PathNotExist The specified path does not exist. The error message returned because the specified path does not exist.

For a list of error codes, visit the API Error Center.