google-api-client 0.9.4 → 0.9.5

data/generated/google/apis/container_v1.rb

@@ -20,13 +20,13 @@ module Google
   module Apis
     # Google Container Engine API
     #
-    # The Google Container Engine API is used for building and managing container
-    # based applications, powered by the open source Kubernetes technology.
+    # Builds and manages clusters that run container-based applications, powered by
+    # open source Kubernetes technology.
     #
     # @see https://cloud.google.com/container-engine/
     module ContainerV1
       VERSION = 'V1'
-      REVISION = '20150603'
+      REVISION = '20160321'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/container_v1/classes.rb

@@ -31,6 +31,12 @@ module Google
         # @return [Array<Google::Apis::ContainerV1::Cluster>]
         attr_accessor :clusters
       
+        # If any zones are listed here, the list of clusters returned may be missing
+        # those zones.
+        # Corresponds to the JSON property `missingZones`
+        # @return [Array<String>]
+        attr_accessor :missing_zones
+      
         def initialize(**args)
            update!(**args)
         end
@@ -38,6 +44,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @clusters = args[:clusters] if args.key?(:clusters)
+          @missing_zones = args[:missing_zones] if args.key?(:missing_zones)
         end
       end
       
@@ -59,14 +66,16 @@ module Google
         attr_accessor :description
       
         # The number of nodes to create in this cluster. You must ensure that your
-        # Compute Engine [resource quota](/compute/docs/resource-quotas) is sufficient
-        # for this number of instances. You must also have available firewall and routes
-        # quota.
+        # Compute Engine resource quota is sufficient for this number of instances. You
+        # must also have available firewall and routes quota. For requests, this field
+        # should only be used in lieu of a "node_pool" object, since this configuration (
+        # along with the "node_config") will be used to create a "NodePool" object with
+        # an auto-generated name. Do not use this and a node_pool at the same time.
         # Corresponds to the JSON property `initialNodeCount`
         # @return [Fixnum]
         attr_accessor :initial_node_count
       
-        # Per-node parameters.
+        # Parameters that describe the nodes in a cluster.
         # Corresponds to the JSON property `nodeConfig`
         # @return [Google::Apis::ContainerV1::NodeConfig]
         attr_accessor :node_config
@@ -77,25 +86,25 @@ module Google
         # @return [Google::Apis::ContainerV1::MasterAuth]
         attr_accessor :master_auth
       
-        # The logging service that the cluster should write logs to. Currently available
-        # options: * "logging.googleapis.com" - the Google Cloud Logging service * "none"
-        # - no logs will be exported from the cluster * "" - default value; the default
-        # is "logging.googleapis.com"
+        # The logging service the cluster should use to write logs. Currently available
+        # options: * `logging.googleapis.com` - the Google Cloud Logging service. * `
+        # none` - no logs will be exported from the cluster. * if left as an empty
+        # string,`logging.googleapis.com` will be used.
         # Corresponds to the JSON property `loggingService`
         # @return [String]
         attr_accessor :logging_service
       
-        # The monitoring service that the cluster should write metrics to. Currently
-        # available options: * "monitoring.googleapis.com" - the Google Cloud Monitoring
-        # service * "none" - no metrics will be exported from the cluster * "" - default
-        # value; the default is "monitoring.googleapis.com"
+        # The monitoring service the cluster should use to write metrics. Currently
+        # available options: * `monitoring.googleapis.com` - the Google Cloud Monitoring
+        # service. * `none` - no metrics will be exported from the cluster. * if left as
+        # an empty string, `monitoring.googleapis.com` will be used.
         # Corresponds to the JSON property `monitoringService`
         # @return [String]
         attr_accessor :monitoring_service
       
