---
title: "POST /v1/{+parent}/serviceLbPolicies"
method: POST
path: "/v1/{+parent}/serviceLbPolicies"
tags: ["projects"]
---

# POST /v1/{+parent}/serviceLbPolicies

`POST /v1/{+parent}/serviceLbPolicies`

Creates a new ServiceLbPolicy in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `serviceLbPolicyId` string

## Request body

- ServiceLbPolicy — ServiceLbPolicy holds global load balancing and traffic distribution configuration that can be applied to a BackendService.
  - `name` string — Identifier. Name of the ServiceLbPolicy resource. It matches pattern `projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}`.
  - `createTime` string, google-datetime — Output only. The timestamp when this resource was created.
  - `updateTime` string, google-datetime — Output only. The timestamp when this resource was last updated.
  - `labels` object — Optional. Set of label tags associated with the ServiceLbPolicy resource.
  - `description` string — Optional. A free-text description of the resource. Max length 1024 characters.
  - `loadBalancingAlgorithm` 'LOAD_BALANCING_ALGORITHM_UNSPECIFIED' | 'SPRAY_TO_WORLD' | 'SPRAY_TO_REGION' | 'WATERFALL_BY_REGION' | 'WATERFALL_BY_ZONE' — Optional. The type of load balancing algorithm to be used. The default behavior is WATERFALL_BY_REGION.
  - `autoCapacityDrain` ServiceLbPolicyAutoCapacityDrain — Option to specify if an unhealthy IG/NEG should be considered for global load balancing and traffic routing.
    - `enable` boolean — Optional. If set to 'True', an unhealthy IG/NEG will be set as drained. - An IG/NEG is considered unhealthy if less than 25% of the instances/endpoints in the IG/NEG are healthy. - This option will never result in draining more than 50% of the configured IGs/NEGs for the Backend Service.
  - `failoverConfig` ServiceLbPolicyFailoverConfig — Option to specify health based failover behavior. This is not related to Network load balancer FailoverPolicy.
    - `failoverHealthThreshold` integer — Optional. The percentage threshold that a load balancer will begin to send traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and 99. The default value is 50 for Global external HTTP(S) load balancer (classic) and Proxyless service mesh, and 70 for others.
  - `isolationConfig` ServiceLbPolicyIsolationConfig — Configuration to provide isolation support for the associated Backend Service.
    - `isolationGranularity` 'ISOLATION_GRANULARITY_UNSPECIFIED' | 'REGION' — Optional. The isolation granularity of the load balancer.
    - `isolationMode` 'ISOLATION_MODE_UNSPECIFIED' | 'NEAREST' | 'STRICT' — Optional. The isolation mode of the load balancer.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/networkservices.md) · [All operations](https://skmtc.net/google/apis/networkservices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/networkservices/revisions/ff841dec54e1/schema)