classes.rb in google-api-client-0.21.0

- old
+ new

@@ -113,12 +113,12 @@
       
         # Optional. The minimum number of nodes to allocate for this model. These
         # nodes are always up, starting from the time the model is deployed, so the
         # cost of operating this model will be at least
         # `rate` * `min_nodes` * number of hours since last billing cycle,
-        # where `rate` is the cost per node-hour as documented in
-        # [pricing](https://cloud.google.com/ml-engine/pricing#prediction_pricing),
+        # where `rate` is the cost per node-hour as documented in the
+        # [pricing guide](/ml-engine/docs/pricing),
         # even if no predictions are performed. There is additional cost for each
         # prediction performed.
         # Unlike manual scaling, if the load gets too heavy for the nodes
         # that are up, the service will automatically add nodes to handle the
         # increased load as well as scale back as traffic drops, always maintaining
@@ -279,10 +279,18 @@
       
       # Represents a set of hyperparameters to optimize.
       class GoogleCloudMlV1HyperparameterSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. The search algorithm specified for the hyperparameter
+        # tuning job.
+        # Uses the default CloudML Engine hyperparameter tuning
+        # algorithm if unspecified.
+        # Corresponds to the JSON property `algorithm`
+        # @return [String]
+        attr_accessor :algorithm
+      
         # Optional. Indicates if the hyperparameter tuning job enables auto trial
         # early stopping.
         # Corresponds to the JSON property `enableTrialEarlyStopping`
         # @return [Boolean]
         attr_accessor :enable_trial_early_stopping
@@ -339,10 +347,11 @@
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @algorithm = args[:algorithm] if args.key?(:algorithm)
           @enable_trial_early_stopping = args[:enable_trial_early_stopping] if args.key?(:enable_trial_early_stopping)
           @goal = args[:goal] if args.key?(:goal)
           @hyperparameter_metric_tag = args[:hyperparameter_metric_tag] if args.key?(:hyperparameter_metric_tag)
           @max_parallel_trials = args[:max_parallel_trials] if args.key?(:max_parallel_trials)
           @max_trials = args[:max_trials] if args.key?(:max_trials)
@@ -398,12 +407,12 @@
         # Represents input parameters for a training job. When using the
         # gcloud command to submit your training job, you can specify
         # the input parameters as command-line arguments and/or in a YAML configuration
         # file referenced from the --config command-line argument. For
         # details, see the guide to
-        # <a href="/ml-engine/docs/training-jobs">submitting a training job</a>.
-        # Next ID: 22
+        # <a href="/ml-engine/docs/tensorflow/training-jobs">submitting a training
+        # job</a>.
         # Corresponds to the JSON property `trainingInput`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1TrainingInput]
         attr_accessor :training_input
       
         # Represents results of a training job. Output only.
@@ -617,12 +626,12 @@
         alias_method :online_prediction_logging?, :online_prediction_logging
       
         # Optional. The list of regions where the model is going to be deployed.
         # Currently only one region per model is supported.
         # Defaults to 'us-central1' if nothing is set.
-        # See the <a href="/ml-engine/docs/regions">available regions</a> for
-        # ML Engine services.
+        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
+        # for ML Engine services.
         # Note:
         # *   No matter where a model is deployed, it can always be accessed by
         # users from anywhere, both for online and batch prediction.
         # *   The region for a batch prediction job is set by the region field when
         # submitting the batch prediction job and does not take its value from
@@ -854,23 +863,23 @@
         # @return [Fixnum]
         attr_accessor :max_worker_count
       
         # Use this field if you want to use the default version for the specified
         # model. The string must use the following format:
-        # `"projects/<var>[YOUR_PROJECT]</var>/models/<var>[YOUR_MODEL]</var>"`
+        # `"projects/YOUR_PROJECT/models/YOUR_MODEL"`
         # Corresponds to the JSON property `modelName`
         # @return [String]
         attr_accessor :model_name
       
         # Required. The output Google Cloud Storage location.
         # Corresponds to the JSON property `outputPath`
         # @return [String]
         attr_accessor :output_path
       
         # Required. The Google Compute Engine region to run the prediction job in.
-        # See the <a href="/ml-engine/docs/regions">available regions</a> for
-        # ML Engine services.
+        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
+        # for ML Engine services.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
         # Optional. The Google Cloud ML runtime version to use for this batch
@@ -901,12 +910,11 @@
         attr_accessor :uri
       
         # Use this field if you want to specify a version of the model to use. The
         # string is formatted the same way as `model_version`, with the addition
         # of the version information:
-        # `"projects/<var>[YOUR_PROJECT]</var>/models/<var>YOUR_MODEL/versions/<var>[
-        # YOUR_VERSION]</var>"`
+        # `"projects/YOUR_PROJECT/models/YOUR_MODEL/versions/YOUR_VERSION"`
         # Corresponds to the JSON property `versionName`
         # @return [String]
         attr_accessor :version_name
       
         def initialize(**args)
@@ -982,12 +990,12 @@
       # Represents input parameters for a training job. When using the
       # gcloud command to submit your training job, you can specify
       # the input parameters as command-line arguments and/or in a YAML configuration
       # file referenced from the --config command-line argument. For
       # details, see the guide to
-      # <a href="/ml-engine/docs/training-jobs">submitting a training job</a>.
-      # Next ID: 22
+      # <a href="/ml-engine/docs/tensorflow/training-jobs">submitting a training
+      # job</a>.
       class GoogleCloudMlV1TrainingInput
         include Google::Apis::Core::Hashable
       
         # Optional. Command line arguments to pass to the program.
         # Corresponds to the JSON property `args`
