Tags
Tagged Objects List
https://api.linode.com/v4/tags/{label}
Returns a paginated list of all objects you've tagged with the requested Tag. This is a mixed collection of all object types.
Important: You must be an unrestricted User in order to access, add, or modify Tags information.
Path Parameters
Query Parameters
The page of a collection to return.
The number of items to return per page.
Request Samples
- Shell
curl -H "Authorization: Bearer $TOKEN" \
"https://api.linode.com/v4/tags/example tag"
Response Samples
- 200
- default
{
"data": [
{
"type": "linode",
"data": {
"label": "balancer12345",
"region": "us-east",
"image": "linode/debian10",
"type": "master",
"group": "",
"tags": [
"example tag",
"another example"
],
"id": 12345,
"status": "active",
"hypervisor": "kvm",
"created": "2018-01-01T00:01:01.000Z",
"updated": "2018-03-01T00:01:01.000Z",
"ipv4": "",
"ipv6": "",
"specs": {
"disk": 81920,
"memory": 4096,
"vcpus": 2,
"gpus": "",
"transfer": 4000
},
"alerts": {
"cpu": 180,
"network_in": 10,
"network_out": 10,
"transfer_quota": 80,
"io": 10000
},
"backups": {
"enabled": true,
"available": true,
"schedule": "",
"last_successful": "2018-01-01T00:01:01"
},
"watchdog_enabled": true,
"host_uuid": "3a3ddd59d9a78bb8de041391075df44de62bfec8",
"has_user_data": true,
"domain": "example.org",
"description": "",
"soa_email": "admin@example.org",
"retry_sec": 300,
"master_ips": "",
"axfr_ips": "",
"expire_sec": 300,
"refresh_sec": 300,
"ttl_sec": 300,
"filesystem_path": "/dev/disk/by-id/scsi-0Linode_Volume_my-volume",
"size": 30,
"linode_id": 12346,
"linode_label": "linode123",
"hardware_type": "nvme",
"hostname": "192.0.2.1.ip.linodeusercontent.com",
"client_conn_throttle": "",
"transfer": {
"total": 32.46078109741211,
"out": 3.5487728118896484,
"in": 28.91200828552246
}
}
}
],
"page": 1,
"pages": 1,
"results": 1
}
Responses
200: A paginated list of objects, organized by type, that have been tagged with the requested Tag.
The Linode's label is for display purposes only. If no label is provided for a Linode, a default will be assigned.
Linode labels have the following constraints:
- Must begin and end with an alphanumeric character.
- May only consist of alphanumeric characters, dashes (
-
), underscores (_
) or periods (.
). - Cannot have two dashes (
--
), underscores (__
) or periods (..
) in a row.
This is the Region where the Linode was deployed. A Linode's region can only be changed by initiating a cross data center migration.
This is the Linode Type that this Linode was deployed with. To change a Linode's Type, use POST /linode/instances/{linodeId}/resize.
A deprecated property denoting a group label for this Linode.
An array of tags applied to this object. Tags are for organizational purposes only.
This Linode's ID which must be provided for all operations impacting this Linode.
A brief description of this Linode's current state. This field may change without direct action from you. For example, when a Linode goes into maintenance mode its status will display "stopped".
The virtualization software powering this Linode.
When this Linode was created.
When this Linode was last updated.
This Linode's IPv4 Addresses. Each Linode is assigned a single public IPv4 address upon creation, and may get a single private IPv4 address if needed. You may need to open a support ticket to get additional IPv4 addresses.
IPv4 addresses may be reassigned between your Linodes, or shared with other Linodes. See the /networking endpoints for details.
This Linode's IPv6 SLAAC address. This address is specific to a Linode, and may not be shared. If the Linode has not been assigned an IPv6 address, the return value will be null
.
Information about the resources available to this Linode.
The amount of storage space, in MB, this Linode has access to. A typical Linode will divide this space between a primary disk with an image
deployed to it, and a swap disk, usually 512 MB. This is the default configuration created when deploying a Linode with an image
through POST /linode/instances. While this configuration is suitable for 99% of use cases, if you need finer control over your Linode's disks, see the /linode/instances/{linodeId}/disks endpoints.
The amount of RAM, in MB, this Linode has access to.
Typically, a Linode boots with all of its available RAM, but this can be configured in a Config profile. See the /linode/instances/{linodeId}/configs endpoints and the LinodeConfig object for more information.
The number of vcpus this Linode has access to.
The number of gpus this Linode has access to.
The amount of network transfer this Linode is allotted each month.
The percentage of CPU usage required to trigger an alert. If the average CPU usage over two hours exceeds this value, we'll send you an alert. Your Linode's total CPU capacity is represented as 100%, multiplied by its number of cores.
For example, a two core Linode's CPU capacity is represented as 200%. If you want
to be alerted at 90% of a two core Linode's CPU capacity, set the alert value to 180
.
The default value is 90% multiplied by the number of cores.
If the value is set to 0
(zero), the alert is disabled.
The amount of incoming traffic, in Mbit/s, required to trigger an alert. If the average incoming traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0
(zero), the alert is disabled.
The amount of outbound traffic, in Mbit/s, required to trigger an alert. If the average outbound traffic over two hours exceeds this value, we'll send you an alert. If this is set to 0
(zero), the alert is disabled.
The percentage of network transfer that may be used before an alert is triggered. When this value is exceeded, we'll alert you. If this is set to 0
(zero), the alert is disabled.
The amount of disk IO operation per second required to trigger an alert. If the average disk IO over two hours exceeds this value, we'll send you an alert. If set to 0
(zero), this alert is disabled.
Information about this Linode's backups status. For information about available backups, see /linode/instances/{linodeId}/backups.
If this Linode has the Backup service enabled. To enable backups, see POST /linode/instances/{linodeId}/backups/enable.
Whether Backups for this Linode are available for restoration.
Backups undergoing maintenance are not available for restoration.
The last successful backup date. 'null' if there was no previous backup.
The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and will reboot it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie will give up if there have been more than 5 boot jobs issued within 15 minutes.
The Linode's host machine, as a UUID.
Whether this compute instance was provisioned utilizing user_data
provided via the Metadata service. See the Linode Create description for more information on Metadata.
Whether this Domain represents the authoritative source of information for the domain it describes ("master"), or whether it is a read-only copy of a master ("slave").
The group this Domain belongs to. This is for display purposes only.
An array of tags applied to this object. Tags are for organizational purposes only.
This Domain's unique ID
Used to control whether this Domain is currently being rendered.
The domain this Domain represents. Domain labels cannot be longer than 63 characters and must conform to RFC1035. Domains must be unique on Linode's platform, including across different Linode accounts; there cannot be two Domains representing the same domain.
A description for this Domain. This is for display purposes only.
Start of Authority email address. This is required for type
master Domains.
The interval, in seconds, at which a failed refresh should be retried.
Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
Any other value is rounded up to the nearest valid value.
A value of 0 is equivalent to the default value of 14400.
The IP addresses representing the master DNS for this Domain. At least one value is required for type
slave Domains. The total combined length of all data within this array cannot exceed 1000 characters.
The list of IPs that may perform a zone transfer for this Domain. The total combined length of all data within this array cannot exceed 1000 characters.
Note: This is potentially dangerous, and should be set to an empty list unless you intend to use it.
The amount of time in seconds that may pass before this Domain is no longer authoritative.
Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
Any other value is rounded up to the nearest valid value.
A value of 0 is equivalent to the default value of 1209600.
The amount of time in seconds before this Domain should be refreshed.
Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
Any other value is rounded up to the nearest valid value.
A value of 0 is equivalent to the default value of 14400.
"Time to Live" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers.
- Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
- Any other value is rounded up to the nearest valid value.
- A value of 0 is equivalent to the default value of 86400.
The Volume's label is for display purposes only.
The unique ID of this Region.
An array of Tags applied to this object. Tags are for organizational purposes only.
The unique ID of this Volume.
The current status of the volume. Can be one of:
creating
- the Volume is being created and is not yet available for use.active
- the Volume is online and available for use.resizing
- the Volume is in the process of upgrading its current capacity.
When this Volume was created.
When this Volume was last updated.
The full filesystem path for the Volume based on the Volume's label. Path is /dev/disk/by-id/scsi-0LinodeVolume + Volume label.
The Volume's size, in GiB.
If a Volume is attached to a specific Linode, the ID of that Linode will be displayed here.
If a Volume is attached to a specific Linode, the label of that Linode will be displayed here.
The storage type of this Volume.
This NodeBalancer's label. These must be unique on your Account.
The Region where this NodeBalancer is located. NodeBalancers only support backends in the same Region.
An array of Tags applied to this object. Tags are for organizational purposes only.
This NodeBalancer's unique ID.
When this NodeBalancer was created.
When this NodeBalancer was last updated.
This NodeBalancer's public IPv4 address.
This NodeBalancer's public IPv6 address.
This NodeBalancer's hostname, beginning with its IP address and ending with .ip.linodeusercontent.com.
Throttle connections per second. Set to 0 (zero) to disable throttling.
Information about the amount of transfer this NodeBalancer has had so far this month.
The total transfer, in MB, used by this NodeBalancer this month.
The total inbound transfer, in MB, used for this NodeBalancer this month.
The total outbound transfer, in MB, used for this NodeBalancer this month.
The current page.
The total number of pages.
The total number of results.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
Tag Delete
https://api.linode.com/v4/tags/{label}
Remove a Tag from all objects and delete it.
Important: You must be an unrestricted User in order to access, add, or modify Tags information.
Path Parameters
Request Samples
Response Samples
- 200
- default
{}
Responses
200: Tag deleted.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.