Api-Roll 54: 2017-09-11

generated/googleapis_beta/lib/oslogin/v1alpha.dart

Index: generated/googleapis_beta/lib/oslogin/v1alpha.dart
diff --git a/generated/googleapis_beta/lib/oslogin/v1alpha.dart b/generated/googleapis_beta/lib/oslogin/v1alpha.dart
index 091c0a447c5cef355bb4d8188353f7172a85a1c2..ef25b3d4b7dc6c959dca3e767864925e48bc1673 100644
--- a/generated/googleapis_beta/lib/oslogin/v1alpha.dart
+++ b/generated/googleapis_beta/lib/oslogin/v1alpha.dart
@@ -9,54 +9,56 @@ import 'dart:convert' as convert;
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
-export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
-    ApiRequestError, DetailedApiRequestError;
+export 'package:_discoveryapis_commons/_discoveryapis_commons.dart'
+    show ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client oslogin/v1alpha';
 
-/** Manages OS login configuration for Directory API users. */
+/// Manages OS login configuration for Directory API users.
 class OsloginApi {
-  /** View and manage your data across Google Cloud Platform services */
-  static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
-
-  /** View your data across Google Cloud Platform services */
-  static const CloudPlatformReadOnlyScope = "https://www.googleapis.com/auth/cloud-platform.read-only";
+  /// View and manage your data across Google Cloud Platform services
+  static const CloudPlatformScope =
+      "https://www.googleapis.com/auth/cloud-platform";
 
+  /// View your data across Google Cloud Platform services
+  static const CloudPlatformReadOnlyScope =
+      "https://www.googleapis.com/auth/cloud-platform.read-only";
 
   final commons.ApiRequester _requester;
 
   UsersResourceApi get users => new UsersResourceApi(_requester);
 
-  OsloginApi(http.Client client, {core.String rootUrl: "https://oslogin.googleapis.com/", core.String servicePath: ""}) :
-      _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
+  OsloginApi(http.Client client,
+      {core.String rootUrl: "https://oslogin.googleapis.com/",
+      core.String servicePath: ""})
+      : _requester =
+            new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
-
 class UsersResourceApi {
   final commons.ApiRequester _requester;
 
-  UsersSshPublicKeysResourceApi get sshPublicKeys => new UsersSshPublicKeysResourceApi(_requester);
-
-  UsersResourceApi(commons.ApiRequester client) : 
-      _requester = client;
-
-  /**
-   * Retrieves the profile information used for logging in to a virtual machine
-   * on Google Compute Engine.
-   *
-   * Request parameters:
-   *
-   * [name] - The unique ID for the user in format `users/{user}`.
-   * Value must have pattern "^users/[^/]+$".
-   *
-   * Completes with a [LoginProfile].
-   *
-   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
-   * error.
-   *
-   * If the used [http.Client] completes with an error when making a REST call,
-   * this method will complete with the same error.
-   */
+  UsersSshPublicKeysResourceApi get sshPublicKeys =>
+      new UsersSshPublicKeysResourceApi(_requester);
+
+  UsersResourceApi(commons.ApiRequester client) : _requester = client;
+
+  /// Retrieves the profile information used for logging in to a virtual
+  /// machine
+  /// on Google Compute Engine.
+  ///
+  /// Request parameters:
+  ///
+  /// [name] - The unique ID for the user in format `users/{user}`.
+  /// Value must have pattern "^users/[^/]+$".
+  ///
+  /// Completes with a [LoginProfile].
+  ///
+  /// Completes with a [commons.ApiRequestError] if the API endpoint returned
+  /// an error.
+  ///
+  /// If the used [http.Client] completes with an error when making a REST
+  /// call, this method will complete with the same error.
   async.Future<LoginProfile> getLoginProfile(core.String name) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -69,39 +71,39 @@ class UsersResourceApi {
       throw new core.ArgumentError("Parameter name is required.");
     }
 
-    _url = 'v1alpha/' + commons.Escaper.ecapeVariableReserved('$name') + '/loginProfile';
+    _url = 'v1alpha/' +
+        commons.Escaper.ecapeVariableReserved('$name') +
+        '/loginProfile';
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "GET",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => new LoginProfile.fromJson(data));
   }
 
