Sign in

v1

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

Creates a new Cluster in a given project and location.

post/v1/{+parent}/clusters

Path parameters

parentstring required

Required. Parent location in which the cluster should be created, in the format projects/{project}/locations/{location}.

Query parameters

clusterIdstring

Required. The ID of the cluster to create. The cluster ID must start with a lowercase letter (a-z), use only lowercase letters or numbers, and contain up to 10 characters. For example, specify cluster001.

requestIdstring

Optional. A unique identifier for this request. A random UUID is recommended. This request is idempotent if and only if request_id is provided.

Request body

namestring

Identifier. Relative resource name of the cluster, in the format projects/{project}/locations/{location}/clusters/{cluster}.

descriptionstring

Optional. A description for your cluster. You can use up to 2,048 characters.

networkResourcesobject

Optional. Network resources available to the cluster. Must contain exactly one value. Keys specify the ID of the network resource by which it can be referenced elsewhere, and must conform to RFC-1034 (lower-case, alphanumeric, and at most 63 characters).

storageResourcesobject

Optional. Storage resources available to the cluster. Keys specify the ID of the storage resource by which it can be referenced elsewhere, and must conform to RFC-1034 (lower-case, alphanumeric, and at most 63 characters).

createTimestring google-datetime

Output only. Time that the cluster was originally created.

labelsobject

Optional. Labels applied to the cluster. Labels can be used to organize clusters and to filter them in queries.

reconcilingboolean

Output only. Indicates whether changes to the cluster are currently in flight. If this is true, then the current state might not match the cluster's intended state.

updateTimestring google-datetime

Output only. Time that the cluster was most recently updated.

computeResourcesobject

Optional. Compute resources available to the cluster. Keys specify the ID of the compute resource by which it can be referenced elsewhere, and must conform to RFC-1034 (lower-case, alphanumeric, and at most 63 characters).

Response

Successful response