Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Instances: insert

Requires authorization

Creates a new Cloud SQL instance. Try it now .

Request

HTTP request

POST https://www.googleapis.com/sql/v1beta1/projects/project/instances

Parameters

Parameter name Value Description
Required parameters
project string Project ID of the project to which the newly created Cloud SQL instances should belong.

Authorization

This request requires authorization with the following scope ( read more about authentication and authorization ).

Scope
https://www.googleapis.com/auth/sqlservice.admin

Request body

In the request body, supply an instance resource with the following properties:

Property name Value Description Notes
Required Properties
instance string Name of the Cloud SQL instance. This does not include the project ID.
project string The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
settings. tier string The tier of service for this instance, for example D1 , D2 . For more information, see pricing . writable
Optional Properties
region string The geographical region. Can be us-east1 or europe-west1 . Defaults to us-east1 . The region can not be changed after instance creation. writable
settings. activationPolicy string The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE . This can be one of the following.
ALWAYS : The instance should always be active.
NEVER : The instance should never be activated.
ON_DEMAND : The instance is activated upon receiving requests.


writable
settings. authorizedGaeApplications[] list The AppEngine app ids that can access this instance. writable
settings. backupConfiguration[] list The daily backup configuration for the instance. writable
settings.backupConfiguration[]. enabled boolean Whether this configuration is enabled. writable
settings.backupConfiguration[]. startTime string Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM . writable
settings. pricingPlan string The pricing plan for this instance. This can be either PER_USE or PACKAGE . writable
settings. replicationType string The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS . writable

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "sql#instancesInsert",
  "operation": string
}
Property name Value Description Notes
kind string This is always sql#instancesInsert .
operation string An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.