-  /**
-   * Adds an SSH public key and returns the profile information. Default POSIX
-   * account information is set when no username and UID exist as part of the
-   * login profile.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * [parent] - The unique ID for the user in format `users/{user}`.
-   * Value must have pattern "^users/[^/]+$".
-   *
-   * Completes with a [ImportSshPublicKeyResponse].
-   *
-   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
-   * error.
-   *
-   * If the used [http.Client] completes with an error when making a REST call,
-   * this method will complete with the same error.
-   */
-  async.Future<ImportSshPublicKeyResponse> importSshPublicKey(SshPublicKey request, core.String parent) {
+  /// Adds an SSH public key and returns the profile information. Default POSIX
+  /// account information is set when no username and UID exist as part of the
+  /// login profile.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// [parent] - The unique ID for the user in format `users/{user}`.
+  /// Value must have pattern "^users/[^/]+$".
+  ///
+  /// Completes with a [ImportSshPublicKeyResponse].
+  ///
+  /// Completes with a [commons.ApiRequestError] if the API endpoint returned
+  /// an error.
+  ///
+  /// If the used [http.Client] completes with an error when making a REST
+  /// call, this method will complete with the same error.
+  async.Future<ImportSshPublicKeyResponse> importSshPublicKey(
+      SshPublicKey request, core.String parent) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -116,46 +118,44 @@ class UsersResourceApi {
       throw new core.ArgumentError("Parameter parent is required.");
     }
 
-    _url = 'v1alpha/' + commons.Escaper.ecapeVariableReserved('$parent') + ':importSshPublicKey';
+    _url = 'v1alpha/' +
+        commons.Escaper.ecapeVariableReserved('$parent') +
+        ':importSshPublicKey';
 
-    var _response = _requester.request(_url,
-                                       "POST",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new ImportSshPublicKeyResponse.fromJson(data));
+    var _response = _requester.request(_url, "POST",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response
+        .then((data) => new ImportSshPublicKeyResponse.fromJson(data));
   }
-
 }
 
-
 class UsersSshPublicKeysResourceApi {
   final commons.ApiRequester _requester;
 
-  UsersSshPublicKeysResourceApi(commons.ApiRequester client) : 
-      _requester = client;
-
-  /**
-   * Deletes an SSH public key.
-   *
-   * Request parameters:
-   *
-   * [name] - The fingerprint of the public key to update. Public keys are
-   * identified by
-   * their SHA-256 fingerprint. The fingerprint of the public key is in format
-   * `users/{user}/sshPublicKeys/{fingerprint}`.
-   * Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
-   *
-   * Completes with a [Empty].
-   *
-   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
-   * error.
-   *
-   * If the used [http.Client] completes with an error when making a REST call,
-   * this method will complete with the same error.
-   */
+  UsersSshPublicKeysResourceApi(commons.ApiRequester client)
+      : _requester = client;
+
+  /// Deletes an SSH public key.
+  ///
+  /// Request parameters:
+  ///
+  /// [name] - The fingerprint of the public key to update. Public keys are
+  /// identified by
+  /// their SHA-256 fingerprint. The fingerprint of the public key is in format
+  /// `users/{user}/sshPublicKeys/{fingerprint}`.
+  /// Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
+  ///
+  /// Completes with a [Empty].
+  ///
+  /// Completes with a [commons.ApiRequestError] if the API endpoint returned
+  /// an error.
+  ///
+  /// If the used [http.Client] completes with an error when making a REST
+  /// call, this method will complete with the same error.
   async.Future<Empty> delete(core.String name) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -170,35 +170,32 @@ class UsersSshPublicKeysResourceApi {
 
     _url = 'v1alpha/' + commons.Escaper.ecapeVariableReserved('$name');
 
-    var _response = _requester.request(_url,
-                                       "DELETE",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "DELETE",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => new Empty.fromJson(data));
   }
 
-  /**
-   * Retrieves an SSH public key.
-   *
-   * Request parameters:
-   *
-   * [name] - The fingerprint of the public key to retrieve. Public keys are
-   * identified
-   * by their SHA-256 fingerprint. The fingerprint of the public key is in
-   * format `users/{user}/sshPublicKeys/{fingerprint}`.
-   * Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
-   *
-   * Completes with a [SshPublicKey].
-   *
-   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
-   * error.
-   *
-   * If the used [http.Client] completes with an error when making a REST call,
-   * this method will complete with the same error.
-   */
+  /// Retrieves an SSH public key.
+  ///
+  /// Request parameters:
+  ///
+  /// [name] - The fingerprint of the public key to retrieve. Public keys are
+  /// identified
+  /// by their SHA-256 fingerprint. The fingerprint of the public key is in
+  /// format `users/{user}/sshPublicKeys/{fingerprint}`.
+  /// Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
+  ///
+  /// Completes with a [SshPublicKey].
+  ///
+  /// Completes with a [commons.ApiRequestError] if the API endpoint returned
+  /// an error.
+  ///
+  /// If the used [http.Client] completes with an error when making a REST
+  /// call, this method will complete with the same error.
   async.Future<SshPublicKey> get(core.String name) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -213,42 +210,41 @@ class UsersSshPublicKeysResourceApi {
 
     _url = 'v1alpha/' + commons.Escaper.ecapeVariableReserved('$name');
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "GET",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => new SshPublicKey.fromJson(data));
   }
 
