Api-roll 33: 2016-03-14

discovery/googleapis_beta/sqladmin__v1beta4.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/sqlservice.admin": {
                     "description": "Manage your Google SQL Service instances"
                 }
             }
         }
     },
     "basePath": "/sql/v1beta4/",
     "baseUrl": "https://www.googleapis.com/sql/v1beta4/",
     "batchPath": "batch",
     "canonicalName": "SQL Admin",
     "description": "API for Cloud SQL database instance management.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/sql/docs/reference/latest",
-    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/qz0bCady5PYvTHNrLWveHwsYJ6Q\"",
+    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/OLx7eYKI1NQCi-ys96oQ7ZJUHE8\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "sqladmin:v1beta4",
     "kind": "discovery#restDescription",
     "name": "sqladmin",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 163 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/sqlservice.admin"
                     ]
                 }
             }
         },
         "databases": {
             "methods": {
                 "delete": {
-                    "description": "Deletes a resource containing information about a database inside a Cloud SQL instance.",
+                    "description": "Deletes a database from a Cloud SQL instance.",
                     "httpMethod": "DELETE",
                     "id": "sql.databases.delete",
                     "parameterOrder": [
                         "project",
                         "instance",
                         "database"
                     ],
                     "parameters": {
                         "database": {
                             "description": "Name of the database to be deleted in the instance.",
@@ skipping 223 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/sqlservice.admin"
                     ]
                 }
             }
         },
         "instances": {
             "methods": {
                 "clone": {
-                    "description": "Creates a Cloud SQL instance as a clone of the source instance.",
+                    "description": "Creates a Cloud SQL instance as a clone of the source instance. The API is not ready for Second Generation instances yet.",
                     "httpMethod": "POST",
                     "id": "sql.instances.clone",
                     "parameterOrder": [
                         "project",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "The ID of the Cloud SQL instance to be cloned (source). This does not include the project ID.",
                             "location": "path",
@@ skipping 943 matching lines @@
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/sqlservice.admin"
                     ]
                 }
             }
         }
     },
