Actions56
- Acquisition Actions
- Asset Actions
- Baseline Actions
- Case Actions
- InterACT Actions
- Organization Actions
- Repository Actions
- Task Actions
- Triage Rule Actions
- User Actions
Asset → Add Tags
AI-generatedOverview
This node operation adds tags to assets within a specified organization in the Binalyze AIR system. It is useful for categorizing and managing assets by applying descriptive tags, which can help in organizing, filtering, and searching assets efficiently. For example, an IT administrator can add tags like 'critical', 'server', or 'workstation' to assets to quickly identify and group them for monitoring or reporting purposes.
Use Case Examples
- Add tags 'critical,server' to all assets in organization ID 12345 to mark important servers.
- Add tags 'workstation,remote' to assets filtered by IP address or name within a specific organization.
Properties
| Name | Meaning |
|---|---|
| Tags | Comma-separated list of tags to add to the assets. Tags must contain only lowercase letters, numbers, hyphens, underscores, dots, backslashes, spaces, @, &, and colons. |
| Organization | The organization to which the assets belong. Tags will be added to assets within this organization. This is required for the Add Tags operation. |
| Filter Options | Optional filters to narrow down which assets to add tags to, such as excluding or including specific asset IDs, filtering by asset name, IP address, isolation status, label, managed status, online status, platform, search term, or existing tags. |
Output
JSON
success- Indicates whether the tag addition operation was successful.message- A message providing additional information about the operation result.taggedAssetsCount- The number of assets that were tagged successfully.
Dependencies
- Requires an API key credential for Binalyze AIR to authenticate and perform operations.
Troubleshooting
- Ensure the organization ID or name is valid and accessible with the provided credentials.
- Verify that the tags conform to the allowed character set and format.
- Check that the filter options are correctly specified to target the intended assets.
- Common error messages may include invalid organization ID, unauthorized access, or invalid tag format. Resolving these involves correcting the input parameters and ensuring proper API permissions.