google-api-client 0.43.0 → 0.44.0

data/generated/google/apis/servicemanagement_v1/service.rb

@@ -49,9 +49,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -83,28 +82,22 @@ module Google
         
         # Lists service operations that match the specified filter in the request.
         # @param [String] filter
-        #   A string for filtering Operations.
-        #   The following filter fields are supported:
-        #   * serviceName: Required. Only `=` operator is allowed.
-        #   * startTime: The time this job was started, in ISO 8601 format.
-        #   Allowed operators are `>=`,  `>`, `<=`, and `<`.
-        #   * status&#58; Can be `done`, `in_progress`, or `failed`. Allowed
-        #   operators are `=`, and `!=`.
-        #   Filter expression supports conjunction (AND) and disjunction (OR)
-        #   logical operators. However, the serviceName restriction must be at the
-        #   top-level and can only be combined with other restrictions via the AND
-        #   logical operator.
-        #   Examples&#58;
-        #   * `serviceName=`some-service`.googleapis.com`
-        #   * `serviceName=`some-service`.googleapis.com AND startTime>="2017-02-01"`
-        #   * `serviceName=`some-service`.googleapis.com AND status=done`
-        #   * `serviceName=`some-service`.googleapis.com AND (status=done OR startTime>="
-        #   2017-02-01")`
+        #   A string for filtering Operations. The following filter fields are supported: *
+        #   serviceName: Required. Only `=` operator is allowed. * startTime: The time
+        #   this job was started, in ISO 8601 format. Allowed operators are `>=`, `>`, `<=`
+        #   , and `<`. * status: Can be `done`, `in_progress`, or `failed`. Allowed
+        #   operators are `=`, and `!=`. Filter expression supports conjunction (AND) and
+        #   disjunction (OR) logical operators. However, the serviceName restriction must
+        #   be at the top-level and can only be combined with other restrictions via the
+        #   AND logical operator. Examples: * `serviceName=`some-service`.googleapis.com` *
+        #   `serviceName=`some-service`.googleapis.com AND startTime>="2017-02-01"` * `
+        #   serviceName=`some-service`.googleapis.com AND status=done` * `serviceName=`
+        #   some-service`.googleapis.com AND (status=done OR startTime>="2017-02-01")`
         # @param [String] name
         #   Not used.
         # @param [Fixnum] page_size
-        #   The maximum number of operations to return. If unspecified, defaults to
-        #   50. The maximum value is 100.
+        #   The maximum number of operations to return. If unspecified, defaults to 50.
+        #   The maximum value is 100.
         # @param [String] page_token
         #   The standard list page token.
         # @param [String] fields
@@ -137,14 +130,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new managed service.
-        # A managed service is immutable, and is subject to mandatory 30-day
-        # data retention. You cannot move a service or recreate it within 30 days
-        # after deletion.
-        # One producer project can own no more than 500 services. For security and
-        # reliability purposes, a production service should be hosted in a
-        # dedicated producer project.
-        # Operation<response: ManagedService>
+        # Creates a new managed service. A managed service is immutable, and is subject
+        # to mandatory 30-day data retention. You cannot move a service or recreate it
+        # within 30 days after deletion. One producer project can own no more than 500
+        # services. For security and reliability purposes, a production service should
+        # be hosted in a dedicated producer project. Operation
         # @param [Google::Apis::ServicemanagementV1::ManagedService] managed_service_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -174,15 +164,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a managed service. This method will change the service to the
-        # `Soft-Delete` state for 30 days. Within this period, service producers may
-        # call UndeleteService to restore the service.
-        # After 30 days, the service will be permanently deleted.
-        # Operation<response: google.protobuf.Empty>
+        # Deletes a managed service. This method will change the service to the `Soft-
+        # Delete` state for 30 days. Within this period, service producers may call
+        # UndeleteService to restore the service. After 30 days, the service will be
+        # permanently deleted. Operation
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -210,10 +198,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Disables a service for a project, so it can no longer be
-        # be used for the project. It prevents accidental usage that may cause
-        # unexpected billing charges or security leaks.
-        # Operation<response: DisableServiceResponse>
+        # Disables a service for a project, so it can no longer be be used for the
+        # project. It prevents accidental usage that may cause unexpected billing
+        # charges or security leaks. Operation
         # @param [String] service_name
         #   Required. Name of the service to disable. Specifying an unknown service name
         #   will cause the request to fail.
