TagService

Create a tag definition

Creates a new tag definition in the authenticated account's default namespace. Returns the created tag definition with a server-assigned UUID. Tag key must be unique within the namespace and account.

post/tags

Request

Request body

compartment_idstring

The compartment ID for multi-tenancy scoping.

created_atstring date-time

Read-only. Timestamp created_at, equals to time when particular object was created. Format: RFC 3339 (ISO 8601).

deleted_atstring date-time

Read-only. Timestamp deleted_at, equals to time when particular object was deleted, by default equals to null. Format: RFC 3339 (ISO 8601).

idstring

The resource identifier.

keystring

The tag key. Must be unique within a namespace and account.

regexpstring

The tag regexp. POSIX regexp string, used for values validation. By default equals to "*" (allow all). Only applies to freeform tags.

regexp_descriptionstring

The regexp_description, optional human-readable description explaining the regexp validation pattern.

statusstring

The tag status. Valid values: "active" (default), "revoked" (soft-deleted).

typestring

The tag type. Valid values: "freeform" (default — any value allowed), "restricted" (only predefined values allowed).

updated_atstring date-time

Read-only. Timestamp updated_at, equals to time when particular object was updated, by default equals to created_at. Format: RFC 3339 (ISO 8601).

versioninteger

The version is used for optimistic concurrency control — prevents multiple users from updating the same tag simultaneously. Must match the current server-side version for updates to succeed.

Response

A successful response.

Changes

No recorded changes to this operation across all 1 revision of this API.