generated/google/apis/servicemanagement_v1/service.rb in google-api-client-0.32.1 vs generated/google/apis/servicemanagement_v1/service.rb in google-api-client-0.33.0
- old
+ new
@@ -173,11 +173,12 @@
# `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>
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # 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
# Available to use for quota purposes for server-side applications. Can be any
@@ -207,11 +208,11 @@
# 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>
# @param [String] service_name
- # Name of the service to disable. Specifying an unknown service name
+ # Required. Name of the service to disable. Specifying an unknown service name
# will cause the request to fail.
# @param [Google::Apis::ServicemanagementV1::DisableServiceRequest] disable_service_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
@@ -245,11 +246,12 @@
# for the project. See
# [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for
# more information.
# Operation<response: EnableServiceResponse>
# @param [String] service_name
- # Name of the service to enable. Specifying an unknown service name will
+ # Required. Name of the service to enable. Specifying an unknown service name
+ # 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.
# @param [String] quota_user
@@ -319,11 +321,12 @@
end
# Gets a managed service. Authentication is required unless the service is
# public.
# @param [String] service_name
- # The name of the service. See the `ServiceManager` overview for naming
+ # 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
# Available to use for quota purposes for server-side applications. Can be any
@@ -350,14 +353,15 @@
execute_or_queue_command(command, &block)
end
# Gets a service configuration (version) for a managed service.
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # Required. The name of the service. See the [overview](/service-management/
+ # overview)
# for naming requirements. For example: `example.googleapis.com`.
# @param [String] config_id
- # The id of the service configuration resource.
+ # 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.
@@ -476,10 +480,11 @@
execute_or_queue_command(command, &block)
end
# Sets the access control policy on the specified resource. Replaces any
# existing policy.
+ # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
# @param [String] resource
# 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
@@ -554,11 +559,12 @@
# 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>
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # 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
# Available to use for quota purposes for server-side applications. Can be any
@@ -591,11 +597,12 @@
# 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
- # The name of the service. See the [overview](/service-management/overview)
+ # 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.
# @param [String] quota_user
@@ -625,14 +632,15 @@
execute_or_queue_command(command, &block)
end
# Gets a service configuration (version) for a managed service.
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # Required. The name of the service. See the [overview](/service-management/
+ # overview)
# for naming requirements. For example: `example.googleapis.com`.
# @param [String] config_id
- # The id of the service configuration resource.
+ # 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.
@@ -666,11 +674,12 @@
end
# Lists the history of the service configuration for a managed service,
# from the newest to the oldest.
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # 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.
# @param [String] page_token
@@ -714,11 +723,12 @@
# 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>
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # 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.
# @param [String] quota_user
@@ -784,10 +794,11 @@
execute_or_queue_command(command, &block)
end
# Sets the access control policy on the specified resource. Replaces any
# existing policy.
+ # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
# @param [String] resource
# 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
@@ -868,11 +879,12 @@
# 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>
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # 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] base_rollout_id
# Unimplemented. Do not use this feature until this comment is removed.
# The rollout id that rollout to be created based on.
@@ -910,14 +922,15 @@
execute_or_queue_command(command, &block)
end
# Gets a service configuration rollout.
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # Required. The name of the service. See the [overview](/service-management/
+ # overview)
# for naming requirements. For example: `example.googleapis.com`.
# @param [String] rollout_id
- # The id of the rollout resource.
+ # Required. The id of the rollout resource.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -945,13 +958,14 @@
end
# Lists the history of the service configuration rollouts for a managed
# service, from the newest to the oldest.
# @param [String] service_name
- # The name of the service. See the [overview](/service-management/overview)
+ # Required. The name of the service. See the [overview](/service-management/
+ # overview)
# for naming requirements. For example: `example.googleapis.com`.
# @param [String] filter
- # Use `filter` to return subset of rollouts.
+ # 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