@@ -247,15 +234,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Enables a service for a project, so it can be used
-        # for the project. See
-        # [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for
-        # more information.
-        # Operation<response: EnableServiceResponse>
+        # Enables a service for a project, so it can be used for the project. See [Cloud
+        # Auth Guide](https://cloud.google.com/docs/authentication) for more information.
+        # Operation
         # @param [String] service_name
         #   Required. Name of the service to enable. Specifying an unknown service name
-        #   will
-        #   cause the request to fail.
+        #   will cause the request to fail.
         # @param [Google::Apis::ServicemanagementV1::EnableServiceRequest] enable_service_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -286,16 +270,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Generates and returns a report (errors, warnings and changes from
-        # existing configurations) associated with
-        # GenerateConfigReportRequest.new_value
-        # If GenerateConfigReportRequest.old_value is specified,
+        # Generates and returns a report (errors, warnings and changes from existing
+        # configurations) associated with GenerateConfigReportRequest.new_value If
+        # GenerateConfigReportRequest.old_value is specified,
         # GenerateConfigReportRequest will contain a single ChangeReport based on the
         # comparison between GenerateConfigReportRequest.new_value and
-        # GenerateConfigReportRequest.old_value.
-        # If GenerateConfigReportRequest.old_value is not specified, this method
-        # will compare GenerateConfigReportRequest.new_value with the last pushed
-        # service configuration.
+        # GenerateConfigReportRequest.old_value. If GenerateConfigReportRequest.
+        # old_value is not specified, this method will compare
+        # GenerateConfigReportRequest.new_value with the last pushed service
+        # configuration.
         # @param [Google::Apis::ServicemanagementV1::GenerateConfigReportRequest] generate_config_report_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -328,9 +311,8 @@ module Google
         # Gets a managed service. Authentication is required unless the service is
         # public.
         # @param [String] service_name
-        #   Required. The name of the service.  See the `ServiceManager` overview for
-        #   naming
-        #   requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the `ServiceManager` overview for
+        #   naming requirements. For example: `example.googleapis.com`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -360,16 +342,13 @@ module Google
         
         # Gets a service configuration (version) for a managed service.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] config_id
-        #   Required. The id of the service configuration resource.
-        #   This field must be specified for the server to return all fields, including
-        #   `SourceInfo`.
+        #   Required. The id of the service configuration resource. This field must be
+        #   specified for the server to return all fields, including `SourceInfo`.
         # @param [String] view
-        #   Specifies which parts of the Service Config should be returned in the
-        #   response.
+        #   Specifies which parts of the Service Config should be returned in the response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -399,12 +378,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
-        # Returns an empty policy if the resource exists and does not have a policy
-        # set.
+        # Gets the access control policy for a resource. Returns an empty policy if the
+        # resource exists and does not have a policy set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -435,24 +413,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists managed services.
-        # Returns all public services. For authenticated users, also returns all
-        # services the calling user has "servicemanagement.services.get" permission
-        # for.
-        # **BETA:** If the caller specifies the `consumer_id`, it returns only the
-        # services enabled on the consumer. The `consumer_id` must have the format
-        # of "project:`PROJECT-ID`".
+        # Lists managed services. Returns all public services. For authenticated users,
+        # also returns all services the calling user has "servicemanagement.services.get"
+        # permission for. **BETA:** If the caller specifies the `consumer_id`, it
+        # returns only the services enabled on the consumer. The `consumer_id` must have
+        # the format of "project:`PROJECT-ID`".
         # @param [String] consumer_id
-        #   Include services consumed by the specified consumer.
-        #   The Google Service Management implementation accepts the following
-        #   forms:
-        #   - project:<project_id>
+        #   Include services consumed by the specified consumer. The Google Service
+        #   Management implementation accepts the following forms: - project:
         # @param [Fixnum] page_size
