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 (FieldsSqlOperationStatus
), "user": string, "insertTime": string, "startTime": string, "endTime": string, "error": { object (OperationErrors
) }, "operationType": enum (SqlOperationType
), "importContext": { object (ImportContext
) }, "exportContext": { object (ExportContext
) }, "backupContext": { object (BackupContext
) }, "name": string, "targetId": string, "selfLink": string, "targetProject": string "subOperationType": { object (SqlSubOperationType
) } }
kind
string
This is always sql#operation
.
targetLink
string
status
enum (
SqlOperationStatus
)
The status of an operation.
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, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "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, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "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, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "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.
backupContext
object (
BackupContext
)
The context for backup 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 resource on which this operation is executed.
selfLink
string
The URI of this resource.
targetProject
string
The project ID of the target instance related to this operation.
subOperationType
object (
SqlSubOperationType
)
Optional. The sub operation based on the operation type.
SqlOperationStatusThe status of an operation.
EnumsSQL_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.
SqlOperationTypeThe type of Cloud SQL operation.
EnumsSQL_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
This item is deprecated!
SNAPSHOT
This item is deprecated!
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.
This item is deprecated!
DEFER_MAINTENANCE
This item is deprecated!
CREATE_CLONE
Creates clone instance.
This item is deprecated!
RESCHEDULE_MAINTENANCE
Reschedule maintenance to another time. START_EXTERNAL_SYNC
Starts external sync of a Cloud SQL EM replica to an external primary instance. LOG_CLEANUP
Recovers logs from an instance's old data disk. AUTO_RESTART
Performs auto-restart of an HA-enabled Cloud SQL database for auto recovery. SWITCHOVER
Switches the roles of the primary and replica pair. The target instance should be the replica. UPDATE_BACKUP
Update a backup. RECONFIGURE_OLD_PRIMARY
Reconfigures old primary after a promote replica operation. Effect of a promote operation to the old primary is executed in this operation, asynchronously from the promote replica operation executed to the replica. CLUSTER_MAINTENANCE
Indicates that the instance, its read replicas, and its cascading replicas are in maintenance. Maintenance typically gets initiated on groups of replicas first, followed by the primary instance. For each instance, maintenance typically causes the instance to be unavailable for 1-3 minutes. SELF_SERVICE_MAINTENANCE
Indicates that the instance (and any of its replicas) are currently in maintenance. This is initiated as a self-service request by using SSM. Maintenance typically causes the instance to be unavailable for 1-3 minutes. SWITCHOVER_TO_REPLICA
Switches a primary instance to a replica. This operation runs as part of a switchover operation to the original primary instance. ImportContext
Database instance import context.
JSON representation{ "uri": string, "database": string, "kind": string, "fileType": enum (FieldsSqlFileType
), "csvImportOptions": { "table": string, "columns": [ string ], "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string }, "importUser": string, "bakImportOptions": { "encryptionOptions": { "certPath": string, "pvkPath": string, "pvkPassword": string }, "striped": boolean, "noRecovery": boolean, "recoveryOnly": boolean, "bakType": enum (BakType
), "stopAt": string, "stopAtMark": string } }
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.
csvImportOptions.escapeCharacter
string
Specifies the character that should appear before a data character that needs to be escaped.
csvImportOptions.quoteCharacter
string
Specifies the quoting character to be used when a data value is quoted.
csvImportOptions.fieldsTerminatedBy
string
Specifies the character that separates columns within each row (line) of the file.
csvImportOptions.linesTerminatedBy
string
This is used to separate lines. If a line does not contain all fields, the rest of the columns are set to their default values.
importUser
string
The PostgreSQL user for this import operation. PostgreSQL instances only.
bakImportOptions
object
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
bakImportOptions.striped
boolean
Whether or not the backup set being restored is striped. Applies only to Cloud SQL for SQL Server.
bakImportOptions.noRecovery
boolean
Whether or not the backup importing will restore database with NORECOVERY option Applies only to Cloud SQL for SQL Server.
bakImportOptions.recoveryOnly
boolean
Whether or not the backup importing request will just bring database online without downloading Bak content only one of "noRecovery" and "recoveryOnly" can be true otherwise error will return. Applies only to Cloud SQL for SQL Server.
bakImportOptions.bakType
enum (
BakType
)
Type of the bak content, FULL or DIFF
bakImportOptions.stopAt
string (
Timestamp
format)
Optional. The timestamp when the import should stop. This timestamp is in the RFC 3339 format (for example, 2023-10-01T16:19:00.094
). This field is equivalent to the STOPAT keyword and applies to Cloud SQL for SQL Server only.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "2014-10-02T15:01:23.045123456Z"
.
bakImportOptions.stopAtMark
string
Optional. The marked transaction where the import should stop. This field is equivalent to the STOPATMARK keyword and applies to Cloud SQL for SQL Server only.
SqlFileType EnumsSQL_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, "escapeCharacter": string, "quoteCharacter": string, "fieldsTerminatedBy": string, "linesTerminatedBy": string }, "fileType": enum (FieldsSqlFileType
), "offload": boolean, "bakExportOptions": { "striped": boolean, "stripeCount": integer, "bakType": enum (BakType
), "copyOnly": boolean, "differentialBase": boolean } }
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 request 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. SQL Server instances:
You must specify one database to be exported, and the fileType
must be BAK
.
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
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, and --set-gtid-purged is set to ON. If set to 2
, the CHANGE MASTER TO statement is written as a SQL comment and has no effect. If set to any value other than 1
, --set-gtid-purged is set to OFF.
csvExportOptions
object
Options for exporting data as CSV. MySQL
and PostgreSQL
instances only.
csvExportOptions.selectQuery
string
The select query used to extract the data.
csvExportOptions.escapeCharacter
string
Specifies the character that should appear before a data character that needs to be escaped.
csvExportOptions.quoteCharacter
string
Specifies the quoting character to be used when a data value is quoted.
csvExportOptions.fieldsTerminatedBy
string
Specifies the character that separates columns within each row (line) of the file.
csvExportOptions.linesTerminatedBy
string
This is used to separate lines. If a line does not contain all fields, the rest of the columns are set to their default values.
fileType
enum (
SqlFileType
)
The file type for the specified uri.
offload
boolean
Option for export offload.
bakExportOptions
object
Options for exporting data as BAK files.
bakExportOptions.striped
boolean
Whether or not the export should be striped.
bakExportOptions.stripeCount
integer
Option for specifying how many stripes to use for the export. If blank, and the value of the striped field is true, the number of stripes is automatically chosen.
bakExportOptions.bakType
enum (
BakType
)
Type of this bak file will be export, FULL or DIFF, SQL Server only
bakExportOptions.copyOnly
(deprecated)
boolean
Deprecated: copyOnly is deprecated. Use differentialBase instead
bakExportOptions.differentialBase
boolean
Whether or not the backup can be used as a differential base copyOnly backup can not be served as differential base
BackupContextBackup context.
JSON representation{ "backupId": string, "kind": string }Fields
backupId
string (int64 format)
The identifier of the backup.
kind
string
This is always sql#backupContext
.
name
string
The name of the backup. Format: projects/{project}/backups/{backup}
SqlSubOperationTypeThe sub operation type based on the operation type.
JSON representation{ // Union fieldFields Union fieldsub_operation_details
can be only one of the following: "maintenanceType": enum (SqlMaintenanceType
) // End of list of possible types for union fieldsub_operation_details
. }
sub_operation_details
. Sub operation details corresponding to the operation type. sub_operation_details
can be only one of the following: maintenanceType
enum (
SqlMaintenanceType
)
The type of maintenance to be performed on the instance.
SqlMaintenanceTypeThe type of maintenance to be performed on the instance.
EnumsSQL_MAINTENANCE_TYPE_UNSPECIFIED
Maintenance type is unspecified. INSTANCE_MAINTENANCE
Indicates that a standalone instance is undergoing maintenance. The instance can be either a primary instance or a replica. REPLICA_INCLUDED_MAINTENANCE
Indicates that the primary instance and all of its replicas, including cascading replicas, are undergoing maintenance. Maintenance is performed on groups of replicas first, followed by the primary instance. INSTANCE_SELF_SERVICE_MAINTENANCE
Indicates that the standalone instance is undergoing maintenance, initiated by self-service. The instance can be either a primary instance or a replica. REPLICA_INCLUDED_SELF_SERVICE_MAINTENANCE
Indicates that the primary instance and all of its replicas are undergoing maintenance, initiated by self-service. Maintenance is performed on groups of replicas first, followed by the primary instance. 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.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4