@@ -1040,12 +1048,12 @@
         # </dd>
         # <dt>standard_gpu</dt>
         # <dd>
         # A machine equivalent to <code suppresswarning="true">standard</code> that
         # also includes a single NVIDIA Tesla K80 GPU. See more about
-        # <a href="/ml-engine/docs/how-tos/using-gpus">
-        # using GPUs for training your model</a>.
+        # <a href="/ml-engine/docs/tensorflow/using-gpus">using GPUs to
+        # train your model</a>.
         # </dd>
         # <dt>complex_model_m_gpu</dt>
         # <dd>
         # A machine equivalent to
         # <code suppresswarning="true">complex_model_m</code> that also includes
@@ -1068,10 +1076,17 @@
         # A machine equivalent to
         # <code suppresswarning="true">complex_model_m</code> that also includes
         # four NVIDIA Tesla P100 GPUs. The availability of these GPUs is in
         # the Beta launch stage.
         # </dd>
+        # <dt>standard_tpu</dt>
+        # <dd>
+        # A TPU VM including one Cloud TPU. The availability of Cloud TPU is in
+        # <i>Beta</i> launch stage. See more about
+        # <a href="/ml-engine/docs/tensorflow/using-tpus">using TPUs to train
+        # your model</a>.
+        # </dd>
         # </dl>
         # You must set this value when `scaleTier` is set to `CUSTOM`.
         # Corresponds to the JSON property `masterType`
         # @return [String]
         attr_accessor :master_type
@@ -1113,18 +1128,19 @@
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
       
         # Required. The Google Compute Engine region to run the training job in.
-        # See the <a href="/ml-engine/docs/regions">available regions</a> for
-        # ML Engine services.
+        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
+        # for ML Engine services.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
         # Optional. The Google Cloud ML runtime version to use for training.  If not
-        # set, Google Cloud ML will choose the latest stable version.
+        # set, Google Cloud ML will choose a stable version, which is defined in the
+        # documentation of runtime version list.
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
         attr_accessor :runtime_version
       
         # Required. Specifies the machine types, the number of replicas for workers
@@ -1233,12 +1249,12 @@
         # @return [String]
         attr_accessor :create_time
       
         # Required. The Google Cloud Storage location of the trained model used to
         # create the version. See the
-        # [overview of model
-        # deployment](/ml-engine/docs/concepts/deployment-overview) for more
+        # [guide to model
+        # deployment](/ml-engine/docs/tensorflow/deploying-models) for more
         # information.
         # When passing Version to
         # [projects.models.versions.create](/ml-engine/reference/rest/v1/projects.models.
         # versions/create)
         # the model service uses the specified location as the source of the model.
@@ -1383,11 +1399,10 @@
       # bar@gmail.com from DATA_WRITE logging.
       class GoogleIamV1AuditConfig
         include Google::Apis::Core::Hashable
       
         # The configuration for logging of each type of permission.
-        # Next ID: 4
         # Corresponds to the JSON property `auditLogConfigs`
         # @return [Array<Google::Apis::MlV1::GoogleIamV1AuditLogConfig>]
         attr_accessor :audit_log_configs
       
         # Specifies a service that will be enabled for audit logging.
@@ -1460,11 +1475,11 @@
         # * `allUsers`: A special identifier that represents anyone who is
         # on the internet; with or without a Google account.
         # * `allAuthenticatedUsers`: A special identifier that represents anyone
         # who is authenticated with a Google account or a service account.
         # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@gmail.com` or `joe@example.com`.
+        # account. For example, `alice@gmail.com` .
         # * `serviceAccount:`emailid``: An email address that represents a service
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
         # For example, `admins@example.com`.
         # * `domain:`domain``: A Google Apps domain name that represents all the
@@ -1491,32 +1506,43 @@
         end
       end
       
       # Defines an Identity and Access Management (IAM) policy. It is used to
       # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
       # `members` to a `role`, where the members can be user accounts, Google groups,
       # Google domains, and service accounts. A `role` is a named list of permissions
       # defined by IAM.
-      # **Example**
+      # **JSON Example**
       # `
       # "bindings": [
       # `
       # "role": "roles/owner",
       # "members": [
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
       # "role": "roles/viewer",
       # "members": ["user:sean@example.com"]
       # `
       # ]
       # `
+      # **YAML Example**
+      # bindings:
+      # - members:
+      # - user:mike@example.com
+      # - group:admins@example.com
+      # - domain:google.com
+      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+      # role: roles/owner
+      # - members:
+      # - user:sean@example.com
+      # role: roles/viewer
       # For a description of IAM and its features, see the
       # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class GoogleIamV1Policy
         include Google::Apis::Core::Hashable
       
@@ -1567,31 +1593,42 @@
       class GoogleIamV1SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
         # Defines an Identity and Access Management (IAM) policy. It is used to
         # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
         # `members` to a `role`, where the members can be user accounts, Google groups,
         # Google domains, and service accounts. A `role` is a named list of permissions
         # defined by IAM.
-        # **Example**
+        # **JSON Example**
         # `
         # "bindings": [
         # `
         # "role": "roles/owner",
         # "members": [
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
         # "role": "roles/viewer",
         # "members": ["user:sean@example.com"]
         # `
         # ]
         # `
+        # **YAML Example**
+        # bindings:
+        # - members:
+        # - user:mike@example.com
+        # - group:admins@example.com
+        # - domain:google.com
+        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+        # role: roles/owner
+        # - members:
+        # - user:sean@example.com
+        # role: roles/viewer
         # For a description of IAM and its features, see the
         # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::MlV1::GoogleIamV1Policy]
         attr_accessor :policy