-        #   The max number of items to include in the response list. Page size is 50
-        #   if not specified. Maximum value is 100.
+        #   The max number of items to include in the response list. Page size is 50 if
+        #   not specified. Maximum value is 100.
         # @param [String] page_token
-        #   Token identifying which result to start with; returned by a previous list
-        #   call.
+        #   Token identifying which result to start with; returned by a previous list call.
         # @param [String] producer_project_id
         #   Include services produced by the specified project.
         # @param [String] fields
@@ -486,11 +459,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -521,15 +494,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
-        # If the resource does not exist, this will return an empty set of
-        # permissions, not a `NOT_FOUND` error.
-        # Note: This operation is designed to be used for building permission-aware
-        # UIs and command-line tools, not for authorization checking. This operation
-        # may "fail open" without warning.
+        # Returns permissions that a caller has on the specified resource. If the
+        # resource does not exist, this will return an empty set of permissions, not a `
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
+        # permission-aware UIs and command-line tools, not for authorization checking.
+        # This operation may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -560,15 +532,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Revives a previously deleted managed service. The method restores the
-        # service using the configuration at the time the service was deleted.
-        # The target service must exist and must have been deleted within the
-        # last 30 days.
-        # Operation<response: UndeleteServiceResponse>
+        # Revives a previously deleted managed service. The method restores the service
+        # using the configuration at the time the service was deleted. The target
+        # service must exist and must have been deleted within the last 30 days.
+        # Operation
         # @param [String] service_name
         #   Required. The name of the service. See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements. For example: `example.googleapis.com`.
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -596,17 +566,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new service configuration (version) for a managed service.
-        # This method only stores the service configuration. To roll out the service
-        # configuration to backend systems please call
-        # CreateServiceRollout.
-        # Only the 100 most recent service configurations and ones referenced by
-        # existing rollouts are kept for each service. The rest will be deleted
-        # eventually.
+        # Creates a new service configuration (version) for a managed service. This
+        # method only stores the service configuration. To roll out the service
+        # configuration to backend systems please call CreateServiceRollout. Only the
+        # 100 most recent service configurations and ones referenced by existing
+        # rollouts are kept for each service. The rest will be deleted eventually.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [Google::Apis::ServicemanagementV1::Service] service_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -639,16 +606,13 @@ module Google
         
         # Gets a service configuration (version) for a managed service.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] config_id
-        #   Required. The id of the service configuration resource.
-        #   This field must be specified for the server to return all fields, including
-        #   `SourceInfo`.
+        #   Required. The id of the service configuration resource. This field must be
+        #   specified for the server to return all fields, including `SourceInfo`.
         # @param [String] view
-        #   Specifies which parts of the Service Config should be returned in the
-        #   response.
+        #   Specifies which parts of the Service Config should be returned in the response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -678,15 +642,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the history of the service configuration for a managed service,
-        # from the newest to the oldest.
+        # Lists the history of the service configuration for a managed service, from the
+        # newest to the oldest.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [Fixnum] page_size
-        #   The max number of items to include in the response list. Page size is 50
-        #   if not specified. Maximum value is 100.
+        #   The max number of items to include in the response list. Page size is 50 if
+        #   not specified. Maximum value is 100.
         # @param [String] page_token
         #   The token of the page to retrieve.
         # @param [String] fields
