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

# POST /v1/{+parent}/appGateways

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

Creates a new AppGateway in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `appGatewayId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- AppGateway — A BeyondCorp AppGateway resource represents a BeyondCorp protected AppGateway to a remote application. It creates all the necessary GCP components needed for creating a BeyondCorp protected AppGateway. Multiple connectors can be authorised for a single AppGateway.
  - `uid` string — Output only. A unique identifier for the instance generated by the system.
  - `uri` string — Output only. Server-defined URI for this resource.
  - `updateTime` string, google-datetime — Output only. Timestamp when the resource was last modified.
  - `allocatedConnections` AllocatedConnection[] — Output only. A list of connections allocated for the Gateway
    - `pscUri` string — Required. The PSC uri of an allocated connection
    - `ingressPort` integer — Required. The ingress port of an allocated connection
  - `name` string — Required. Unique resource name of the AppGateway. The name is ignored when creating an AppGateway.
  - `displayName` string — Optional. An arbitrary user-provided name for the AppGateway. Cannot exceed 64 characters.
  - `labels` object — Optional. Resource labels to represent user provided metadata.
  - `createTime` string, google-datetime — Output only. Timestamp when the resource was created.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `hostType` 'HOST_TYPE_UNSPECIFIED' | 'GCP_REGIONAL_MIG' — Required. The type of hosting used by the AppGateway.
  - `type` 'TYPE_UNSPECIFIED' | 'TCP_PROXY' — Required. The type of network connectivity used by the AppGateway.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'CREATED' | 'UPDATING' | 'DELETING' | 'DOWN' — Output only. The current state of the AppGateway.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/beyondcorp.md) · [All operations](https://skmtc.dev/google/apis/beyondcorp/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/beyondcorp/revisions/e86980a523a5/schema)