Api-roll 33: 2016-03-14

generated/googleapis_beta/lib/sqladmin/v1beta4.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.sqladmin.v1beta4;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 192 matching lines @@
 }
 
 
 class DatabasesResourceApi {
   final commons.ApiRequester _requester;
 
   DatabasesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes a resource containing information about a database inside a Cloud
-   * SQL instance.
+   * Deletes a database from a Cloud SQL instance.
    *
    * Request parameters:
    *
    * [project] - Project ID of the project that contains the instance.
    *
    * [instance] - Database instance ID. This does not include the project ID.
    *
    * [database] - Name of the database to be deleted in the instance.
    *
    * Completes with a [Operation].
@@ skipping 335 matching lines @@
 }
 
 
 class InstancesResourceApi {
   final commons.ApiRequester _requester;
 
   InstancesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Creates a Cloud SQL instance as a clone of the source instance.
+   * Creates a Cloud SQL instance as a clone of the source instance. The API is
+   * not ready for Second Generation instances yet.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID of the source as well as the clone Cloud SQL
    * instance.
    *
    * [instance] - The ID of the Cloud SQL instance to be cloned (source). This
    * does not include the project ID.
@@ skipping 1845 matching lines @@
       _json["name"] = name;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /**
- * The name and status of the failover replica. Only applies to Second
- * Generation instances.
+ * The name and status of the failover replica. This property is applicable only
+ * to Second Generation instances.
  */
 class DatabaseInstanceFailoverReplica {
+  /**
+   * 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.
+   */
   core.bool available;
+  /** The name of the failover replica. */
   core.String name;
 
   DatabaseInstanceFailoverReplica();
 
   DatabaseInstanceFailoverReplica.fromJson(core.Map _json) {
     if (_json.containsKey("available")) {
       available = _json["available"];
     }
     if (_json.containsKey("name")) {
       name = _json["name"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (available != null) {
       _json["available"] = available;
     }
     if (name != null) {
       _json["name"] = name;
     }
     return _json;
   }
 }
 
 /** A Cloud SQL instance resource. */
 class DatabaseInstance {
-  /** The current disk usage of the instance in bytes. */
+  /**
+   * 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.
+   */
+  core.String backendType;
+  /**
+   * 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.
+   */
   core.String currentDiskSize;
   /**
    * 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
+   * Defaults to MYSQL_5_6. The databaseVersion can not be changed after
    * instance creation.
    */
   core.String databaseVersion;
   /** HTTP 1.1 Entity tag for the resource. */
   core.String etag;
   /**
-   * The name and status of the failover replica. Only applies to Second
-   * Generation instances.
+   * The name and status of the failover replica. This property is applicable
+   * only to Second Generation instances.
    */
   DatabaseInstanceFailoverReplica failoverReplica;
   /**
    * 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.
    */
   core.String instanceType;
   /** The assigned IP addresses for the instance. */
   core.List<IpMapping> ipAddresses;
-  /** The IPv6 address assigned to the instance. */
+  /**
+   * The IPv6 address assigned to the instance. This property is applicable only
+   * to First Generation instances.
+   */
   core.String ipv6Address;
   /** This is always sql#instance. */
   core.String kind;
   /**
    * The name of the instance which will act as master in the replication setup.
    */
   core.String masterInstanceName;
   /** The maximum disk size of the instance in bytes. */
   core.String maxDiskSize;
   /** Name of the Cloud SQL instance. This does not include the project ID. */
   core.String name;
   /** Configuration specific to on-premises instances. */
   OnPremisesConfiguration onPremisesConfiguration;
   /**
    * The project ID of the project containing the Cloud SQL instance. The Google
    * apps domain is prefixed if applicable.
    */
   core.String project;
   /**
-   * 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.
+   * 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.
    */
   core.String region;
   /**
    * Configuration specific to read-replicas replicating from on-premises
    * masters.
    */
   ReplicaConfiguration replicaConfiguration;
   /** The replicas of the instance. */
   core.List<core.String> replicaNames;
   /** The URI of this resource. */
   core.String selfLink;
   /** SSL configuration. */
   SslCert serverCaCert;
-  /** The service account email address assigned to the instance. */
+  /**
+   * The service account email address assigned to the instance. This property
+   * is applicable only to Second Generation instances.
+   */
   core.String serviceAccountEmailAddress;
   /** The user settings. */
   Settings settings;
   /**
    * 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.
    */
   core.String state;
+  /** If the instance state is SUSPENDED, the reason for the suspension. */
+  core.List<core.String> suspensionReason;
 
   DatabaseInstance();
 
   DatabaseInstance.fromJson(core.Map _json) {
+    if (_json.containsKey("backendType")) {
+      backendType = _json["backendType"];
+    }
     if (_json.containsKey("currentDiskSize")) {
       currentDiskSize = _json["currentDiskSize"];
     }
     if (_json.containsKey("databaseVersion")) {
       databaseVersion = _json["databaseVersion"];
     }
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
     if (_json.containsKey("failoverReplica")) {
@@ skipping 43 matching lines @@
     }
     if (_json.containsKey("serviceAccountEmailAddress")) {
       serviceAccountEmailAddress = _json["serviceAccountEmailAddress"];
     }
     if (_json.containsKey("settings")) {
       settings = new Settings.fromJson(_json["settings"]);
     }
     if (_json.containsKey("state")) {
       state = _json["state"];
     }
+    if (_json.containsKey("suspensionReason")) {
+      suspensionReason = _json["suspensionReason"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (backendType != null) {
+      _json["backendType"] = backendType;
+    }
     if (currentDiskSize != null) {
       _json["currentDiskSize"] = currentDiskSize;
     }
     if (databaseVersion != null) {
       _json["databaseVersion"] = databaseVersion;
     }
     if (etag != null) {
       _json["etag"] = etag;
     }
     if (failoverReplica != null) {
@@ skipping 43 matching lines @@
     }
     if (serviceAccountEmailAddress != null) {
       _json["serviceAccountEmailAddress"] = serviceAccountEmailAddress;
     }
     if (settings != null) {
       _json["settings"] = (settings).toJson();
     }
     if (state != null) {
       _json["state"] = state;
     }
+    if (suspensionReason != null) {
+      _json["suspensionReason"] = suspensionReason;
+    }
     return _json;
   }
 }
 
 /** Database list response. */
 class DatabasesListResponse {
   /** List of database resources in the instance. */
   core.List<Database> items;
   /** This is always sql#databasesList. */
   core.String kind;
@@ skipping 1242 matching lines @@
 }
 
 /** Database instance settings. */
 class Settings {
   /**
    * 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.
+   * ON_DEMAND: The instance is activated upon receiving requests; only
+   * applicable to First Generation instances.
    */
   core.String activationPolicy;
-  /** The App Engine app IDs that can access this instance. */
+  /**
+   * The App Engine app IDs that can access this instance. This property is only
+   * applicable to First Generation instances.
+   */
   core.List<core.String> authorizedGaeApplications;
   /** The daily backup configuration for the instance. */
   BackupConfiguration backupConfiguration;
   /**
    * Configuration specific to read replica instances. Indicates whether
-   * database flags for crash-safe replication are enabled.
+   * database flags for crash-safe replication are enabled. This property is
+   * only applicable to First Generation instances.
    */
   core.bool crashSafeReplicationEnabled;
   /**
-   * The size of data disk, in GB. Only supported for 2nd Generation instances.
-   * The data disk size minimum is 10GB.
+   * The size of data disk, in GB. The data disk size minimum is 10GB. This
+   * property is only applicable to Second Generation instances.
    */
   core.String dataDiskSizeGb;
   /**
-   * The type of data disk. Only supported for 2nd Generation instances. The
-   * default type is SSD.
+   * 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.
    */
   core.String dataDiskType;
   /** The database flags passed to the instance at startup. */
   core.List<DatabaseFlags> databaseFlags;
   /**
    * Configuration specific to read replica instances. Indicates whether
    * replication is enabled or not.
    */
   core.bool databaseReplicationEnabled;
   /**
    * 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.
    */
   IpConfiguration ipConfiguration;
   /** This is always sql#settings. */
   core.String kind;
   /**
    * 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.
+   * performance. App Engine co-location is only applicable to First Generation
+   * instances.
    */
   LocationPreference locationPreference;
   /**
    * The maintenance window for this instance. This specifies when the instance
-   * may be restarted for maintenance purposes.
+   * may be restarted for maintenance purposes. This property is only applicable
+   * to Second Generation instances.
    */
   MaintenanceWindow maintenanceWindow;
   /**
    * The pricing plan for this instance. This can be either PER_USE or PACKAGE.
+   * Only PER_USE is supported for Second Generation instances.
    */
   core.String pricingPlan;
   /**
    * The type of replication this instance uses. This can be either ASYNCHRONOUS
-   * or SYNCHRONOUS.
+   * or SYNCHRONOUS. This property is only applicable to First Generation
+   * instances.
    */
   core.String replicationType;
   /**
    * 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.
    */
   core.String settingsVersion;
   /**
@@ skipping 447 matching lines @@
   }
 }
 
 /** A Cloud SQL user resource. */
 class User {
   /** HTTP 1.1 Entity tag for the resource. */
   core.String etag;
   /**
    * 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.
+   * part of the request URL. The host name cannot be updated after insertion.
    */
   core.String host;
   /**
    * 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.
    */
   core.String instance;
   /** This is always sql#user. */
   core.String kind;
   /**
@@ skipping 97 matching lines @@
     }
     if (kind != null) {
       _json["kind"] = kind;
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     return _json;
   }
 }