-  /**
-   * Updates an SSH public key and returns the profile information. This method
-   * supports patch semantics.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * [name] - The fingerprint of the public key to update. Public keys are
-   * identified by
-   * their SHA-256 fingerprint. The fingerprint of the public key is in format
-   * `users/{user}/sshPublicKeys/{fingerprint}`.
-   * Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
-   *
-   * [updateMask] - Mask to control which fields get updated. Updates all if not
-   * present.
-   *
-   * Completes with a [SshPublicKey].
-   *
-   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
-   * error.
-   *
-   * If the used [http.Client] completes with an error when making a REST call,
-   * this method will complete with the same error.
-   */
-  async.Future<SshPublicKey> patch(SshPublicKey request, core.String name, {core.String updateMask}) {
+  /// Updates an SSH public key and returns the profile information. This
+  /// method
+  /// supports patch semantics.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// [name] - The fingerprint of the public key to update. Public keys are
+  /// identified by
+  /// their SHA-256 fingerprint. The fingerprint of the public key is in format
+  /// `users/{user}/sshPublicKeys/{fingerprint}`.
+  /// Value must have pattern "^users/[^/]+/sshPublicKeys/[^/]+$".
+  ///
+  /// [updateMask] - Mask to control which fields get updated. Updates all if
+  /// not present.
+  ///
+  /// Completes with a [SshPublicKey].
+  ///
+  /// Completes with a [commons.ApiRequestError] if the API endpoint returned
+  /// an error.
+  ///
+  /// If the used [http.Client] completes with an error when making a REST
+  /// call, this method will complete with the same error.
+  async.Future<SshPublicKey> patch(SshPublicKey request, core.String name,
+      {core.String updateMask}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -268,47 +264,40 @@ class UsersSshPublicKeysResourceApi {
 
     _url = 'v1alpha/' + commons.Escaper.ecapeVariableReserved('$name');
 
-    var _response = _requester.request(_url,
-                                       "PATCH",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "PATCH",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => new SshPublicKey.fromJson(data));
   }
-
 }
 
-
-
-/**
- * A generic empty message that you can re-use to avoid defining duplicated
- * empty messages in your APIs. A typical example is to use it as the request
- * or the response type of an API method. For instance:
- *
- *     service Foo {
- *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- *     }
- *
- * The JSON representation for `Empty` is empty JSON object `{}`.
- */
+/// A generic empty message that you can re-use to avoid defining duplicated
+/// empty messages in your APIs. A typical example is to use it as the request
+/// or the response type of an API method. For instance:
+///
+///     service Foo {
+///       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+///     }
+///
+/// The JSON representation for `Empty` is empty JSON object `{}`.
 class Empty {
-
   Empty();
 
-  Empty.fromJson(core.Map _json) {
-  }
+  Empty.fromJson(core.Map _json) {}
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     return _json;
   }
 }
 
-/** A response message for importing an SSH public key. */
+/// A response message for importing an SSH public key.
 class ImportSshPublicKeyResponse {
-  /** The login profile information for the user. */
+  /// The login profile information for the user.
   LoginProfile loginProfile;
 
   ImportSshPublicKeyResponse();
@@ -320,7 +309,8 @@ class ImportSshPublicKeyResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (loginProfile != null) {
       _json["loginProfile"] = (loginProfile).toJson();
     }
@@ -328,18 +318,19 @@ class ImportSshPublicKeyResponse {
   }
 }
 
