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) specifically for image-related tasks. The Describe Tasks operation allows users to query and retrieve information about asynchronous image processing tasks, such as copying or detecting images.

Common scenarios where this node is beneficial include:

  • Monitoring the status and progress of image processing tasks initiated earlier.
  • Retrieving detailed metadata about specific image-related tasks by their IDs or associated resource IDs.
  • Paginating through large sets of task results when many tasks exist.

For example, after initiating an image copy operation, you can use this node to check the status and progress of that copy task by providing its task ID.

Properties

Name Meaning
Query Type Choose how to query tasks:
- By Task IDs
- By Resource IDs
Task IDs Comma-separated list of task IDs (max 100). Used if "Query Type" is "By Task IDs".
Resource IDs Comma-separated list of resource IDs (usually image IDs, max 100). Used if "Query Type" is "By Resource IDs".
Max Results Maximum number of results per page to return (1-100). Default is 20.
Next Token Pagination token to retrieve the next page of results.

Output

The output JSON contains the following fields:

  • success (boolean): Indicates whether the request was successful.
  • requestId (string): The unique identifier for the API request.
  • nextToken (string|null): Token to fetch the next page of results if more tasks are available.
  • tasks (array): List of task objects, each containing:
    • id: Task ID.
    • createdAt: Timestamp when the task was created.
    • updatedAt: Timestamp of the last update to the task.
    • endAt: Timestamp when the task ended.
    • resourceId: Associated resource ID (e.g., image ID).
    • type: Type of the task.
    • progress: Progress percentage or status indicator.
    • status: Current status of the task.
  • totalTasks (number): Number of tasks returned in this response.
  • hasMore (boolean): Whether there are more tasks available beyond this page.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the VolcEngine ECS API.
  • The node uses the base URL https://open.volcengineapi.com and sends requests with content type application/x-www-form-urlencoded.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Error: At least one task ID/resource ID is required
    This occurs if the input string for task IDs or resource IDs is empty or only whitespace. Ensure you provide at least one valid ID.

  • Error: Maximum 100 task IDs/resource IDs are allowed
    The API limits queries to a maximum of 100 IDs per request. Reduce the number of IDs accordingly.

  • Empty or missing imageId parameter (for other operations like detectImage)
    Although not directly related to Describe Tasks, ensure that when using other image operations, the imageId parameter is provided and non-empty.

  • Pagination issues
    If you receive fewer results than expected, check if nextToken is present in the output and use it to fetch subsequent pages.

  • API request failures
    Network issues, invalid credentials, or incorrect parameters may cause errors. Verify your API key and parameter correctness.

Links and References

Discussion