-        # The name of the Google Compute Engine [network](/compute/docs/networking#
-        # networks_1) to which the cluster is connected. If left unspecified, the "
-        # default" network will be used.
+        # The name of the Google Compute Engine [network](/compute/docs/networks-and-
+        # firewalls#networks) to which the cluster is connected. If left unspecified,
+        # the `default` network will be used.
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
@@ -108,6 +117,18 @@ module Google
         # @return [String]
         attr_accessor :cluster_ipv4_cidr
       
+        # Configuration for the addons that can be automatically spun up in the cluster,
+        # enabling additional functionality.
+        # Corresponds to the JSON property `addonsConfig`
+        # @return [Google::Apis::ContainerV1::AddonsConfig]
+        attr_accessor :addons_config
+      
+        # The name of the Google Compute Engine [subnetwork](/compute/docs/subnetworks)
+        # to which the cluster is connected.
+        # Corresponds to the JSON property `subnetwork`
+        # @return [String]
+        attr_accessor :subnetwork
+      
         # [Output only] Server-defined URL for the resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
@@ -119,15 +140,15 @@ module Google
         # @return [String]
         attr_accessor :zone
       
-        # [Output only] The IP address of this cluster's Kubernetes master endpoint. The
-        # endpoint can be accessed from the internet at `https://username:password@
-        # endpoint/`. See the `masterAuth` property of this resource for username and
-        # password information.
+        # [Output only] The IP address of this cluster's master endpoint. The endpoint
+        # can be accessed from the internet at `https://username:password@endpoint/`.
+        # See the `masterAuth` property of this resource for username and password
+        # information.
         # Corresponds to the JSON property `endpoint`
         # @return [String]
         attr_accessor :endpoint
       
-        # [Output only] The software version of Kubernetes master and kubelets used in
+        # [Output only] The software version of the master endpoint and kubelets used in
         # the cluster when it was first created. The version can be upgraded over time.
         # Corresponds to the JSON property `initialClusterVersion`
         # @return [String]
@@ -139,8 +160,8 @@ module Google
         attr_accessor :current_master_version
       
         # [Output only] The current version of the node software components. If they are
-        # currently at different versions because they're in the process of being
-        # upgraded, this reflects the minimum version of any of them.
+        # currently at multiple versions because they're in the process of being
+        # upgraded, this reflects the minimum version of all nodes.
         # Corresponds to the JSON property `currentNodeVersion`
         # @return [String]
         attr_accessor :current_node_version
@@ -163,15 +184,15 @@ module Google
         attr_accessor :status_message
       
         # [Output only] The size of the address space on each node for hosting
-        # containers. This is provisioned from within the container_ipv4_cidr range.
+        # containers. This is provisioned from within the `container_ipv4_cidr` range.
         # Corresponds to the JSON property `nodeIpv4CidrSize`
         # @return [Fixnum]
         attr_accessor :node_ipv4_cidr_size
       
         # [Output only] The IP address range of the Kubernetes services in this cluster,
         # in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
-        # notation (e.g. `1.2.3.4/29`). Service addresses are typically put in the last /
-        # 16 from the container CIDR.
+        # notation (e.g. `1.2.3.4/29`). Service addresses are typically put in the last `
+        # /16` from the container CIDR.
         # Corresponds to the JSON property `servicesIpv4Cidr`
         # @return [String]
         attr_accessor :services_ipv4_cidr
@@ -182,6 +203,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :instance_group_urls
       
+        # [Output only] The number of nodes currently in the cluster.
+        # Corresponds to the JSON property `currentNodeCount`
+        # @return [Fixnum]
+        attr_accessor :current_node_count
+      
         def initialize(**args)
            update!(**args)
         end
@@ -197,6 +223,8 @@ module Google
           @monitoring_service = args[:monitoring_service] if args.key?(:monitoring_service)
           @network = args[:network] if args.key?(:network)
           @cluster_ipv4_cidr = args[:cluster_ipv4_cidr] if args.key?(:cluster_ipv4_cidr)
