VolcEngine ECS icon

VolcEngine ECS

Interact with VolcEngine Elastic Compute Service (ECS)
Join our community

Actions3

Overview

This node interacts with the VolcEngine Elastic Compute Service (ECS) to manage custom images. Specifically, the Copy Image operation allows users to copy a custom image from one region to another within VolcEngine's cloud infrastructure. This is useful for scenarios such as:

  • Migrating or replicating virtual machine images across different geographic regions for disaster recovery or latency optimization.
  • Creating backups of custom images in multiple regions.
  • Preparing images in a target region before launching instances there.

For example, a user might copy a custom Linux server image from the Beijing region to the Shanghai region to deploy new servers closer to their customers in East China.

Properties

Name Meaning
Source Image ID The unique identifier of the source custom image to copy. Format: image-xxxxxxxxxxxxxx.
Destination Region The target region where the image will be copied. Options: 华北2（北京）, 华东2（上海）, 华南1（广州）, 中国香港（香港）. Cannot be the same as the source region.
Target Image Name The name for the copied image in the destination region. Length limit: 1-128 characters.
Image Description Optional description for the copied image. If empty, defaults to the source image's description. Length limit: 0-255 characters.
Copy Image Tags Boolean flag indicating whether to copy tags from the source image to the target image.
Project Name Optional project name associated with the image. Required if the user's account has limited project permissions.

Output

The node outputs a JSON object containing details about the copy operation result:

  • success: Boolean indicating if the copy was successful.
  • requestId: The request ID returned by the VolcEngine API for tracking.
  • sourceImageId: The original image ID that was copied.
  • targetImageId: The new image ID created in the destination region.
  • targetRegion: The region where the image was copied to.
  • targetImageName: The name assigned to the copied image.
  • message: A human-readable message confirming the success and showing the new image ID.

Example output JSON:

{
  "success": true,
  "requestId": "some-request-id",
  "sourceImageId": "image-1234567890ab",
  "targetImageId": "image-0987654321cd",
  "targetRegion": "cn-shanghai",
  "targetImageName": "my-copied-image",
  "message": "镜像复制成功，目标镜像ID: image-0987654321cd"
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with VolcEngine ECS.
  • The node makes HTTP requests to the VolcEngine ECS API endpoint at https://open.volcengineapi.com.
  • Proper permissions on the VolcEngine account are needed to perform image copy operations, including access to both source and destination regions.
  • If project-level permissions are enforced, specifying the correct project name is necessary.

Troubleshooting

  • Error: At least one image ID is required — Ensure the Source Image ID property is provided and correctly formatted.
  • Error: Destination region cannot be the same as source region — Select a different target region than the source image’s region.
  • Permission errors — Verify that the API key has sufficient permissions for copying images and accessing both regions.
  • Invalid image name or description length — Confirm that the target image name is between 1 and 128 characters and description does not exceed 255 characters.
  • Network or API errors — Check network connectivity and VolcEngine service status; retry if transient issues occur.
  • If the node returns a failure with an error message, enabling "Continue On Fail" can help process other items without stopping the workflow.

Links and References

Discussion