Stay organized with collections
Save and categorize content based on your preferences.
Creates an instance configuration and begins preparing it to be used.
The returned long-running operation can be used to track the progress of
preparing the new instance configuration. The instance configuration
name is assigned by the caller. If the named instance configuration
already exists, CreateInstanceConfig returns ALREADY_EXISTS.
Immediately after the request returns: * The instance configuration is
readable via the API, with all requested attributes. The instance
configuration's reconciling field is set to true. Its state is
CREATING. While the operation is pending: * Cancelling the operation
renders the instance configuration immediately unreadable via the API. *
Except for deleting the creating resource, all other attempts to modify
the instance configuration are rejected. Upon completion of the returned
operation: * Instances can be created using the instance configuration.
* The instance configuration's reconciling field becomes false. Its
state becomes READY. The returned long-running operation will have a
name of the format /operations/ and can be used to track creation of
the instance configuration. The metadata field type is
CreateInstanceConfigMetadata. The response field type is InstanceConfig,
if successful. Authorization requires spanner.instanceConfigs.create
permission on the resource parent.
This method waits—the workflow execution is paused—until the operation is
complete, fails, or times out. The default timeout value is 1800 seconds (30
minutes) and can be changed to a maximum value of 31536000 seconds (one year)
for long-running operations using the connector_params field.
The connector uses polling to monitor the long-running operation, which might
generate additional billable steps. The polling policy for the long-running
operation can be configured. For example, if you set skip_polling to True,
the connector invocation call is non-blocking if the initial request succeeds;
otherwise, retries might occur.
For more information about connector-specific parameters (connector_params),
see Invoke a connector call.
For more information about retries and long-running operations, see
Understand connectors.
Arguments
Parameters
parent
string
Required. The name of the project in which to create the instance configuration. Values are of the form projects/.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Method: googleapis.spanner.v1.projects.instanceConfigs.create\n\nCreates an instance configuration and begins preparing it to be used.\nThe returned long-running operation can be used to track the progress of\npreparing the new instance configuration. The instance configuration\nname is assigned by the caller. If the named instance configuration\nalready exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`.\nImmediately after the request returns: \\* The instance configuration is\nreadable via the API, with all requested attributes. The instance\nconfiguration's reconciling field is set to true. Its state is\n`CREATING`. While the operation is pending: \\* Cancelling the operation\nrenders the instance configuration immediately unreadable via the API. \\*\nExcept for deleting the creating resource, all other attempts to modify\nthe instance configuration are rejected. Upon completion of the returned\noperation: \\* Instances can be created using the instance configuration.\n\\* The instance configuration's reconciling field becomes false. Its\nstate becomes `READY`. The returned long-running operation will have a\nname of the format `/operations/` and can be used to track creation of\nthe instance configuration. The metadata field type is\nCreateInstanceConfigMetadata. The response field type is InstanceConfig,\nif successful. Authorization requires `spanner.instanceConfigs.create`\npermission on the resource parent.\n\nThis method waits---the workflow execution is paused---until the operation is\ncomplete, fails, or times out. The default timeout value is `1800` seconds (30\nminutes) and can be changed to a maximum value of `31536000` seconds (one year)\nfor long-running operations using the `connector_params` field.\n\nThe connector uses polling to monitor the long-running operation, which might\ngenerate additional billable steps. The polling policy for the long-running\noperation can be configured. For example, if you set `skip_polling` to `True`,\nthe connector invocation call is non-blocking if the initial request succeeds;\notherwise, retries might occur.\n\nFor more information about connector-specific parameters (`connector_params`),\nsee [Invoke a connector call](/workflows/docs/reference/googleapis#invoke_a_connector_call).\n\nFor more information about retries and long-running operations, see\n[Understand connectors](/workflows/docs/connectors).\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`Operation`](https://cloud.google.com/workflows/docs/reference/googleapis/spanner/v1/Overview#Operation).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/create). \n\n### YAML\n\n```yaml\n- create:\n call: googleapis.spanner.v1.projects.instanceConfigs.create\n args:\n parent: ...\n body:\n instanceConfig:\n baseConfig: ...\n displayName: ...\n etag: ...\n labels: ...\n leaderOptions: ...\n name: ...\n replicas: ...\n instanceConfigId: ...\n validateOnly: ...\n result: createResult\n```\n\n### JSON\n\n```json\n[\n {\n \"create\": {\n \"call\": \"googleapis.spanner.v1.projects.instanceConfigs.create\",\n \"args\": {\n \"parent\": \"...\",\n \"body\": {\n \"instanceConfig\": {\n \"baseConfig\": \"...\",\n \"displayName\": \"...\",\n \"etag\": \"...\",\n \"labels\": \"...\",\n \"leaderOptions\": \"...\",\n \"name\": \"...\",\n \"replicas\": \"...\"\n },\n \"instanceConfigId\": \"...\",\n \"validateOnly\": \"...\"\n }\n },\n \"result\": \"createResult\"\n }\n }\n]\n```"]]