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 '{}'

400

{
  "detail": "<string>",
  "exception_class": "<string>",
  "hint": "<string>",
  "message": "<string>",
  "request_id": "<string>",
  "status": 123,
  "title": "<string>",
  "trace_id": "<string>",
  "type": "internal-server-error",
  "context": {
    "allowed_methods": [
      "<string>"
    ],
    "blocking_count": 123,
    "blocking_resources": [
      {
        "resource_id": "<string>",
        "resource_type": "<string>",
        "resource_name": "<string>"
      }
    ],
    "client_id": 123,
    "operation": "<string>",
    "project_id": 123,
    "quotas": [
      {
        "available": 123,
        "limit": 123,
        "name": "<string>",
        "overflow": 123,
        "region_id": 123,
        "requested": 123,
        "resulting_usage": 123,
        "scope": "global",
        "unit": "<string>",
        "usage": 123
      }
    ],
    "reason": "account",
    "region_id": 123,
    "resource_id": "<string>",
    "resource_status": "<string>",
    "resource_type": "<string>",
    "retry_after": 123
  },
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "loc": [
        "<string>"
      ],
      "ctx": {}
    }
  ],
  "info": null,
  "invalid_fields": null
}

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, or empty strings. Cannot contain characters from U+0080 to U+00FF. Trailing or leading whitespaces will be stripped.

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