+          @addons_config = args[:addons_config] if args.key?(:addons_config)
+          @subnetwork = args[:subnetwork] if args.key?(:subnetwork)
           @self_link = args[:self_link] if args.key?(:self_link)
           @zone = args[:zone] if args.key?(:zone)
           @endpoint = args[:endpoint] if args.key?(:endpoint)
@@ -209,10 +237,11 @@ module Google
           @node_ipv4_cidr_size = args[:node_ipv4_cidr_size] if args.key?(:node_ipv4_cidr_size)
           @services_ipv4_cidr = args[:services_ipv4_cidr] if args.key?(:services_ipv4_cidr)
           @instance_group_urls = args[:instance_group_urls] if args.key?(:instance_group_urls)
+          @current_node_count = args[:current_node_count] if args.key?(:current_node_count)
         end
       end
       
-      # Per-node parameters.
+      # Parameters that describe the nodes in a cluster.
       class NodeConfig
         include Google::Apis::Core::Hashable
       
@@ -234,11 +263,26 @@ module Google
         # required, and by default are not included: * `https://www.googleapis.com/auth/
         # compute` is required for mounting persistent storage on your nodes. * `https://
         # www.googleapis.com/auth/devstorage.read_only` is required for communicating
-        # with *gcr.io*. If unspecified, no scopes are added.
+        # with **gcr.io** (the [Google Container Registry](/container-registry/)). If
+        # unspecified, no scopes are added, unless Cloud Logging or Cloud Monitoring are
+        # enabled, in which case their required scopes will be added.
         # Corresponds to the JSON property `oauthScopes`
         # @return [Array<String>]
         attr_accessor :oauth_scopes
       
+        # The metadata key/value pairs assigned to instances in the cluster. Keys must
+        # conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes in length.
+        # These are reflected as part of a URL in the metadata server. Additionally, to
+        # avoid ambiguity, keys must not conflict with any other metadata keys for the
+        # project or be one of the four reserved keys: "instance-template", "kube-env", "
+        # startup-script", and "user-data" Values are free-form strings, and only have
+        # meaning as interpreted by the image running in the instance. The only
+        # restriction placed on them is that each value's size must be less than or
+        # equal to 32 KB. The total size of all keys and values must be less than 512 KB.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,String>]
+        attr_accessor :metadata
+      
         def initialize(**args)
            update!(**args)
         end
@@ -248,6 +292,7 @@ module Google
           @machine_type = args[:machine_type] if args.key?(:machine_type)
           @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb)
           @oauth_scopes = args[:oauth_scopes] if args.key?(:oauth_scopes)
+          @metadata = args[:metadata] if args.key?(:metadata)
         end
       end
       
@@ -256,32 +301,31 @@ module Google
       class MasterAuth
         include Google::Apis::Core::Hashable
       
-        # The username to use for HTTP basic authentication when accessing the
-        # Kubernetes master endpoint.
+        # The username to use for HTTP basic authentication to the master endpoint.
         # Corresponds to the JSON property `username`
         # @return [String]
         attr_accessor :username
       
-        # The password to use for HTTP basic authentication when accessing the
-        # Kubernetes master endpoint. Because the master endpoint is open to the
-        # internet, you should create a strong password.
+        # The password to use for HTTP basic authentication to the master endpoint.
+        # Because the master endpoint is open to the Internet, you should create a
+        # strong password.
         # Corresponds to the JSON property `password`
         # @return [String]
         attr_accessor :password
       
-        # [Output only] Base64 encoded public certificate that is the root of trust for
+        # [Output only] Base64-encoded public certificate that is the root of trust for
         # the cluster.
         # Corresponds to the JSON property `clusterCaCertificate`
         # @return [String]
         attr_accessor :cluster_ca_certificate
       
-        # [Output only] Base64 encoded public certificate used by clients to
+        # [Output only] Base64-encoded public certificate used by clients to
         # authenticate to the cluster endpoint.
         # Corresponds to the JSON property `clientCertificate`
         # @return [String]
         attr_accessor :client_certificate
       
