Sign in

v1

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

Creates a new Instance in a given location.

post/v1/{+parent}/instances

Path parameters

parentstring required

Required. The resource name of the instance location using the form: projects/{project_id}/locations/{location_id} where location_id refers to a GCP region

Query parameters

instanceIdstring

Required. The logical name of the Memcached instance in the user project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a number or a letter. * Must be unique within the user project / location. If any of the above are not met, the API raises an invalid argument error.

Request body

namestring

Required. Unique name of the resource in this scope including project and location using the form: projects/{project_id}/locations/{location_id}/instances/{instance_id} Note: Memcached instances are managed and addressed at the regional level so location_id here refers to a Google Cloud region; however, users may choose which zones Memcached nodes should be provisioned in within an instance. Refer to zones field for more details.

displayNamestring

User provided name for the instance, which is only used for display purposes. Cannot be more than 80 characters.

labelsobject

Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources

authorizedNetworkstring

The full name of the Google Compute Engine network to which the instance is connected. If left unspecified, the default network will be used.

zonesstring[]

Zones in which Memcached nodes should be provisioned. Memcached nodes will be equally distributed across these zones. If not provided, the service will by default create nodes in all zones in the region for the instance.

nodeCountinteger

Required. Number of nodes in the Memcached instance.

memcacheVersion'MEMCACHE_VERSION_UNSPECIFIED' | 'MEMCACHE_1_5' | 'MEMCACHE_1_6_15'

The major version of Memcached software. If not provided, latest supported version will be used. Currently the latest supported major version is MEMCACHE_1_5. The minor version will be automatically determined by our system based on the latest supported minor version.

createTimestring google-datetime

Output only. The time the instance was created.

updateTimestring google-datetime

Output only. The time the instance was updated.

state'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'PERFORMING_MAINTENANCE' | 'MEMCACHE_VERSION_UPGRADING'

Output only. The state of this Memcached instance.

memcacheFullVersionstring

Output only. The full version of memcached server running on this instance. System automatically determines the full memcached version for an instance based on the input MemcacheVersion. The full version format will be "memcached-1.5.16".

discoveryEndpointstring

Output only. Endpoint for the Discovery API.

reservedIpRangeIdstring[]

Optional. Contains the id of allocated IP address ranges associated with the private service access connection for example, "test-default" associated with IP range 10.0.0.0/29.

satisfiesPzsboolean

Optional. Output only. Reserved for future use.

satisfiesPziboolean

Optional. Output only. Reserved for future use.

maintenanceVersionstring

Optional. Last self service update maintenance version triggered by the customer. If it is empty, it means that the maintenance version is not set by the user.

effectiveMaintenanceVersionstring

Output only. The effective maintenance version of the instance.

availableMaintenanceVersionsstring[]

Output only. The available maintenance versions that can be applied to the instance.

Response

Successful response