DigitalOcean-public.v2-new_Tags
Retrieve a Tag
To retrieve an individual tag, you can send a GET request to /v2/tags/$TAG_NAME.
This endpoint will only return tagged resources that you are authorized to see. For example, to see tagged Droplets, include the droplet:read scope.
get/v2/tags/{tag_id}
Path parameters
tag_idstring required
The name of the tag. Tags may contain letters, numbers, colons, dashes, and underscores. There is a limit of 255 characters per tag.
Response
The response will be a JSON object with a key called tag. The value of this will be a tag object containing the standard tag attributes.
Tagged resources will only include resources that you are authorized to see.
Example response
{
"tag": {
"tag": {
"name": "extra-awesome",
"resources": {
"count": 5,
"last_tagged_uri": "https://api.digitalocean.com/v2/images/7555620",
"droplets": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/droplets/3164444"
},
"images": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/images/7555620"
},
"volumes": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/volumes/3d80cb72-342b-4aaa-b92e-4e4abb24a933"
},
"volume_snapshots": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/snapshots/1f6f46e8-6b60-11e9-be4e-0a58ac144519"
},
"databases": {
"count": 1,
"last_tagged_uri": "https://api.digitalocean.com/v2/databases/b92438f6-ba03-416c-b642-e9236db91976"
}
}
}
}
}