API Reference

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

client.cache.originCloudRegions.list(OriginCloudRegionListParams { zone_id, page, per_page } params, RequestOptionsoptions?): V4PagePaginationArray<OriginCloudRegion { origin_ip, region, vendor, modified_on } >

GET/zones/{zone_id}/origin/cloud_regions

Get an origin cloud region mapping

client.cache.originCloudRegions.get(stringoriginIP, OriginCloudRegionGetParams { zone_id } params, RequestOptionsoptions?): OriginCloudRegion { origin_ip, region, vendor, modified_on }

GET/zones/{zone_id}/origin/cloud_regions/{origin_ip}

Create or replace an origin cloud region mapping

client.cache.originCloudRegions.update(stringoriginIP, OriginCloudRegionUpdateParams { zone_id, origin_ip, region, vendor } params, RequestOptionsoptions?): OriginCloudRegion { origin_ip, region, vendor, modified_on }

PUT/zones/{zone_id}/origin/cloud_regions/{origin_ip}

Delete an origin cloud region mapping

client.cache.originCloudRegions.delete(stringoriginIP, OriginCloudRegionDeleteParams { zone_id } params, RequestOptionsoptions?): OriginCloudRegionDeleteResponse { origin_ip }

DELETE/zones/{zone_id}/origin/cloud_regions/{origin_ip}

Batch create or replace origin cloud region mappings

client.cache.originCloudRegions.bulkUpdate(OriginCloudRegionBulkUpdateParams { zone_id, body } params, RequestOptionsoptions?): OriginCloudRegionBulkUpdateResponse { failed, succeeded }

PUT/zones/{zone_id}/origin/cloud_regions/batch

Batch delete origin cloud region mappings

client.cache.originCloudRegions.bulkDelete(OriginCloudRegionBulkDeleteParams { zone_id } params, RequestOptionsoptions?): OriginCloudRegionBulkDeleteResponse { failed, succeeded }

DELETE/zones/{zone_id}/origin/cloud_regions/batch

List supported cloud vendors and regions

client.cache.originCloudRegions.supportedRegions(OriginCloudRegionSupportedRegionsParams { zone_id } params, RequestOptionsoptions?): OriginCloudRegionSupportedRegionsResponse { obtained_codes, vendors }

GET/zones/{zone_id}/origin/cloud_regions/supported_regions

ModelsExpand Collapse

OriginCloudRegion { 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).

region: string

Cloud vendor region identifier.

vendor: "aws" | "azure" | "gcp" | "oci"

Cloud vendor hosting the origin.

One of the following:

"aws"

"azure"

"gcp"

"oci"

modified_on?: string

Time this mapping was last modified.

formatdate-time

OriginCloudRegionDeleteResponse { origin_ip }

Response result for a delete operation. Identifies the deleted mapping.

origin_ip: string

The origin IP address whose mapping was deleted.

OriginCloudRegionBulkUpdateResponse { failed, succeeded }

Response result for a batch origin cloud region operation.

failed: Array<Failed>

Items that could not be applied, with error details.

origin_ip: string

The origin IP address for this item.

error?: string

Error message explaining why the item failed. Present only on failed items.

region?: string

Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

vendor?: string

Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

succeeded: Array<Succeeded>

Items that were successfully applied.

origin_ip: string

The origin IP address for this item.

error?: string

Error message explaining why the item failed. Present only on failed items.

region?: string

Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

vendor?: string

Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

OriginCloudRegionBulkDeleteResponse { failed, succeeded }

Response result for a batch origin cloud region operation.

failed: Array<Failed>

Items that could not be applied, with error details.

origin_ip: string

The origin IP address for this item.

error?: string

Error message explaining why the item failed. Present only on failed items.

region?: string

Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

vendor?: string

Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

succeeded: Array<Succeeded>

Items that were successfully applied.

origin_ip: string

The origin IP address for this item.

error?: string

Error message explaining why the item failed. Present only on failed items.

region?: string

Cloud vendor region identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

vendor?: string

Cloud vendor identifier. Present on succeeded items (the new value for upsert, the deleted value for delete).

OriginCloudRegionSupportedRegionsResponse { 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.

vendors: Record<string, Array<Vendor>>

Map of vendor name to list of supported regions.

name: string

Cloud vendor region identifier.

upper_tier_colos: Array<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.