REST Resource: operations

Resource: Operation

An Operation resource. For successful operations that return an Operation resource, only the fields relevant to the operation are populated in the resource.

JSON representation
{
  "kind": string,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "user": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    object (OperationErrors)
  },
  "operationType": enum (SqlOperationType),
  "importContext": {
    object (ImportContext)
  },
  "exportContext": {
    object (ExportContext)
  },
  "name": string,
  "targetId": string,
  "selfLink": string,
  "targetProject": string
}
Fields
kind

string

This is always

sql#operation

.

status

enum (SqlOperationStatus)

The status of an operation. Valid values are

PENDING

,

RUNNING

,

DONE

,

SQL_OPERATION_STATUS_UNSPECIFIED

.

user

string

The email address of the user who initiated this operation.

insertTime

string (Timestamp format)

The time this operation was enqueued in UTC timezone in RFC 3339 format, for example

2012-11-15T16:19:00.094Z

.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

startTime

string (Timestamp format)

The time this operation actually started in UTC timezone in RFC 3339 format, for example

2012-11-15T16:19:00.094Z

.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

The time this operation finished in UTC timezone in RFC 3339 format, for example

2012-11-15T16:19:00.094Z

.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

error

object (OperationErrors)

If errors occurred during processing of this operation, this field will be populated.

operationType

enum (SqlOperationType)

The type of the operation. Valid values are

CREATE

,

DELETE

,

UPDATE

,

RESTART

,

IMPORT

,

EXPORT

,

BACKUP_VOLUME

,

RESTORE_VOLUME

,

CREATE_USER

,

DELETE_USER

,

CREATE_DATABASE

,

DELETE_DATABASE

.

importContext

object (ImportContext)

The context for import operation, if applicable.

exportContext

object (ExportContext)

The context for export operation, if applicable.

name

string

An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.

targetId

string

Name of the database instance related to this operation.

targetProject

string

The project ID of the target instance related to this operation.

SqlOperationStatus

The status of an operation.

Enums
SQL_OPERATION_STATUS_UNSPECIFIED The state of the operation is unknown.
PENDING The operation has been queued, but has not started yet.
RUNNING The operation is running.
DONE The operation completed.

OperationErrors

Database instance operation errors list wrapper.

JSON representation
{
  "kind": string,
  "errors": [
    {
      object (OperationError)
    }
  ]
}
Fields
kind

string

This is always

sql#operationErrors

.

errors[]

object (OperationError)

The list of errors encountered while processing this operation.

SqlOperationType

The type of Cloud SQL operation.

Enums
SQL_OPERATION_TYPE_UNSPECIFIED Unknown operation type.
IMPORT Imports data into a Cloud SQL instance.
EXPORT Exports data from a Cloud SQL instance to a Cloud Storage bucket.
CREATE Creates a new Cloud SQL instance.
UPDATE Updates the settings of a Cloud SQL instance.
DELETE Deletes a Cloud SQL instance.
RESTART Restarts the Cloud SQL instance.
BACKUP
SNAPSHOT
BACKUP_VOLUME Performs instance backup.
DELETE_VOLUME Deletes an instance backup.
RESTORE_VOLUME Restores an instance backup.
INJECT_USER Injects a privileged user in mysql for MOB instances.
CLONE Clones a Cloud SQL instance.
STOP_REPLICA Stops replication on a Cloud SQL read replica instance.
START_REPLICA Starts replication on a Cloud SQL read replica instance.
PROMOTE_REPLICA Promotes a Cloud SQL replica instance.
CREATE_REPLICA Creates a Cloud SQL replica instance.
CREATE_USER Creates a new user in a Cloud SQL instance.
DELETE_USER Deletes a user from a Cloud SQL instance.
UPDATE_USER Updates an existing user in a Cloud SQL instance.
CREATE_DATABASE Creates a database in the Cloud SQL instance.
DELETE_DATABASE Deletes a database in the Cloud SQL instance.
UPDATE_DATABASE Updates a database in the Cloud SQL instance.
FAILOVER Performs failover of an HA-enabled Cloud SQL failover replica.
DELETE_BACKUP Deletes the backup taken by a backup run.
RECREATE_REPLICA
TRUNCATE_LOG Truncates a general or slow log table in MySQL.
DEMOTE_MASTER Demotes the stand-alone instance to be a Cloud SQL read replica for an external database server.
MAINTENANCE Indicates that the instance is currently in maintenance. Maintenance typically causes the instance to be unavailable for 1-3 minutes.
ENABLE_PRIVATE_IP

This field is deprecated, and will be removed in future version of API.

