google-cloud-os_login-v1beta 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 991ec6a6faff76e98b0e91ad50780ff022bca2147ba41049860f675eadfed0a2
-  data.tar.gz: c158f8415f71f8f00db4f99ef73c0d1dbb014b55331240877a0f73f70bff11a4
+  metadata.gz: 90df7c4342d79edc96c3cd59dd5355ee46a96a1b9fa3ed40a21ed2545bfbde3e
+  data.tar.gz: 262ce1289795bfb38f83cbc456002c12ac335212490802e91589717b3d655d7c
 SHA512:
-  metadata.gz: 1dd564255d4d46c2bf2a98ac056c8cbcd4b916a4e4231ca5d344e8169cdab4536eaeed41fa9ba5e6244e47a953d8818c9382c0ba420a99ba5d4c9cedc6a27bda
-  data.tar.gz: 83cf2133f3d3527d0af113db977be7e0129123354917f71681dc4c35e302a4e85481afe3d6b4eec3ea5f28ea1c2e46725e58df194c4fb7acee797d609eed0d44
+  metadata.gz: 1f3f9ba3678c3a61ad28da1fc7959e13c0275683b8e935c4dad670c547c5f45ebee4606532c56c5cbdfa23f1f7b84604e252528e73ac117b6be96be04715fb97
+  data.tar.gz: 4ac32d535934eff6f604dcadfb2f5df5e86bd43a09198a8d8ed0b0beddcce1737e46c28aa64c1d3a5fa360cea862180f0c5c243e6c0d87e9706a8db485d2d2bc

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud OS Login V1beta API
 
-API Client library for the Cloud OS Login V1beta API
+You can use OS Login to manage access to your VM instances using IAM roles.
 
 Use OS Login to manage SSH access to your instances using IAM without having to create and manage individual SSH keys. OS Login maintains a consistent Linux user identity across VM instances and is the recommended way to manage many users across multiple instances or projects.
 
@@ -33,8 +33,8 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/os_login/v1beta"
 
 client = ::Google::Cloud::OsLogin::V1beta::OsLoginService::Client.new
-request = ::Google::Cloud::OsLogin::V1beta::DeletePosixAccountRequest.new # (request fields as keyword arguments...)
-response = client.delete_posix_account request
+request = ::Google::Cloud::OsLogin::V1beta::CreateSshPublicKeyRequest.new # (request fields as keyword arguments...)
+response = client.create_ssh_public_key request
 ```
 
 View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-os_login-v1beta/latest)
@@ -46,7 +46,7 @@ for general usage information.
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
 or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.

data/lib/google/cloud/os_login/v1beta/os_login_service/client.rb

@@ -177,6 +177,93 @@ module Google
 
             # Service calls
 
+            ##
+            # Create an SSH public key
+            #
+            # @overload create_ssh_public_key(request, options = nil)
+            #   Pass arguments to `create_ssh_public_key` via a request object, either of type
+            #   {::Google::Cloud::OsLogin::V1beta::CreateSshPublicKeyRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::OsLogin::V1beta::CreateSshPublicKeyRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload create_ssh_public_key(parent: nil, ssh_public_key: nil)
+            #   Pass arguments to `create_ssh_public_key` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::String]
+            #     Required. The unique ID for the user in format `users/{user}`.
+            #   @param ssh_public_key [::Google::Cloud::OsLogin::Common::SshPublicKey, ::Hash]
+            #     Required. The SSH public key and expiration time.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::OsLogin::Common::SshPublicKey]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::OsLogin::Common::SshPublicKey]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/os_login/v1beta"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::OsLogin::V1beta::OsLoginService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::OsLogin::V1beta::CreateSshPublicKeyRequest.new
+            #
+            #   # Call the create_ssh_public_key method.
+            #   result = client.create_ssh_public_key request
+            #
+            #   # The returned object is of type Google::Cloud::OsLogin::Common::SshPublicKey.
+            #   p result
+            #
+            def create_ssh_public_key request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OsLogin::V1beta::CreateSshPublicKeyRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.create_ssh_public_key.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::OsLogin::V1beta::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.create_ssh_public_key.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.create_ssh_public_key.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @os_login_service_stub.call_rpc :create_ssh_public_key, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Deletes a POSIX account.
             #
@@ -196,9 +283,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. A reference to the POSIX account to update. POSIX accounts are identified
-            #     by the project ID they are associated with. A reference to the POSIX
-            #     account is in format `users/{user}/projects/{project}`.
+            #     Required. A reference to the POSIX account to update. POSIX accounts are
+            #     identified by the project ID they are associated with. A reference to the
+            #     POSIX account is in format `users/{user}/projects/{project}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -283,9 +370,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. 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}`.
+            #     Required. 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}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -365,7 +452,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload get_login_profile(name: nil, project_id: nil, system_id: nil)
+            # @overload get_login_profile(name: nil, project_id: nil, system_id: nil, view: nil)
             #   Pass arguments to `get_login_profile` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -376,6 +463,8 @@ module Google
             #     The project ID of the Google Cloud Platform project.
             #   @param system_id [::String]
             #     A system ID for filtering the results of the request.
+            #   @param view [::Google::Cloud::OsLogin::V1beta::LoginProfileView]
+            #     The view configures whether to retrieve security keys information.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::OsLogin::V1beta::LoginProfile]
@@ -460,9 +549,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. 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}`.
+            #     Required. 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}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::OsLogin::Common::SshPublicKey]
@@ -543,7 +632,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload import_ssh_public_key(parent: nil, ssh_public_key: nil, project_id: nil)
+            # @overload import_ssh_public_key(parent: nil, ssh_public_key: nil, project_id: nil, view: nil)
             #   Pass arguments to `import_ssh_public_key` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -554,6 +643,8 @@ module Google
             #     Required. The SSH public key and expiration time.
             #   @param project_id [::String]
             #     The project ID of the Google Cloud Platform project.
