--- title: "PATCH /v1/{+name}" method: PATCH path: "/v1/{+name}" tags: ["projects"] --- # PATCH /v1/{+name} `PATCH /v1/{+name}` Updates an existing Instance in a given project and location. ## Path parameters - `name` string, required ## Query parameters - `updateMask` string ## Request body - Instance — A Memorystore for Memcached instance - `name` string — 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. - `displayName` string — User provided name for the instance, which is only used for display purposes. Cannot be more than 80 characters. - `labels` object — Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources - `authorizedNetwork` string — The full name of the Google Compute Engine [network](/compute/docs/networks-and-firewalls#networks) to which the instance is connected. If left unspecified, the `default` network will be used. - `zones` string[] — 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. - `nodeCount` integer — Required. Number of nodes in the Memcached instance. - `nodeConfig` NodeConfig — Configuration for a Memcached Node. - `cpuCount` integer — Required. Number of cpus per Memcached node. - `memorySizeMb` integer — Required. Memory size in MiB for each Memcached node. - `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. - `parameters` MemcacheParameters - `id` string — Output only. The unique ID associated with this set of parameters. Users can use this id to determine if the parameters associated with the instance differ from the parameters associated with the nodes. A discrepancy between parameter ids can inform users that they may need to take action to apply parameters on nodes. - `params` object — User defined set of parameters to use in the memcached process. - `memcacheNodes` Node[] — Output only. List of Memcached nodes. Refer to Node message for more details. - `nodeId` string — Output only. Identifier of the Memcached node. The node id does not include project or location like the Memcached instance name. - `zone` string — Output only. Location (GCP Zone) for the Memcached node. - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'DELETING' | 'UPDATING' — Output only. Current state of the Memcached node. - `host` string — Output only. Hostname or IP address of the Memcached node used by the clients to connect to the Memcached server on this node. - `port` integer — Output only. The port number of the Memcached server on this node. - `parameters` MemcacheParameters - `id` string — Output only. The unique ID associated with this set of parameters. Users can use this id to determine if the parameters associated with the instance differ from the parameters associated with the nodes. A discrepancy between parameter ids can inform users that they may need to take action to apply parameters on nodes. - `params` object — User defined set of parameters to use in the memcached process. - `memcacheVersion` 'MEMCACHE_VERSION_UNSPECIFIED' | 'MEMCACHE_1_5' | 'MEMCACHE_1_6_15' — Output only. Major version of memcached server running on this node, e.g. MEMCACHE_1_5 - `memcacheFullVersion` string — Output only. The full version of memcached server running on this node. e.g. - memcached-1.5.16 - `createTime` string, google-datetime — Output only. The time the instance was created. - `updateTime` string, 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. - `memcacheFullVersion` string — 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". - `instanceMessages` InstanceMessage[] — List of messages that describe the current state of the Memcached instance. - `code` 'CODE_UNSPECIFIED' | 'ZONE_DISTRIBUTION_UNBALANCED' — A code that correspond to one type of user-facing message. - `message` string — Message on memcached instance which will be exposed to users. - `discoveryEndpoint` string — Output only. Endpoint for the Discovery API. - `maintenancePolicy` GoogleCloudMemcacheV1MaintenancePolicy — Maintenance policy per instance. - `createTime` string, google-datetime — Output only. The time when the policy was created. - `updateTime` string, google-datetime — Output only. The time when the policy was updated. - `description` string — Description of what this policy is for. Create/Update methods return INVALID_ARGUMENT if the length is greater than 512. - `weeklyMaintenanceWindow` WeeklyMaintenanceWindow[] — Required. Maintenance window that is applied to resources covered by this policy. Minimum 1. For the current version, the maximum number of weekly_maintenance_windows is expected to be one. - `day` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Required. Allows to define schedule that runs specified day of the week. - `startTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `duration` string, google-duration — Required. Duration of the time window. - `maintenanceSchedule` MaintenanceSchedule — Upcoming maintenance schedule. - `startTime` string, google-datetime — Output only. The start time of any upcoming scheduled maintenance for this instance. - `endTime` string, google-datetime — Output only. The end time of any upcoming scheduled maintenance for this instance. - `scheduleDeadlineTime` string, google-datetime — Output only. The deadline that the maintenance schedule start time can not go beyond, including reschedule. - `reservedIpRangeId` string[] — 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. - `satisfiesPzs` boolean — Optional. Output only. Reserved for future use. - `satisfiesPzi` boolean — Optional. Output only. Reserved for future use. - `maintenanceVersion` string — 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. - `effectiveMaintenanceVersion` string — Output only. The effective maintenance version of the instance. - `availableMaintenanceVersions` string[] — Output only. The available maintenance versions that can be applied to the instance. ## Response `200` Successful response --- [API](https://skmtc.dev/google/apis/memcache.md) · [All operations](https://skmtc.dev/google/apis/memcache/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/memcache/revisions/128455fef9ed/schema)