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

# POST /v1/{+parent}/gatewayAdvertisedRoutes

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

Create a GatewayAdvertisedRoute

## Path parameters

- `parent` string, required

## Query parameters

- `gatewayAdvertisedRouteId` string
- `requestId` string

## Request body

- GatewayAdvertisedRoute — A gateway advertised route is a route that a gateway spoke advertises somewhere.
  - `ipRange` string — Immutable. This route's advertised IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`.
  - `createTime` string, google-datetime — Output only. The time the gateway advertised route was created.
  - `recipient` 'RECIPIENT_UNSPECIFIED' | 'ADVERTISE_TO_HUB' — Optional. The recipient of this advertised route.
  - `description` string — An optional description of the gateway advertised route.
  - `priority` integer — Optional. The priority of this advertised route. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges.
  - `updateTime` string, google-datetime — Output only. The time the gateway advertised route was last updated.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'ACCEPTING' | 'REJECTING' | 'UPDATING' | 'INACTIVE' | 'OBSOLETE' | 'FAILED' — Output only. The current lifecycle state of this gateway advertised route.
  - `name` string — Identifier. The name of the gateway advertised route. Route names must be unique and use the following form: `projects/{project_number}/locations/{region}/spokes/{spoke}/gatewayAdvertisedRoutes/{gateway_advertised_route_id}`
  - `labels` object — Optional labels in key-value pair format. For more information about labels, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
  - `uniqueId` string — Output only. The Google-generated UUID for the gateway advertised route. This value is unique across all gateway advertised route resources. If a gateway advertised route is deleted and another with the same name is created, the new route is assigned a different `unique_id`.

## Response `200`

Successful response

---

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