Cloudinary icon

Cloudinary

Upload to Cloudinary

Actions5

Overview

This node integrates with a cloud-based media management service to perform administrative operations related to tags on media assets. Specifically, the "Admin - Get Tags" operation retrieves all tags associated with a specified type of resource (image, video, or raw files). This is useful for scenarios where users want to analyze, filter, or manage tags applied to their media assets in bulk.

Practical examples include:

  • Fetching all image tags starting with a certain prefix to organize or audit tagging conventions.
  • Retrieving a limited number of video tags to display popular categories or labels in a dashboard.
  • Getting raw file tags to automate workflows based on metadata classification.

Properties

Name Meaning
Resource Type The type of resource to get tags for. Options: Image, Video, Raw.
Prefix Filter tags that start with this prefix (string). Optional; if empty, no prefix filtering.
Max Results Maximum number of tags to return. Number between 1 and 500. Defaults to 100.

Output

The output is a JSON object containing the list of tags retrieved from the service for the specified resource type. The structure typically includes tag names and possibly additional metadata about each tag as returned by the API.

Example output snippet (simplified):

{
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ],
  "next_cursor": "optional-pagination-token"
}

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the cloud media management service.
  • The node uses HTTP Basic Authentication with the API key and secret.
  • No additional environment variables are required beyond the configured credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Requesting more than 500 tags will be rejected due to API limits.
    • Using an invalid resource type may result in errors or empty results.

  • Error messages:

    • "Invalid API key or secret": Check that the API credentials are correctly configured.
    • "Max results must be between 1 and 500": Adjust the Max Results property within allowed range.
    • "Resource type not supported": Ensure the Resource Type is one of Image, Video, or Raw.

To resolve these, verify credentials, input parameters, and ensure network connectivity to the API endpoint.

Links and References

Discussion