Stay organized with collections
Save and categorize content based on your preferences.
Creates an instance partition and begins preparing it to be used. The
returned long-running operation can be used to track the progress of
preparing the new instance partition. The instance partition name is
assigned by the caller. If the named instance partition already exists,
CreateInstancePartition returns ALREADY_EXISTS. Immediately upon
completion of this request: * The instance partition is readable via the
API, with all requested attributes but no allocated resources. Its state
is CREATING. Until completion of the returned operation: * Cancelling
the operation renders the instance partition immediately unreadable via
the API. * The instance partition can be deleted. * All other attempts
to modify the instance partition are rejected. Upon completion of the
returned operation: * Billing for all successfully-allocated resources
begins (some types may have lower than the requested levels). *
Databases can start using this instance partition. * The instance
partition's allocated resource levels are readable via the API. * The
instance partition's 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 partition. The metadata field type is
CreateInstancePartitionMetadata. The response field type is
InstancePartition, if successful.
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 instance in which to create the instance partition. Values are of the form projects//instances/.
[[["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.instances.instancePartitions.create\n\nCreates an instance partition and begins preparing it to be used. The\nreturned long-running operation can be used to track the progress of\npreparing the new instance partition. The instance partition name is\nassigned by the caller. If the named instance partition already exists,\n`CreateInstancePartition` returns `ALREADY_EXISTS`. Immediately upon\ncompletion of this request: \\* The instance partition is readable via the\nAPI, with all requested attributes but no allocated resources. Its state\nis `CREATING`. Until completion of the returned operation: \\* Cancelling\nthe operation renders the instance partition immediately unreadable via\nthe API. \\* The instance partition can be deleted. \\* All other attempts\nto modify the instance partition are rejected. Upon completion of the\nreturned operation: \\* Billing for all successfully-allocated resources\nbegins (some types may have lower than the requested levels). \\*\nDatabases can start using this instance partition. \\* The instance\npartition's allocated resource levels are readable via the API. \\* The\ninstance partition's state becomes `READY`. The returned long-running\noperation will have a name of the format `/operations/` and can be used\nto track creation of the instance partition. The metadata field type is\nCreateInstancePartitionMetadata. The response field type is\nInstancePartition, if successful.\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.instances.instancePartitions/create). \n\n### YAML\n\n```yaml\n- create:\n call: googleapis.spanner.v1.projects.instances.instancePartitions.create\n args:\n parent: ...\n body:\n instancePartition:\n config: ...\n displayName: ...\n etag: ...\n name: ...\n nodeCount: ...\n processingUnits: ...\n instancePartitionId: ...\n result: createResult\n```\n\n### JSON\n\n```json\n[\n {\n \"create\": {\n \"call\": \"googleapis.spanner.v1.projects.instances.instancePartitions.create\",\n \"args\": {\n \"parent\": \"...\",\n \"body\": {\n \"instancePartition\": {\n \"config\": \"...\",\n \"displayName\": \"...\",\n \"etag\": \"...\",\n \"name\": \"...\",\n \"nodeCount\": \"...\",\n \"processingUnits\": \"...\"\n },\n \"instancePartitionId\": \"...\"\n }\n },\n \"result\": \"createResult\"\n }\n }\n]\n```"]]