--- title: Cache --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Cache ##### [Purge Cached Content](https://developers.cloudflare.com/api/resources/cache/methods/purge) POST/zones/{zone\_id}/purge\_cache ##### [Purge Cached Content by Environment](https://developers.cloudflare.com/api/resources/cache/methods/purge_environment) POST/zones/{zone\_id}/environments/{environment\_id}/purge\_cache ##### [Invalidate Cached Content](https://developers.cloudflare.com/api/resources/cache/methods/invalidate) POST/zones/{zone\_id}/invalidate\_cache ##### [Invalidate Cached Content by Environment](https://developers.cloudflare.com/api/resources/cache/methods/invalidate_environment) POST/zones/{zone\_id}/environments/{environment\_id}/invalidate\_cache ##### ModelsExpand Collapse

CachePurgeResponse object {id }

id: string maxLength32 Link to this property

[Link to this property](<#(resource)%20cache%20%3E%20(model)%20cache_purge_response%20%3E%20(schema)>)

CachePurgeEnvironmentResponse object {id }

id: string maxLength32 Link to this property

[Link to this property](<#(resource)%20cache%20%3E%20(model)%20cache_purge_environment_response%20%3E%20(schema)>)

CacheInvalidateResponse object {id }

id: string maxLength32 Link to this property

[Link to this property](<#(resource)%20cache%20%3E%20(model)%20cache_invalidate_response%20%3E%20(schema)>)

CacheInvalidateEnvironmentResponse object {id }

id: string maxLength32 Link to this property

[Link to this property](<#(resource)%20cache%20%3E%20(model)%20cache_invalidate_environment_response%20%3E%20(schema)>) #### CacheCache Reserve ##### [Get Cache Reserve setting](https://developers.cloudflare.com/api/resources/cache/subresources/cache_reserve/methods/get) GET/zones/{zone\_id}/cache/cache\_reserve ##### [Change Cache Reserve setting](https://developers.cloudflare.com/api/resources/cache/subresources/cache_reserve/methods/edit) PATCH/zones/{zone\_id}/cache/cache\_reserve ##### [Get Cache Reserve Clear](https://developers.cloudflare.com/api/resources/cache/subresources/cache_reserve/methods/status) GET/zones/{zone\_id}/cache/cache\_reserve\_clear ##### [Start Cache Reserve Clear](https://developers.cloudflare.com/api/resources/cache/subresources/cache_reserve/methods/clear) POST/zones/{zone\_id}/cache/cache\_reserve\_clear ##### ModelsExpand Collapse CacheReserve = "cache\_reserve" The identifier of the caching setting. [Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve%20%3E%20(schema)>) CacheReserveClear = "cache\_reserve\_clear" ID of the zone setting. [Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve_clear%20%3E%20(schema)>)

CacheReserveGetResponse object {id, editable, value, modified\_on }

id: CacheReserve The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Cache Reserve zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve_get_response%20%3E%20(schema)>)

CacheReserveEditResponse object {id, editable, value, modified\_on }

id: CacheReserve The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Cache Reserve zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve_edit_response%20%3E%20(schema)>)

CacheReserveStatusResponse object {id, start\_ts, state, 2 more } You can use Cache Reserve Clear to clear your Cache Reserve, but you must first disable Cache Reserve. In most cases, this will be accomplished within 24 hours. You cannot re-enable Cache Reserve while this process is ongoing. Keep in mind that you cannot undo or cancel this operation.

id: CacheReserveClear ID of the zone setting. Link to this property start\_ts: string The time that the latest Cache Reserve Clear operation started. formatdate-time Link to this property

state: "In-progress"or "Completed" The current state of the Cache Reserve Clear operation.

One of the following: "In-progress" Link to this property "Completed" Link to this property

Link to this property end\_ts: optional string The time that the latest Cache Reserve Clear operation completed. formatdate-time Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve_status_response%20%3E%20(schema)>)

CacheReserveClearResponse object {id, start\_ts, state, 2 more } You can use Cache Reserve Clear to clear your Cache Reserve, but you must first disable Cache Reserve. In most cases, this will be accomplished within 24 hours. You cannot re-enable Cache Reserve while this process is ongoing. Keep in mind that you cannot undo or cancel this operation.

id: CacheReserveClear ID of the zone setting. Link to this property start\_ts: string The time that the latest Cache Reserve Clear operation started. formatdate-time Link to this property

state: "In-progress"or "Completed" The current state of the Cache Reserve Clear operation.

One of the following: "In-progress" Link to this property "Completed" Link to this property

[Link to this property](<#(resource)%20cache.cache_reserve%20%3E%20(model)%20cache_reserve_clear_response%20%3E%20(schema)>) #### CacheSmart Tiered Cache ##### [Get Smart Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/smart_tiered_cache/methods/get) GET/zones/{zone\_id}/cache/tiered\_cache\_smart\_topology\_enable ##### [Create Smart Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/smart_tiered_cache/methods/create) POST/zones/{zone\_id}/cache/tiered\_cache\_smart\_topology\_enable ##### [Patch Smart Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/smart_tiered_cache/methods/edit) PATCH/zones/{zone\_id}/cache/tiered\_cache\_smart\_topology\_enable ##### [Delete Smart Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/smart_tiered_cache/methods/delete) DELETE/zones/{zone\_id}/cache/tiered\_cache\_smart\_topology\_enable ##### ModelsExpand Collapse

SmartTieredCacheGetResponse object {id, editable, value, modified\_on }

id: "tiered\_cache\_smart\_topology\_enable" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Smart Tiered Cache zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.smart_tiered_cache%20%3E%20(model)%20smart_tiered_cache_get_response%20%3E%20(schema)>)

SmartTieredCacheCreateResponse object {id, editable, value, modified\_on }

id: "tiered\_cache\_smart\_topology\_enable" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Smart Tiered Cache zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.smart_tiered_cache%20%3E%20(model)%20smart_tiered_cache_create_response%20%3E%20(schema)>)

