v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1348107211.1 KB
projects

Creates a new Transport in a given project and location.

post/v1/{+parent}/transports

Path parameters

parentstring required

Required. Value for parent.

Query parameters

requestIdstring

Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

transportIdstring

Required. Id of the requesting object

Request body

providedActivationKeystring

Optional. Immutable. Key used for establishing a connection with the remote transport. This key can only be provided if the profile supports an INPUT key flow and the resource is in the PENDING_KEY state.

generatedActivationKeystring

Output only. Google-generated activation key. This is only output if the selected profile supports an OUTPUT key flow. Inputting this to the provider is only valid while the resource is in a PENDING_KEY state. Once the provider has accepted the key, the resource will move to the CONFIGURING state.

updateTimestring google-datetime

Output only. Update time stamp.

remoteProfilestring

Optional. Immutable. Name of the remoteTransportProfile that this Transport is connecting to.

mtuLimitinteger

Output only. The maximum transmission unit (MTU) of a packet that can be sent over this transport.

bandwidth'BANDWIDTH_UNSPECIFIED' | 'BPS_50M' | 'BPS_100M' | 'BPS_200M' | 'BPS_300M' | 'BPS_400M' | 'BPS_500M' | 'BPS_1G' | 'BPS_2G' | 'BPS_5G' | 'BPS_10G' | 'BPS_20G' | 'BPS_50G' | 'BPS_100G'

Optional. Bandwidth of the Transport. This must be one of the supported bandwidths for the remote profile, and must be set when no activation key is being provided.

advertisedRoutesstring[]

Optional. List of IP Prefixes that will be advertised to the remote provider. Both IPv4 and IPv6 addresses are supported.

remoteAccountIdstring

Optional. Immutable. The user supplied account id for the CSP associated with the remote profile.

namestring

Identifier. Name of the resource.

networkstring

Optional. Immutable. Resource URI of the Network that will be peered with this Transport. This field must be provided during resource creation and cannot be changed.

createTimestring google-datetime

Output only. Create time stamp.

descriptionstring

Optional. Description of the Transport.

state'STATE_UNSPECIFIED' | 'CREATING' | 'PENDING_CONFIG' | 'PENDING_KEY' | 'ACTIVE' | 'DELETING' | 'DEPROVISIONED'

Output only. State of the underlying connectivity.

stackType'STACK_TYPE_UNSPECIFIED' | 'IPV4_ONLY' | 'IPV4_IPV6'

Optional. IP version stack for the established connectivity.

peeringNetworkstring

Output only. VPC Network URI that was created for the VPC Peering connection to the provided network. If VPC Peering is disconnected, this can be used to re-establish.

labelsobject

Optional. Labels as key value pairs.

Response

Successful response