[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-09-03。"],[],[],null,["# Configure an instance\n\nMemorystore for Valkey supports a subset of the [OSS Valkey configuration\nparameters](https://github.com/valkey-io/valkey/blob/7.2/valkey.conf) that you can modify to customize the\nbehavior of your instance.\n\nConfiguration changes don't require a restart of the nodes, and are saved if a\nnode restarts. After creating an instance, you can update the modifiable\nconfiguration parameters.\n\nFor more information about the modifiable configuration parameters, see\n[Supported instance configurations](/memorystore/docs/valkey/supported-instance-configurations).\n\nBefore you begin\n----------------\n\nEnsure that you have installed the latest version of the Google Cloud CLI\nby running `gcloud components update`.\n\nView configuration parameters\n-----------------------------\n\nTo view configuration parameters using the Google Cloud CLI, run the\n`gcloud memorystore instances describe` command, replacing \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with\nappropriate values.\n\nYou can't see configuration parameters when running the\n`gcloud memorystore instances describe` command unless you change a configuration\nparameter from its default value. \n\n```\ngcloud memorystore instances describe instance-id --location=region-id\n```\n\nExample: \n\n```\ngcloud memorystore instances describe my-instance --location=us-central1\n```\n\nSet a configuration parameter during instance creation\n------------------------------------------------------\n\nTo set a configuration parameter while creating an instance, run the\n`gcloud memorystore instances create` command with `--engine-configs` flag, replacing\n\u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values. \n\n```\ngcloud memorystore instances create instance-id \\\n--location=region-id \\\n--project=project-id \\\n--node-type=node-type \\\n--shard-count=shard-count \\\n--mode=MODE\n--engine-configs=config-name=config-value \\\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003einstance-id\u003c/var\u003e is the ID of the Memorystore for Valkey instance you're creating.\n- \u003cvar translate=\"no\"\u003eregion-id\u003c/var\u003e is the region where you want the instance placed.\n- \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e is your project ID.\n- \u003cvar translate=\"no\"\u003enode-type\u003c/var\u003e is your chosen node type. Accepted values are:\n\n - `shared-core-nano`\n - `standard-small`\n - `highmem-medium`\n - `highmem-xlarge`\n\n | **Caution** : We recommend that you use the `shared-core-nano` node type for development or testing purposes only. If you run Memorystore for Valkey in a production environment, then we recommend using the `standard-small`, `highmem-medium`, or `highmem-xlarge` node types. For more information about these node types, see [Choose a node type](/memorystore/docs/valkey/instance-node-specification#choose-node-type).\n- \u003cvar translate=\"no\"\u003eshard-count\u003c/var\u003e determines the number of shards in your instance. Shard count determines the total memory capacity for storing instance data. If the mode that you select is Cluster Mode Disabled, then you can specify only one shard for your instance. For more information, see [Instance and node specification](/memorystore/docs/valkey/instance-node-specification).\n\n- \u003cvar translate=\"no\"\u003emode\u003c/var\u003e determines if the instance is Cluster Mode Enabled or Cluster Mode Disabled. If this field is omitted,\n then the instance defaults to Cluster Mode Enabled. For more information, see [Enable and disable Cluster Mode](/memorystore/docs/valkey/cluster-mode-enabled-and-disabled).\n\n- \u003cvar translate=\"no\"\u003econfig-name\u003c/var\u003e is the configuration parameter to modify.\n\n- \u003cvar translate=\"no\"\u003econfig-value\u003c/var\u003e is your chosen setting corresponding to the parameter you're configuring.\n\nFor example: \n\n### Cluster Mode Enabled example\n\n\u003cbr /\u003e\n\n```\n gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru\n \n```\n\n\u003cbr /\u003e\n\n### Cluster Mode Disabled example\n\n\u003cbr /\u003e\n\n```\n gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=1 --mode=cluster-disabled --engine-configs=maxmemory-policy=allkeys-lru\n \n```\n\n\u003cbr /\u003e\n\nUpdate a configuration parameter\n--------------------------------\n\nTo update a configuration parameter for an existing instance, run the\n`gcloud memorystore instances update` command with the `--update-engine-configs` flag,\nreplacing \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values. \n\n```\ngcloud memorystore instances update instance-id \\\n--location=region-id \\\n--project=project-id \\\n--update-engine-configs=config-name=config-value\n```\n\nExample: \n\n```\ngcloud memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru\n```\n| **Note** : For more information about which configuration parameters you can update, see [Modifiable configuration\n| parameters](/memorystore/docs/valkey/supported-instance-configurations#modifiable_configuration_parameters).\n\nReset a configuration parameter\n-------------------------------\n\nTo reset a configuration parameter to its default value, run the\n`gcloud memorystore instances update` command with the `--remove-engine-configs` flag,\nreplacing \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values. \n\n```\ngcloud memorystore instances update instance-id \\\n--location=region-id \\\n--project=project-id \\\n--remove-engine-configs=config-name\n```\n\nExample: \n\n```\ngcloud memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy\n```\n\nClear configuration parameters\n------------------------------\n\nTo clear all configuration parameters to their default values, run the\n`gcloud memorystore instances update` command with the `--clear-engine-configs` flag,\nreplacing \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values. \n\n```\ngcloud memorystore instances update instance-id \\\n--location=region-id \\\n--project=project-id \\\n--clear-engine-configs\n```\n\nExample: \n\n```\ngcloud memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs\n```"]]
