Create or update subnet tags

Create or update one or more tags for a subnet. If a tag does not exist, it gets created. If a tag already exists, its value is overwritten.

Deprecated: Use PATCH /v1/subnets/{project_id}/{region_id}/{subnet_id} instead.

POST /cloud/v1/subnets/{project_id}/{region_id}/{subnet_id}/metadata

Create or update subnet tags

cURL

curl --request POST \
  --url https://api.gcore.com/cloud/v1/subnets/{project_id}/{region_id}/{subnet_id}/metadata \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{}'

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id · integer · required

Project ID

Example:

1

region_id · integer · required

Region ID

Example:

1

subnet_id · string<uuid4> · required

Subnet ID

Example:

"b39792c3-3160-4356-912e-ba396c95cdcf"

Body

application/json

A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.

{key} · string

Tag value. Maximum 255 characters. Cannot contain tabs, newlines, empty string or start/end with whitespace.

Required string length: 1 - 255

Pattern: ^[^ \t\n\r\f\v]([^\t\n\r\f\v]*[^ \t\n\r\f\v])?$

Example:

"my-tag-value"

Response

204

No Content