google-cloud-service_management-v1 0.1.0

data/proto_docs/google/api/resource.rb

@@ -0,0 +1,283 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # A simple descriptor of a resource type.
+    #
+    # ResourceDescriptor annotates a resource message (either by means of a
+    # protobuf annotation or use in the service config), and associates the
+    # resource's schema, the resource type, and the pattern of the resource name.
+    #
+    # Example:
+    #
+    #     message Topic {
+    #       // Indicates this message defines a resource schema.
+    #       // Declares the resource type in the format of {service}/{kind}.
+    #       // For Kubernetes resources, the format is {api group}/{kind}.
+    #       option (google.api.resource) = {
+    #         type: "pubsub.googleapis.com/Topic"
+    #         name_descriptor: {
+    #           pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #
+    # Sometimes, resources have multiple patterns, typically because they can
+    # live under multiple parents.
+    #
+    # Example:
+    #
+    #     message LogEntry {
+    #       option (google.api.resource) = {
+    #         type: "logging.googleapis.com/LogEntry"
+    #         name_descriptor: {
+    #           pattern: "projects/{project}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "folders/{folder}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #           parent_name_extractor: "folders/{folder}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "organizations/{organization}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
+    #           parent_name_extractor: "organizations/{organization}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
+    #           parent_type: "billing.googleapis.com/BillingAccount"
+    #           parent_name_extractor: "billingAccounts/{billing_account}"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #     resources:
+    #     - type: 'logging.googleapis.com/LogEntry'
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         - pattern: "folders/{folder}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #           parent_name_extractor: "folders/{folder}"
+    #         - pattern: "organizations/{organization}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
+    #           parent_name_extractor: "organizations/{organization}"
+    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
+    #           parent_type: "billing.googleapis.com/BillingAccount"
+    #           parent_name_extractor: "billingAccounts/{billing_account}"
+    #
+    # For flexible resources, the resource name doesn't contain parent names, but
+    # the resource itself has parents for policy evaluation.
+    #
+    # Example:
+    #
+    #     message Shelf {
+    #       option (google.api.resource) = {
+    #         type: "library.googleapis.com/Shelf"
+    #         name_descriptor: {
+    #           pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #     resources:
+    #     - type: 'library.googleapis.com/Shelf'
+    #       name_descriptor:
+    #         - pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #         - pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    # @!attribute [rw] type
+    #   @return [::String]
+    #     The resource type. It must be in the format of
+    #     \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
+    #     singular and must not include version numbers.
+    #
+    #     Example: `storage.googleapis.com/Bucket`
+    #
+    #     The value of the resource_type_kind must follow the regular expression
+    #     /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
+    #     should use PascalCase (UpperCamelCase). The maximum number of
+    #     characters allowed for the `resource_type_kind` is 100.
+    # @!attribute [rw] pattern
+    #   @return [::Array<::String>]
+    #     Optional. The relative resource name pattern associated with this resource
+    #     type. The DNS prefix of the full resource name shouldn't be specified here.
+    #
+    #     The path pattern must follow the syntax, which aligns with HTTP binding
+    #     syntax:
+    #
+    #         Template = Segment { "/" Segment } ;
+    #         Segment = LITERAL | Variable ;
+    #         Variable = "{" LITERAL "}" ;
+    #
+    #     Examples:
+    #
+    #         - "projects/\\{project}/topics/\\{topic}"
+    #         - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
+    #
+    #     The components in braces correspond to the IDs for each resource in the
+    #     hierarchy. It is expected that, if multiple patterns are provided,
+    #     the same component name (e.g. "project") refers to IDs of the same
+    #     type of resource.
+    # @!attribute [rw] name_field
+    #   @return [::String]
+    #     Optional. The field on the resource that designates the resource name
+    #     field. If omitted, this is assumed to be "name".
+    # @!attribute [rw] history
+    #   @return [::Google::Api::ResourceDescriptor::History]
+    #     Optional. The historical or future-looking state of the resource pattern.
+    #
+    #     Example:
+    #
+    #         // The InspectTemplate message originally only supported resource
+    #         // names with organization, and project was added later.
+    #         message InspectTemplate {
+    #           option (google.api.resource) = {
+    #             type: "dlp.googleapis.com/InspectTemplate"
+    #             pattern:
+    #             "organizations/{organization}/inspectTemplates/{inspect_template}"
+    #             pattern: "projects/{project}/inspectTemplates/{inspect_template}"
+    #             history: ORIGINALLY_SINGLE_PATTERN
+    #           };
+    #         }
+    # @!attribute [rw] plural
+    #   @return [::String]
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
+    #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
+    # @!attribute [rw] singular
+    #   @return [::String]
+    #     The same concept of the `singular` field in k8s CRD spec
+    #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
+    class ResourceDescriptor
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # A description of the historical or future-looking state of the
+      # resource pattern.
+      module History
+        # The "unset" value.
+        HISTORY_UNSPECIFIED = 0
+
+        # The resource originally had one pattern and launched as such, and
+        # additional patterns were added later.
+        ORIGINALLY_SINGLE_PATTERN = 1
+
+        # The resource has one pattern, but the API owner expects to add more
+        # later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents
+        # that from being necessary once there are multiple patterns.)
+        FUTURE_MULTI_PATTERN = 2
+      end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
+    end
+
+    # Defines a proto annotation that describes a string field that refers to
+    # an API resource.
+    # @!attribute [rw] type
+    #   @return [::String]
+    #     The resource type that the annotated field references.
+    #
+    #     Example:
+    #
+    #         message Subscription {
+    #           string topic = 2 [(google.api.resource_reference) = {
+    #             type: "pubsub.googleapis.com/Topic"
+    #           }];
+    #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
+    # @!attribute [rw] child_type
+    #   @return [::String]
+    #     The resource type of a child collection that the annotated field
+    #     references. This is useful for annotating the `parent` field that
+    #     doesn't have a fixed resource type.
+    #
+    #     Example:
+    #
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
+    class ResourceReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/api/service.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # `Service` is the root object of Google service configuration schema. It
+    # describes basic information about a service, such as the name and the
+    # title, and delegates other aspects to sub-sections. Each sub-section is
+    # either a proto message or a repeated proto message that configures a
+    # specific aspect, such as auth. See each proto message definition for details.
+    #
+    # Example:
+    #
+    #     type: google.api.Service
+    #     config_version: 3
+    #     name: calendar.googleapis.com
+    #     title: Google Calendar API
+    #     apis:
+    #     - name: google.calendar.v3.Calendar
+    #     authentication:
+    #       providers:
+    #       - id: google_calendar_auth
+    #         jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+    #         issuer: https://securetoken.google.com
+    #       rules:
+    #       - selector: "*"
+    #         requirements:
+    #           provider_id: google_calendar_auth
+    # @!attribute [rw] config_version
+    #   @return [::Google::Protobuf::UInt32Value]
+    #     The semantic version of the service configuration. The config version
+    #     affects the interpretation of the service configuration. For example,
+    #     certain features are enabled by default for certain config versions.
+    #     The latest config version is `3`.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The DNS address at which this service is available,
+    #     e.g. `calendar.googleapis.com`.
+    # @!attribute [rw] id
+    #   @return [::String]
+    #     A unique ID for a specific instance of this message, typically assigned
+    #     by the client for tracking purpose. If empty, the server may choose to
+    #     generate one instead.
+    # @!attribute [rw] title
+    #   @return [::String]
+    #     The product title for this service.
+    # @!attribute [rw] producer_project_id
+    #   @return [::String]
+    #     The Google project that owns this service.
+    # @!attribute [rw] apis
+    #   @return [::Array<::Google::Protobuf::Api>]
+    #     A list of API interfaces exported by this service. Only the `name` field
+    #     of the {::Google::Protobuf::Api google.protobuf.Api} needs to be provided by the configuration
+    #     author, as the remaining fields will be derived from the IDL during the
+    #     normalization process. It is an error to specify an API interface here
+    #     which cannot be resolved against the associated IDL files.
+    # @!attribute [rw] types
+    #   @return [::Array<::Google::Protobuf::Type>]
+    #     A list of all proto message types included in this API service.
+    #     Types referenced directly or indirectly by the `apis` are
+    #     automatically included.  Messages which are not referenced but
+    #     shall be included, such as types used by the `google.protobuf.Any` type,
+    #     should be listed here by name. Example:
+    #
+    #         types:
+    #         - name: google.protobuf.Int32
+    # @!attribute [rw] enums
+    #   @return [::Array<::Google::Protobuf::Enum>]
+    #     A list of all enum types included in this API service.  Enums
+    #     referenced directly or indirectly by the `apis` are automatically
+    #     included.  Enums which are not referenced but shall be included
+    #     should be listed here by name. Example:
+    #
+    #         enums:
+    #         - name: google.someapi.v1.SomeEnum
+    # @!attribute [rw] documentation
+    #   @return [::Google::Api::Documentation]
+    #     Additional API documentation.
+    # @!attribute [rw] backend
+    #   @return [::Google::Api::Backend]
+    #     API backend configuration.
+    # @!attribute [rw] http
+    #   @return [::Google::Api::Http]
+    #     HTTP configuration.
+    # @!attribute [rw] quota
+    #   @return [::Google::Api::Quota]
+    #     Quota configuration.
+    # @!attribute [rw] authentication
+    #   @return [::Google::Api::Authentication]
+    #     Auth configuration.
+    # @!attribute [rw] context
+    #   @return [::Google::Api::Context]
+    #     Context configuration.
+    # @!attribute [rw] usage
+    #   @return [::Google::Api::Usage]
+    #     Configuration controlling usage of this service.
+    # @!attribute [rw] endpoints
+    #   @return [::Array<::Google::Api::Endpoint>]
+    #     Configuration for network endpoints.  If this is empty, then an endpoint
+    #     with the same name as the service is automatically generated to service all
+    #     defined APIs.
+    # @!attribute [rw] control
+    #   @return [::Google::Api::Control]
+    #     Configuration for the service control plane.
+    # @!attribute [rw] logs
+    #   @return [::Array<::Google::Api::LogDescriptor>]
+    #     Defines the logs used by this service.
+    # @!attribute [rw] metrics
+    #   @return [::Array<::Google::Api::MetricDescriptor>]
+    #     Defines the metrics used by this service.
+    # @!attribute [rw] monitored_resources
+    #   @return [::Array<::Google::Api::MonitoredResourceDescriptor>]
+    #     Defines the monitored resources used by this service. This is required
+    #     by the {::Google::Api::Service#monitoring Service.monitoring} and {::Google::Api::Service#logging Service.logging} configurations.
+    # @!attribute [rw] billing
+    #   @return [::Google::Api::Billing]
+    #     Billing configuration.
+    # @!attribute [rw] logging
+    #   @return [::Google::Api::Logging]
+    #     Logging configuration.
+    # @!attribute [rw] monitoring
+    #   @return [::Google::Api::Monitoring]
+    #     Monitoring configuration.
+    # @!attribute [rw] system_parameters
+    #   @return [::Google::Api::SystemParameters]
+    #     System parameter configuration.
+    # @!attribute [rw] source_info
+    #   @return [::Google::Api::SourceInfo]
+    #     Output only. The source information for this configuration if available.
+    class Service
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/api/servicemanagement/v1/resources.rb