SmartTieredCacheEditResponse object {id, editable, value, modified\_on }

id: "tiered\_cache\_smart\_topology\_enable" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Smart Tiered Cache zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.smart_tiered_cache%20%3E%20(model)%20smart_tiered_cache_edit_response%20%3E%20(schema)>)

SmartTieredCacheDeleteResponse object {id, editable, modified\_on }

id: "tiered\_cache\_smart\_topology\_enable" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.smart_tiered_cache%20%3E%20(model)%20smart_tiered_cache_delete_response%20%3E%20(schema)>) #### CacheVariants ##### [Get variants setting](https://developers.cloudflare.com/api/resources/cache/subresources/variants/methods/get) GET/zones/{zone\_id}/cache/variants ##### [Change variants setting](https://developers.cloudflare.com/api/resources/cache/subresources/variants/methods/edit) PATCH/zones/{zone\_id}/cache/variants ##### [Delete variants setting](https://developers.cloudflare.com/api/resources/cache/subresources/variants/methods/delete) DELETE/zones/{zone\_id}/cache/variants ##### ModelsExpand Collapse

VariantGetResponse object {id, editable, value, modified\_on }

id: "variants" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: object {avif, bmp, gif, 8 more } Value of the zone setting.

avif: optional array of string List of strings with the MIME types of all the variants that should be served for avif. Link to this property bmp: optional array of string List of strings with the MIME types of all the variants that should be served for bmp. Link to this property gif: optional array of string List of strings with the MIME types of all the variants that should be served for gif. Link to this property jp2: optional array of string List of strings with the MIME types of all the variants that should be served for jp2. Link to this property jpeg: optional array of string List of strings with the MIME types of all the variants that should be served for jpeg. Link to this property jpg: optional array of string List of strings with the MIME types of all the variants that should be served for jpg. Link to this property jpg2: optional array of string List of strings with the MIME types of all the variants that should be served for jpg2. Link to this property png: optional array of string List of strings with the MIME types of all the variants that should be served for png. Link to this property tif: optional array of string List of strings with the MIME types of all the variants that should be served for tif. Link to this property tiff: optional array of string List of strings with the MIME types of all the variants that should be served for tiff. Link to this property webp: optional array of string List of strings with the MIME types of all the variants that should be served for webp. Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.variants%20%3E%20(model)%20variant_get_response%20%3E%20(schema)>)

VariantEditResponse object {id, editable, value, modified\_on }

id: "variants" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: object {avif, bmp, gif, 8 more } Value of the zone setting.

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.variants%20%3E%20(model)%20variant_edit_response%20%3E%20(schema)>)

VariantDeleteResponse object {id, editable, modified\_on }

id: "variants" The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.variants%20%3E%20(model)%20variant_delete_response%20%3E%20(schema)>) #### CacheRegional Tiered Cache ##### [Get Regional Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/regional_tiered_cache/methods/get) GET/zones/{zone\_id}/cache/regional\_tiered\_cache ##### [Change Regional Tiered Cache setting](https://developers.cloudflare.com/api/resources/cache/subresources/regional_tiered_cache/methods/edit) PATCH/zones/{zone\_id}/cache/regional\_tiered\_cache ##### ModelsExpand Collapse RegionalTieredCache = "tc\_regional" The identifier of the caching setting. [Link to this property](<#(resource)%20cache.regional_tiered_cache%20%3E%20(model)%20regional_tiered_cache%20%3E%20(schema)>)

RegionalTieredCacheGetResponse object {id, editable, value, modified\_on }

