Apply changes to an existing pool, overwriting the supplied properties.
/user/load_balancers/pools/{identifier}
patch
Load Balancer Pools
load-balancer-pools-patch-pool
nullnull[
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"example": "17b5962d775c646f3f9725cbc7a53df4",
"type": "string"
}
}
]{
"content": {
"application/json": {
"schema": {
"properties": {
"check_regions": {
"description": "A list of regions from which to run health checks. Null means every Cloudflare data center.",
"example": [
"WEU",
"ENAM"
],
"items": {
"description": "WNAM: Western North America, ENAM: Eastern North America, WEU: Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM: Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa, SAF: South Africa, SAS: Southern Asia, SEAS: South East Asia, NEAS: North East Asia, ALL_REGIONS: all regions (ENTERPRISE customers only).",
"enum": [
"WNAM",
"ENAM",
"WEU",
"EEU",
"NSAM",
"SSAM",
"OC",
"ME",
"NAF",
"SAF",
"SAS",
"SEAS",
"NEAS",
"ALL_REGIONS"
],
"type": "string"
},
"nullable": true,
"type": "array"
},
"description": {
"description": "A human-readable description of the pool.",
"example": "Primary data center - Provider XYZ",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the pool is disabled. This field is set with the time the pool was disabled at.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) or disable this pool. Disabled pools will not receive traffic and are excluded from health checks. Disabling a pool will cause any load balancers using it to failover to the next pool (if any).",
"example": false,
"type": "boolean"
},
"latitude": {
"description": "The latitude of the data center containing the origins used in this pool in decimal degrees. If this is set, longitude must also be set.",
"type": "number"
},
"load_shedding": {
"description": "Configures load shedding policies and percentages for the pool.",
"properties": {
"default_percent": {
"default": 0,
"description": "The percent of traffic to shed from the pool, according to the default policy. Applies to new sessions and traffic without session affinity.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"default_policy": {
"default": "random",
"description": "The default policy to use when load shedding. A random policy randomly sheds a given percent of requests. A hash policy computes a hash over the CF-Connecting-IP address and sheds all requests originating from a percent of IPs.",
"enum": [
"random",
"hash"
],
"type": "string"
},
"session_percent": {
"default": 0,
"description": "The percent of existing sessions to shed from the pool, according to the session policy.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"session_policy": {
"default": "hash",
"description": "Only the hash policy is supported for existing sessions (to avoid exponential decay).",
"enum": [
"hash"
],
"type": "string"
}
},
"type": "object"
},
"longitude": {
"description": "The longitude of the data center containing the origins used in this pool in decimal degrees. If this is set, latitude must also be set.",
"type": "number"
},
"minimum_origins": {
"default": 1,
"description": "The minimum number of origins that must be healthy for this pool to serve traffic. If the number of healthy origins falls below this number, the pool will be marked unhealthy and will failover to the next available pool.",
"type": "integer"
},
"monitor": {
"description": "The ID of the Monitor to use for checking the health of origins within this pool."
},
"name": {
"description": "A short name (tag) for the pool. Only alphanumeric characters, hyphens, and underscores are allowed.",
"example": "primary-dc-1",
"type": "string"
},
"notification_email": {
"description": "This field is now deprecated. It has been moved to Cloudflare's Centralized Notification service https://developers.cloudflare.com/fundamentals/notifications/. The email address to send health status notifications to. This can be an individual mailbox or a mailing list. Multiple emails can be supplied as a comma delimited list.",
"example": "someone@example.com,sometwo@example.com",
"type": "string"
},
"notification_filter": {
"description": "Filter pool and origin health notifications by resource type or health status. Use null to reset.",
"example": {
"origin": {
"disable": true
},
"pool": {
"healthy": false
}
},
"nullable": true,
"properties": {
"origin": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
},
"pool": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
},
"origin_steering": {
"description": "Configures origin steering for the pool. Controls how origins are selected for new sessions and traffic without session affinity.",
"properties": {
"policy": {
"default": "random",
"description": "The type of origin steering policy to use.\n- `\"random\"`: Select an origin randomly.\n- `\"hash\"`: Select an origin by computing a hash over the CF-Connecting-IP address.\n- `\"least_outstanding_requests\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of outstanding requests. Origins with more pending requests are weighted proportionately less relative to others.\n- `\"least_connections\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of open connections. Origins with more open connections are weighted proportionately less relative to others. Supported for HTTP/1 and HTTP/2 connections.",
"enum": [
"random",
"hash",
"least_outstanding_requests",
"least_connections"
],
"type": "string"
}
},
"type": "object"
},
"origins": {
"description": "The list of origins within this pool. Traffic directed at this pool is balanced across all currently healthy origins, provided the pool itself is healthy.",
"items": {
"properties": {
"address": {
"description": "The IP address (IPv4 or IPv6) of the origin, or its publicly addressable hostname. Hostnames entered here should resolve directly to the origin, and not be a hostname proxied by Cloudflare. To set an internal/reserved address, virtual_network_id must also be set.",
"example": "0.0.0.0",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the origin is disabled. This field is set with the time the origin was disabled.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) this origin within the pool. Disabled origins will not receive traffic and are excluded from health checks. The origin will only be disabled for the current pool.",
"example": true,
"type": "boolean"
},
"header": {
"description": "The request header is used to pass additional information with an HTTP request. Currently supported header is 'Host'.",
"properties": {
"Host": {
"description": "The 'Host' header allows to override the hostname set in the HTTP request. Current support is 1 'Host' header override per origin.",
"items": {
"example": "example.com",
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": {
"description": "A human-identifiable name for the origin.",
"example": "app-server-1",
"type": "string"
},
"virtual_network_id": {
"description": "The virtual network subnet ID the origin belongs in. Virtual network must also belong to the account.",
"example": "a5624d4e-044a-4ff0-b3e1-e2465353d4b4",
"type": "string"
},
"weight": {
"default": 1,
"description": "The weight of this origin relative to other origins in the pool. Based on the configured weight the total traffic is distributed among origins within the pool.\n- `origin_steering.policy=\"least_outstanding_requests\"`: Use weight to scale the origin's outstanding requests.\n- `origin_steering.policy=\"least_connections\"`: Use weight to scale the origin's open connections.",
"example": 0.6,
"maximum": 1,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
}
}
}
},
"required": true
}{
"200": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"allOf": [
{
"properties": {
"errors": {
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
},
"messages": {
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
},
"result": {
"anyOf": [
{
"type": "object"
},
{
"items": {},
"type": "array"
},
{
"type": "string"
}
]
},
"success": {
"description": "Whether the API call was successful",
"enum": [
true
],
"example": true,
"type": "boolean"
}
},
"required": [
"success",
"errors",
"messages",
"result"
],
"type": "object"
},
{
"properties": {
"result": {
"anyOf": [
{
"nullable": true,
"type": "object"
},
{
"nullable": true,
"type": "string"
}
]
}
}
}
],
"type": "object"
},
{
"properties": {
"result": {
"properties": {
"check_regions": {
"description": "A list of regions from which to run health checks. Null means every Cloudflare data center.",
"example": [
"WEU",
"ENAM"
],
"items": {
"description": "WNAM: Western North America, ENAM: Eastern North America, WEU: Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM: Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa, SAF: South Africa, SAS: Southern Asia, SEAS: South East Asia, NEAS: North East Asia, ALL_REGIONS: all regions (ENTERPRISE customers only).",
"enum": [
"WNAM",
"ENAM",
"WEU",
"EEU",
"NSAM",
"SSAM",
"OC",
"ME",
"NAF",
"SAF",
"SAS",
"SEAS",
"NEAS",
"ALL_REGIONS"
],
"type": "string"
},
"nullable": true,
"type": "array"
},
"created_on": {
"example": "2014-01-01T05:20:00.12345Z",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"description": {
"description": "A human-readable description of the pool.",
"example": "Primary data center - Provider XYZ",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the pool is disabled. This field is set with the time the pool was disabled at.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) or disable this pool. Disabled pools will not receive traffic and are excluded from health checks. Disabling a pool will cause any load balancers using it to failover to the next pool (if any).",
"example": false,
"type": "boolean"
},
"id": {
"example": "17b5962d775c646f3f9725cbc7a53df4",
"type": "string"
},
"latitude": {
"description": "The latitude of the data center containing the origins used in this pool in decimal degrees. If this is set, longitude must also be set.",
"type": "number"
},
"load_shedding": {
"description": "Configures load shedding policies and percentages for the pool.",
"properties": {
"default_percent": {
"default": 0,
"description": "The percent of traffic to shed from the pool, according to the default policy. Applies to new sessions and traffic without session affinity.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"default_policy": {
"default": "random",
"description": "The default policy to use when load shedding. A random policy randomly sheds a given percent of requests. A hash policy computes a hash over the CF-Connecting-IP address and sheds all requests originating from a percent of IPs.",
"enum": [
"random",
"hash"
],
"type": "string"
},
"session_percent": {
"default": 0,
"description": "The percent of existing sessions to shed from the pool, according to the session policy.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"session_policy": {
"default": "hash",
"description": "Only the hash policy is supported for existing sessions (to avoid exponential decay).",
"enum": [
"hash"
],
"type": "string"
}
},
"type": "object"
},
"longitude": {
"description": "The longitude of the data center containing the origins used in this pool in decimal degrees. If this is set, latitude must also be set.",
"type": "number"
},
"minimum_origins": {
"default": 1,
"description": "The minimum number of origins that must be healthy for this pool to serve traffic. If the number of healthy origins falls below this number, the pool will be marked unhealthy and will failover to the next available pool.",
"type": "integer"
},
"modified_on": {
"example": "2014-01-01T05:20:00.12345Z",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"monitor": {
"description": "The ID of the Monitor to use for checking the health of origins within this pool."
},
"name": {
"description": "A short name (tag) for the pool. Only alphanumeric characters, hyphens, and underscores are allowed.",
"example": "primary-dc-1",
"type": "string"
},
"notification_email": {
"description": "This field is now deprecated. It has been moved to Cloudflare's Centralized Notification service https://developers.cloudflare.com/fundamentals/notifications/. The email address to send health status notifications to. This can be an individual mailbox or a mailing list. Multiple emails can be supplied as a comma delimited list.",
"example": "someone@example.com,sometwo@example.com",
"type": "string"
},
"notification_filter": {
"description": "Filter pool and origin health notifications by resource type or health status. Use null to reset.",
"example": {
"origin": {
"disable": true
},
"pool": {
"healthy": false
}
},
"nullable": true,
"properties": {
"origin": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
},
"pool": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
},
"origin_steering": {
"description": "Configures origin steering for the pool. Controls how origins are selected for new sessions and traffic without session affinity.",
"properties": {
"policy": {
"default": "random",
"description": "The type of origin steering policy to use.\n- `\"random\"`: Select an origin randomly.\n- `\"hash\"`: Select an origin by computing a hash over the CF-Connecting-IP address.\n- `\"least_outstanding_requests\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of outstanding requests. Origins with more pending requests are weighted proportionately less relative to others.\n- `\"least_connections\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of open connections. Origins with more open connections are weighted proportionately less relative to others. Supported for HTTP/1 and HTTP/2 connections.",
"enum": [
"random",
"hash",
"least_outstanding_requests",
"least_connections"
],
"type": "string"
}
},
"type": "object"
},
"origins": {
"description": "The list of origins within this pool. Traffic directed at this pool is balanced across all currently healthy origins, provided the pool itself is healthy.",
"items": {
"properties": {
"address": {
"description": "The IP address (IPv4 or IPv6) of the origin, or its publicly addressable hostname. Hostnames entered here should resolve directly to the origin, and not be a hostname proxied by Cloudflare. To set an internal/reserved address, virtual_network_id must also be set.",
"example": "0.0.0.0",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the origin is disabled. This field is set with the time the origin was disabled.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) this origin within the pool. Disabled origins will not receive traffic and are excluded from health checks. The origin will only be disabled for the current pool.",
"example": true,
"type": "boolean"
},
"header": {
"description": "The request header is used to pass additional information with an HTTP request. Currently supported header is 'Host'.",
"properties": {
"Host": {
"description": "The 'Host' header allows to override the hostname set in the HTTP request. Current support is 1 'Host' header override per origin.",
"items": {
"example": "example.com",
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": {
"description": "A human-identifiable name for the origin.",
"example": "app-server-1",
"type": "string"
},
"virtual_network_id": {
"description": "The virtual network subnet ID the origin belongs in. Virtual network must also belong to the account.",
"example": "a5624d4e-044a-4ff0-b3e1-e2465353d4b4",
"type": "string"
},
"weight": {
"default": 1,
"description": "The weight of this origin relative to other origins in the pool. Based on the configured weight the total traffic is distributed among origins within the pool.\n- `origin_steering.policy=\"least_outstanding_requests\"`: Use weight to scale the origin's outstanding requests.\n- `origin_steering.policy=\"least_connections\"`: Use weight to scale the origin's open connections.",
"example": 0.6,
"maximum": 1,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
}
}
]
}
}
},
"description": "Patch Pool response"
},
"4XX": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"allOf": [
{
"allOf": [
{
"properties": {
"errors": {
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
},
"messages": {
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
},
"result": {
"anyOf": [
{
"type": "object"
},
{
"items": {},
"type": "array"
},
{
"type": "string"
}
]
},
"success": {
"description": "Whether the API call was successful",
"enum": [
true
],
"example": true,
"type": "boolean"
}
},
"required": [
"success",
"errors",
"messages",
"result"
],
"type": "object"
},
{
"properties": {
"result": {
"anyOf": [
{
"nullable": true,
"type": "object"
},
{
"nullable": true,
"type": "string"
}
]
}
}
}
],
"type": "object"
},
{
"properties": {
"result": {
"properties": {
"check_regions": {
"description": "A list of regions from which to run health checks. Null means every Cloudflare data center.",
"example": [
"WEU",
"ENAM"
],
"items": {
"description": "WNAM: Western North America, ENAM: Eastern North America, WEU: Western Europe, EEU: Eastern Europe, NSAM: Northern South America, SSAM: Southern South America, OC: Oceania, ME: Middle East, NAF: North Africa, SAF: South Africa, SAS: Southern Asia, SEAS: South East Asia, NEAS: North East Asia, ALL_REGIONS: all regions (ENTERPRISE customers only).",
"enum": [
"WNAM",
"ENAM",
"WEU",
"EEU",
"NSAM",
"SSAM",
"OC",
"ME",
"NAF",
"SAF",
"SAS",
"SEAS",
"NEAS",
"ALL_REGIONS"
],
"type": "string"
},
"nullable": true,
"type": "array"
},
"created_on": {
"example": "2014-01-01T05:20:00.12345Z",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"description": {
"description": "A human-readable description of the pool.",
"example": "Primary data center - Provider XYZ",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the pool is disabled. This field is set with the time the pool was disabled at.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) or disable this pool. Disabled pools will not receive traffic and are excluded from health checks. Disabling a pool will cause any load balancers using it to failover to the next pool (if any).",
"example": false,
"type": "boolean"
},
"id": {
"example": "17b5962d775c646f3f9725cbc7a53df4",
"type": "string"
},
"latitude": {
"description": "The latitude of the data center containing the origins used in this pool in decimal degrees. If this is set, longitude must also be set.",
"type": "number"
},
"load_shedding": {
"description": "Configures load shedding policies and percentages for the pool.",
"properties": {
"default_percent": {
"default": 0,
"description": "The percent of traffic to shed from the pool, according to the default policy. Applies to new sessions and traffic without session affinity.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"default_policy": {
"default": "random",
"description": "The default policy to use when load shedding. A random policy randomly sheds a given percent of requests. A hash policy computes a hash over the CF-Connecting-IP address and sheds all requests originating from a percent of IPs.",
"enum": [
"random",
"hash"
],
"type": "string"
},
"session_percent": {
"default": 0,
"description": "The percent of existing sessions to shed from the pool, according to the session policy.",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"session_policy": {
"default": "hash",
"description": "Only the hash policy is supported for existing sessions (to avoid exponential decay).",
"enum": [
"hash"
],
"type": "string"
}
},
"type": "object"
},
"longitude": {
"description": "The longitude of the data center containing the origins used in this pool in decimal degrees. If this is set, latitude must also be set.",
"type": "number"
},
"minimum_origins": {
"default": 1,
"description": "The minimum number of origins that must be healthy for this pool to serve traffic. If the number of healthy origins falls below this number, the pool will be marked unhealthy and will failover to the next available pool.",
"type": "integer"
},
"modified_on": {
"example": "2014-01-01T05:20:00.12345Z",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"monitor": {
"description": "The ID of the Monitor to use for checking the health of origins within this pool."
},
"name": {
"description": "A short name (tag) for the pool. Only alphanumeric characters, hyphens, and underscores are allowed.",
"example": "primary-dc-1",
"type": "string"
},
"notification_email": {
"description": "This field is now deprecated. It has been moved to Cloudflare's Centralized Notification service https://developers.cloudflare.com/fundamentals/notifications/. The email address to send health status notifications to. This can be an individual mailbox or a mailing list. Multiple emails can be supplied as a comma delimited list.",
"example": "someone@example.com,sometwo@example.com",
"type": "string"
},
"notification_filter": {
"description": "Filter pool and origin health notifications by resource type or health status. Use null to reset.",
"example": {
"origin": {
"disable": true
},
"pool": {
"healthy": false
}
},
"nullable": true,
"properties": {
"origin": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
},
"pool": {
"description": "Filter options for a particular resource type (pool or origin). Use null to reset.",
"nullable": true,
"properties": {
"disable": {
"default": false,
"description": "If set true, disable notifications for this type of resource (pool or origin).",
"type": "boolean"
},
"healthy": {
"description": "If present, send notifications only for this health status (e.g. false for only DOWN events). Use null to reset (all events).",
"nullable": true,
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
},
"origin_steering": {
"description": "Configures origin steering for the pool. Controls how origins are selected for new sessions and traffic without session affinity.",
"properties": {
"policy": {
"default": "random",
"description": "The type of origin steering policy to use.\n- `\"random\"`: Select an origin randomly.\n- `\"hash\"`: Select an origin by computing a hash over the CF-Connecting-IP address.\n- `\"least_outstanding_requests\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of outstanding requests. Origins with more pending requests are weighted proportionately less relative to others.\n- `\"least_connections\"`: Select an origin by taking into consideration origin weights, as well as each origin's number of open connections. Origins with more open connections are weighted proportionately less relative to others. Supported for HTTP/1 and HTTP/2 connections.",
"enum": [
"random",
"hash",
"least_outstanding_requests",
"least_connections"
],
"type": "string"
}
},
"type": "object"
},
"origins": {
"description": "The list of origins within this pool. Traffic directed at this pool is balanced across all currently healthy origins, provided the pool itself is healthy.",
"items": {
"properties": {
"address": {
"description": "The IP address (IPv4 or IPv6) of the origin, or its publicly addressable hostname. Hostnames entered here should resolve directly to the origin, and not be a hostname proxied by Cloudflare. To set an internal/reserved address, virtual_network_id must also be set.",
"example": "0.0.0.0",
"type": "string"
},
"disabled_at": {
"description": "This field shows up only if the origin is disabled. This field is set with the time the origin was disabled.",
"format": "date-time",
"readOnly": true,
"type": "string"
},
"enabled": {
"default": true,
"description": "Whether to enable (the default) this origin within the pool. Disabled origins will not receive traffic and are excluded from health checks. The origin will only be disabled for the current pool.",
"example": true,
"type": "boolean"
},
"header": {
"description": "The request header is used to pass additional information with an HTTP request. Currently supported header is 'Host'.",
"properties": {
"Host": {
"description": "The 'Host' header allows to override the hostname set in the HTTP request. Current support is 1 'Host' header override per origin.",
"items": {
"example": "example.com",
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": {
"description": "A human-identifiable name for the origin.",
"example": "app-server-1",
"type": "string"
},
"virtual_network_id": {
"description": "The virtual network subnet ID the origin belongs in. Virtual network must also belong to the account.",
"example": "a5624d4e-044a-4ff0-b3e1-e2465353d4b4",
"type": "string"
},
"weight": {
"default": 1,
"description": "The weight of this origin relative to other origins in the pool. Based on the configured weight the total traffic is distributed among origins within the pool.\n- `origin_steering.policy=\"least_outstanding_requests\"`: Use weight to scale the origin's outstanding requests.\n- `origin_steering.policy=\"least_connections\"`: Use weight to scale the origin's open connections.",
"example": 0.6,
"maximum": 1,
"minimum": 0,
"multipleOf": 0.01,
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
}
}
]
},
{
"properties": {
"errors": {
"allOf": [
{
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
}
],
"example": [
{
"code": 7003,
"message": "No route for the URI"
}
],
"minLength": 1
},
"messages": {
"allOf": [
{
"example": [],
"items": {
"properties": {
"code": {
"minimum": 1000,
"type": "integer"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"uniqueItems": true
},
"type": "array"
}
],
"example": []
},
"result": {
"enum": [
null
],
"nullable": true,
"type": "object"
},
"success": {
"description": "Whether the API call was successful",
"enum": [
false
],
"example": false,
"type": "boolean"
}
},
"required": [
"success",
"errors",
"messages",
"result"
],
"type": "object"
}
]
}
}
},
"description": "Patch Pool response failure"
}
}[
{
"api_email": [],
"api_key": []
}
]