DEFER_MAINTENANCE
CREATE_CLONE Creates clone instance.
RESCHEDULE_MAINTENANCE Reschedule maintenance to another time.

ImportContext

Database instance import context.

JSON representation
{
  "uri": string,
  "database": string,
  "kind": string,
  "fileType": enum (SqlFileType),
  "csvImportOptions": {
    "table": string,
    "columns": [
      string
    ]
  },
  "importUser": string,
  "bakImportOptions": {
    "encryptionOptions": {
      "certPath": string,
      "pvkPath": string,
      "pvkPassword": string
    }
  }
}
Fields
uri

string

Path to the import file in Cloud Storage, in the form

gs: //bucketName/fileName

. Compressed gzip files (.gz) are supported // when

fileType

is

SQL

. The instance must have // write permissions to the bucket and read access to the file.

database

string

The target database for the import. If

fileType

is

SQL

, this field is required only if the import file does not specify a database, and is overridden by any database specification in the import file. If

fileType

is

CSV

, one database must be specified.

kind

string

This is always

sql#importContext

.

fileType

enum (SqlFileType)

The file type for the specified uri.

SQL

: The file contains SQL statements.

CSV

: The file contains CSV data.

csvImportOptions

object

Options for importing data as CSV.

csvImportOptions.table

string

The table to which CSV data is imported.

csvImportOptions.columns[]

string

The columns to which CSV data is imported. If not specified, all columns of the database table are loaded with CSV data.

importUser

string

The PostgreSQL user for this import operation. PostgreSQL instances only.

bakImportOptions

object

instances.import parameters specific to SQL Server .BAK files

bakImportOptions.encryptionOptions

object

bakImportOptions.encryptionOptions.certPath

string

Path to the Certificate (.cer) in Cloud Storage, in the form

gs://bucketName/fileName

. The instance must have write permissions to the bucket and read access to the file.

bakImportOptions.encryptionOptions.pvkPath

string

Path to the Certificate Private Key (.pvk) in Cloud Storage, in the form

gs://bucketName/fileName

. The instance must have write permissions to the bucket and read access to the file.

bakImportOptions.encryptionOptions.pvkPassword

string

Password that encrypts the private key

SqlFileType

Enums
SQL_FILE_TYPE_UNSPECIFIED Unknown file type.
SQL File containing SQL statements.
CSV File in CSV format.
BAK

ExportContext

Database instance export context.

JSON representation
{
  "uri": string,
  "databases": [
    string
  ],
  "kind": string,
  "sqlExportOptions": {
    "tables": [
      string
    ],
    "schemaOnly": boolean,
    "mysqlExportOptions": {
      "masterData": integer
    }
  },
  "csvExportOptions": {
    "selectQuery": string
  },
  "fileType": enum (SqlFileType)
}
Fields
uri

string

The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form

gs: //bucketName/fileName

. If the file already exists, the requests // succeeds, but the operation fails. If

fileType

is //

SQL

and the filename ends with .gz, the contents are // compressed.

databases[]

string

Databases to be exported.
MySQL instances: If

fileType

is

SQL

and no database is specified, all databases are exported, except for the

mysql

system database. If

fileType

is

CSV

, you can specify one database, either by using this property or by using the

csvExportOptions.selectQuery

property, which takes precedence over this property.
PostgreSQL instances: You must specify one database to be exported. If

fileType

is

CSV

, this database must match the one specified in the

csvExportOptions.selectQuery

property.

kind

string

This is always

sql#exportContext

.

sqlExportOptions

object

Options for exporting data as SQL statements.

sqlExportOptions.tables[]

string

Tables to export, or that were exported, from the specified database. If you specify tables, specify one and only one database. For PostgreSQL instances, you can specify only one table.

sqlExportOptions.schemaOnly

boolean

instances.export only schemas.

sqlExportOptions.mysqlExportOptions

object

sqlExportOptions.mysqlExportOptions.masterData

integer

Option to include SQL statement required to set up replication. If set to

1

, the dump file includes a CHANGE MASTER TO statement with the binary log coordinates. If set to

2

, the CHANGE MASTER TO statement is written as a SQL comment, and has no effect. All other values are ignored.

csvExportOptions

object

Options for exporting data as CSV.

csvExportOptions.selectQuery

string

The select query used to extract the data.

fileType

enum (SqlFileType)

The file type for the specified uri.

SQL

: The file contains SQL statements.

CSV

: The file contains CSV data.

Methods

get

Retrieves an instance operation that has been performed on an instance.

list

Lists all instance operations that have been performed on the given Cloud SQL instance in the reverse chronological order of the start time.