Sign in

v1

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

Creates a new Network Connectivity Center hub in the specified project.

post/v1/{+parent}/hubs

Path parameters

parentstring required

Required. The parent resource.

Query parameters

hubIdstring

Required. A unique identifier for the hub.

requestIdstring

Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server knows to ignore the request if it has already been completed. The server guarantees that a request doesn't result in creation of duplicate commitments for at least 60 minutes. 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 to see whether the original operation was received. If it was, the server ignores the second request. This behavior prevents clients from mistakenly 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).

Request body

state'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'ACCEPTING' | 'REJECTING' | 'UPDATING' | 'INACTIVE' | 'OBSOLETE' | 'FAILED'

Output only. The current lifecycle state of this hub.

createTimestring google-datetime

Output only. The time the hub was created.

descriptionstring

Optional. An optional description of the hub.

exportPscboolean

Optional. Whether Private Service Connect connection propagation is enabled for the hub. If true, Private Service Connect endpoints in VPC spokes attached to the hub are made accessible to other VPC spokes attached to the hub. The default value is false.

labelsobject

Optional labels in key-value pair format. For more information about labels, see Requirements for labels.

presetTopology'PRESET_TOPOLOGY_UNSPECIFIED' | 'MESH' | 'STAR' | 'HYBRID_INSPECTION'

Optional. The topology implemented in this hub. Currently, this field is only used when policy_mode = PRESET. The available preset topologies are MESH and STAR. If preset_topology is unspecified and policy_mode = PRESET, the preset_topology defaults to MESH. When policy_mode = CUSTOM, the preset_topology is set to PRESET_TOPOLOGY_UNSPECIFIED.

updateTimestring google-datetime

Output only. The time the hub was last updated.

routeTablesstring[]

Output only. The route tables that belong to this hub. They use the following form: projects/{project_number}/locations/global/hubs/{hub_id}/routeTables/{route_table_id} This field is read-only. Network Connectivity Center automatically populates it based on the route tables nested under the hub.

policyMode'POLICY_MODE_UNSPECIFIED' | 'PRESET'

Optional. The policy mode of this hub. This field can be either PRESET or CUSTOM. If unspecified, the policy_mode defaults to PRESET.

uniqueIdstring

Output only. The Google-generated UUID for the hub. This value is unique across all hub resources. If a hub is deleted and another with the same name is created, the new hub is assigned a different unique_id.

namestring

Immutable. The name of the hub. Hub names must be unique. They use the following form: projects/{project_number}/locations/global/hubs/{hub_id}

Response

Successful response