@@ -718,21 +681,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new service configuration (version) for a managed service based
-        # on
-        # user-supplied configuration source files (for example: OpenAPI
-        # Specification). This method stores the source configurations as well as the
-        # generated service configuration. To rollout the service configuration to
-        # other services,
-        # please call CreateServiceRollout.
-        # Only the 100 most recent configuration sources and ones referenced by
-        # existing service configurtions are kept for each service. The rest will be
-        # deleted eventually.
-        # Operation<response: SubmitConfigSourceResponse>
+        # Creates a new service configuration (version) for a managed service based on
+        # user-supplied configuration source files (for example: OpenAPI Specification).
+        # This method stores the source configurations as well as the generated service
+        # configuration. To rollout the service configuration to other services, please
+        # call CreateServiceRollout. Only the 100 most recent configuration sources and
+        # ones referenced by existing service configurtions are kept for each service.
+        # The rest will be deleted eventually. Operation
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [Google::Apis::ServicemanagementV1::SubmitConfigSourceRequest] submit_config_source_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -763,12 +721,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
-        # Returns an empty policy if the resource exists and does not have a policy
-        # set.
+        # Gets the access control policy for a resource. Returns an empty policy if the
+        # resource exists and does not have a policy set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -800,11 +757,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -835,15 +792,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
-        # If the resource does not exist, this will return an empty set of
-        # permissions, not a `NOT_FOUND` error.
-        # Note: This operation is designed to be used for building permission-aware
-        # UIs and command-line tools, not for authorization checking. This operation
-        # may "fail open" without warning.
+        # Returns permissions that a caller has on the specified resource. If the
+        # resource does not exist, this will return an empty set of permissions, not a `
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
+        # permission-aware UIs and command-line tools, not for authorization checking.
+        # This operation may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ServicemanagementV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -874,21 +830,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new service configuration rollout. Based on rollout, the
-        # Google Service Management will roll out the service configurations to
-        # different backend services. For example, the logging configuration will be
-        # pushed to Google Cloud Logging.
-        # Please note that any previous pending and running Rollouts and associated
-        # Operations will be automatically cancelled so that the latest Rollout will
-        # not be blocked by previous Rollouts.
-        # Only the 100 most recent (in any state) and the last 10 successful (if not
-        # already part of the set of 100 most recent) rollouts are kept for each
-        # service. The rest will be deleted eventually.
-        # Operation<response: Rollout>
+        # Creates a new service configuration rollout. Based on rollout, the Google
+        # Service Management will roll out the service configurations to different
+        # backend services. For example, the logging configuration will be pushed to
+        # Google Cloud Logging. Please note that any previous pending and running
+        # Rollouts and associated Operations will be automatically cancelled so that the
+        # latest Rollout will not be blocked by previous Rollouts. Only the 100 most
+        # recent (in any state) and the last 10 successful (if not already part of the
+        # set of 100 most recent) rollouts are kept for each service. The rest will be
+        # deleted eventually. Operation
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [Google::Apis::ServicemanagementV1::Rollout] rollout_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -921,9 +874,8 @@ module Google
         
         # Gets a service configuration rollout.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] rollout_id
         #   Required. The id of the rollout resource.
         # @param [String] fields
@@ -954,24 +906,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the history of the service configuration rollouts for a managed
-        # service, from the newest to the oldest.
+        # Lists the history of the service configuration rollouts for a managed service,
+        # from the newest to the oldest.
         # @param [String] service_name
-        #   Required. The name of the service.  See the [overview](/service-management/
-        #   overview)
-        #   for naming requirements.  For example: `example.googleapis.com`.
+        #   Required. The name of the service. See the [overview](/service-management/
+        #   overview) for naming requirements. For example: `example.googleapis.com`.
         # @param [String] filter
-        #   Required. Use `filter` to return subset of rollouts.
-        #   The following filters are supported:
-        #   -- To limit the results to only those in
-        #   [status](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
-        #   use filter='status=SUCCESS'
-        #   -- To limit the results to those in
-        #   [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
-        #   or 'FAILED', use filter='status=CANCELLED OR status=FAILED'
+        #   Required. Use `filter` to return subset of rollouts. The following filters are
+        #   supported: -- To limit the results to only those in [status](google.api.
+        #   servicemanagement.v1.RolloutStatus) 'SUCCESS', use filter='status=SUCCESS' --
+        #   To limit the results to those in [status](google.api.servicemanagement.v1.
+        #   RolloutStatus) 'CANCELLED' or 'FAILED', use filter='status=CANCELLED OR status=
+        #   FAILED'
         # @param [Fixnum] page_size
-        #   The max number of items to include in the response list. Page size is 50
-        #   if not specified. Maximum value is 100.
+        #   The max number of items to include in the response list. Page size is 50 if
+        #   not specified. Maximum value is 100.
         # @param [String] page_token
         #   The token of the page to retrieve.
         # @param [String] fields