-        # [Output only] Base64 encoded private key used by clients to authenticate to
+        # [Output only] Base64-encoded private key used by clients to authenticate to
         # the cluster endpoint.
         # Corresponds to the JSON property `clientKey`
         # @return [String]
@@ -301,6 +345,81 @@ module Google
         end
       end
       
+      # Configuration for the addons that can be automatically spun up in the cluster,
+      # enabling additional functionality.
+      class AddonsConfig
+        include Google::Apis::Core::Hashable
+      
+        # Configuration options for the HTTP (L7) load balancing controller addon, which
+        # makes it easy to set up HTTP load balancers for services in a cluster.
+        # Corresponds to the JSON property `httpLoadBalancing`
+        # @return [Google::Apis::ContainerV1::HttpLoadBalancing]
+        attr_accessor :http_load_balancing
+      
+        # Configuration options for the horizontal pod autoscaling feature, which
+        # increases or decreases the number of replica pods a replication controller has
+        # based on the resource usage of the existing pods.
+        # Corresponds to the JSON property `horizontalPodAutoscaling`
+        # @return [Google::Apis::ContainerV1::HorizontalPodAutoscaling]
+        attr_accessor :horizontal_pod_autoscaling
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @http_load_balancing = args[:http_load_balancing] if args.key?(:http_load_balancing)
+          @horizontal_pod_autoscaling = args[:horizontal_pod_autoscaling] if args.key?(:horizontal_pod_autoscaling)
+        end
+      end
+      
+      # Configuration options for the HTTP (L7) load balancing controller addon, which
+      # makes it easy to set up HTTP load balancers for services in a cluster.
+      class HttpLoadBalancing
+        include Google::Apis::Core::Hashable
+      
+        # Whether the HTTP Load Balancing controller is enabled in the cluster. When
+        # enabled, it runs a small pod in the cluster that manages the load balancers.
+        # Corresponds to the JSON property `disabled`
+        # @return [Boolean]
+        attr_accessor :disabled
+        alias_method :disabled?, :disabled
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disabled = args[:disabled] if args.key?(:disabled)
+        end
+      end
+      
+      # Configuration options for the horizontal pod autoscaling feature, which
+      # increases or decreases the number of replica pods a replication controller has
+      # based on the resource usage of the existing pods.
+      class HorizontalPodAutoscaling
+        include Google::Apis::Core::Hashable
+      
+        # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster. When
+        # enabled, it ensures that a Heapster pod is running in the cluster, which is
+        # also used by the Cloud Monitoring service.
+        # Corresponds to the JSON property `disabled`
+        # @return [Boolean]
+        attr_accessor :disabled
+        alias_method :disabled?, :disabled
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disabled = args[:disabled] if args.key?(:disabled)
+        end
+      end
+      
       # CreateClusterRequest creates a cluster.
       class CreateClusterRequest
         include Google::Apis::Core::Hashable
@@ -320,7 +439,8 @@ module Google
         end
       end
       
-      # Defines the operation resource. All fields are output only.
+      # This operation resource represents operations that may have happened or are
+      # happening on the cluster. All fields are output only.
       class Operation
         include Google::Apis::Core::Hashable
       
@@ -345,6 +465,11 @@ module Google
         # @return [String]
         attr_accessor :status
       
+        # Detailed operation progress, if available.
+        # Corresponds to the JSON property `detail`
+        # @return [String]
+        attr_accessor :detail
+      
         # If an error has occurred, a textual description of the error.
         # Corresponds to the JSON property `statusMessage`
         # @return [String]
@@ -370,17 +495,19 @@ module Google
           @zone = args[:zone] if args.key?(:zone)
           @operation_type = args[:operation_type] if args.key?(:operation_type)
           @status = args[:status] if args.key?(:status)
