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

# POST /v1/{+parent}/destinations

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

Creates a `Destination` resource in a specified project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `destinationId` string
- `requestId` string

## Request body

- Destination — The `Destination` resource. It specifies the IP prefix and the associated autonomous system numbers (ASN) that you want to include in a `MulticloudDataTransferConfig` resource.
  - `endpoints` DestinationEndpoint[] — Required. Unordered list. The list of `DestinationEndpoint` resources configured for the IP prefix.
    - `csp` string — Required. The CSP of the remote IP prefix.
    - `state` 'STATE_UNSPECIFIED' | 'VALID' | 'INVALID' — Output only. The state of the `DestinationEndpoint` resource.
    - `updateTime` string, google-datetime — Output only. Time when the `DestinationEndpoint` resource was updated.
    - `asn` string, int64 — Required. The ASN of the remote IP prefix.
  - `name` string — Identifier. The name of the `Destination` resource. Format: `projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}/destinations/{destination}`.
  - `ipPrefix` string — Required. Immutable. The IP prefix that represents your workload on another CSP.
  - `labels` object — Optional. User-defined labels.
  - `etag` string — The etag is computed by the server, and might be sent with update and delete requests so that the client has an up-to-date value before proceeding.
  - `stateTimeline` StateTimeline — The timeline of the pending states for a resource.
    - `states` StateMetadata[] — Output only. The state and activation time details of the resource state.
      - `state` 'STATE_UNSPECIFIED' | 'ADDING' | 'ACTIVE' | 'DELETING' | 'SUSPENDING' | 'SUSPENDED' — Output only. The state of the resource.
      - `effectiveTime` string, google-datetime — Output only. Accompanies only the transient states, which include `ADDING`, `DELETING`, and `SUSPENDING`, to denote the time until which the transient state of the resource will be effective. For instance, if the state is `ADDING`, this field shows the time when the resource state transitions to `ACTIVE`.
  - `uid` string — Output only. The Google-generated unique ID for the `Destination` resource. This value is unique across all `Destination` resources. If a resource is deleted and another with the same name is created, the new resource is assigned a different and unique ID.
  - `createTime` string, google-datetime — Output only. Time when the `Destination` resource was created.
  - `description` string — Optional. A description of this resource.
  - `updateTime` string, google-datetime — Output only. Time when the `Destination` resource was updated.

## 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)