--- title: Origin Cloud Regions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Cache](https://developers.cloudflare.com/api/resources/cache) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Origin 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)>)