Updated on 2026-06-30 GMT+08:00

Resume a Migration Task Group with a Specified ID

Function

This API is used to resume a paused migration task group with a specified ID.

Calling Method

For details, see Calling APIs.

URI

PUT /v2/{project_id}/taskgroups/{group_id}/start

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.

Minimum: 1

Maximum: 1024

group_id

Yes

String

The task group ID.

Minimum: 1

Maximum: 1024

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The token used for IAM authentication.

Minimum: 1

Maximum: 16384

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

src_ak

No

String

The AK for accessing the source node. Enter a maximum of 100 characters. This parameter is not required for URL list–based migration task groups.

Minimum: 1

Maximum: 100

src_sk

No

String

The SK for accessing the source node. Enter a maximum of 100 characters. This parameter is not required for URL list–based migration task groups.

Minimum: 1

Maximum: 100

src_crypto_type

No

String

The encryption/decryption type. The default value is DEFAULT. The options are DEFAULT and KMS.

Default: DEFAULT

Minimum: 1

Maximum: 32

Enumeration values:

  • DEFAULT

  • KMS

src_kms_key_id

No

String

The KMS key ID, which contains 36 characters.

Minimum: 0

Maximum: 36

connection_string

No

String

The connection string, which is used for Microsoft Azure Blob authentication.

Minimum: 0

Maximum: 2048

json_auth_file

No

String

The file used for Google Cloud Storage authentication.

Minimum: 0

Maximum: 65535

dst_ak

Yes

String

The AK for accessing the destination node. Enter a maximum of 100 characters.

Minimum: 1

Maximum: 100

dst_sk

Yes

String

The SK for accessing the destination node. Enter a maximum of 100 characters.

Minimum: 1

Maximum: 100

dst_crypto_type

No

String

The encryption/decryption type. The default value is DEFAULT. The options are DEFAULT and KMS.

Default: DEFAULT

Minimum: 1

Maximum: 32

Enumeration values:

  • DEFAULT

  • KMS

dst_kms_key_id

No

String

The KMS key ID, which contains 36 characters.

Minimum: 0

Maximum: 36

source_cdn_authentication_key

No

String

The CDN authentication key.

Minimum: 0

Maximum: 255

source_cdn_crypto_type

No

String

The encryption/decryption type. The default value is DEFAULT. The options are DEFAULT and KMS.

Default: DEFAULT

Minimum: 1

Maximum: 32

Enumeration values:

  • DEFAULT

  • KMS

source_cdn_kms_key_id

No

String

The KMS key ID, which contains 36 characters.

Minimum: 0

Maximum: 36

Response Parameters

Status code: 200

Ok

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_msg

String

Error message.

error_code

String

Error code.

Status code: 403

Table 5 Response body parameters

Parameter

Type

Description

error_msg

String

Error message.

error_code

String

Error code.

Example Requests

This example retries the migration task group whose ID is 2c11d99a-9596-4bc6-a6ad-2336455b149c using the AK/SK pairs of the source and destination accounts.

PUT https://{endpoint}/v2/{project_id}/taskgroups/2c11d99a-9596-4bc6-a6ad-2336455b149c/start

{
  "src_ak" : "src_AK",
  "src_sk" : "src_SK",
  "dst_ak" : "dst_AK",
  "dst_sk" : "dst_AK"
}

Example Responses

None

Status Codes

Status Code

Description

200

Ok

400

Bad Request

403

Forbidden

Error Codes

See Error Codes.