id: RegionalTieredCache The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Regional Tiered Cache zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.regional_tiered_cache%20%3E%20(model)%20regional_tiered_cache_get_response%20%3E%20(schema)>)

RegionalTieredCacheEditResponse object {id, editable, value, modified\_on }

id: RegionalTieredCache The identifier of the caching setting. Link to this property editable: boolean Whether the setting is editable. Link to this property

value: "on"or "off" Value of the Regional Tiered Cache zone setting.

One of the following: "on" Link to this property "off" Link to this property

Link to this property modified\_on: optional string Last time this setting was modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.regional_tiered_cache%20%3E%20(model)%20regional_tiered_cache_edit_response%20%3E%20(schema)>) #### CacheOrigin Cloud Regions ##### [List origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/list) GET/zones/{zone\_id}/origin/cloud\_regions ##### [Get an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/get) GET/zones/{zone\_id}/origin/cloud\_regions/{origin\_ip} ##### [Create or replace an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/update) PUT/zones/{zone\_id}/origin/cloud\_regions/{origin\_ip} ##### [Delete an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/delete) DELETE/zones/{zone\_id}/origin/cloud\_regions/{origin\_ip} ##### [Batch create or replace origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/bulk_update) PUT/zones/{zone\_id}/origin/cloud\_regions/batch ##### [Batch delete origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/bulk_delete) DELETE/zones/{zone\_id}/origin/cloud\_regions/batch ##### [List supported cloud vendors and regions](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/supported_regions) GET/zones/{zone\_id}/origin/cloud\_regions/supported\_regions ##### [List origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/list_v1) Deprecated GET/zones/{zone\_id}/cache/origin\_cloud\_regions ##### [Create an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/create_v1) Deprecated POST/zones/{zone\_id}/cache/origin\_cloud\_regions ##### [Create or update an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/edit_v1) Deprecated PATCH/zones/{zone\_id}/cache/origin\_cloud\_regions ##### [Get an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/get_v1) Deprecated GET/zones/{zone\_id}/cache/origin\_cloud\_regions/{origin\_ip} ##### [Delete an origin cloud region mapping](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/delete_v1) Deprecated DELETE/zones/{zone\_id}/cache/origin\_cloud\_regions/{origin\_ip} ##### [Batch create or update origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/bulk_edit_v1) Deprecated PATCH/zones/{zone\_id}/cache/origin\_cloud\_regions/batch ##### [Batch delete origin cloud region mappings](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/bulk_delete_v1) Deprecated DELETE/zones/{zone\_id}/cache/origin\_cloud\_regions/batch ##### [List supported cloud vendors and regions](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions/methods/supported_regions_v1) Deprecated GET/zones/{zone\_id}/cache/origin\_cloud\_regions/supported\_regions ##### ModelsExpand Collapse

OriginCloudRegionListResponse object {origin\_ip, region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

origin\_ip: string The origin IP address (IPv4 or IPv6). Normalized to canonical form (RFC 5952 for IPv6). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_list_response%20%3E%20(schema)>)

OriginCloudRegionGetResponse object {origin\_ip, region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

origin\_ip: string The origin IP address (IPv4 or IPv6). Normalized to canonical form (RFC 5952 for IPv6). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_get_response%20%3E%20(schema)>)

OriginCloudRegionUpdateResponse object {origin\_ip, region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

origin\_ip: string The origin IP address (IPv4 or IPv6). Normalized to canonical form (RFC 5952 for IPv6). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_update_response%20%3E%20(schema)>)

OriginCloudRegionDeleteResponse object {origin\_ip } Response result for a delete operation. Identifies the deleted mapping.

origin\_ip: string The origin IP address whose mapping was deleted. Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_delete_response%20%3E%20(schema)>)

OriginCloudRegionBulkUpdateResponse object {failed, succeeded } Response result for a batch origin cloud region operation.

failed: array of object {origin\_ip, error, region, vendor } Items that could not be applied, with error details.

origin\_ip: string The origin IP address for this item. Link to this property error: optional string Error message explaining why the item failed. Present only on failed items. Link to this property region: optional string Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete). Link to this property vendor: optional string Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete). Link to this property

Link to this property

succeeded: array of object {origin\_ip, error, region, vendor } Items that were successfully applied.

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_bulk_update_response%20%3E%20(schema)>)

OriginCloudRegionBulkDeleteResponse object {failed, succeeded } Response result for a batch origin cloud region operation.

failed: array of object {origin\_ip, error, region, vendor } Items that could not be applied, with error details.

Link to this property

succeeded: array of object {origin\_ip, error, region, vendor } Items that were successfully applied.

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_bulk_delete_response%20%3E%20(schema)>)

OriginCloudRegionSupportedRegionsResponse object {obtained\_codes, vendors } Cloud vendors and their supported regions for origin cloud region mappings.

