Update docs
diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html
index 0ddfa3c..43410f4 100644
--- a/docs/dyn/sqladmin_v1beta4.instances.html
+++ b/docs/dyn/sqladmin_v1beta4.instances.html
@@ -76,7 +76,7 @@
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#clone">clone(project, instance, body)</a></code></p>
-<p class="firstline">Creates a Cloud SQL instance as a clone of the source instance.</p>
+<p class="firstline">Creates a Cloud SQL instance as a clone of the source instance. The API is not ready for Second Generation instances yet.</p>
<p class="toc_element">
<code><a href="#delete">delete(project, instance)</a></code></p>
<p class="firstline">Deletes a Cloud SQL instance.</p>
@@ -128,7 +128,7 @@
<h3>Method Details</h3>
<div class="method">
<code class="details" id="clone">clone(project, instance, body)</code>
- <pre>Creates a Cloud SQL instance as a clone of the source instance.
+ <pre>Creates a Cloud SQL instance as a clone of the source instance. The API is not ready for Second Generation instances yet.
Args:
project: string, Project ID of the source as well as the clone Cloud SQL instance. (required)
@@ -468,16 +468,116 @@
An object of the form:
{ # A Cloud SQL instance resource.
+ "backendType": "A String", # FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.
+ # SECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.
+ # EXTERNAL: A MySQL server that is not managed by Google.
+ "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Users should use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ for details.
+ "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance. This property is applicable only to Second Generation instances.
+ "ipAddresses": [ # The assigned IP addresses for the instance.
+ { # Database instance IP Mapping.
+ "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
+ "ipAddress": "A String", # The IP address assigned.
+ },
+ ],
+ "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
+ "instanceType": "A String", # The instance type. This can be one of the following.
+ # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
+ # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
+ # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
+ "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
+ "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension.
+ "A String",
+ ],
+ "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
+ "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
+ # RUNNABLE: The instance is running, or is ready to run when accessed.
+ # SUSPENDED: The instance is not available, for example due to problems with billing.
+ # PENDING_CREATE: The instance is being created.
+ # MAINTENANCE: The instance is down for maintenance.
+ # FAILED: The instance creation failed.
+ # UNKNOWN_STATE: The state of the instance is unknown.
+ "etag": "A String", # HTTP 1.1 Entity tag for the resource.
+ "failoverReplica": { # The name and status of the failover replica. This property is applicable only to Second Generation instances.
+ "available": True or False, # The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The master can only failover to the falover replica when the status is true.
+ "name": "A String", # The name of the failover replica.
+ },
+ "replicaNames": [ # The replicas of the instance.
+ "A String",
+ ],
"onPremisesConfiguration": { # On-premises instance configuration. # Configuration specific to on-premises instances.
"kind": "sql#onPremisesConfiguration", # This is always sql#onPremisesConfiguration.
"hostPort": "A String", # The host and port of the on-premises instance in host:port format
},
"kind": "sql#instance", # This is always sql#instance.
- "failoverReplica": { # The name and status of the failover replica. Only applies to Second Generation instances.
- "available": True or False,
- "name": "A String",
+ "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
+ "ipv6Address": "A String", # The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.
+ "serverCaCert": { # SslCerts Resource # SSL configuration.
+ "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
+ "kind": "sql#sslCert", # This is always sql#sslCert.
+ "sha1Fingerprint": "A String", # Sha1 Fingerprint.
+ "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
+ "instance": "A String", # Name of the database instance.
+ "cert": "A String", # PEM representation.
+ "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
+ "selfLink": "A String", # The URI of this resource.
},
- "ipv6Address": "A String", # The IPv6 address assigned to the instance.
+ "region": "A String", # The geographical region. Can be us-central (FIRST_GEN instances only), us-central1 (SECOND_GEN instances only), asia-east1 or europe-west1. Defaults to us-central or us-central1 depending on the instance type (First Generation or Second Generation). The region can not be changed after instance creation.
+ "settings": { # Database instance settings. # The user settings.
+ "databaseFlags": [ # The database flags passed to the instance at startup.
+ { # MySQL flags for Cloud SQL instances.
+ "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
+ "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
+ },
+ ],
+ "kind": "sql#settings", # This is always sql#settings.
+ "dataDiskType": "A String", # The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. Applies only to Second Generation instances.
+ "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. Applies only to Second Generation instances.
+ "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
+ "updateTrack": "A String",
+ "day": 42, # day of week (1-7), starting on Monday.
+ "hour": 42, # hour of day - 0 to 23.
+ },
+ "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.
+ "A String",
+ ],
+ "activationPolicy": "A 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; only applicable to First Generation instances.
+ "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
+ "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
+ "enabled": True or False, # Whether this configuration is enabled.
+ "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
+ "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
+ },
+ "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances.
+ "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
+ "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
+ "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
+ { # An entry for an Access Control list.
+ "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "kind": "sql#aclEntry", # This is always sql#aclEntry.
+ "value": "A String", # The whitelisted value for the access control list.
+ "name": "A String", # An optional label to identify this entry.
+ },
+ ],
+ },
+ "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
+ "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+ "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.
+ "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property is only applicable to First Generation instances.
+ "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.
+ "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
+ "storageAutoResize": True or False, # Configuration to increase storage size automatically. The default value is false. Applies only to Second Generation instances.
+ "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance. App Engine co-location is only applicable to First Generation instances.
+ "kind": "sql#locationPreference", # This is always sql#locationPreference.
+ "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
+ "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
+ },
+ "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. Applies only to Second Generation instances.
+ },
+ "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
"replicaConfiguration": { # Read-replica configuration for connecting to the master. # Configuration specific to read-replicas replicating from on-premises masters.
"kind": "sql#replicaConfiguration", # This is always sql#replicaConfiguration.
"failoverTarget": True or False, # Specifies if the replica is the failover target. If the field is set to true the replica will be designated as a failover replica. In case the master instance fails, the replica instance will be promoted as the new master instance.
@@ -496,100 +596,7 @@
"connectRetryInterval": 42, # Seconds to wait between connect retries. MySQL's default is 60 seconds.
},
},
- "replicaNames": [ # The replicas of the instance.
- "A String",
- ],
- "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
- "region": "A String", # The geographical region. Can be us-central, asia-east1 or europe-west1. Defaults to us-central. The region can not be changed after instance creation.
- "serverCaCert": { # SslCerts Resource # SSL configuration.
- "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
- "kind": "sql#sslCert", # This is always sql#sslCert.
- "sha1Fingerprint": "A String", # Sha1 Fingerprint.
- "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
- "instance": "A String", # Name of the database instance.
- "cert": "A String", # PEM representation.
- "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
- "selfLink": "A String", # The URI of this resource.
- },
- "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
- "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
- "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
- "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
- # RUNNABLE: The instance is running, or is ready to run when accessed.
- # SUSPENDED: The instance is not available, for example due to problems with billing.
- # PENDING_CREATE: The instance is being created.
- # MAINTENANCE: The instance is down for maintenance.
- # FAILED: The instance creation failed.
- # UNKNOWN_STATE: The state of the instance is unknown.
- "etag": "A String", # HTTP 1.1 Entity tag for the resource.
- "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance.
- "ipAddresses": [ # The assigned IP addresses for the instance.
- { # Database instance IP Mapping.
- "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
- "ipAddress": "A String", # The IP address assigned.
- },
- ],
- "databaseVersion": "A String", # The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_5. The databaseVersion can not be changed after instance creation.
- "settings": { # Database instance settings. # The user settings.
- "databaseFlags": [ # The database flags passed to the instance at startup.
- { # MySQL flags for Cloud SQL instances.
- "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
- "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
- },
- ],
- "kind": "sql#settings", # This is always sql#settings.
- "dataDiskType": "A String", # The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.
- "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes.
- "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
- "updateTrack": "A String",
- "day": 42, # day of week (1-7), starting on Monday.
- "hour": 42, # hour of day - 0 to 23.
- },
- "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance.
- "A String",
- ],
- "activationPolicy": "A 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.
- "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
- "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
- "enabled": True or False, # Whether this configuration is enabled.
- "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
- "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
- },
- "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance.
- "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
- "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
- "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
- { # An entry for an Access Control list.
- "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "kind": "sql#aclEntry", # This is always sql#aclEntry.
- "value": "A String", # The whitelisted value for the access control list.
- "name": "A String", # An optional label to identify this entry.
- },
- ],
- },
- "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
- "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
- "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
- "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.
- "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
- "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
- "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance.
- "kind": "sql#locationPreference", # This is always sql#locationPreference.
- "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
- "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
- },
- "dataDiskSizeGb": "A String", # The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.
- },
- "instanceType": "A String", # The instance type. This can be one of the following.
- # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
- # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
- # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
"selfLink": "A String", # The URI of this resource.
- "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
}</pre>
</div>
@@ -693,16 +700,116 @@
The object takes the form of:
{ # A Cloud SQL instance resource.
+ "backendType": "A String", # FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.
+ # SECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.
+ # EXTERNAL: A MySQL server that is not managed by Google.
+ "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Users should use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ for details.
+ "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance. This property is applicable only to Second Generation instances.
+ "ipAddresses": [ # The assigned IP addresses for the instance.
+ { # Database instance IP Mapping.
+ "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
+ "ipAddress": "A String", # The IP address assigned.
+ },
+ ],
+ "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
+ "instanceType": "A String", # The instance type. This can be one of the following.
+ # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
+ # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
+ # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
+ "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
+ "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension.
+ "A String",
+ ],
+ "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
+ "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
+ # RUNNABLE: The instance is running, or is ready to run when accessed.
+ # SUSPENDED: The instance is not available, for example due to problems with billing.
+ # PENDING_CREATE: The instance is being created.
+ # MAINTENANCE: The instance is down for maintenance.
+ # FAILED: The instance creation failed.
+ # UNKNOWN_STATE: The state of the instance is unknown.
+ "etag": "A String", # HTTP 1.1 Entity tag for the resource.
+ "failoverReplica": { # The name and status of the failover replica. This property is applicable only to Second Generation instances.
+ "available": True or False, # The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The master can only failover to the falover replica when the status is true.
+ "name": "A String", # The name of the failover replica.
+ },
+ "replicaNames": [ # The replicas of the instance.
+ "A String",
+ ],
"onPremisesConfiguration": { # On-premises instance configuration. # Configuration specific to on-premises instances.
"kind": "sql#onPremisesConfiguration", # This is always sql#onPremisesConfiguration.
"hostPort": "A String", # The host and port of the on-premises instance in host:port format
},
"kind": "sql#instance", # This is always sql#instance.
- "failoverReplica": { # The name and status of the failover replica. Only applies to Second Generation instances.
- "available": True or False,
- "name": "A String",
+ "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
+ "ipv6Address": "A String", # The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.
+ "serverCaCert": { # SslCerts Resource # SSL configuration.
+ "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
+ "kind": "sql#sslCert", # This is always sql#sslCert.
+ "sha1Fingerprint": "A String", # Sha1 Fingerprint.
+ "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
+ "instance": "A String", # Name of the database instance.
+ "cert": "A String", # PEM representation.
+ "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
+ "selfLink": "A String", # The URI of this resource.
},
- "ipv6Address": "A String", # The IPv6 address assigned to the instance.
+ "region": "A String", # The geographical region. Can be us-central (FIRST_GEN instances only), us-central1 (SECOND_GEN instances only), asia-east1 or europe-west1. Defaults to us-central or us-central1 depending on the instance type (First Generation or Second Generation). The region can not be changed after instance creation.
+ "settings": { # Database instance settings. # The user settings.
+ "databaseFlags": [ # The database flags passed to the instance at startup.
+ { # MySQL flags for Cloud SQL instances.
+ "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
+ "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
+ },
+ ],
+ "kind": "sql#settings", # This is always sql#settings.
+ "dataDiskType": "A String", # The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. Applies only to Second Generation instances.
+ "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. Applies only to Second Generation instances.
+ "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
+ "updateTrack": "A String",
+ "day": 42, # day of week (1-7), starting on Monday.
+ "hour": 42, # hour of day - 0 to 23.
+ },
+ "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.
+ "A String",
+ ],
+ "activationPolicy": "A 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; only applicable to First Generation instances.
+ "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
+ "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
+ "enabled": True or False, # Whether this configuration is enabled.
+ "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
+ "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
+ },
+ "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances.
+ "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
+ "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
+ "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
+ { # An entry for an Access Control list.
+ "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "kind": "sql#aclEntry", # This is always sql#aclEntry.
+ "value": "A String", # The whitelisted value for the access control list.
+ "name": "A String", # An optional label to identify this entry.
+ },
+ ],
+ },
+ "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
+ "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+ "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.
+ "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property is only applicable to First Generation instances.
+ "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.
+ "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
+ "storageAutoResize": True or False, # Configuration to increase storage size automatically. The default value is false. Applies only to Second Generation instances.
+ "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance. App Engine co-location is only applicable to First Generation instances.
+ "kind": "sql#locationPreference", # This is always sql#locationPreference.
+ "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
+ "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
+ },
+ "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. Applies only to Second Generation instances.
+ },
+ "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
"replicaConfiguration": { # Read-replica configuration for connecting to the master. # Configuration specific to read-replicas replicating from on-premises masters.
"kind": "sql#replicaConfiguration", # This is always sql#replicaConfiguration.
"failoverTarget": True or False, # Specifies if the replica is the failover target. If the field is set to true the replica will be designated as a failover replica. In case the master instance fails, the replica instance will be promoted as the new master instance.
@@ -721,100 +828,7 @@
"connectRetryInterval": 42, # Seconds to wait between connect retries. MySQL's default is 60 seconds.
},
},
- "replicaNames": [ # The replicas of the instance.
- "A String",
- ],
- "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
- "region": "A String", # The geographical region. Can be us-central, asia-east1 or europe-west1. Defaults to us-central. The region can not be changed after instance creation.
- "serverCaCert": { # SslCerts Resource # SSL configuration.
- "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
- "kind": "sql#sslCert", # This is always sql#sslCert.
- "sha1Fingerprint": "A String", # Sha1 Fingerprint.
- "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
- "instance": "A String", # Name of the database instance.
- "cert": "A String", # PEM representation.
- "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
- "selfLink": "A String", # The URI of this resource.
- },
- "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
- "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
- "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
- "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
- # RUNNABLE: The instance is running, or is ready to run when accessed.
- # SUSPENDED: The instance is not available, for example due to problems with billing.
- # PENDING_CREATE: The instance is being created.
- # MAINTENANCE: The instance is down for maintenance.
- # FAILED: The instance creation failed.
- # UNKNOWN_STATE: The state of the instance is unknown.
- "etag": "A String", # HTTP 1.1 Entity tag for the resource.
- "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance.
- "ipAddresses": [ # The assigned IP addresses for the instance.
- { # Database instance IP Mapping.
- "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
- "ipAddress": "A String", # The IP address assigned.
- },
- ],
- "databaseVersion": "A String", # The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_5. The databaseVersion can not be changed after instance creation.
- "settings": { # Database instance settings. # The user settings.
- "databaseFlags": [ # The database flags passed to the instance at startup.
- { # MySQL flags for Cloud SQL instances.
- "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
- "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
- },
- ],
- "kind": "sql#settings", # This is always sql#settings.
- "dataDiskType": "A String", # The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.
- "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes.
- "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
- "updateTrack": "A String",
- "day": 42, # day of week (1-7), starting on Monday.
- "hour": 42, # hour of day - 0 to 23.
- },
- "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance.
- "A String",
- ],
- "activationPolicy": "A 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.
- "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
- "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
- "enabled": True or False, # Whether this configuration is enabled.
- "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
- "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
- },
- "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance.
- "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
- "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
- "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
- { # An entry for an Access Control list.
- "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "kind": "sql#aclEntry", # This is always sql#aclEntry.
- "value": "A String", # The whitelisted value for the access control list.
- "name": "A String", # An optional label to identify this entry.
- },
- ],
- },
- "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
- "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
- "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
- "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.
- "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
- "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
- "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance.
- "kind": "sql#locationPreference", # This is always sql#locationPreference.
- "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
- "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
- },
- "dataDiskSizeGb": "A String", # The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.
- },
- "instanceType": "A String", # The instance type. This can be one of the following.
- # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
- # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
- # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
"selfLink": "A String", # The URI of this resource.
- "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
}
@@ -896,16 +910,116 @@
"nextPageToken": "A String", # The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
"items": [ # List of database instance resources.
{ # A Cloud SQL instance resource.
+ "backendType": "A String", # FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.
+ # SECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.
+ # EXTERNAL: A MySQL server that is not managed by Google.
+ "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Users should use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ for details.
+ "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance. This property is applicable only to Second Generation instances.
+ "ipAddresses": [ # The assigned IP addresses for the instance.
+ { # Database instance IP Mapping.
+ "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
+ "ipAddress": "A String", # The IP address assigned.
+ },
+ ],
+ "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
+ "instanceType": "A String", # The instance type. This can be one of the following.
+ # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
+ # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
+ # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
+ "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
+ "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension.
+ "A String",
+ ],
+ "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
+ "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
+ # RUNNABLE: The instance is running, or is ready to run when accessed.
+ # SUSPENDED: The instance is not available, for example due to problems with billing.
+ # PENDING_CREATE: The instance is being created.
+ # MAINTENANCE: The instance is down for maintenance.
+ # FAILED: The instance creation failed.
+ # UNKNOWN_STATE: The state of the instance is unknown.
+ "etag": "A String", # HTTP 1.1 Entity tag for the resource.
+ "failoverReplica": { # The name and status of the failover replica. This property is applicable only to Second Generation instances.
+ "available": True or False, # The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The master can only failover to the falover replica when the status is true.
+ "name": "A String", # The name of the failover replica.
+ },
+ "replicaNames": [ # The replicas of the instance.
+ "A String",
+ ],
"onPremisesConfiguration": { # On-premises instance configuration. # Configuration specific to on-premises instances.
"kind": "sql#onPremisesConfiguration", # This is always sql#onPremisesConfiguration.
"hostPort": "A String", # The host and port of the on-premises instance in host:port format
},
"kind": "sql#instance", # This is always sql#instance.
- "failoverReplica": { # The name and status of the failover replica. Only applies to Second Generation instances.
- "available": True or False,
- "name": "A String",
+ "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
+ "ipv6Address": "A String", # The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.
+ "serverCaCert": { # SslCerts Resource # SSL configuration.
+ "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
+ "kind": "sql#sslCert", # This is always sql#sslCert.
+ "sha1Fingerprint": "A String", # Sha1 Fingerprint.
+ "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
+ "instance": "A String", # Name of the database instance.
+ "cert": "A String", # PEM representation.
+ "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
+ "selfLink": "A String", # The URI of this resource.
},
- "ipv6Address": "A String", # The IPv6 address assigned to the instance.
+ "region": "A String", # The geographical region. Can be us-central (FIRST_GEN instances only), us-central1 (SECOND_GEN instances only), asia-east1 or europe-west1. Defaults to us-central or us-central1 depending on the instance type (First Generation or Second Generation). The region can not be changed after instance creation.
+ "settings": { # Database instance settings. # The user settings.
+ "databaseFlags": [ # The database flags passed to the instance at startup.
+ { # MySQL flags for Cloud SQL instances.
+ "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
+ "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
+ },
+ ],
+ "kind": "sql#settings", # This is always sql#settings.
+ "dataDiskType": "A String", # The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. Applies only to Second Generation instances.
+ "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. Applies only to Second Generation instances.
+ "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
+ "updateTrack": "A String",
+ "day": 42, # day of week (1-7), starting on Monday.
+ "hour": 42, # hour of day - 0 to 23.
+ },
+ "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.
+ "A String",
+ ],
+ "activationPolicy": "A 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; only applicable to First Generation instances.
+ "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
+ "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
+ "enabled": True or False, # Whether this configuration is enabled.
+ "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
+ "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
+ },
+ "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances.
+ "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
+ "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
+ "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
+ { # An entry for an Access Control list.
+ "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "kind": "sql#aclEntry", # This is always sql#aclEntry.
+ "value": "A String", # The whitelisted value for the access control list.
+ "name": "A String", # An optional label to identify this entry.
+ },
+ ],
+ },
+ "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
+ "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+ "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.
+ "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property is only applicable to First Generation instances.
+ "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.
+ "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
+ "storageAutoResize": True or False, # Configuration to increase storage size automatically. The default value is false. Applies only to Second Generation instances.
+ "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance. App Engine co-location is only applicable to First Generation instances.
+ "kind": "sql#locationPreference", # This is always sql#locationPreference.
+ "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
+ "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
+ },
+ "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. Applies only to Second Generation instances.
+ },
+ "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
"replicaConfiguration": { # Read-replica configuration for connecting to the master. # Configuration specific to read-replicas replicating from on-premises masters.
"kind": "sql#replicaConfiguration", # This is always sql#replicaConfiguration.
"failoverTarget": True or False, # Specifies if the replica is the failover target. If the field is set to true the replica will be designated as a failover replica. In case the master instance fails, the replica instance will be promoted as the new master instance.
@@ -924,100 +1038,7 @@
"connectRetryInterval": 42, # Seconds to wait between connect retries. MySQL's default is 60 seconds.
},
},
- "replicaNames": [ # The replicas of the instance.
- "A String",
- ],
- "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
- "region": "A String", # The geographical region. Can be us-central, asia-east1 or europe-west1. Defaults to us-central. The region can not be changed after instance creation.
- "serverCaCert": { # SslCerts Resource # SSL configuration.
- "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
- "kind": "sql#sslCert", # This is always sql#sslCert.
- "sha1Fingerprint": "A String", # Sha1 Fingerprint.
- "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
- "instance": "A String", # Name of the database instance.
- "cert": "A String", # PEM representation.
- "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
- "selfLink": "A String", # The URI of this resource.
- },
- "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
- "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
- "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
- "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
- # RUNNABLE: The instance is running, or is ready to run when accessed.
- # SUSPENDED: The instance is not available, for example due to problems with billing.
- # PENDING_CREATE: The instance is being created.
- # MAINTENANCE: The instance is down for maintenance.
- # FAILED: The instance creation failed.
- # UNKNOWN_STATE: The state of the instance is unknown.
- "etag": "A String", # HTTP 1.1 Entity tag for the resource.
- "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance.
- "ipAddresses": [ # The assigned IP addresses for the instance.
- { # Database instance IP Mapping.
- "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
- "ipAddress": "A String", # The IP address assigned.
- },
- ],
- "databaseVersion": "A String", # The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_5. The databaseVersion can not be changed after instance creation.
- "settings": { # Database instance settings. # The user settings.
- "databaseFlags": [ # The database flags passed to the instance at startup.
- { # MySQL flags for Cloud SQL instances.
- "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
- "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
- },
- ],
- "kind": "sql#settings", # This is always sql#settings.
- "dataDiskType": "A String", # The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.
- "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes.
- "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
- "updateTrack": "A String",
- "day": 42, # day of week (1-7), starting on Monday.
- "hour": 42, # hour of day - 0 to 23.
- },
- "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance.
- "A String",
- ],
- "activationPolicy": "A 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.
- "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
- "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
- "enabled": True or False, # Whether this configuration is enabled.
- "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
- "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
- },
- "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance.
- "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
- "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
- "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
- { # An entry for an Access Control list.
- "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "kind": "sql#aclEntry", # This is always sql#aclEntry.
- "value": "A String", # The whitelisted value for the access control list.
- "name": "A String", # An optional label to identify this entry.
- },
- ],
- },
- "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
- "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
- "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
- "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.
- "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
- "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
- "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance.
- "kind": "sql#locationPreference", # This is always sql#locationPreference.
- "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
- "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
- },
- "dataDiskSizeGb": "A String", # The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.
- },
- "instanceType": "A String", # The instance type. This can be one of the following.
- # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
- # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
- # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
"selfLink": "A String", # The URI of this resource.
- "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
},
],
"kind": "sql#instancesList", # This is always sql#instancesList.
@@ -1049,16 +1070,116 @@
The object takes the form of:
{ # A Cloud SQL instance resource.
+ "backendType": "A String", # FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.
+ # SECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.
+ # EXTERNAL: A MySQL server that is not managed by Google.
+ "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Users should use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ for details.
+ "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance. This property is applicable only to Second Generation instances.
+ "ipAddresses": [ # The assigned IP addresses for the instance.
+ { # Database instance IP Mapping.
+ "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
+ "ipAddress": "A String", # The IP address assigned.
+ },
+ ],
+ "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
+ "instanceType": "A String", # The instance type. This can be one of the following.
+ # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
+ # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
+ # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
+ "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
+ "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension.
+ "A String",
+ ],
+ "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
+ "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
+ # RUNNABLE: The instance is running, or is ready to run when accessed.
+ # SUSPENDED: The instance is not available, for example due to problems with billing.
+ # PENDING_CREATE: The instance is being created.
+ # MAINTENANCE: The instance is down for maintenance.
+ # FAILED: The instance creation failed.
+ # UNKNOWN_STATE: The state of the instance is unknown.
+ "etag": "A String", # HTTP 1.1 Entity tag for the resource.
+ "failoverReplica": { # The name and status of the failover replica. This property is applicable only to Second Generation instances.
+ "available": True or False, # The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The master can only failover to the falover replica when the status is true.
+ "name": "A String", # The name of the failover replica.
+ },
+ "replicaNames": [ # The replicas of the instance.
+ "A String",
+ ],
"onPremisesConfiguration": { # On-premises instance configuration. # Configuration specific to on-premises instances.
"kind": "sql#onPremisesConfiguration", # This is always sql#onPremisesConfiguration.
"hostPort": "A String", # The host and port of the on-premises instance in host:port format
},
"kind": "sql#instance", # This is always sql#instance.
- "failoverReplica": { # The name and status of the failover replica. Only applies to Second Generation instances.
- "available": True or False,
- "name": "A String",
+ "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
+ "ipv6Address": "A String", # The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.
+ "serverCaCert": { # SslCerts Resource # SSL configuration.
+ "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
+ "kind": "sql#sslCert", # This is always sql#sslCert.
+ "sha1Fingerprint": "A String", # Sha1 Fingerprint.
+ "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
+ "instance": "A String", # Name of the database instance.
+ "cert": "A String", # PEM representation.
+ "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
+ "selfLink": "A String", # The URI of this resource.
},
- "ipv6Address": "A String", # The IPv6 address assigned to the instance.
+ "region": "A String", # The geographical region. Can be us-central (FIRST_GEN instances only), us-central1 (SECOND_GEN instances only), asia-east1 or europe-west1. Defaults to us-central or us-central1 depending on the instance type (First Generation or Second Generation). The region can not be changed after instance creation.
+ "settings": { # Database instance settings. # The user settings.
+ "databaseFlags": [ # The database flags passed to the instance at startup.
+ { # MySQL flags for Cloud SQL instances.
+ "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
+ "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
+ },
+ ],
+ "kind": "sql#settings", # This is always sql#settings.
+ "dataDiskType": "A String", # The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. Applies only to Second Generation instances.
+ "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. Applies only to Second Generation instances.
+ "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
+ "updateTrack": "A String",
+ "day": 42, # day of week (1-7), starting on Monday.
+ "hour": 42, # hour of day - 0 to 23.
+ },
+ "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.
+ "A String",
+ ],
+ "activationPolicy": "A 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; only applicable to First Generation instances.
+ "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
+ "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
+ "enabled": True or False, # Whether this configuration is enabled.
+ "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
+ "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
+ },
+ "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances.
+ "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
+ "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
+ "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
+ { # An entry for an Access Control list.
+ "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "kind": "sql#aclEntry", # This is always sql#aclEntry.
+ "value": "A String", # The whitelisted value for the access control list.
+ "name": "A String", # An optional label to identify this entry.
+ },
+ ],
+ },
+ "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
+ "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+ "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.
+ "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property is only applicable to First Generation instances.
+ "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.
+ "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
+ "storageAutoResize": True or False, # Configuration to increase storage size automatically. The default value is false. Applies only to Second Generation instances.
+ "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance. App Engine co-location is only applicable to First Generation instances.
+ "kind": "sql#locationPreference", # This is always sql#locationPreference.
+ "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
+ "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
+ },
+ "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. Applies only to Second Generation instances.
+ },
+ "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
"replicaConfiguration": { # Read-replica configuration for connecting to the master. # Configuration specific to read-replicas replicating from on-premises masters.
"kind": "sql#replicaConfiguration", # This is always sql#replicaConfiguration.
"failoverTarget": True or False, # Specifies if the replica is the failover target. If the field is set to true the replica will be designated as a failover replica. In case the master instance fails, the replica instance will be promoted as the new master instance.
@@ -1077,100 +1198,7 @@
"connectRetryInterval": 42, # Seconds to wait between connect retries. MySQL's default is 60 seconds.
},
},
- "replicaNames": [ # The replicas of the instance.
- "A String",
- ],
- "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
- "region": "A String", # The geographical region. Can be us-central, asia-east1 or europe-west1. Defaults to us-central. The region can not be changed after instance creation.
- "serverCaCert": { # SslCerts Resource # SSL configuration.
- "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
- "kind": "sql#sslCert", # This is always sql#sslCert.
- "sha1Fingerprint": "A String", # Sha1 Fingerprint.
- "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
- "instance": "A String", # Name of the database instance.
- "cert": "A String", # PEM representation.
- "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
- "selfLink": "A String", # The URI of this resource.
- },
- "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
- "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
- "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
- "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
- # RUNNABLE: The instance is running, or is ready to run when accessed.
- # SUSPENDED: The instance is not available, for example due to problems with billing.
- # PENDING_CREATE: The instance is being created.
- # MAINTENANCE: The instance is down for maintenance.
- # FAILED: The instance creation failed.
- # UNKNOWN_STATE: The state of the instance is unknown.
- "etag": "A String", # HTTP 1.1 Entity tag for the resource.
- "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance.
- "ipAddresses": [ # The assigned IP addresses for the instance.
- { # Database instance IP Mapping.
- "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
- "ipAddress": "A String", # The IP address assigned.
- },
- ],
- "databaseVersion": "A String", # The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_5. The databaseVersion can not be changed after instance creation.
- "settings": { # Database instance settings. # The user settings.
- "databaseFlags": [ # The database flags passed to the instance at startup.
- { # MySQL flags for Cloud SQL instances.
- "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
- "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
- },
- ],
- "kind": "sql#settings", # This is always sql#settings.
- "dataDiskType": "A String", # The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.
- "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes.
- "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
- "updateTrack": "A String",
- "day": 42, # day of week (1-7), starting on Monday.
- "hour": 42, # hour of day - 0 to 23.
- },
- "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance.
- "A String",
- ],
- "activationPolicy": "A 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.
- "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
- "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
- "enabled": True or False, # Whether this configuration is enabled.
- "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
- "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
- },
- "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance.
- "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
- "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
- "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
- { # An entry for an Access Control list.
- "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "kind": "sql#aclEntry", # This is always sql#aclEntry.
- "value": "A String", # The whitelisted value for the access control list.
- "name": "A String", # An optional label to identify this entry.
- },
- ],
- },
- "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
- "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
- "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
- "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.
- "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
- "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
- "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance.
- "kind": "sql#locationPreference", # This is always sql#locationPreference.
- "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
- "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
- },
- "dataDiskSizeGb": "A String", # The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.
- },
- "instanceType": "A String", # The instance type. This can be one of the following.
- # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
- # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
- # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
"selfLink": "A String", # The URI of this resource.
- "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
}
@@ -1678,16 +1706,116 @@
The object takes the form of:
{ # A Cloud SQL instance resource.
+ "backendType": "A String", # FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.
+ # SECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.
+ # EXTERNAL: A MySQL server that is not managed by Google.
+ "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Users should use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ for details.
+ "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance. This property is applicable only to Second Generation instances.
+ "ipAddresses": [ # The assigned IP addresses for the instance.
+ { # Database instance IP Mapping.
+ "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
+ "ipAddress": "A String", # The IP address assigned.
+ },
+ ],
+ "databaseVersion": "A String", # The database engine type and version. The databaseVersion can not be changed after instance creation. Can be MYSQL_5_5, MYSQL_5_6 or MYSQL_5_7. Defaults to MYSQL_5_6. MYSQL_5_7 is applicable only to Second Generation instances.
+ "instanceType": "A String", # The instance type. This can be one of the following.
+ # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
+ # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
+ # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
+ "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
+ "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension.
+ "A String",
+ ],
+ "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
+ "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
+ # RUNNABLE: The instance is running, or is ready to run when accessed.
+ # SUSPENDED: The instance is not available, for example due to problems with billing.
+ # PENDING_CREATE: The instance is being created.
+ # MAINTENANCE: The instance is down for maintenance.
+ # FAILED: The instance creation failed.
+ # UNKNOWN_STATE: The state of the instance is unknown.
+ "etag": "A String", # HTTP 1.1 Entity tag for the resource.
+ "failoverReplica": { # The name and status of the failover replica. This property is applicable only to Second Generation instances.
+ "available": True or False, # The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The master can only failover to the falover replica when the status is true.
+ "name": "A String", # The name of the failover replica.
+ },
+ "replicaNames": [ # The replicas of the instance.
+ "A String",
+ ],
"onPremisesConfiguration": { # On-premises instance configuration. # Configuration specific to on-premises instances.
"kind": "sql#onPremisesConfiguration", # This is always sql#onPremisesConfiguration.
"hostPort": "A String", # The host and port of the on-premises instance in host:port format
},
"kind": "sql#instance", # This is always sql#instance.
- "failoverReplica": { # The name and status of the failover replica. Only applies to Second Generation instances.
- "available": True or False,
- "name": "A String",
+ "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
+ "ipv6Address": "A String", # The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.
+ "serverCaCert": { # SslCerts Resource # SSL configuration.
+ "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
+ "kind": "sql#sslCert", # This is always sql#sslCert.
+ "sha1Fingerprint": "A String", # Sha1 Fingerprint.
+ "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
+ "instance": "A String", # Name of the database instance.
+ "cert": "A String", # PEM representation.
+ "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
+ "selfLink": "A String", # The URI of this resource.
},
- "ipv6Address": "A String", # The IPv6 address assigned to the instance.
+ "region": "A String", # The geographical region. Can be us-central (FIRST_GEN instances only), us-central1 (SECOND_GEN instances only), asia-east1 or europe-west1. Defaults to us-central or us-central1 depending on the instance type (First Generation or Second Generation). The region can not be changed after instance creation.
+ "settings": { # Database instance settings. # The user settings.
+ "databaseFlags": [ # The database flags passed to the instance at startup.
+ { # MySQL flags for Cloud SQL instances.
+ "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
+ "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
+ },
+ ],
+ "kind": "sql#settings", # This is always sql#settings.
+ "dataDiskType": "A String", # The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. Applies only to Second Generation instances.
+ "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. Applies only to Second Generation instances.
+ "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
+ "updateTrack": "A String",
+ "day": 42, # day of week (1-7), starting on Monday.
+ "hour": 42, # hour of day - 0 to 23.
+ },
+ "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.
+ "A String",
+ ],
+ "activationPolicy": "A 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; only applicable to First Generation instances.
+ "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
+ "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
+ "enabled": True or False, # Whether this configuration is enabled.
+ "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
+ "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
+ },
+ "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance. The IPv4 address cannot be disabled for Second Generation instances.
+ "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
+ "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
+ "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
+ { # An entry for an Access Control list.
+ "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
+ "kind": "sql#aclEntry", # This is always sql#aclEntry.
+ "value": "A String", # The whitelisted value for the access control list.
+ "name": "A String", # An optional label to identify this entry.
+ },
+ ],
+ },
+ "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
+ "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+ "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.
+ "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property is only applicable to First Generation instances.
+ "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.
+ "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
+ "storageAutoResize": True or False, # Configuration to increase storage size automatically. The default value is false. Applies only to Second Generation instances.
+ "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance. App Engine co-location is only applicable to First Generation instances.
+ "kind": "sql#locationPreference", # This is always sql#locationPreference.
+ "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
+ "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
+ },
+ "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. Applies only to Second Generation instances.
+ },
+ "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
"replicaConfiguration": { # Read-replica configuration for connecting to the master. # Configuration specific to read-replicas replicating from on-premises masters.
"kind": "sql#replicaConfiguration", # This is always sql#replicaConfiguration.
"failoverTarget": True or False, # Specifies if the replica is the failover target. If the field is set to true the replica will be designated as a failover replica. In case the master instance fails, the replica instance will be promoted as the new master instance.
@@ -1706,100 +1834,7 @@
"connectRetryInterval": 42, # Seconds to wait between connect retries. MySQL's default is 60 seconds.
},
},
- "replicaNames": [ # The replicas of the instance.
- "A String",
- ],
- "project": "A String", # The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.
- "region": "A String", # The geographical region. Can be us-central, asia-east1 or europe-west1. Defaults to us-central. The region can not be changed after instance creation.
- "serverCaCert": { # SslCerts Resource # SSL configuration.
- "certSerialNumber": "A String", # Serial number, as extracted from the certificate.
- "kind": "sql#sslCert", # This is always sql#sslCert.
- "sha1Fingerprint": "A String", # Sha1 Fingerprint.
- "commonName": "A String", # User supplied name. Constrained to [a-zA-Z.-_ ]+.
- "instance": "A String", # Name of the database instance.
- "cert": "A String", # PEM representation.
- "expirationTime": "A String", # The time when the certificate expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "createTime": "A String", # The time when the certificate was created in RFC 3339 format, for example 2012-11-15T16:19:00.094Z
- "selfLink": "A String", # The URI of this resource.
- },
- "masterInstanceName": "A String", # The name of the instance which will act as master in the replication setup.
- "name": "A String", # Name of the Cloud SQL instance. This does not include the project ID.
- "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
- "state": "A String", # The current serving state of the Cloud SQL instance. This can be one of the following.
- # RUNNABLE: The instance is running, or is ready to run when accessed.
- # SUSPENDED: The instance is not available, for example due to problems with billing.
- # PENDING_CREATE: The instance is being created.
- # MAINTENANCE: The instance is down for maintenance.
- # FAILED: The instance creation failed.
- # UNKNOWN_STATE: The state of the instance is unknown.
- "etag": "A String", # HTTP 1.1 Entity tag for the resource.
- "serviceAccountEmailAddress": "A String", # The service account email address assigned to the instance.
- "ipAddresses": [ # The assigned IP addresses for the instance.
- { # Database instance IP Mapping.
- "timeToRetire": "A String", # The due time for this IP to be retired in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. This field is only available when the IP is scheduled to be retired.
- "ipAddress": "A String", # The IP address assigned.
- },
- ],
- "databaseVersion": "A String", # The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_5. The databaseVersion can not be changed after instance creation.
- "settings": { # Database instance settings. # The user settings.
- "databaseFlags": [ # The database flags passed to the instance at startup.
- { # MySQL flags for Cloud SQL instances.
- "name": "A String", # The name of the flag. These flags are passed at instance startup, so include both MySQL server options and MySQL system variables. Flags should be specified with underscores, not hyphens. For more information, see Configuring MySQL Flags in the Google Cloud SQL documentation, as well as the official MySQL documentation for server options and system variables.
- "value": "A String", # The value of the flag. Booleans should be set to on for true and off for false. This field must be omitted if the flag doesn't take a value.
- },
- ],
- "kind": "sql#settings", # This is always sql#settings.
- "dataDiskType": "A String", # The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.
- "maintenanceWindow": { # Maintenance window. This specifies when a v2 Cloud SQL instance should preferably be restarted for system maintenance puruposes. # The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes.
- "kind": "sql#maintenanceWindow", # This is always sql#maintenanceWindow.
- "updateTrack": "A String",
- "day": 42, # day of week (1-7), starting on Monday.
- "hour": 42, # hour of day - 0 to 23.
- },
- "authorizedGaeApplications": [ # The App Engine app IDs that can access this instance.
- "A String",
- ],
- "activationPolicy": "A 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.
- "backupConfiguration": { # Database instance backup configuration. # The daily backup configuration for the instance.
- "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
- "enabled": True or False, # Whether this configuration is enabled.
- "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
- "binaryLogEnabled": True or False, # Whether binary log is enabled. If backup configuration is disabled, binary log must be disabled as well.
- },
- "ipConfiguration": { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance.
- "requireSsl": True or False, # Whether the mysqld should default to 'REQUIRE X509' for users connecting over IP.
- "ipv4Enabled": True or False, # Whether the instance should be assigned an IP address or not.
- "authorizedNetworks": [ # The list of external networks that are allowed to connect to the instance using the IP. In CIDR notation, also known as 'slash' notation (e.g. 192.168.100.0/24).
- { # An entry for an Access Control list.
- "expirationTime": "A String", # The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
- "kind": "sql#aclEntry", # This is always sql#aclEntry.
- "value": "A String", # The whitelisted value for the access control list.
- "name": "A String", # An optional label to identify this entry.
- },
- ],
- },
- "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
- "databaseReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether replication is enabled or not.
- "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
- "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.
- "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
- "settingsVersion": "A String", # The version of instance settings. This is a required field for update method to make sure concurrent updates are handled properly. During update, use the most recent settingsVersion value for this instance and do not try to update this value.
- "locationPreference": { # Preferred location. This specifies where a Cloud SQL instance should preferably be located, either in a specific Compute Engine zone, or co-located with an App Engine application. Note that if the preferred location is not available, the instance will be located as close as possible within the region. Only one location may be specified. # The location preference settings. This allows the instance to be located as near as possible to either an App Engine app or GCE zone for better performance.
- "kind": "sql#locationPreference", # This is always sql#locationPreference.
- "zone": "A String", # The preferred Compute Engine zone (e.g. us-centra1-a, us-central1-b, etc.).
- "followGaeApplication": "A String", # The AppEngine application to follow, it must be in the same region as the Cloud SQL instance.
- },
- "dataDiskSizeGb": "A String", # The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.
- },
- "instanceType": "A String", # The instance type. This can be one of the following.
- # CLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.
- # ON_PREMISES_INSTANCE: An instance running on the customer's premises.
- # READ_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.
"selfLink": "A String", # The URI of this resource.
- "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
}