@@ -0,0 +1,326 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ServiceManagement
+      module V1
+        # The full representation of a Service that is managed by
+        # Google Service Management.
+        # @!attribute [rw] service_name
+        #   @return [::String]
+        #     The name of the service. See the [overview](/service-management/overview)
+        #     for naming requirements.
+        # @!attribute [rw] producer_project_id
+        #   @return [::String]
+        #     ID of the project that produces and owns this service.
+        class ManagedService
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The metadata associated with a long running operation resource.
+        # @!attribute [rw] resource_names
+        #   @return [::Array<::String>]
+        #     The full name of the resources that this operation is directly
+        #     associated with.
+        # @!attribute [rw] steps
+        #   @return [::Array<::Google::Cloud::ServiceManagement::V1::OperationMetadata::Step>]
+        #     Detailed status information for each step. The order is undetermined.
+        # @!attribute [rw] progress_percentage
+        #   @return [::Integer]
+        #     Percentage of completion of this operation, ranging from 0 to 100.
+        # @!attribute [rw] start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The start time of the operation.
+        class OperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents the status of one operation step.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     The short description of the step.
+          # @!attribute [rw] status
+          #   @return [::Google::Cloud::ServiceManagement::V1::OperationMetadata::Status]
+          #     The status code.
+          class Step
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Code describes the status of the operation (or one of its steps).
+          module Status
+            # Unspecifed code.
+            STATUS_UNSPECIFIED = 0
+
+            # The operation or step has completed without errors.
+            DONE = 1
+
+            # The operation or step has not started yet.
+            NOT_STARTED = 2
+
+            # The operation or step is in progress.
+            IN_PROGRESS = 3
+
+            # The operation or step has completed with errors. If the operation is
+            # rollbackable, the rollback completed with errors too.
+            FAILED = 4
+
+            # The operation or step has completed with cancellation.
+            CANCELLED = 5
+          end
+        end
+
+        # Represents a diagnostic message (error or warning)
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     File name and line number of the error or warning.
+        # @!attribute [rw] kind
+        #   @return [::Google::Cloud::ServiceManagement::V1::Diagnostic::Kind]
+        #     The kind of diagnostic information provided.
+        # @!attribute [rw] message
+        #   @return [::String]
+        #     Message describing the error or warning.
+        class Diagnostic
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The kind of diagnostic information possible.
+          module Kind
+            # Warnings and errors
+            WARNING = 0
+
+            # Only errors
+            ERROR = 1
+          end
+        end
+
+        # Represents a source file which is used to generate the service configuration
+        # defined by `google.api.Service`.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     A unique ID for a specific instance of this message, typically assigned
+        #     by the client for tracking purpose. If empty, the server may choose to
+        #     generate one instead.
+        # @!attribute [rw] files
+        #   @return [::Array<::Google::Cloud::ServiceManagement::V1::ConfigFile>]
+        #     Set of source configuration files that are used to generate a service
+        #     configuration (`google.api.Service`).
+        class ConfigSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Generic specification of a source configuration file
+        # @!attribute [rw] file_path
+        #   @return [::String]
+        #     The file name of the configuration file (full or relative path).
+        # @!attribute [rw] file_contents
+        #   @return [::String]
+        #     The bytes that constitute the file.
+        # @!attribute [rw] file_type
+        #   @return [::Google::Cloud::ServiceManagement::V1::ConfigFile::FileType]
+        #     The type of configuration file this represents.
+        class ConfigFile
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          module FileType
+            # Unknown file type.
+            FILE_TYPE_UNSPECIFIED = 0
+
+            # YAML-specification of service.
+            SERVICE_CONFIG_YAML = 1
+
+            # OpenAPI specification, serialized in JSON.
+            OPEN_API_JSON = 2
+
+            # OpenAPI specification, serialized in YAML.
+            OPEN_API_YAML = 3
+
+            # FileDescriptorSet, generated by protoc.
+            #
+            # To generate, use protoc with imports and source info included.
+            # For an example test.proto file, the following command would put the value
+            # in a new file named out.pb.
+            #
+            # $protoc --include_imports --include_source_info test.proto -o out.pb
+            FILE_DESCRIPTOR_SET_PROTO = 4
+
+            # Uncompiled Proto file. Used for storage and display purposes only,
+            # currently server-side compilation is not supported. Should match the
+            # inputs to 'protoc' command used to generated FILE_DESCRIPTOR_SET_PROTO. A
+            # file of this type can only be included if at least one file of type
+            # FILE_DESCRIPTOR_SET_PROTO is included.
+            PROTO_FILE = 6
+          end
+        end
+
+        # Represents a service configuration with its name and id.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Resource name of a service config. It must have the following
+        #     format: "services/\\{service name}/configs/\\{config id}".
+        class ConfigRef
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Change report associated with a particular service configuration.
+        #
+        # It contains a list of ConfigChanges based on the comparison between
+        # two service configurations.
+        # @!attribute [rw] config_changes
+        #   @return [::Array<::Google::Api::ConfigChange>]
+        #     List of changes between two service configurations.
+        #     The changes will be alphabetically sorted based on the identifier
+        #     of each change.
+        #     A ConfigChange identifier is a dot separated path to the configuration.
+        #     Example: visibility.rules[selector='LibraryService.CreateBook'].restriction
+        class ChangeReport
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A rollout resource that defines how service configuration versions are pushed
+        # to control plane systems. Typically, you create a new version of the
+        # service config, and then create a Rollout to push the service config.
+        # @!attribute [rw] rollout_id
+        #   @return [::String]
+        #     Optional. Unique identifier of this Rollout. Must be no longer than 63 characters
+        #     and only lower case letters, digits, '.', '_' and '-' are allowed.
+        #
+        #     If not specified by client, the server will generate one. The generated id
+        #     will have the form of <date><revision number>, where "date" is the create
+        #     date in ISO 8601 format.  "revision number" is a monotonically increasing
+        #     positive number that is reset every day for each service.
+        #     An example of the generated rollout_id is '2016-02-16r1'
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Creation time of the rollout. Readonly.
+        # @!attribute [rw] created_by
+        #   @return [::String]
+        #     The user who created the Rollout. Readonly.
+        # @!attribute [rw] status
+        #   @return [::Google::Cloud::ServiceManagement::V1::Rollout::RolloutStatus]
+        #     The status of this rollout. Readonly. In case of a failed rollout,
+        #     the system will automatically rollback to the current Rollout
+        #     version. Readonly.
+        # @!attribute [rw] traffic_percent_strategy
+        #   @return [::Google::Cloud::ServiceManagement::V1::Rollout::TrafficPercentStrategy]
+        #     Google Service Control selects service configurations based on
+        #     traffic percentage.
+        # @!attribute [rw] delete_service_strategy
+        #   @return [::Google::Cloud::ServiceManagement::V1::Rollout::DeleteServiceStrategy]
+        #     The strategy associated with a rollout to delete a `ManagedService`.
+        #     Readonly.
+        # @!attribute [rw] service_name
+        #   @return [::String]
+        #     The name of the service associated with this Rollout.
+        class Rollout
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Strategy that specifies how clients of Google Service Controller want to
+          # send traffic to use different config versions. This is generally
+          # used by API proxy to split traffic based on your configured percentage for
+          # each config version.
+          #
+          # One example of how to gradually rollout a new service configuration using
+          # this
+          # strategy:
+          # Day 1
+          #
+          #     Rollout {
+          #       id: "example.googleapis.com/rollout_20160206"
+          #       traffic_percent_strategy {
+          #         percentages: {
+          #           "example.googleapis.com/20160201": 70.00
+          #           "example.googleapis.com/20160206": 30.00
+          #         }
+          #       }
+          #     }
+          #
+          # Day 2
+          #
+          #     Rollout {
+          #       id: "example.googleapis.com/rollout_20160207"
+          #       traffic_percent_strategy: {
+          #         percentages: {
+          #           "example.googleapis.com/20160206": 100.00
+          #         }
+          #       }
+          #     }
+          # @!attribute [rw] percentages
+          #   @return [::Google::Protobuf::Map{::String => ::Float}]
+          #     Maps service configuration IDs to their corresponding traffic percentage.
+          #     Key is the service configuration ID, Value is the traffic percentage
+          #     which must be greater than 0.0 and the sum must equal to 100.0.
+          class TrafficPercentStrategy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::Float]
+            class PercentagesEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Strategy used to delete a service. This strategy is a placeholder only
+          # used by the system generated rollout to delete a service.
+          class DeleteServiceStrategy
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Status of a Rollout.
+          module RolloutStatus
+            # No status specified.
+            ROLLOUT_STATUS_UNSPECIFIED = 0
+
+            # The Rollout is in progress.
+            IN_PROGRESS = 1
+
+            # The Rollout has completed successfully.
+            SUCCESS = 2
+
+            # The Rollout has been cancelled. This can happen if you have overlapping
+            # Rollout pushes, and the previous ones will be cancelled.
+            CANCELLED = 3
+
+            # The Rollout has failed and the rollback attempt has failed too.
+            FAILED = 4
+
+            # The Rollout has not started yet and is pending for execution.
+            PENDING = 5
+
+            # The Rollout has failed and rolled back to the previous successful
+            # Rollout.
+            FAILED_ROLLED_BACK = 6
+          end
+        end
+      end
+    end
+  end
+end