Skip to content
Start here

Resource Tagging

List tagged resources
resource_tagging.list(ResourceTaggingListParams**kwargs) -> SyncCursorPaginationAfter[ResourceTaggingListResponse]
GET/accounts/{account_id}/tags/resources
ModelsExpand Collapse

Response for access_application resources

One of the following:
class ResourceTaggingTaggedResourceObjectAccessApplication: …

Response for access_application resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessApplicationPolicy: …

Response for access_application_policy resources

id: str

Identifies the unique resource.

access_application_id: str

Access application ID is required only for access_application_policy resources

formatuuid
etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application_policy"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessGroup: …

Response for access_group resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_group"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccount: …

Response for account resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccountRuleset: …

Response for account_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account_ruleset"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAIGateway: …

Response for ai_gateway resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["ai_gateway"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingPolicy: …

Response for alerting_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingWebhook: …

Response for alerting_webhook resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_webhook"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAPIGatewayOperation: …

Response for api_gateway_operation resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["api_gateway_operation"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCloudflaredTunnel: …

Response for cloudflared_tunnel resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cloudflared_tunnel"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomCertificate: …

Response for custom_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomHostname: …

Response for custom_hostname resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_hostname"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsDeployment: …

Response for cws_deployment resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_deployment"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicy: …

Response for cws_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicySet: …

Response for cws_policy_set resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy_set"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsWorkload: …

Response for cws_workload resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_workload"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectD1Database: …

Response for d1_database resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["d1_database"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDevice: …

Response for device resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["device"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDNSRecord: …

Response for dns_record resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["dns_record"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDurableObjectNamespace: …

Response for durable_object_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["durable_object_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayList: …

Response for gateway_list resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_list"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayRule: …

Response for gateway_rule resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_rule"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectHealthcheck: …

Response for healthcheck resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["healthcheck"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectImage: …

Response for image resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["image"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectInfrastructureTarget: …

Response for infrastructure_target resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["infrastructure_target"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectKVNamespace: …

Response for kv_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["kv_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancer: …

Response for load_balancer resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerMonitor: …

Response for load_balancer_monitor resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_monitor"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerPool: …

Response for load_balancer_pool resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_pool"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectManagedClientCertificate: …

Response for managed_client_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["managed_client_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectPagesProject: …

Response for pages_project resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["pages_project"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectQueue: …

Response for queue resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["queue"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectR2Bucket: …

Response for r2_bucket resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["r2_bucket"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectResourceShare: …

Response for resource_share resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["resource_share"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamLiveInput: …

Response for stream_live_input resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_live_input"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamVideo: …

Response for stream_video resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_video"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectVectorizeIndex: …

Response for vectorize_index resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["vectorize_index"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorker: …

Response for worker resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerRoute: …

Response for worker_route resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_route"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerVersion: …

Response for worker_version resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_version"]
worker_id: str

Worker ID is required only for worker_version resources

tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZone: …

Response for zone resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZoneRuleset: …

Response for zone_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone_ruleset"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time

Resource TaggingAccount Tags

Get tags for an account-level resource
resource_tagging.account_tags.get(AccountTagGetParams**kwargs) -> AccountTagGetResponse
GET/accounts/{account_id}/tags
Set tags for an account-level resource
resource_tagging.account_tags.update(AccountTagUpdateParams**kwargs) -> AccountTagUpdateResponse
PUT/accounts/{account_id}/tags
Delete tags from an account-level resource
resource_tagging.account_tags.delete(AccountTagDeleteParams**kwargs)
DELETE/accounts/{account_id}/tags
ModelsExpand Collapse

Response for access_application resources

One of the following:
class ResourceTaggingTaggedResourceObjectAccessApplication: …

Response for access_application resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessApplicationPolicy: …

Response for access_application_policy resources

id: str

Identifies the unique resource.

access_application_id: str

Access application ID is required only for access_application_policy resources

formatuuid
etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application_policy"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessGroup: …

Response for access_group resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_group"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccount: …

Response for account resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccountRuleset: …

Response for account_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account_ruleset"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAIGateway: …

Response for ai_gateway resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["ai_gateway"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingPolicy: …

Response for alerting_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingWebhook: …

Response for alerting_webhook resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_webhook"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAPIGatewayOperation: …

Response for api_gateway_operation resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["api_gateway_operation"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCloudflaredTunnel: …

Response for cloudflared_tunnel resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cloudflared_tunnel"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomCertificate: …

Response for custom_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomHostname: …

Response for custom_hostname resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_hostname"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsDeployment: …

Response for cws_deployment resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_deployment"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicy: …

Response for cws_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicySet: …

Response for cws_policy_set resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy_set"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsWorkload: …

Response for cws_workload resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_workload"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectD1Database: …

Response for d1_database resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["d1_database"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDevice: …

Response for device resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["device"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDNSRecord: …

Response for dns_record resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["dns_record"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDurableObjectNamespace: …

Response for durable_object_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["durable_object_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayList: …

Response for gateway_list resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_list"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayRule: …

Response for gateway_rule resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_rule"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectHealthcheck: …

Response for healthcheck resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["healthcheck"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectImage: …

Response for image resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["image"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectInfrastructureTarget: …

Response for infrastructure_target resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["infrastructure_target"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectKVNamespace: …

Response for kv_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["kv_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancer: …

Response for load_balancer resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerMonitor: …

Response for load_balancer_monitor resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_monitor"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerPool: …

Response for load_balancer_pool resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_pool"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectManagedClientCertificate: …

Response for managed_client_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["managed_client_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectPagesProject: …

Response for pages_project resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["pages_project"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectQueue: …

Response for queue resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["queue"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectR2Bucket: …

Response for r2_bucket resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["r2_bucket"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectResourceShare: …

Response for resource_share resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["resource_share"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamLiveInput: …

Response for stream_live_input resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_live_input"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamVideo: …

Response for stream_video resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_video"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectVectorizeIndex: …

Response for vectorize_index resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["vectorize_index"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorker: …

Response for worker resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerRoute: …

Response for worker_route resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_route"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerVersion: …

Response for worker_version resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_version"]
worker_id: str

Worker ID is required only for worker_version resources

tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZone: …

Response for zone resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZoneRuleset: …

Response for zone_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone_ruleset"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time

Response for access_application resources

One of the following:
class ResourceTaggingTaggedResourceObjectAccessApplication: …

Response for access_application resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessApplicationPolicy: …

Response for access_application_policy resources

id: str

Identifies the unique resource.

access_application_id: str

Access application ID is required only for access_application_policy resources

formatuuid
etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application_policy"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessGroup: …

Response for access_group resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_group"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccount: …

Response for account resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccountRuleset: …

Response for account_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account_ruleset"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAIGateway: …

Response for ai_gateway resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["ai_gateway"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingPolicy: …

Response for alerting_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingWebhook: …

Response for alerting_webhook resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_webhook"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAPIGatewayOperation: …

Response for api_gateway_operation resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["api_gateway_operation"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCloudflaredTunnel: …

Response for cloudflared_tunnel resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cloudflared_tunnel"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomCertificate: …

Response for custom_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomHostname: …

Response for custom_hostname resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_hostname"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsDeployment: …

Response for cws_deployment resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_deployment"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicy: …

Response for cws_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicySet: …

Response for cws_policy_set resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy_set"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsWorkload: …

Response for cws_workload resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_workload"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectD1Database: …

Response for d1_database resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["d1_database"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDevice: …

Response for device resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["device"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDNSRecord: …

Response for dns_record resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["dns_record"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDurableObjectNamespace: …

Response for durable_object_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["durable_object_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayList: …

Response for gateway_list resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_list"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayRule: …

Response for gateway_rule resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_rule"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectHealthcheck: …

Response for healthcheck resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["healthcheck"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectImage: …

Response for image resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["image"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectInfrastructureTarget: …

Response for infrastructure_target resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["infrastructure_target"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectKVNamespace: …

Response for kv_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["kv_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancer: …

Response for load_balancer resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerMonitor: …

Response for load_balancer_monitor resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_monitor"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerPool: …

Response for load_balancer_pool resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_pool"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectManagedClientCertificate: …

Response for managed_client_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["managed_client_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectPagesProject: …

Response for pages_project resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["pages_project"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectQueue: …

Response for queue resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["queue"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectR2Bucket: …

Response for r2_bucket resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["r2_bucket"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectResourceShare: …

Response for resource_share resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["resource_share"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamLiveInput: …

Response for stream_live_input resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_live_input"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamVideo: …

Response for stream_video resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_video"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectVectorizeIndex: …

Response for vectorize_index resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["vectorize_index"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorker: …

Response for worker resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerRoute: …

Response for worker_route resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_route"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerVersion: …

Response for worker_version resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_version"]
worker_id: str

Worker ID is required only for worker_version resources

tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZone: …

Response for zone resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZoneRuleset: …

Response for zone_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone_ruleset"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time

Resource TaggingZone Tags

Get tags for a zone-level resource
resource_tagging.zone_tags.get(ZoneTagGetParams**kwargs) -> ZoneTagGetResponse
GET/zones/{zone_id}/tags
Set tags for a zone-level resource
resource_tagging.zone_tags.update(ZoneTagUpdateParams**kwargs) -> ZoneTagUpdateResponse
PUT/zones/{zone_id}/tags
Delete tags from a zone-level resource
resource_tagging.zone_tags.delete(ZoneTagDeleteParams**kwargs)
DELETE/zones/{zone_id}/tags
ModelsExpand Collapse

Response for access_application resources

One of the following:
class ResourceTaggingTaggedResourceObjectAccessApplication: …

Response for access_application resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessApplicationPolicy: …

Response for access_application_policy resources

id: str

Identifies the unique resource.

access_application_id: str

Access application ID is required only for access_application_policy resources

formatuuid
etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application_policy"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessGroup: …

Response for access_group resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_group"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccount: …

Response for account resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccountRuleset: …

Response for account_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account_ruleset"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAIGateway: …

Response for ai_gateway resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["ai_gateway"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingPolicy: …

Response for alerting_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingWebhook: …

Response for alerting_webhook resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_webhook"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAPIGatewayOperation: …

Response for api_gateway_operation resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["api_gateway_operation"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCloudflaredTunnel: …

Response for cloudflared_tunnel resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cloudflared_tunnel"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomCertificate: …

Response for custom_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomHostname: …

Response for custom_hostname resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_hostname"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsDeployment: …

Response for cws_deployment resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_deployment"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicy: …

Response for cws_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicySet: …

Response for cws_policy_set resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy_set"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsWorkload: …

Response for cws_workload resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_workload"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectD1Database: …

Response for d1_database resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["d1_database"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDevice: …

Response for device resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["device"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDNSRecord: …

Response for dns_record resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["dns_record"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDurableObjectNamespace: …

Response for durable_object_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["durable_object_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayList: …

Response for gateway_list resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_list"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayRule: …

Response for gateway_rule resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_rule"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectHealthcheck: …

Response for healthcheck resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["healthcheck"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectImage: …

Response for image resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["image"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectInfrastructureTarget: …

Response for infrastructure_target resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["infrastructure_target"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectKVNamespace: …

Response for kv_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["kv_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancer: …

Response for load_balancer resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerMonitor: …

Response for load_balancer_monitor resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_monitor"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerPool: …

Response for load_balancer_pool resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_pool"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectManagedClientCertificate: …

Response for managed_client_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["managed_client_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectPagesProject: …

Response for pages_project resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["pages_project"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectQueue: …

Response for queue resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["queue"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectR2Bucket: …

Response for r2_bucket resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["r2_bucket"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectResourceShare: …

Response for resource_share resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["resource_share"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamLiveInput: …

Response for stream_live_input resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_live_input"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamVideo: …

Response for stream_video resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_video"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectVectorizeIndex: …

Response for vectorize_index resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["vectorize_index"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorker: …

Response for worker resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerRoute: …

Response for worker_route resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_route"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerVersion: …

Response for worker_version resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_version"]
worker_id: str

Worker ID is required only for worker_version resources

tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZone: …

Response for zone resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZoneRuleset: …

Response for zone_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone_ruleset"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time

Response for access_application resources

One of the following:
class ResourceTaggingTaggedResourceObjectAccessApplication: …

Response for access_application resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessApplicationPolicy: …

Response for access_application_policy resources

id: str

Identifies the unique resource.

access_application_id: str

Access application ID is required only for access_application_policy resources

formatuuid
etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_application_policy"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccessGroup: …

Response for access_group resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["access_group"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccount: …

Response for account resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAccountRuleset: …

Response for account_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["account_ruleset"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAIGateway: …

Response for ai_gateway resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["ai_gateway"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingPolicy: …

Response for alerting_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAlertingWebhook: …

Response for alerting_webhook resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["alerting_webhook"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectAPIGatewayOperation: …

Response for api_gateway_operation resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["api_gateway_operation"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCloudflaredTunnel: …

Response for cloudflared_tunnel resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cloudflared_tunnel"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomCertificate: …

Response for custom_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCustomHostname: …

Response for custom_hostname resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["custom_hostname"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsDeployment: …

Response for cws_deployment resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_deployment"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicy: …

Response for cws_policy resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsPolicySet: …

Response for cws_policy_set resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_policy_set"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectCwsWorkload: …

Response for cws_workload resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["cws_workload"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectD1Database: …

Response for d1_database resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["d1_database"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDevice: …

Response for device resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["device"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDNSRecord: …

Response for dns_record resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["dns_record"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectDurableObjectNamespace: …

Response for durable_object_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["durable_object_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayList: …

Response for gateway_list resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_list"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectGatewayRule: …

Response for gateway_rule resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["gateway_rule"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectHealthcheck: …

Response for healthcheck resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["healthcheck"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectImage: …

Response for image resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["image"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectInfrastructureTarget: …

Response for infrastructure_target resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["infrastructure_target"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectKVNamespace: …

Response for kv_namespace resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["kv_namespace"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancer: …

Response for load_balancer resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerMonitor: …

Response for load_balancer_monitor resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_monitor"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectLoadBalancerPool: …

Response for load_balancer_pool resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["load_balancer_pool"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectManagedClientCertificate: …

Response for managed_client_certificate resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["managed_client_certificate"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectPagesProject: …

Response for pages_project resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["pages_project"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectQueue: …

Response for queue resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["queue"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectR2Bucket: …

Response for r2_bucket resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["r2_bucket"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectResourceShare: …

Response for resource_share resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["resource_share"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamLiveInput: …

Response for stream_live_input resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_live_input"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectStreamVideo: …

Response for stream_video resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["stream_video"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectVectorizeIndex: …

Response for vectorize_index resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["vectorize_index"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorker: …

Response for worker resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker"]
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerRoute: …

Response for worker_route resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_route"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectWorkerVersion: …

Response for worker_version resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["worker_version"]
worker_id: str

Worker ID is required only for worker_version resources

tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZone: …

Response for zone resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time
class ResourceTaggingTaggedResourceObjectZoneRuleset: …

Response for zone_ruleset resources

id: str

Identifies the unique resource.

etag: str

ETag identifier for optimistic concurrency control. Formatted as “v1:” where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations.

name: str

Human-readable name of the resource.

tags: Dict[str, str]

Contains key-value pairs of tags. Keys may contain at most 256 characters. Values may contain at most 1024 characters and may be empty for key-only tags.

type: Literal["zone_ruleset"]
zone_id: str

Zone ID is required only for zone-level resources

maxLength32
minLength32
tags_updated_at: Optional[datetime]

Monotonic version of the resource’s tags: the timestamp assigned when the tags were last written. Returned by read endpoints, by 2PC prepare (the version that will be assigned on commit, unless a concurrent write lands first, in which case a newer version is assigned), and by 2PC commit (the authoritative committed version). Omitted for untagged resources and delete commits: a deleted resource has no current version, and deletions are ordered by event order rather than by version.

formatdate-time

Resource TaggingKeys

List tag keys
resource_tagging.keys.list(KeyListParams**kwargs) -> SyncCursorPaginationAfter[KeyListResponse]
GET/accounts/{account_id}/tags/keys
ModelsExpand Collapse
str

Resource TaggingValues

List tag values
resource_tagging.values.list(strtag_key, ValueListParams**kwargs) -> SyncCursorPaginationAfter[ValueListResponse]
GET/accounts/{account_id}/tags/values/{tag_key}
ModelsExpand Collapse
str

Resource TaggingSummary

List tag key summary
resource_tagging.summary.get(SummaryGetParams**kwargs) -> SummaryGetResponse
GET/accounts/{account_id}/tags/summary
ModelsExpand Collapse
List[SummaryGetResponseItem]

Contains an array of tag keys with their distinct values.

key: str

A tag key.

values: List[str]

All distinct values for this tag key.