obtained\_codes: boolean Whether Cloudflare airport codes (IATA colo identifiers) were successfully resolved for the upper_tier_colos field on each region. When false, the upper_tier_colos arrays may be empty or incomplete. Link to this property

vendors: map\[array of object {name, upper\_tier\_colos } ] Map of vendor name to list of supported regions.

name: string Cloud vendor region identifier. Link to this property upper\_tier\_colos: array of string Cloudflare Tiered Cache upper-tier colocation codes co-located with this cloud region. Requests from zones with a matching origin mapping will be routed through these colos. Link to this property

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_supported_regions_response%20%3E%20(schema)>)

OriginCloudRegionListV1Response object {id, editable, value, modified\_on } Response result for a list of origin cloud region mappings.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: array of object {"origin-ip", region, vendor, modified\_on }

"origin-ip": string The origin IP address (IPv4 or IPv6, canonicalized). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

Link to this property modified\_on: optional string Time the mapping set was last modified. Null when no mappings exist. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_list_v1_response%20%3E%20(schema)>)

OriginCloudRegionCreateV1Response object {id, editable, value, modified\_on } Response result for a single origin cloud region mapping.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: object {"origin-ip", region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

"origin-ip": string The origin IP address (IPv4 or IPv6, canonicalized). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

Link to this property modified\_on: optional string Time the mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_create_v1_response%20%3E%20(schema)>)

OriginCloudRegionEditV1Response object {id, editable, value, modified\_on } Response result for a list of origin cloud region mappings.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: array of object {"origin-ip", region, vendor, modified\_on }

"origin-ip": string The origin IP address (IPv4 or IPv6, canonicalized). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

Link to this property modified\_on: optional string Time the mapping set was last modified. Null when no mappings exist. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_edit_v1_response%20%3E%20(schema)>)

OriginCloudRegionGetV1Response object {id, editable, value, modified\_on } Response result for a single origin cloud region mapping.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: object {"origin-ip", region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

"origin-ip": string The origin IP address (IPv4 or IPv6, canonicalized). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

Link to this property modified\_on: optional string Time the mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_get_v1_response%20%3E%20(schema)>)

OriginCloudRegionDeleteV1Response object {id, editable, value, modified\_on } Response result for a single origin cloud region mapping.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: object {"origin-ip", region, vendor, modified\_on } A single origin IP-to-cloud-region mapping.

"origin-ip": string The origin IP address (IPv4 or IPv6, canonicalized). Link to this property region: string Cloud vendor region identifier. Link to this property

vendor: "aws"or "azure"or "gcp"or "oci" Cloud vendor hosting the origin.

One of the following: "aws" Link to this property "azure" Link to this property "gcp" Link to this property "oci" Link to this property

Link to this property modified\_on: optional string Time this mapping was last modified. formatdate-time Link to this property

Link to this property modified\_on: optional string Time the mapping was last modified. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_delete_v1_response%20%3E%20(schema)>)

OriginCloudRegionBulkEditV1Response object {id, editable, value, modified\_on } Response result for a batch origin cloud region operation.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: object {failed, succeeded }

failed: array of object {"origin-ip", error, region, vendor } Items that could not be applied, with error details.

"origin-ip": string The origin IP address for this item. Link to this property error: optional string Error message explaining why the item failed. Present only on failed items. Link to this property region: optional string Cloud vendor region identifier. Present on succeeded items for patch operations. Link to this property vendor: optional string Cloud vendor identifier. Present on succeeded items for patch operations. Link to this property

Link to this property

succeeded: array of object {"origin-ip", error, region, vendor } Items that were successfully applied.

Link to this property

Link to this property modified\_on: optional string Time the mapping set was last modified. Null when no items were successfully applied. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_bulk_edit_v1_response%20%3E%20(schema)>)

OriginCloudRegionBulkDeleteV1Response object {id, editable, value, modified\_on } Response result for a batch origin cloud region operation.

id: "origin\_public\_cloud\_region" Link to this property editable: boolean Whether the setting can be modified by the current user. Link to this property

value: object {failed, succeeded }

failed: array of object {"origin-ip", error, region, vendor } Items that could not be applied, with error details.

Link to this property

succeeded: array of object {"origin-ip", error, region, vendor } Items that were successfully applied.

Link to this property

Link to this property modified\_on: optional string Time the mapping set was last modified. Null when no items were successfully applied. formatdate-time Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_bulk_delete_v1_response%20%3E%20(schema)>)

OriginCloudRegionSupportedRegionsV1Response object {obtained\_codes, vendors } Cloud vendors and their supported regions for origin cloud region mappings.

vendors: map\[array of object {name, upper\_tier\_colos } ] Map of vendor name to list of supported regions.

Link to this property

[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(model)%20origin_cloud_region_supported_regions_v1_response%20%3E%20(schema)>)