-/**
- * The Directory API profile information used for logging in to a virtual
- * machine on Google Compute Engine.
- */
+/// The Directory API profile information used for logging in to a virtual
+/// machine on Google Compute Engine.
 class LoginProfile {
-  /** A unique user ID for identifying the user. */
+  /// A unique user ID for identifying the user.
   core.String name;
-  /** The list of POSIX accounts associated with the Directory API user. */
+
+  /// The list of POSIX accounts associated with the Directory API user.
   core.List<PosixAccount> posixAccounts;
-  /** A map from SSH public key fingerprint to the associated key object. */
+
+  /// A map from SSH public key fingerprint to the associated key object.
   core.Map<core.String, SshPublicKey> sshPublicKeys;
-  /** Indicates if the user is suspended. */
+
+  /// Indicates if the user is suspended.
   core.bool suspended;
 
   LoginProfile();
@@ -349,10 +340,16 @@ class LoginProfile {
       name = _json["name"];
     }
     if (_json.containsKey("posixAccounts")) {
-      posixAccounts = _json["posixAccounts"].map((value) => new PosixAccount.fromJson(value)).toList();
+      posixAccounts = _json["posixAccounts"]
+          .map((value) => new PosixAccount.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("sshPublicKeys")) {
-      sshPublicKeys = commons.mapMap<core.Map<core.String, core.Object>, SshPublicKey>(_json["sshPublicKeys"], (core.Map<core.String, core.Object> item) => new SshPublicKey.fromJson(item));
+      sshPublicKeys =
+          commons.mapMap<core.Map<core.String, core.Object>, SshPublicKey>(
+              _json["sshPublicKeys"],
+              (core.Map<core.String, core.Object> item) =>
+                  new SshPublicKey.fromJson(item));
     }
     if (_json.containsKey("suspended")) {
       suspended = _json["suspended"];
@@ -360,15 +357,19 @@ class LoginProfile {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (name != null) {
       _json["name"] = name;
     }
     if (posixAccounts != null) {
-      _json["posixAccounts"] = posixAccounts.map((value) => (value).toJson()).toList();
+      _json["posixAccounts"] =
+          posixAccounts.map((value) => (value).toJson()).toList();
     }
     if (sshPublicKeys != null) {
-      _json["sshPublicKeys"] = commons.mapMap<SshPublicKey, core.Map<core.String, core.Object>>(sshPublicKeys, (SshPublicKey item) => (item).toJson());
+      _json["sshPublicKeys"] =
+          commons.mapMap<SshPublicKey, core.Map<core.String, core.Object>>(
+              sshPublicKeys, (SshPublicKey item) => (item).toJson());
     }
     if (suspended != null) {
       _json["suspended"] = suspended;
@@ -377,26 +378,31 @@ class LoginProfile {
   }
 }
 
-/** The POSIX account information associated with a Directory API User. */
+/// The POSIX account information associated with a Directory API User.
 class PosixAccount {
-  /** The GECOS (user information) entry for this account. */
+  /// The GECOS (user information) entry for this account.
   core.String gecos;
-  /** The default group ID. */
+
+  /// The default group ID.
   core.int gid;
-  /** The path to the home directory for this account. */
+
+  /// The path to the home directory for this account.
   core.String homeDirectory;
-  /** Only one POSIX account can be marked as primary. */
+
+  /// Only one POSIX account can be marked as primary.
   core.bool primary;
-  /** The path to the logic shell for this account. */
+
+  /// The path to the logic shell for this account.
   core.String shell;
-  /**
-   * System identifier for which account the username or uid applies to.
-   * By default, the empty value is used.
-   */
+
+  /// System identifier for which account the username or uid applies to.
+  /// By default, the empty value is used.
   core.String systemId;
-  /** The user ID. */
+
+  /// The user ID.
   core.int uid;
-  /** The username of the POSIX account. */
+
+  /// The username of the POSIX account.
   core.String username;
 
   PosixAccount();
@@ -429,7 +435,8 @@ class PosixAccount {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (gecos != null) {
       _json["gecos"] = gecos;
     }
@@ -458,17 +465,18 @@ class PosixAccount {
   }
 }
 
-/** The SSH public key information associated with a Directory API User. */
+/// The SSH public key information associated with a Directory API User.
 class SshPublicKey {
-  /** An expiration time in microseconds since epoch. */
+  /// An expiration time in microseconds since epoch.
   core.String expirationTimeUsec;
-  /** [Output Only] The SHA-256 fingerprint of the SSH public key. */
+
+  /// [Output Only] The SHA-256 fingerprint of the SSH public key.
   core.String fingerprint;
-  /**
-   * Public key text in SSH format, defined by
-   * <a href="https://www.ietf.org/rfc/rfc4253.txt" target="_blank">RFC4253</a>
-   * section 6.6.
-   */
+
+  /// Public key text in SSH format, defined by
+  /// <a href="https://www.ietf.org/rfc/rfc4253.txt"
+  /// target="_blank">RFC4253</a>
+  /// section 6.6.
   core.String key;
 
   SshPublicKey();
@@ -486,7 +494,8 @@ class SshPublicKey {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (expirationTimeUsec != null) {
       _json["expirationTimeUsec"] = expirationTimeUsec;
     }