-    "revision": "20151201",
+    "revision": "20160222",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AclEntry": {
             "description": "An entry for an Access Control list.",
             "id": "AclEntry",
             "properties": {
                 "expirationTime": {
                     "description": "The time when this access control entry expires in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.",
                     "format": "date-time",
                     "type": "string"
@@ skipping 222 matching lines @@
                     "description": "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.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DatabaseInstance": {
             "description": "A Cloud SQL instance resource.",
             "id": "DatabaseInstance",
             "properties": {
+                "backendType": {
+                    "description": "FIRST_GEN: Basic Cloud SQL instance that runs in a Google-managed container.\nSECOND_GEN: A newer Cloud SQL backend that runs in a Compute Engine VM.\nEXTERNAL: A MySQL server that is not managed by Google.",
+                    "type": "string"
+                },
                 "currentDiskSize": {
-                    "description": "The current disk usage of the instance in bytes.",
+                    "description": "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.",
                     "format": "int64",
                     "type": "string"
                 },
                 "databaseVersion": {
-                    "description": "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.",
+                    "description": "The database engine type and version. Can be MYSQL_5_5 or MYSQL_5_6. Defaults to MYSQL_5_6. The databaseVersion can not be changed after instance creation.",
                     "type": "string"
                 },
                 "etag": {
                     "description": "HTTP 1.1 Entity tag for the resource.",
                     "type": "string"
                 },
                 "failoverReplica": {
-                    "description": "The name and status of the failover replica. Only applies to Second Generation instances.",
+                    "description": "The name and status of the failover replica. This property is applicable only to Second Generation instances.",
                     "properties": {
                         "available": {
+                            "description": "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.",
                             "type": "boolean"
                         },
                         "name": {
+                            "description": "The name of the failover replica.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "instanceType": {
                     "description": "The instance type. This can be one of the following.\nCLOUD_SQL_INSTANCE: A Cloud SQL instance that is not replicating from a master.\nON_PREMISES_INSTANCE: An instance running on the customer's premises.\nREAD_REPLICA_INSTANCE: A Cloud SQL instance configured as a read-replica.",
                     "type": "string"
                 },
                 "ipAddresses": {
                     "description": "The assigned IP addresses for the instance.",
                     "items": {
                         "$ref": "IpMapping"
                     },
                     "type": "array"
                 },
                 "ipv6Address": {
-                    "description": "The IPv6 address assigned to the instance.",
+                    "description": "The IPv6 address assigned to the instance. This property is applicable only to First Generation instances.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "sql#instance",
                     "description": "This is always sql#instance.",
                     "type": "string"
                 },
                 "masterInstanceName": {
                     "description": "The name of the instance which will act as master in the replication setup.",
                     "type": "string"
@@ skipping 14 matching lines @@
                 },
                 "onPremisesConfiguration": {
                     "$ref": "OnPremisesConfiguration",
                     "description": "Configuration specific to on-premises instances."
                 },
                 "project": {
                     "description": "The project ID of the project containing the Cloud SQL instance. The Google apps domain is prefixed if applicable.",
                     "type": "string"
                 },
                 "region": {
-                    "description": "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.",
+                    "description": "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.",
                     "type": "string"
                 },
                 "replicaConfiguration": {
                     "$ref": "ReplicaConfiguration",
                     "description": "Configuration specific to read-replicas replicating from on-premises masters."
                 },
                 "replicaNames": {
                     "description": "The replicas of the instance.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "selfLink": {
                     "description": "The URI of this resource.",
                     "type": "string"
                 },
                 "serverCaCert": {
                     "$ref": "SslCert",
                     "description": "SSL configuration."
                 },
                 "serviceAccountEmailAddress": {
-                    "description": "The service account email address assigned to the instance.",
+                    "description": "The service account email address assigned to the instance. This property is applicable only to Second Generation instances.",
                     "type": "string"
                 },
                 "settings": {
                     "$ref": "Settings",
                     "annotations": {
                         "required": [
                             "sql.instances.insert",
                             "sql.instances.update"
                         ]
                     },
                     "description": "The user settings."
                 },
                 "state": {
                     "description": "The current serving state of the Cloud SQL instance. This can be one of the following.\nRUNNABLE: The instance is running, or is ready to run when accessed.\nSUSPENDED: The instance is not available, for example due to problems with billing.\nPENDING_CREATE: The instance is being created.\nMAINTENANCE: The instance is down for maintenance.\nFAILED: The instance creation failed.\nUNKNOWN_STATE: The state of the instance is unknown.",
                     "type": "string"
+                },
+                "suspensionReason": {
+                    "description": "If the instance state is SUSPENDED, the reason for the suspension.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
                 }
             },
             "type": "object"
         },
         "DatabasesListResponse": {
             "description": "Database list response.",
             "id": "DatabasesListResponse",
             "properties": {
                 "items": {
                     "description": "List of database resources in the instance.",
@@ skipping 597 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Settings": {
             "description": "Database instance settings.",
             "id": "Settings",
             "properties": {
                 "activationPolicy": {
-                    "description": "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.\nALWAYS: The instance should always be active.\nNEVER: The instance should never be activated.\nON_DEMAND: The instance is activated upon receiving requests.",
+                    "description": "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.\nALWAYS: The instance should always be active.\nNEVER: The instance should never be activated.\nON_DEMAND: The instance is activated upon receiving requests; only applicable to First Generation instances.",
                     "type": "string"
                 },
                 "authorizedGaeApplications": {
-                    "description": "The App Engine app IDs that can access this instance.",
+                    "description": "The App Engine app IDs that can access this instance. This property is only applicable to First Generation instances.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "backupConfiguration": {
                     "$ref": "BackupConfiguration",
                     "description": "The daily backup configuration for the instance."
                 },
                 "crashSafeReplicationEnabled": {
-                    "description": "Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled.",
+                    "description": "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.",
                     "type": "boolean"
                 },
                 "dataDiskSizeGb": {
-                    "description": "The size of data disk, in GB. Only supported for 2nd Generation instances. The data disk size minimum is 10GB.",
+                    "description": "The size of data disk, in GB. The data disk size minimum is 10GB. This property is only applicable to Second Generation instances.",
                     "format": "int64",
                     "type": "string"
                 },
                 "dataDiskType": {
-                    "description": "The type of data disk. Only supported for 2nd Generation instances. The default type is SSD.",
+                    "description": "The type of data disk. Only supported for Second Generation instances. The default type is PD_SSD. This property is only applicable to Second Generation instances.",
                     "type": "string"
                 },
                 "databaseFlags": {
                     "description": "The database flags passed to the instance at startup.",
                     "items": {
                         "$ref": "DatabaseFlags"
                     },
                     "type": "array"
                 },
                 "databaseReplicationEnabled": {
                     "description": "Configuration specific to read replica instances. Indicates whether replication is enabled or not.",
                     "type": "boolean"
                 },
                 "ipConfiguration": {
                     "$ref": "IpConfiguration",
-                    "description": "The settings for IP Management. This allows to enable or disable the instance IP and manage which external networks can connect to the instance."
+                    "description": "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."
                 },
                 "kind": {
                     "default": "sql#settings",
                     "description": "This is always sql#settings.",
                     "type": "string"
                 },
                 "locationPreference": {
                     "$ref": "LocationPreference",
-                    "description": "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."
+                    "description": "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."
                 },
                 "maintenanceWindow": {
                     "$ref": "MaintenanceWindow",
-                    "description": "The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes."
+                    "description": "The maintenance window for this instance. This specifies when the instance may be restarted for maintenance purposes. This property is only applicable to Second Generation instances."
                 },
                 "pricingPlan": {
-                    "description": "The pricing plan for this instance. This can be either PER_USE or PACKAGE.",
+                    "description": "The pricing plan for this instance. This can be either PER_USE or PACKAGE. Only PER_USE is supported for Second Generation instances.",
                     "type": "string"
                 },
                 "replicationType": {
-                    "description": "The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.",
+                    "description": "The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS. This property is only applicable to First Generation instances.",
                     "type": "string"
                 },
                 "settingsVersion": {
                     "annotations": {
                         "required": [
                             "sql.instances.update"
                         ]
                     },
                     "description": "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.",
                     "format": "int64",
@@ skipping 188 matching lines @@
         },
         "User": {
             "description": "A Cloud SQL user resource.",
             "id": "User",
             "properties": {
                 "etag": {
                     "description": "HTTP 1.1 Entity tag for the resource.",
                     "type": "string"
                 },
                 "host": {
-                    "description": "The host name from which the user can connect. For insert operations, host defaults to an empty string. For update operations, host is specified as part of the request URL. The host name is not mutable with this API.",
+                    "description": "The host name from which the user can connect. For insert operations, host defaults to an empty string. For update operations, host is specified as part of the request URL. The host name cannot be updated after insertion.",
                     "type": "string"
                 },
                 "instance": {
                     "description": "The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for update since it is already specified on the URL.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "sql#user",
                     "description": "This is always sql#user.",
                     "type": "string"
@@ skipping 34 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "sql/v1beta4/",
     "title": "Cloud SQL Administration API",
     "version": "v1beta4"
 }