--- title: Pools --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Load Balancers](https://developers.cloudflare.com/api/go/resources/load_balancers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Pools ##### [List Pools](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/list) client.LoadBalancers.Pools.List(ctx, params) (\*SinglePage\[[Pool]()], error) GET/accounts/{account\_id}/load\_balancers/pools ##### [Pool Details](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/get) client.LoadBalancers.Pools.Get(ctx, poolID, query) (\*[Pool](), error) GET/accounts/{account\_id}/load\_balancers/pools/{pool\_id} ##### [Create Pool](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/create) client.LoadBalancers.Pools.New(ctx, params) (\*[Pool](), error) POST/accounts/{account\_id}/load\_balancers/pools ##### [Update Pool](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/update) client.LoadBalancers.Pools.Update(ctx, poolID, params) (\*[Pool](), error) PUT/accounts/{account\_id}/load\_balancers/pools/{pool\_id} ##### [Patch Pool](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/edit) client.LoadBalancers.Pools.Edit(ctx, poolID, params) (\*[Pool](), error) PATCH/accounts/{account\_id}/load\_balancers/pools/{pool\_id} ##### [Delete Pool](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/delete) client.LoadBalancers.Pools.Delete(ctx, poolID, body) (\*[PoolDeleteResponse](), error) DELETE/accounts/{account\_id}/load\_balancers/pools/{pool\_id} ##### [Patch Pools](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/methods/bulk_edit) client.LoadBalancers.Pools.BulkEdit(ctx, params) (\*SinglePage\[[Pool]()], error) PATCH/accounts/{account\_id}/load\_balancers/pools ##### ModelsExpand Collapse
type Pool struct{…} ID stringOptional Link to this property
CheckRegions \[]CheckRegionOptional A list of regions from which to run health checks. Null means every Cloudflare data center. One of the following: const CheckRegionWnam CheckRegion = "WNAM" Link to this property const CheckRegionEnam CheckRegion = "ENAM" Link to this property const CheckRegionWeu CheckRegion = "WEU" Link to this property const CheckRegionEeu CheckRegion = "EEU" Link to this property const CheckRegionNsam CheckRegion = "NSAM" Link to this property const CheckRegionSsam CheckRegion = "SSAM" Link to this property const CheckRegionOc CheckRegion = "OC" Link to this property const CheckRegionMe CheckRegion = "ME" Link to this property const CheckRegionNaf CheckRegion = "NAF" Link to this property const CheckRegionSaf CheckRegion = "SAF" Link to this property const CheckRegionSas CheckRegion = "SAS" Link to this property const CheckRegionSeas CheckRegion = "SEAS" Link to this property const CheckRegionNeas CheckRegion = "NEAS" Link to this property const CheckRegionChina CheckRegion = "CHINA" Link to this property const CheckRegionAllRegions CheckRegion = "ALL\_REGIONS" Link to this property
Link to this property CreatedOn stringOptional Link to this property Description stringOptional A human-readable description of the pool. Link to this property DisabledAt TimeOptional This field shows up only if the pool is disabled. This field is set with the time the pool was disabled at. formatdate-time Link to this property Enabled boolOptional 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). Link to this property
HealthSources \[]PoolHealthSourceOptional A list of health sources, ordered from highest to lowest priority, used to evaluate individual origin health and overall pool health. The load balancer uses the first source that has data and falls back to the next. Currently accepted values are null or the exact array \[“regional”, “global”]; any other combination is rejected. Null (the default) behaves like \[“local”, “global”]. \[“regional”, “global”] makes each region steer on its own health, falling back to the global decision when a region has no fresh data. Setting regional requires at least one region in check\_regions. One of the following: const PoolHealthSourceLocal PoolHealthSource = "local" Link to this property const PoolHealthSourceRegional PoolHealthSource = "regional" Link to this property const PoolHealthSourceGlobal PoolHealthSource = "global" Link to this property
Link to this property Latitude float64Optional 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. Link to this property LoadShedding LoadSheddingOptional Configures load shedding policies and percentages for the pool. Link to this property Longitude float64Optional 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. Link to this property MinimumOrigins int64Optional 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. Link to this property ModifiedOn stringOptional Link to this property Monitor stringOptional The ID of the Monitor to use for checking the health of origins within this pool. Link to this property MonitorGroup stringOptional The ID of the Monitor Group to use for checking the health of origins within this pool. Link to this property Name stringOptional A short name (tag) for the pool. Only alphanumeric characters, hyphens, and underscores are allowed. Link to this property Networks \[]stringOptional List of networks where Load Balancer or Pool is enabled. Link to this property NotificationEmail stringOptional 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. Link to this property NotificationFilter NotificationFilterOptional Filter pool and origin health notifications by resource type or health status. Use null to reset. Link to this property OriginSteering OriginSteeringOptional Configures origin steering for the pool. Controls how origins are selected for new sessions and traffic without session affinity. Link to this property
Origins \[]OriginOptional 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. Address stringOptional 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. Link to this property DisabledAt TimeOptional This field shows up only if the origin is disabled. This field is set with the time the origin was disabled. formatdate-time Link to this property Enabled boolOptional 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. Link to this property FlattenCNAME boolOptional Whether to flatten CNAME records for this origin, resolving them to A/AAAA records before returning to the client. When true (the default), the director resolves CNAME addresses to their underlying A/AAAA records. When false, the origin address is returned as a raw CNAME record without resolution. This setting mirrors the DNS API record flatten\_cname setting. Link to this property Header HeaderOptional The request header is used to pass additional information with an HTTP request. Currently supported header is ‘Host’. Link to this property Name stringOptional A human-identifiable name for the origin. Link to this property Port int64Optional The port for upstream connections. A value of 0 means the default port for the protocol will be used. Link to this property VirtualNetworkID stringOptional The virtual network subnet ID the origin belongs in. Virtual network must also belong to the account. Link to this property Weight float64Optional 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. - origin_steering.policy="least_outstanding_requests": Use weight to scale the origin’s outstanding requests. - origin_steering.policy="least_connections": Use weight to scale the origin’s open connections. maximum1 minimum0 multipleOf0.01 Link to this property
Link to this property
[Link to this property](<#(resource)%20load_balancers.pools%20%3E%20(model)%20pool%20%3E%20(schema)>) #### PoolsHealth ##### [Pool Health Details](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/subresources/health/methods/get) client.LoadBalancers.Pools.Health.Get(ctx, poolID, query) (\*[PoolHealthGetResponse](), error) GET/accounts/{account\_id}/load\_balancers/pools/{pool\_id}/health ##### [Preview Pool](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/subresources/health/methods/create) client.LoadBalancers.Pools.Health.New(ctx, poolID, params) (\*[PoolHealthNewResponse](), error) POST/accounts/{account\_id}/load\_balancers/pools/{pool\_id}/preview #### PoolsReferences ##### [List Pool References](https://developers.cloudflare.com/api/go/resources/load_balancers/subresources/pools/subresources/references/methods/get) client.LoadBalancers.Pools.References.Get(ctx, poolID, query) (\*SinglePage\[[PoolReferenceGetResponse]()], error) GET/accounts/{account\_id}/load\_balancers/pools/{pool\_id}/references