+            #   @param view [::Google::Cloud::OsLogin::V1beta::LoginProfileView]
+            #     The view configures whether to retrieve security keys information.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::OsLogin::V1beta::ImportSshPublicKeyResponse]
@@ -639,9 +730,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. 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}`.
+            #     Required. 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}`.
             #   @param ssh_public_key [::Google::Cloud::OsLogin::Common::SshPublicKey, ::Hash]
             #     Required. The SSH public key and expiration time.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
@@ -727,17 +818,17 @@ module Google
             # @example
             #
             #   # Modify the global config, setting the timeout for
-            #   # delete_posix_account to 20 seconds,
+            #   # create_ssh_public_key to 20 seconds,
             #   # and all remaining timeouts to 10 seconds.
             #   ::Google::Cloud::OsLogin::V1beta::OsLoginService::Client.configure do |config|
             #     config.timeout = 10.0
-            #     config.rpcs.delete_posix_account.timeout = 20.0
+            #     config.rpcs.create_ssh_public_key.timeout = 20.0
             #   end
             #
             #   # Apply the above configuration only to a new client.
             #   client = ::Google::Cloud::OsLogin::V1beta::OsLoginService::Client.new do |config|
             #     config.timeout = 10.0
-            #     config.rpcs.delete_posix_account.timeout = 20.0
+            #     config.rpcs.create_ssh_public_key.timeout = 20.0
             #   end
             #
             # @!attribute [rw] endpoint
@@ -846,6 +937,11 @@ module Google
               #         trigger a retry.
               #
               class Rpcs
+                ##
+                # RPC-specific configuration for `create_ssh_public_key`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :create_ssh_public_key
                 ##
                 # RPC-specific configuration for `delete_posix_account`
                 # @return [::Gapic::Config::Method]
@@ -879,6 +975,8 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
+                  create_ssh_public_key_config = parent_rpcs.create_ssh_public_key if parent_rpcs.respond_to? :create_ssh_public_key
+                  @create_ssh_public_key = ::Gapic::Config::Method.new create_ssh_public_key_config
                   delete_posix_account_config = parent_rpcs.delete_posix_account if parent_rpcs.respond_to? :delete_posix_account
                   @delete_posix_account = ::Gapic::Config::Method.new delete_posix_account_config
                   delete_ssh_public_key_config = parent_rpcs.delete_ssh_public_key if parent_rpcs.respond_to? :delete_ssh_public_key