generated/google/apis/container_v1/classes.rb in google-api-client-0.12.0 vs generated/google/apis/container_v1/classes.rb in google-api-client-0.13.0

- old
+ new

@@ -20,399 +20,73 @@ module Google module Apis module ContainerV1 - # A Google Container Engine cluster. - class Cluster + # The authentication information for accessing the master endpoint. + # Authentication can be done using HTTP basic auth or using client + # certificates. + class MasterAuth include Google::Apis::Core::Hashable - # The fingerprint of the set of labels for this cluster. - # Corresponds to the JSON property `labelFingerprint` + # 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. If a password is provided for cluster creation, username + # must be non-empty. + # Corresponds to the JSON property `password` # @return [String] - attr_accessor :label_fingerprint + attr_accessor :password - # [Output only] The name of the Google Compute Engine - # [zone](/compute/docs/zones#available) in which the cluster - # resides. - # Corresponds to the JSON property `zone` - # @return [String] - attr_accessor :zone + # Configuration for client certificates on the cluster. + # Corresponds to the JSON property `clientCertificateConfig` + # @return [Google::Apis::ContainerV1::ClientCertificateConfig] + attr_accessor :client_certificate_config - # 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` + # [Output only] Base64-encoded private key used by clients to authenticate + # to the cluster endpoint. + # Corresponds to the JSON property `clientKey` # @return [String] - attr_accessor :logging_service + attr_accessor :client_key - # [Output only] The size of the address space on each node for hosting - # 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 time the cluster will be automatically - # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. - # Corresponds to the JSON property `expireTime` + # [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 :expire_time + attr_accessor :cluster_ca_certificate - # [Output only] Additional information about the current status of this - # cluster, if available. - # Corresponds to the JSON property `statusMessage` + # [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 :status_message + attr_accessor :client_certificate - # The authentication information for accessing the master endpoint. - # Authentication can be done using HTTP basic auth or using client - # certificates. - # Corresponds to the JSON property `masterAuth` - # @return [Google::Apis::ContainerV1::MasterAuth] - attr_accessor :master_auth - - # [Output only] The current software version of the master endpoint. - # Corresponds to the JSON property `currentMasterVersion` + # The username to use for HTTP basic authentication to the master endpoint. + # For clusters v1.6.0 and later, you can disable basic authentication by + # providing an empty username. + # Corresponds to the JSON property `username` # @return [String] - attr_accessor :current_master_version + attr_accessor :username - # Parameters that describe the nodes in a cluster. - # Corresponds to the JSON property `nodeConfig` - # @return [Google::Apis::ContainerV1::NodeConfig] - attr_accessor :node_config - - # 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 - - # [Output only] The current status of this cluster. - # Corresponds to the JSON property `status` - # @return [String] - attr_accessor :status - - # [Output only] The current version of the node software components. - # If they are 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 - - # 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 - - # The resource labels for the cluster to use to annotate any related GCE - # resources. - # Corresponds to the JSON property `resourceLabels` - # @return [Hash<String,String>] - attr_accessor :resource_labels - - # The name of this cluster. The name must be unique within this project - # and zone, and can be up to 40 characters with the following restrictions: - # * Lowercase letters, numbers, and hyphens only. - # * Must start with a letter. - # * Must end with a number or a letter. - # Corresponds to the JSON property `name` - # @return [String] - attr_accessor :name - - # The initial Kubernetes version for this cluster. Valid versions are those - # found in validMasterVersions returned by getServerConfig. The version can - # be upgraded over time; such upgrades are reflected in - # currentMasterVersion and currentNodeVersion. - # Corresponds to the JSON property `initialClusterVersion` - # @return [String] - attr_accessor :initial_cluster_version - - # [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 - - # Configuration for the legacy Attribute Based Access Control authorization - # mode. - # Corresponds to the JSON property `legacyAbac` - # @return [Google::Apis::ContainerV1::LegacyAbac] - attr_accessor :legacy_abac - - # [Output only] The time the cluster was created, in - # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. - # Corresponds to the JSON property `createTime` - # @return [String] - attr_accessor :create_time - - # The IP address range of the container pods in this cluster, in - # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - # notation (e.g. `10.96.0.0/14`). Leave blank to have - # one automatically chosen or specify a `/14` block in `10.0.0.0/8`. - # Corresponds to the JSON property `clusterIpv4Cidr` - # @return [String] - attr_accessor :cluster_ipv4_cidr - - # The number of nodes to create in this cluster. You must ensure that your - # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a> - # 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 - - # [Output only] Server-defined URL for the resource. - # Corresponds to the JSON property `selfLink` - # @return [String] - attr_accessor :self_link - - # The list of Google Compute Engine - # [locations](/compute/docs/zones#available) in which the cluster's nodes - # should be located. - # Corresponds to the JSON property `locations` - # @return [Array<String>] - attr_accessor :locations - - # The node pools associated with this cluster. - # This field should not be set if "node_config" or "initial_node_count" are - # specified. - # Corresponds to the JSON property `nodePools` - # @return [Array<Google::Apis::ContainerV1::NodePool>] - attr_accessor :node_pools - - # [Output only] The resource URLs of [instance - # groups](/compute/docs/instance-groups/) associated with this - # cluster. - # Corresponds to the JSON property `instanceGroupUrls` - # @return [Array<String>] - attr_accessor :instance_group_urls - - # [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. - # Corresponds to the JSON property `servicesIpv4Cidr` - # @return [String] - attr_accessor :services_ipv4_cidr - - # Kubernetes alpha features are enabled on this cluster. This includes alpha - # API groups (e.g. v1alpha1) and features that may not be production ready in - # the kubernetes version of the master and nodes. - # The cluster has no SLA for uptime and master/node upgrades are disabled. - # Alpha enabled clusters are automatically deleted thirty days after - # creation. - # Corresponds to the JSON property `enableKubernetesAlpha` - # @return [Boolean] - attr_accessor :enable_kubernetes_alpha - alias_method :enable_kubernetes_alpha?, :enable_kubernetes_alpha - - # An optional description of this cluster. - # Corresponds to the JSON property `description` - # @return [String] - attr_accessor :description - - # [Output only] The number of nodes currently in the cluster. - # Corresponds to the JSON property `currentNodeCount` - # @return [Fixnum] - attr_accessor :current_node_count - - # 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/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 - def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) - @label_fingerprint = args[:label_fingerprint] if args.key?(:label_fingerprint) - @zone = args[:zone] if args.key?(:zone) - @logging_service = args[:logging_service] if args.key?(:logging_service) - @node_ipv4_cidr_size = args[:node_ipv4_cidr_size] if args.key?(:node_ipv4_cidr_size) - @expire_time = args[:expire_time] if args.key?(:expire_time) - @status_message = args[:status_message] if args.key?(:status_message) - @master_auth = args[:master_auth] if args.key?(:master_auth) - @current_master_version = args[:current_master_version] if args.key?(:current_master_version) - @node_config = args[:node_config] if args.key?(:node_config) - @addons_config = args[:addons_config] if args.key?(:addons_config) - @status = args[:status] if args.key?(:status) - @current_node_version = args[:current_node_version] if args.key?(:current_node_version) - @subnetwork = args[:subnetwork] if args.key?(:subnetwork) - @resource_labels = args[:resource_labels] if args.key?(:resource_labels) - @name = args[:name] if args.key?(:name) - @initial_cluster_version = args[:initial_cluster_version] if args.key?(:initial_cluster_version) - @endpoint = args[:endpoint] if args.key?(:endpoint) - @legacy_abac = args[:legacy_abac] if args.key?(:legacy_abac) - @create_time = args[:create_time] if args.key?(:create_time) - @cluster_ipv4_cidr = args[:cluster_ipv4_cidr] if args.key?(:cluster_ipv4_cidr) - @initial_node_count = args[:initial_node_count] if args.key?(:initial_node_count) - @self_link = args[:self_link] if args.key?(:self_link) - @locations = args[:locations] if args.key?(:locations) - @node_pools = args[:node_pools] if args.key?(:node_pools) - @instance_group_urls = args[:instance_group_urls] if args.key?(:instance_group_urls) - @services_ipv4_cidr = args[:services_ipv4_cidr] if args.key?(:services_ipv4_cidr) - @enable_kubernetes_alpha = args[:enable_kubernetes_alpha] if args.key?(:enable_kubernetes_alpha) - @description = args[:description] if args.key?(:description) - @current_node_count = args[:current_node_count] if args.key?(:current_node_count) - @monitoring_service = args[:monitoring_service] if args.key?(:monitoring_service) - @network = args[:network] if args.key?(:network) + @password = args[:password] if args.key?(:password) + @client_certificate_config = args[:client_certificate_config] if args.key?(:client_certificate_config) + @client_key = args[:client_key] if args.key?(:client_key) + @cluster_ca_certificate = args[:cluster_ca_certificate] if args.key?(:cluster_ca_certificate) + @client_certificate = args[:client_certificate] if args.key?(:client_certificate) + @username = args[:username] if args.key?(:username) end end - # ListOperationsResponse is the result of ListOperationsRequest. - class ListOperationsResponse - include Google::Apis::Core::Hashable - - # A list of operations in the project in the specified zone. - # Corresponds to the JSON property `operations` - # @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 - - # 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 - - # CreateNodePoolRequest creates a node pool for a cluster. - class CreateNodePoolRequest - include Google::Apis::Core::Hashable - - # NodePool contains the name and configuration for a cluster's node pool. - # Node pools are a set of nodes (i.e. VM's), with a common configuration and - # specification, under the control of the cluster master. They may have a set - # of Kubernetes labels applied to them, which may be used to reference them - # during pod scheduling. They may also be resized up or down, to accommodate - # the workload. - # Corresponds to the JSON property `nodePool` - # @return [Google::Apis::ContainerV1::NodePool] - attr_accessor :node_pool - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @node_pool = args[:node_pool] if args.key?(:node_pool) - end - end - - # Container Engine service configuration. - class ServerConfig - include Google::Apis::Core::Hashable - - # List of valid master versions. - # Corresponds to the JSON property `validMasterVersions` - # @return [Array<String>] - attr_accessor :valid_master_versions - - # Version of Kubernetes the service deploys by default. - # Corresponds to the JSON property `defaultClusterVersion` - # @return [String] - attr_accessor :default_cluster_version - - # Default image type. - # Corresponds to the JSON property `defaultImageType` - # @return [String] - attr_accessor :default_image_type - - # List of valid node upgrade target versions. - # Corresponds to the JSON property `validNodeVersions` - # @return [Array<String>] - attr_accessor :valid_node_versions - - # List of valid image types. - # Corresponds to the JSON property `validImageTypes` - # @return [Array<String>] - attr_accessor :valid_image_types - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @valid_master_versions = args[:valid_master_versions] if args.key?(:valid_master_versions) - @default_cluster_version = args[:default_cluster_version] if args.key?(:default_cluster_version) - @default_image_type = args[:default_image_type] if args.key?(:default_image_type) - @valid_node_versions = args[:valid_node_versions] if args.key?(:valid_node_versions) - @valid_image_types = args[:valid_image_types] if args.key?(:valid_image_types) - end - end - # Parameters that describe the nodes in a cluster. class NodeConfig include Google::Apis::Core::Hashable - # The image type to use for this node. Note that for a given image type, - # the latest version of it will be used. - # Corresponds to the JSON property `imageType` - # @return [String] - attr_accessor :image_type - - # The set of Google API scopes to be made available on all of the - # node VMs under the "default" service account. - # The following scopes are recommended, but not 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** - # (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 - - # Whether the nodes are created as preemptible VM instances. See: - # https://cloud.google.com/compute/docs/instances/preemptible for more - # inforamtion about preemptible VM instances. - # Corresponds to the JSON property `preemptible` - # @return [Boolean] - attr_accessor :preemptible - alias_method :preemptible?, :preemptible - # The map of Kubernetes labels (key/value pairs) to be applied to each node. # These will added in addition to any default label(s) that # Kubernetes may apply to the node. # In case of conflict in label keys, the applied set may differ depending on # the Kubernetes version -- it's best to assume the behavior is undefined @@ -474,82 +148,58 @@ # `n1-standard-1`. # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type + # The image type to use for this node. Note that for a given image type, + # the latest version of it will be used. + # Corresponds to the JSON property `imageType` + # @return [String] + attr_accessor :image_type + + # The set of Google API scopes to be made available on all of the + # node VMs under the "default" service account. + # The following scopes are recommended, but not 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** + # (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 + + # Whether the nodes are created as preemptible VM instances. See: + # https://cloud.google.com/compute/docs/instances/preemptible for more + # information about preemptible VM instances. + # Corresponds to the JSON property `preemptible` + # @return [Boolean] + attr_accessor :preemptible + alias_method :preemptible?, :preemptible + def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) - @image_type = args[:image_type] if args.key?(:image_type) - @oauth_scopes = args[:oauth_scopes] if args.key?(:oauth_scopes) - @preemptible = args[:preemptible] if args.key?(:preemptible) @labels = args[:labels] if args.key?(:labels) @local_ssd_count = args[:local_ssd_count] if args.key?(:local_ssd_count) @metadata = args[:metadata] if args.key?(:metadata) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @tags = args[:tags] if args.key?(:tags) @service_account = args[:service_account] if args.key?(:service_account) @machine_type = args[:machine_type] if args.key?(:machine_type) + @image_type = args[:image_type] if args.key?(:image_type) + @oauth_scopes = args[:oauth_scopes] if args.key?(:oauth_scopes) + @preemptible = args[:preemptible] if args.key?(:preemptible) end end - # The authentication information for accessing the master endpoint. - # Authentication can be done using HTTP basic auth or using client - # certificates. - class MasterAuth - include Google::Apis::Core::Hashable - - # 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. If a password is provided for cluster creation, username - # must be non-empty. - # Corresponds to the JSON property `password` - # @return [String] - attr_accessor :password - - # [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 - - # The username to use for HTTP basic authentication to the master endpoint. - # For clusters v1.6.0 and later, you can disable basic authentication by - # providing an empty username. - # Corresponds to the JSON property `username` - # @return [String] - attr_accessor :username - - # [Output only] Base64-encoded private key used by clients to authenticate - # to the cluster endpoint. - # Corresponds to the JSON property `clientKey` - # @return [String] - attr_accessor :client_key - - # [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 - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @password = args[:password] if args.key?(:password) - @client_certificate = args[:client_certificate] if args.key?(:client_certificate) - @username = args[:username] if args.key?(:username) - @client_key = args[:client_key] if args.key?(:client_key) - @cluster_ca_certificate = args[:cluster_ca_certificate] if args.key?(:cluster_ca_certificate) - end - end - # AutoUpgradeOptions defines the set of options for the user to control how # the Auto Upgrades will proceed. class AutoUpgradeOptions include Google::Apis::Core::Hashable @@ -579,30 +229,30 @@ # ListClustersResponse is the result of ListClustersRequest. class ListClustersResponse include Google::Apis::Core::Hashable - # A list of clusters in the project in the specified zone, or - # across all ones. - # Corresponds to the JSON property `clusters` - # @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 + # A list of clusters in the project in the specified zone, or + # across all ones. + # Corresponds to the JSON property `clusters` + # @return [Array<Google::Apis::ContainerV1::Cluster>] + attr_accessor :clusters + def initialize(**args) update!(**args) end # 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) + @clusters = args[:clusters] if args.key?(:clusters) 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. @@ -630,10 +280,16 @@ # NodePoolAutoscaling contains information required by cluster autoscaler to # adjust the size of the node pool to the current cluster usage. class NodePoolAutoscaling include Google::Apis::Core::Hashable + # Is autoscaling enabled for this node pool. + # Corresponds to the JSON property `enabled` + # @return [Boolean] + attr_accessor :enabled + alias_method :enabled?, :enabled + # Maximum number of nodes in the NodePool. Must be >= min_node_count. There # has to enough quota to scale up the cluster. # Corresponds to the JSON property `maxNodeCount` # @return [Fixnum] attr_accessor :max_node_count @@ -642,28 +298,42 @@ # max_node_count. # Corresponds to the JSON property `minNodeCount` # @return [Fixnum] attr_accessor :min_node_count - # Is autoscaling enabled for this node pool. - # Corresponds to the JSON property `enabled` - # @return [Boolean] - attr_accessor :enabled - alias_method :enabled?, :enabled - def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) + @enabled = args[:enabled] if args.key?(:enabled) @max_node_count = args[:max_node_count] if args.key?(:max_node_count) @min_node_count = args[:min_node_count] if args.key?(:min_node_count) - @enabled = args[:enabled] if args.key?(:enabled) end end + # Configuration for client certificates on the cluster. + class ClientCertificateConfig + include Google::Apis::Core::Hashable + + # Issue a client certificate. + # Corresponds to the JSON property `issueClientCertificate` + # @return [Boolean] + attr_accessor :issue_client_certificate + alias_method :issue_client_certificate?, :issue_client_certificate + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @issue_client_certificate = args[:issue_client_certificate] if args.key?(:issue_client_certificate) + end + end + # SetMasterAuthRequest updates the admin password of a cluster. class SetMasterAuthRequest include Google::Apis::Core::Hashable # The authentication information for accessing the master endpoint. @@ -693,10 +363,37 @@ # be applied to a cluster with each request, so at most one field can be # provided. class ClusterUpdate include Google::Apis::Core::Hashable + # The desired image type for the node pool. + # NOTE: Set the "desired_node_pool" field as well. + # Corresponds to the JSON property `desiredImageType` + # @return [String] + attr_accessor :desired_image_type + + # 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 node pool to be upgraded. This field is mandatory if + # "desired_node_version", "desired_image_family" or + # "desired_node_pool_autoscaling" is specified and there is more than one + # node pool on the cluster. + # Corresponds to the JSON property `desiredNodePoolId` + # @return [String] + attr_accessor :desired_node_pool_id + + # 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 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] @@ -724,51 +421,24 @@ # * "none" - no metrics will be exported from the cluster # Corresponds to the JSON property `desiredMonitoringService` # @return [String] attr_accessor :desired_monitoring_service - # The desired image type for the node pool. - # NOTE: Set the "desired_node_pool" field as well. - # Corresponds to the JSON property `desiredImageType` - # @return [String] - attr_accessor :desired_image_type - - # 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 node pool to be upgraded. This field is mandatory if - # "desired_node_version", "desired_image_family" or - # "desired_node_pool_autoscaling" is specified and there is more than one - # node pool on the cluster. - # Corresponds to the JSON property `desiredNodePoolId` - # @return [String] - attr_accessor :desired_node_pool_id - - # 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 - def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) - @desired_master_version = args[:desired_master_version] if args.key?(:desired_master_version) - @desired_node_pool_autoscaling = args[:desired_node_pool_autoscaling] if args.key?(:desired_node_pool_autoscaling) - @desired_locations = args[:desired_locations] if args.key?(:desired_locations) - @desired_monitoring_service = args[:desired_monitoring_service] if args.key?(:desired_monitoring_service) @desired_image_type = args[:desired_image_type] if args.key?(:desired_image_type) @desired_addons_config = args[:desired_addons_config] if args.key?(:desired_addons_config) @desired_node_pool_id = args[:desired_node_pool_id] if args.key?(:desired_node_pool_id) @desired_node_version = args[:desired_node_version] if args.key?(:desired_node_version) + @desired_master_version = args[:desired_master_version] if args.key?(:desired_master_version) + @desired_node_pool_autoscaling = args[:desired_node_pool_autoscaling] if args.key?(:desired_node_pool_autoscaling) + @desired_locations = args[:desired_locations] if args.key?(:desired_locations) + @desired_monitoring_service = args[:desired_monitoring_service] if args.key?(:desired_monitoring_service) end end # Configuration options for the horizontal pod autoscaling feature, which # increases or decreases the number of replica pods a replication controller @@ -792,47 +462,47 @@ def update!(**args) @disabled = args[:disabled] if args.key?(:disabled) end end - # 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 + # SetNodePoolManagementRequest sets the node management properties of a node + # pool. + class SetNodePoolManagementRequest include Google::Apis::Core::Hashable + # NodeManagement defines the set of node management services turned on for the + # node pool. + # Corresponds to the JSON property `management` + # @return [Google::Apis::ContainerV1::NodeManagement] + attr_accessor :management + def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) + @management = args[:management] if args.key?(:management) end end - # SetNodePoolManagementRequest sets the node management properties of a node - # pool. - class SetNodePoolManagementRequest + # 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 include Google::Apis::Core::Hashable - # NodeManagement defines the set of node management services turned on for the - # node pool. - # Corresponds to the JSON property `management` - # @return [Google::Apis::ContainerV1::NodeManagement] - attr_accessor :management - def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) - @management = args[:management] if args.key?(:management) end end # CreateClusterRequest creates a cluster. class CreateClusterRequest @@ -962,84 +632,84 @@ # during pod scheduling. They may also be resized up or down, to accommodate # the workload. class NodePool include Google::Apis::Core::Hashable + # [Output only] The status of the nodes in this pool instance. + # Corresponds to the JSON property `status` + # @return [String] + attr_accessor :status + + # Parameters that describe the nodes in a cluster. + # Corresponds to the JSON property `config` + # @return [Google::Apis::ContainerV1::NodeConfig] + attr_accessor :config + + # The name of the node pool. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # [Output only] Additional information about the current status of this + # node pool instance, if available. + # Corresponds to the JSON property `statusMessage` + # @return [String] + attr_accessor :status_message + # NodePoolAutoscaling contains information required by cluster autoscaler to # adjust the size of the node pool to the current cluster usage. # Corresponds to the JSON property `autoscaling` # @return [Google::Apis::ContainerV1::NodePoolAutoscaling] attr_accessor :autoscaling + # NodeManagement defines the set of node management services turned on for the + # node pool. + # Corresponds to the JSON property `management` + # @return [Google::Apis::ContainerV1::NodeManagement] + attr_accessor :management + # The initial node count for the pool. You must ensure that your # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a> # is sufficient for this number of instances. You must also have available # firewall and routes quota. # Corresponds to the JSON property `initialNodeCount` # @return [Fixnum] attr_accessor :initial_node_count - # NodeManagement defines the set of node management services turned on for the - # node pool. - # Corresponds to the JSON property `management` - # @return [Google::Apis::ContainerV1::NodeManagement] - attr_accessor :management - # [Output only] Server-defined URL for the resource. # Corresponds to the JSON property `selfLink` # @return [String] attr_accessor :self_link + # [Output only] The version of the Kubernetes of this node. + # Corresponds to the JSON property `version` + # @return [String] + attr_accessor :version + # [Output only] The resource URLs of [instance # groups](/compute/docs/instance-groups/) associated with this # node pool. # Corresponds to the JSON property `instanceGroupUrls` # @return [Array<String>] attr_accessor :instance_group_urls - # [Output only] The version of the Kubernetes of this node. - # Corresponds to the JSON property `version` - # @return [String] - attr_accessor :version - - # [Output only] The status of the nodes in this pool instance. - # Corresponds to the JSON property `status` - # @return [String] - attr_accessor :status - - # Parameters that describe the nodes in a cluster. - # Corresponds to the JSON property `config` - # @return [Google::Apis::ContainerV1::NodeConfig] - attr_accessor :config - - # [Output only] Additional information about the current status of this - # node pool instance, if available. - # Corresponds to the JSON property `statusMessage` - # @return [String] - attr_accessor :status_message - - # The name of the node pool. - # Corresponds to the JSON property `name` - # @return [String] - attr_accessor :name - def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) + @status = args[:status] if args.key?(:status) + @config = args[:config] if args.key?(:config) + @name = args[:name] if args.key?(:name) + @status_message = args[:status_message] if args.key?(:status_message) @autoscaling = args[:autoscaling] if args.key?(:autoscaling) - @initial_node_count = args[:initial_node_count] if args.key?(:initial_node_count) @management = args[:management] if args.key?(:management) + @initial_node_count = args[:initial_node_count] if args.key?(:initial_node_count) @self_link = args[:self_link] if args.key?(:self_link) - @instance_group_urls = args[:instance_group_urls] if args.key?(:instance_group_urls) @version = args[:version] if args.key?(:version) - @status = args[:status] if args.key?(:status) - @config = args[:config] if args.key?(:config) - @status_message = args[:status_message] if args.key?(:status_message) - @name = args[:name] if args.key?(:name) + @instance_group_urls = args[:instance_group_urls] if args.key?(:instance_group_urls) end end # NodeManagement defines the set of node management services turned on for the # node pool. @@ -1118,17 +788,10 @@ # 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 - # The name of the Google Compute Engine - # [zone](/compute/docs/zones#available) in which the operation - # is taking place. - # Corresponds to the JSON property `zone` - # @return [String] - attr_accessor :zone - # The current status of the operation. # Corresponds to the JSON property `status` # @return [String] attr_accessor :status @@ -1160,24 +823,31 @@ # The operation type. # Corresponds to the JSON property `operationType` # @return [String] attr_accessor :operation_type + # The name of the Google Compute Engine + # [zone](/compute/docs/zones#available) in which the operation + # is taking place. + # Corresponds to the JSON property `zone` + # @return [String] + attr_accessor :zone + def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) - @zone = args[:zone] if args.key?(:zone) @status = args[:status] if args.key?(:status) @name = args[:name] if args.key?(:name) @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) @detail = args[:detail] if args.key?(:detail) @operation_type = args[:operation_type] if args.key?(:operation_type) + @zone = args[:zone] if args.key?(:zone) end end # Configuration for the addons that can be automatically spun up in the # cluster, enabling additional functionality. @@ -1221,10 +891,30 @@ # Update properties of this object def update!(**args) end end + # SetNodePoolSizeRequest sets the size a node + # pool. + class SetNodePoolSizeRequest + include Google::Apis::Core::Hashable + + # The desired node count for the pool. + # Corresponds to the JSON property `nodeCount` + # @return [Fixnum] + attr_accessor :node_count + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @node_count = args[:node_count] if args.key?(:node_count) + end + end + # UpdateClusterRequest updates the settings of a cluster. class UpdateClusterRequest include Google::Apis::Core::Hashable # ClusterUpdate describes an update to the cluster. Exactly one update can @@ -1239,9 +929,365 @@ end # Update properties of this object def update!(**args) @update = args[:update] if args.key?(:update) + end + end + + # A Google Container Engine cluster. + class Cluster + include Google::Apis::Core::Hashable + + # 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 + + # The fingerprint of the set of labels for this cluster. + # Corresponds to the JSON property `labelFingerprint` + # @return [String] + attr_accessor :label_fingerprint + + # [Output only] The name of the Google Compute Engine + # [zone](/compute/docs/zones#available) in which the cluster + # resides. + # Corresponds to the JSON property `zone` + # @return [String] + attr_accessor :zone + + # [Output only] The size of the address space on each node for hosting + # 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 time the cluster will be automatically + # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + # Corresponds to the JSON property `expireTime` + # @return [String] + attr_accessor :expire_time + + # 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 + + # [Output only] Additional information about the current status of this + # cluster, if available. + # Corresponds to the JSON property `statusMessage` + # @return [String] + attr_accessor :status_message + + # The authentication information for accessing the master endpoint. + # Authentication can be done using HTTP basic auth or using client + # certificates. + # Corresponds to the JSON property `masterAuth` + # @return [Google::Apis::ContainerV1::MasterAuth] + attr_accessor :master_auth + + # [Output only] The current software version of the master endpoint. + # Corresponds to the JSON property `currentMasterVersion` + # @return [String] + attr_accessor :current_master_version + + # Parameters that describe the nodes in a cluster. + # Corresponds to the JSON property `nodeConfig` + # @return [Google::Apis::ContainerV1::NodeConfig] + attr_accessor :node_config + + # 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 + + # [Output only] The current status of this cluster. + # Corresponds to the JSON property `status` + # @return [String] + attr_accessor :status + + # [Output only] The current version of the node software components. + # If they are 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 + + # 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 + + # The resource labels for the cluster to use to annotate any related + # Google Compute Engine resources. + # Corresponds to the JSON property `resourceLabels` + # @return [Hash<String,String>] + attr_accessor :resource_labels + + # The name of this cluster. The name must be unique within this project + # and zone, and can be up to 40 characters with the following restrictions: + # * Lowercase letters, numbers, and hyphens only. + # * Must start with a letter. + # * Must end with a number or a letter. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # The initial Kubernetes version for this cluster. Valid versions are those + # found in validMasterVersions returned by getServerConfig. The version can + # be upgraded over time; such upgrades are reflected in + # currentMasterVersion and currentNodeVersion. + # Corresponds to the JSON property `initialClusterVersion` + # @return [String] + attr_accessor :initial_cluster_version + + # [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 + + # Configuration for the legacy Attribute Based Access Control authorization + # mode. + # Corresponds to the JSON property `legacyAbac` + # @return [Google::Apis::ContainerV1::LegacyAbac] + attr_accessor :legacy_abac + + # [Output only] The time the cluster was created, in + # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. + # Corresponds to the JSON property `createTime` + # @return [String] + attr_accessor :create_time + + # The IP address range of the container pods in this cluster, in + # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + # notation (e.g. `10.96.0.0/14`). Leave blank to have + # one automatically chosen or specify a `/14` block in `10.0.0.0/8`. + # Corresponds to the JSON property `clusterIpv4Cidr` + # @return [String] + attr_accessor :cluster_ipv4_cidr + + # The number of nodes to create in this cluster. You must ensure that your + # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a> + # 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 + + # The node pools associated with this cluster. + # This field should not be set if "node_config" or "initial_node_count" are + # specified. + # Corresponds to the JSON property `nodePools` + # @return [Array<Google::Apis::ContainerV1::NodePool>] + attr_accessor :node_pools + + # The list of Google Compute Engine + # [locations](/compute/docs/zones#available) in which the cluster's nodes + # should be located. + # Corresponds to the JSON property `locations` + # @return [Array<String>] + attr_accessor :locations + + # [Output only] Server-defined URL for the resource. + # Corresponds to the JSON property `selfLink` + # @return [String] + attr_accessor :self_link + + # [Output only] The resource URLs of [instance + # groups](/compute/docs/instance-groups/) associated with this + # cluster. + # Corresponds to the JSON property `instanceGroupUrls` + # @return [Array<String>] + attr_accessor :instance_group_urls + + # [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. + # Corresponds to the JSON property `servicesIpv4Cidr` + # @return [String] + attr_accessor :services_ipv4_cidr + + # Kubernetes alpha features are enabled on this cluster. This includes alpha + # API groups (e.g. v1alpha1) and features that may not be production ready in + # the kubernetes version of the master and nodes. + # The cluster has no SLA for uptime and master/node upgrades are disabled. + # Alpha enabled clusters are automatically deleted thirty days after + # creation. + # Corresponds to the JSON property `enableKubernetesAlpha` + # @return [Boolean] + attr_accessor :enable_kubernetes_alpha + alias_method :enable_kubernetes_alpha?, :enable_kubernetes_alpha + + # An optional description of this cluster. + # Corresponds to the JSON property `description` + # @return [String] + attr_accessor :description + + # [Output only] The number of nodes currently in the cluster. + # Corresponds to the JSON property `currentNodeCount` + # @return [Fixnum] + attr_accessor :current_node_count + + # 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 + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @network = args[:network] if args.key?(:network) + @label_fingerprint = args[:label_fingerprint] if args.key?(:label_fingerprint) + @zone = args[:zone] if args.key?(:zone) + @node_ipv4_cidr_size = args[:node_ipv4_cidr_size] if args.key?(:node_ipv4_cidr_size) + @expire_time = args[:expire_time] if args.key?(:expire_time) + @logging_service = args[:logging_service] if args.key?(:logging_service) + @status_message = args[:status_message] if args.key?(:status_message) + @master_auth = args[:master_auth] if args.key?(:master_auth) + @current_master_version = args[:current_master_version] if args.key?(:current_master_version) + @node_config = args[:node_config] if args.key?(:node_config) + @addons_config = args[:addons_config] if args.key?(:addons_config) + @status = args[:status] if args.key?(:status) + @current_node_version = args[:current_node_version] if args.key?(:current_node_version) + @subnetwork = args[:subnetwork] if args.key?(:subnetwork) + @resource_labels = args[:resource_labels] if args.key?(:resource_labels) + @name = args[:name] if args.key?(:name) + @initial_cluster_version = args[:initial_cluster_version] if args.key?(:initial_cluster_version) + @endpoint = args[:endpoint] if args.key?(:endpoint) + @legacy_abac = args[:legacy_abac] if args.key?(:legacy_abac) + @create_time = args[:create_time] if args.key?(:create_time) + @cluster_ipv4_cidr = args[:cluster_ipv4_cidr] if args.key?(:cluster_ipv4_cidr) + @initial_node_count = args[:initial_node_count] if args.key?(:initial_node_count) + @node_pools = args[:node_pools] if args.key?(:node_pools) + @locations = args[:locations] if args.key?(:locations) + @self_link = args[:self_link] if args.key?(:self_link) + @instance_group_urls = args[:instance_group_urls] if args.key?(:instance_group_urls) + @services_ipv4_cidr = args[:services_ipv4_cidr] if args.key?(:services_ipv4_cidr) + @enable_kubernetes_alpha = args[:enable_kubernetes_alpha] if args.key?(:enable_kubernetes_alpha) + @description = args[:description] if args.key?(:description) + @current_node_count = args[:current_node_count] if args.key?(:current_node_count) + @monitoring_service = args[:monitoring_service] if args.key?(:monitoring_service) + end + end + + # CreateNodePoolRequest creates a node pool for a cluster. + class CreateNodePoolRequest + include Google::Apis::Core::Hashable + + # NodePool contains the name and configuration for a cluster's node pool. + # Node pools are a set of nodes (i.e. VM's), with a common configuration and + # specification, under the control of the cluster master. They may have a set + # of Kubernetes labels applied to them, which may be used to reference them + # during pod scheduling. They may also be resized up or down, to accommodate + # the workload. + # Corresponds to the JSON property `nodePool` + # @return [Google::Apis::ContainerV1::NodePool] + attr_accessor :node_pool + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @node_pool = args[:node_pool] if args.key?(:node_pool) + end + end + + # ListOperationsResponse is the result of ListOperationsRequest. + class ListOperationsResponse + include Google::Apis::Core::Hashable + + # A list of operations in the project in the specified zone. + # Corresponds to the JSON property `operations` + # @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 + + # 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 service configuration. + class ServerConfig + include Google::Apis::Core::Hashable + + # List of valid master versions. + # Corresponds to the JSON property `validMasterVersions` + # @return [Array<String>] + attr_accessor :valid_master_versions + + # Version of Kubernetes the service deploys by default. + # Corresponds to the JSON property `defaultClusterVersion` + # @return [String] + attr_accessor :default_cluster_version + + # Default image type. + # Corresponds to the JSON property `defaultImageType` + # @return [String] + attr_accessor :default_image_type + + # List of valid node upgrade target versions. + # Corresponds to the JSON property `validNodeVersions` + # @return [Array<String>] + attr_accessor :valid_node_versions + + # List of valid image types. + # Corresponds to the JSON property `validImageTypes` + # @return [Array<String>] + attr_accessor :valid_image_types + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @valid_master_versions = args[:valid_master_versions] if args.key?(:valid_master_versions) + @default_cluster_version = args[:default_cluster_version] if args.key?(:default_cluster_version) + @default_image_type = args[:default_image_type] if args.key?(:default_image_type) + @valid_node_versions = args[:valid_node_versions] if args.key?(:valid_node_versions) + @valid_image_types = args[:valid_image_types] if args.key?(:valid_image_types) end end end end end