tagged_objects

Creates, updates, deletes, gets or lists a tagged_objects resource.

Overview

Name	tagged_objects
Type	Resource
Id	linode.tags.tagged_objects

Fields

The following fields are returned by SELECT queries:

list

A paginated list of objects, organized by type, that have been tagged with the requested tag.

Name	Datatype	Description
data		Details on the the specific object type the tag is assigned to.
type	string	The type of object the tag is applied to. (domain, linode, nodebalancer, volume) (example: linode)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	tagLabel	page, page_size	Returns a paginated list of all objects you've tagged with the specified tag. The response includes a mixed collection of all object types. > 📘 > > This operation can only be accessed by account users with unrestricted access. Talk to your local account administrator about access management. OAuth scopes. <br /> account:read_only<br /> Learn more...

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
tagLabel	string	The label of the tag to access. (example: {{tagLabel}})
page	integer	The page of a collection to return.
page_size	integer	The number of items to return per page.

SELECT examples

list

Returns a paginated list of all objects you've tagged with the specified tag. The response includes a mixed collection of all object types.

> 📘
>
> This operation can only be accessed by account users with unrestricted access. Talk to your local account administrator about access management. OAuth scopes.

<br /> account:read_only<br />

Learn more...

SELECT
data,
type
FROM linode.tags.tagged_objects
WHERE tagLabel = '{{ tagLabel }}' -- required
AND page = '{{ page }}'
AND page_size = '{{ page_size }}'
;