+          @detail = args[:detail] if args.key?(:detail)
           @status_message = args[:status_message] if args.key?(:status_message)
           @self_link = args[:self_link] if args.key?(:self_link)
           @target_link = args[:target_link] if args.key?(:target_link)
         end
       end
       
-      # UpdateClusterRequest updates a cluster.
+      # UpdateClusterRequest updates the settings of a cluster.
       class UpdateClusterRequest
         include Google::Apis::Core::Hashable
       
-        # ClusterUpdate describes an update to the cluster.
+        # ClusterUpdate describes an update to the cluster. Exactly one update can be
+        # applied to a cluster with each request, so at most one field can be provided.
         # Corresponds to the JSON property `update`
         # @return [Google::Apis::ContainerV1::ClusterUpdate]
         attr_accessor :update
@@ -395,16 +522,37 @@ module Google
         end
       end
       
-      # ClusterUpdate describes an update to the cluster.
+      # ClusterUpdate describes an update to the cluster. Exactly one update can be
+      # applied to a cluster with each request, so at most one field can be provided.
       class ClusterUpdate
         include Google::Apis::Core::Hashable
       
-        # The Kubernetes version to change the nodes to (typically an upgrade). Use "-"
+        # The Kubernetes version to change the nodes to (typically an upgrade). Use `-`
         # to upgrade to the latest version supported by the server.
         # Corresponds to the JSON property `desiredNodeVersion`
         # @return [String]
         attr_accessor :desired_node_version
       
+        # The monitoring service the cluster should use to write metrics. Currently
+        # available options: * "monitoring.googleapis.com" - the Google Cloud Monitoring
+        # service * "none" - no metrics will be exported from the cluster
+        # Corresponds to the JSON property `desiredMonitoringService`
+        # @return [String]
+        attr_accessor :desired_monitoring_service
+      
+        # Configuration for the addons that can be automatically spun up in the cluster,
+        # enabling additional functionality.
+        # Corresponds to the JSON property `desiredAddonsConfig`
+        # @return [Google::Apis::ContainerV1::AddonsConfig]
+        attr_accessor :desired_addons_config
+      
+        # The Kubernetes version to change the master to. The only valid value is the
+        # latest supported version. Use "-" to have the server automatically select the
+        # latest version.
+        # Corresponds to the JSON property `desiredMasterVersion`
+        # @return [String]
+        attr_accessor :desired_master_version
+      
         def initialize(**args)
            update!(**args)
         end
@@ -412,6 +560,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @desired_node_version = args[:desired_node_version] if args.key?(:desired_node_version)
+          @desired_monitoring_service = args[:desired_monitoring_service] if args.key?(:desired_monitoring_service)
+          @desired_addons_config = args[:desired_addons_config] if args.key?(:desired_addons_config)
+          @desired_master_version = args[:desired_master_version] if args.key?(:desired_master_version)
         end
       end
       
@@ -424,6 +575,12 @@ module Google
         # @return [Array<Google::Apis::ContainerV1::Operation>]
         attr_accessor :operations
       
+        # If any zones are listed here, the list of operations returned may be missing
+        # the operations from those zones.
+        # Corresponds to the JSON property `missingZones`
+        # @return [Array<String>]
+        attr_accessor :missing_zones
+      
         def initialize(**args)
            update!(**args)
         end
@@ -431,14 +588,15 @@ module Google
         # Update properties of this object
         def update!(**args)
           @operations = args[:operations] if args.key?(:operations)
+          @missing_zones = args[:missing_zones] if args.key?(:missing_zones)
         end
       end
       
-      # Container Engine Server configuration.
+      # Container Engine service configuration.
       class ServerConfig
         include Google::Apis::Core::Hashable
       
-        # What version this server deploys by default.
+        # Version of Kubernetes the service deploys by default.
         # Corresponds to the JSON property `defaultClusterVersion`
         # @return [String]
         attr_accessor :default_cluster_version