REST Resource: projects.locations.multicloudDataTransferConfigs.destinations

Resource: 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.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "etag": string,
  "description": string,
  "ipPrefix": string,
  "endpoints": [
    {
      object (DestinationEndpoint)
    }
  ],
  "stateTimeline": {
    object (StateTimeline)
  },
  "uid": string
}
Fields
name

string

Identifier. The name of the Destination resource. Format: projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloudDataTransferConfig}/destinations/{destination}.

createTime

string (Timestamp format)

Output only. Time when the Destination resource was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. Time when the Destination resource was updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Optional. User-defined labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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.

description

string

Optional. A description of this resource.

ipPrefix

string

Required. Immutable. The IP prefix that represents your workload on another CSP.

endpoints[]

object (DestinationEndpoint)

Required. Unordered list. The list of DestinationEndpoint resources configured for the IP prefix.

stateTimeline

object (StateTimeline)

Output only. The timeline of the expected Destination states or the current rest state. If a state change is expected, the value is ADDING, DELETING or SUSPENDING, depending on the action specified.

Example: "stateTimeline": { "states": [ { // The time when the Destination resource will be activated. "effectiveTime": "2024-12-01T08:00:00Z", "state": "ADDING" }, { // The time when the Destination resource will be suspended. "effectiveTime": "2024-12-01T20:00:00Z", "state": "SUSPENDING" } ] }

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.

DestinationEndpoint

The metadata for a DestinationEndpoint resource.

JSON representation
{
  "asn": string,
  "csp": string,
  "state": enum (State),
  "updateTime": string
}
Fields
asn

string (int64 format)

Required. The ASN of the remote IP prefix.

csp

string

Required. The CSP of the remote IP prefix.

state

enum (State)

Output only. The state of the DestinationEndpoint resource.

updateTime

string (Timestamp format)

Output only. Time when the DestinationEndpoint resource was updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

State

The state of the DestinationEndpoint resource.

Enums
STATE_UNSPECIFIED An invalid state, which is the default case.
VALID The DestinationEndpoint resource is valid.
INVALID The DestinationEndpoint resource is invalid.

Methods

create

Creates a Destination resource in a specified project and location.

delete

Deletes a Destination resource.

get

Gets the details of a Destination resource.

list

Lists the Destination resources in a specified project and location.

patch

Updates a Destination resource in a specified project and location.