google-api-client 0.48.0 → 0.53.0

data/generated/google/apis/apigateway_v1beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see  https://cloud.google.com/api-gateway/docs
     module ApigatewayV1beta
       VERSION = 'V1beta'
-      REVISION = '20200901'
+      REVISION = '20201211'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/apigateway_v1beta/classes.rb

@@ -22,7 +22,7 @@ module Google
   module Apis
     module ApigatewayV1beta
       
-      # A consumable API that can be used by multiple Gateways.
+      # An API that can be served by one or more Gateways.
       class ApigatewayApi
         include Google::Apis::Core::Hashable
       
@@ -82,11 +82,8 @@ module Google
         end
       end
       
-      # An API Configuration is an association of an API Controller Config and a
-      # Gateway Config. For APIs with a Managed Service API Controller, this resource
-      # is associated with one or more Service Configs and a Service Rollout.
-      # Initially, this resource will extract the Gateway Config from the API
-      # Controller Config.
+      # An API Configuration is a combination of settings for both the Managed Service
+      # and Gateways serving this API Config.
       class ApigatewayApiConfig
         include Google::Apis::Core::Hashable
       
@@ -105,6 +102,16 @@ module Google
         # @return [Google::Apis::ApigatewayV1beta::ApigatewayGatewayConfig]
         attr_accessor :gateway_config
       
+        # Immutable. The Google Cloud IAM Service Account that Gateways serving this
+        # config should use to authenticate to other services. This may either be the
+        # Service Account's email (``ACCOUNT_ID`@`PROJECT`.iam.gserviceaccount.com`) or
+        # its full resource name (`projects/`PROJECT`/accounts/`UNIQUE_ID``). This is
+        # most often used when the service is a GCP resource such as a Cloud Run Service
+        # or an IAP-secured service.
+        # Corresponds to the JSON property `gatewayServiceAccount`
+        # @return [String]
+        attr_accessor :gateway_service_account
+      
         # Optional. gRPC service definition files. If specified, openapi_documents must
         # not be included.
         # Corresponds to the JSON property `grpcServices`
@@ -119,9 +126,9 @@ module Google
         attr_accessor :labels
       
         # Optional. Service Configuration files. At least one must be included when
-        # using gRPC service definitions. See https: //cloud.google.com/endpoints/docs/
-        # grpc/g // rpc-service-config#service_configuration_overview for the expected
-        # file contents. If multiple files are specified, the files are merged with the
+        # using gRPC service definitions. See https://cloud.google.com/endpoints/docs/
+        # grpc/grpc-service-config#service_configuration_overview for the expected file
+        # contents. If multiple files are specified, the files are merged with the
         # following rules: * All singular scalar fields are merged using "last one wins"
         # semantics in the order of the files uploaded. * Repeated fields are
         # concatenated. * Singular embedded messages are merged using these rules for
@@ -137,7 +144,7 @@ module Google
         attr_accessor :name
       
         # Optional. OpenAPI specification documents. If specified, grpc_services and
-        # managed_service_config must not be included.
+        # managed_service_configs must not be included.
         # Corresponds to the JSON property `openapiDocuments`
         # @return [Array<Google::Apis::ApigatewayV1beta::ApigatewayApiConfigOpenApiDocument>]
         attr_accessor :openapi_documents
@@ -167,6 +174,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @display_name = args[:display_name] if args.key?(:display_name)
           @gateway_config = args[:gateway_config] if args.key?(:gateway_config)
+          @gateway_service_account = args[:gateway_service_account] if args.key?(:gateway_service_account)
           @grpc_services = args[:grpc_services] if args.key?(:grpc_services)
           @labels = args[:labels] if args.key?(:labels)
           @managed_service_configs = args[:managed_service_configs] if args.key?(:managed_service_configs)
@@ -322,21 +330,21 @@ module Google
         end
       end
       
-      # Configuration for a backend.
+      # Configuration for all backends.
       class ApigatewayBackendConfig
         include Google::Apis::Core::Hashable
       
         # Google Cloud IAM service account used to sign OIDC tokens for backends that
-        # have authentication configured (https: //cloud.google.com/service-
-        # infrastructur // e/docs/service-management/reference/rest/v1/services.configs#
+        # have authentication configured (https://cloud.google.com/service-
+        # infrastructure/docs/service-management/reference/rest/v1/services.configs#
         # backend). This may either be the Service Account's email (i.e. "`ACCOUNT_ID`@`
         # PROJECT`.iam.gserviceaccount.com") or its full resource name (i.e. "projects/`
         # PROJECT`/accounts/`UNIQUE_ID`"). This is most often used when the backend is a
         # GCP resource such as a Cloud Run Service or an IAP-secured service. Note that
         # this token is always sent as an authorization header bearer token. The
         # audience of the OIDC token is configured in the associated Service Config in
-        # the BackendRule option (https: //github.com/googleapis/googleapis/blob/ //
-        # master/google/api/backend.proto#L125).
+        # the BackendRule option (https://github.com/googleapis/googleapis/blob/master/
+        # google/api/backend.proto#L125).
         # Corresponds to the JSON property `googleServiceAccount`
         # @return [String]
         attr_accessor :google_service_account
@@ -561,7 +569,7 @@ module Google
       class ApigatewayGatewayConfig
         include Google::Apis::Core::Hashable
       
-        # Configuration for a backend.
+        # Configuration for all backends.
         # Corresponds to the JSON property `backendConfig`
         # @return [Google::Apis::ApigatewayV1beta::ApigatewayBackendConfig]
         attr_accessor :backend_config

data/generated/google/apis/apigateway_v1beta/representations.rb

@@ -210,6 +210,7 @@ module Google
           property :display_name, as: 'displayName'
           property :gateway_config, as: 'gatewayConfig', class: Google::Apis::ApigatewayV1beta::ApigatewayGatewayConfig, decorator: Google::Apis::ApigatewayV1beta::ApigatewayGatewayConfig::Representation
       
+          property :gateway_service_account, as: 'gatewayServiceAccount'
           collection :grpc_services, as: 'grpcServices', class: Google::Apis::ApigatewayV1beta::ApigatewayApiConfigGrpcServiceDefinition, decorator: Google::Apis::ApigatewayV1beta::ApigatewayApiConfigGrpcServiceDefinition::Representation
       
           hash :labels, as: 'labels'

data/generated/google/apis/apigee_v1.rb

@@ -29,7 +29,7 @@ module Google
     # @see https://cloud.google.com/apigee-api-management/
     module ApigeeV1
       VERSION = 'V1'
-      REVISION = '20201022'
+      REVISION = '20201210'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/apigee_v1/classes.rb

@@ -190,22 +190,35 @@ module Google
         end
       end
       
-      # A reference to a certificate or key, certificate pair.
+      # Request for ActivateNatAddressRequest. Activate the nat address request.
+      class GoogleCloudApigeeV1ActivateNatAddressRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Reference to a certificate or key/certificate pair.
       class GoogleCloudApigeeV1Alias
         include Google::Apis::Core::Hashable
       
-        # The resource ID for this alias. Values must match regular expression `[^/]`1,
+        # Resource ID for this alias. Values must match the regular expression `[^/]`1,
         # 255``.
         # Corresponds to the JSON property `alias`
         # @return [String]
         attr_accessor :alias
       
-        # The chain of certificates under this alias.
+        # Chain of certificates under this alias.
         # Corresponds to the JSON property `certsInfo`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Certificate]
         attr_accessor :certs_info
       
-        # The type of alias.
+        # Type of alias.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -339,32 +352,18 @@ module Google
       class GoogleCloudApigeeV1ApiProduct
         include Google::Apis::Core::Hashable
       
-        # Comma-separated list of API resources to be bundled in the API Product. By
-        # default, the resource paths are mapped from the `proxy.pathsuffix` variable.
-        # The proxy path suffix is defined as the URI fragment following the
-        # ProxyEndpoint base path. For example, if the `apiResources` element is defined
-        # to be `/forecastrss` and the base path defined for the API proxy is `/weather`,
-        # then only requests to `/weather/forecastrss` are permitted by the API product.
-        # You can select a specific path, or you can select all subpaths with the
-        # following wildcard: - /**: Indicates that all sub-URIs are included. - /* :
-        # Indicates that only URIs one level down are included. By default, / supports
-        # the same resources as /** as well as the base path defined by the API proxy.
-        # For example, if the base path of the API proxy is `/v1/weatherapikey`, then
-        # the API product supports requests to `/v1/weatherapikey` and to any sub-URIs,
-        # such as `/v1/weatherapikey/forecastrss`, `/v1/weatherapikey/region/CA`, and so
-        # on. For more information, see: - Manage API products - Managing a transaction
-        # recording policy using the API
+        # 
         # Corresponds to the JSON property `apiResources`
         # @return [Array<String>]
         attr_accessor :api_resources
       
-        # Specifies how API keys are approved to access the APIs defined by the API
-        # product. If set to `manual`, the consumer key is generated and returned in "
-        # pending" state. In this case, the API keys won't work until they have been
-        # explicitly approved. If set to `auto`, the consumer key is generated and
-        # returned in "approved" state and can be used immediately. *NOTE:* Typically, `
-        # auto` is used to provide access to free or trial API products that provide
-        # limited quota or capabilities.
+        # Flag that specifies how API keys are approved to access the APIs defined by
+        # the API product. If set to `manual`, the consumer key is generated and
+        # returned in "pending" state. In this case, the API keys won't work until they
+        # have been explicitly approved. If set to `auto`, the consumer key is generated
+        # and returned in "approved" state and can be used immediately. **Note:**
+        # Typically, `auto` is used to provide access to free or trial API products that
+        # provide limited quota or capabilities.
         # Corresponds to the JSON property `approvalType`
         # @return [String]
         attr_accessor :approval_type
@@ -376,10 +375,8 @@ module Google
         # to developers in the Apigee developer portal. For example, you can set a
         # product to `internal` while it is in development and then change access to `
         # public` when it is ready to release on the portal. API products marked as `
-        # private` do not appear on the portal but can be accessed by external
-        # developers. For monetization, you can use the attributes field to: - Specify
-        # transaction success criteria - Specify custom attributes on which you base
-        # rate plan charges.
+        # private` do not appear on the portal, but can be accessed by external
+        # developers.
         # Corresponds to the JSON property `attributes`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Attribute>]
         attr_accessor :attributes
@@ -389,25 +386,39 @@ module Google
         # @return [Fixnum]
         attr_accessor :created_at
       
-        # An overview of the API product. Include key information about the API product
-        # that is not captured by other fields.
+        # Description of the API product. Include key information about the API product
+        # that is not captured by other fields. Comma-separated list of API resources to
+        # be bundled in the API product. By default, the resource paths are mapped from
+        # the `proxy.pathsuffix` variable. The proxy path suffix is defined as the URI
+        # fragment following the ProxyEndpoint base path. For example, if the `
+        # apiResources` element is defined to be `/forecastrss` and the base path
+        # defined for the API proxy is `/weather`, then only requests to `/weather/
+        # forecastrss` are permitted by the API product. You can select a specific path,
+        # or you can select all subpaths with the following wildcard: - `/**`: Indicates
+        # that all sub-URIs are included. - `/*` : Indicates that only URIs one level
+        # down are included. By default, / supports the same resources as /** as well as
+        # the base path defined by the API proxy. For example, if the base path of the
+        # API proxy is `/v1/weatherapikey`, then the API product supports requests to `/
+        # v1/weatherapikey` and to any sub-URIs, such as `/v1/weatherapikey/forecastrss`,
+        # `/v1/weatherapikey/region/CA`, and so on. For more information, see Managing
+        # API products.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The name to be displayed in the UI or developer portal to developers
-        # registering for API access.
+        # Name displayed in the UI or developer portal to developers registering for API
+        # access.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # A comma-separated list of environment names to which the API product is bound.
+        # Comma-separated list of environment names to which the API product is bound.
         # Requests to environments that are not listed are rejected. By specifying one
         # or more environments, you can bind the resources listed in the API product to
         # a specific environment, preventing developers from accessing those resources
         # through API proxies deployed in another environment. This setting is used, for
-        # example, to prevent resources associated with API proxies in 'prod' from being
-        # accessed by API proxies deployed in 'test'.
+        # example, to prevent resources associated with API proxies in `prod` from being
+        # accessed by API proxies deployed in `test`.
         # Corresponds to the JSON property `environments`
         # @return [Array<String>]
         attr_accessor :environments
@@ -417,31 +428,30 @@ module Google
         # @return [Fixnum]
         attr_accessor :last_modified_at
       
-        # The internal name of the API Product. Characters you can use in the name are
-        # restricted to: A-Z0-9._\-$ %. *NOTE:* The internal name cannot be edited when
-        # updating the API product.
+        # Internal name of the API product. Characters you can use in the name are
+        # restricted to: `A-Z0-9._\-$ %`. **Note:** The internal name cannot be edited
+        # when updating the API product.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The OperationGroup contains a list of configuration details associated with
-        # Apigee proxies or Remote services. Remote services are non-Apigee Edge proxies.
-        # eg, Istio-Envoy.
+        # List of operation configuration details associated with Apigee API proxies or
+        # remote services. Remote services are non-Apigee proxies, such as Istio-Envoy.
         # Corresponds to the JSON property `operationGroup`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1OperationGroup]
         attr_accessor :operation_group
       
-        # A comma-separated list of API proxy names to which this API product is bound.
-        # By specifying API proxies, you can associate resources in the API product with
+        # Comma-separated list of API proxy names to which this API product is bound. By
+        # specifying API proxies, you can associate resources in the API product with
         # specific API proxies, preventing developers from accessing those resources
-        # through other API proxies. Edge rejects requests to API proxies that are not
-        # listed. *NOTE:* The API proxy names must already exist in the specified
+        # through other API proxies. Apigee rejects requests to API proxies that are not
+        # listed. **Note:** The API proxy names must already exist in the specified
         # environment as they will be validated upon creation.
         # Corresponds to the JSON property `proxies`
         # @return [Array<String>]
         attr_accessor :proxies
       
-        # The number of request messages permitted per app by this API product for the
+        # Number of request messages permitted per app by this API product for the
         # specified `quotaInterval` and `quotaTimeUnit`. For example, a `quota` of 50,
         # for a `quotaInterval` of 12 and a `quotaTimeUnit` of hours means 50 requests
         # are allowed every 12 hours.
@@ -449,20 +459,20 @@ module Google
         # @return [String]
         attr_accessor :quota
       
-        # The time interval over which the number of request messages is calculated.
+        # Time interval over which the number of request messages is calculated.
         # Corresponds to the JSON property `quotaInterval`
         # @return [String]
         attr_accessor :quota_interval
       
-        # The time unit defined for the `quotaInterval`. Valid values include minute,
-        # hour, day, or month.
+        # Time unit defined for the `quotaInterval`. Valid values include `minute`, `
+        # hour`, `day`, or `month`.
         # Corresponds to the JSON property `quotaTimeUnit`
         # @return [String]
         attr_accessor :quota_time_unit
       
-        # A comma-separated list of OAuth scopes that are validated at runtime. Edge
+        # Comma-separated list of OAuth scopes that are validated at runtime. Apigee
         # validates that the scopes in any access token presented match the scopes
-        # defined in the OAuth policy assoicated with the API product.
+        # defined in the OAuth policy associated with the API product.
         # Corresponds to the JSON property `scopes`
         # @return [Array<String>]
         attr_accessor :scopes
@@ -853,6 +863,11 @@ module Google
         # @return [String]
         attr_accessor :created
       
+        # Hostname is available only when query is executed at host level.
+        # Corresponds to the JSON property `envgroupHostname`
+        # @return [String]
+        attr_accessor :envgroup_hostname
+      
         # Error is set when query fails.
         # Corresponds to the JSON property `error`
         # @return [String]
@@ -894,7 +909,9 @@ module Google
         attr_accessor :result_rows
       
         # Self link of the query. Example: `/organizations/myorg/environments/myenv/
-        # queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd`
+        # queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd` or following format if query is
+        # running at host level: `/organizations/myorg/hostQueries/9cfc0d85-0f30-46d6-
+        # ae6f-318d0cb961bd`
         # Corresponds to the JSON property `self`
         # @return [String]
         attr_accessor :self
@@ -916,6 +933,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @created = args[:created] if args.key?(:created)
+          @envgroup_hostname = args[:envgroup_hostname] if args.key?(:envgroup_hostname)
           @error = args[:error] if args.key?(:error)
           @execution_time = args[:execution_time] if args.key?(:execution_time)
           @name = args[:name] if args.key?(:name)
@@ -940,7 +958,9 @@ module Google
         attr_accessor :expires
       
         # Self link of the query results. Example: `/organizations/myorg/environments/
-        # myenv/queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result`
+        # myenv/queries/9cfc0d85-0f30-46d6-ae6f-318d0cb961bd/result` or following format
+        # if query is running at host level: `/organizations/myorg/hostQueries/9cfc0d85-
+        # 0f30-46d6-ae6f-318d0cb961bd/result`
         # Corresponds to the JSON property `self`
         # @return [String]
         attr_accessor :self
@@ -956,6 +976,50 @@ module Google
         end
       end
       
+      # 
+      class GoogleCloudApigeeV1AsyncQueryResultView
+        include Google::Apis::Core::Hashable
+      
+        # Error code when there is a failure.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # Error message when there is a failure.
+        # Corresponds to the JSON property `error`
+        # @return [String]
+        attr_accessor :error
+      
+        # Metadata contains information like metrics, dimenstions etc of the AsyncQuery.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1QueryMetadata]
+        attr_accessor :metadata
+      
+        # Rows of query result. Each row is a JSON object. Example: `sum(message_count):
+        # 1, developer_app: "(not set)",…`
+        # Corresponds to the JSON property `rows`
+        # @return [Array<Object>]
+        attr_accessor :rows
+      
+        # State of retrieving ResultView.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @error = args[:error] if args.key?(:error)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @rows = args[:rows] if args.key?(:rows)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # Key-value pair to store extra metadata.
       class GoogleCloudApigeeV1Attribute
         include Google::Apis::Core::Hashable
@@ -1000,61 +1064,163 @@ module Google
         end
       end
       
-      # An X.509 certificate as defined in RFC 5280.
+      # CanaryEvaluation represents the canary analysis between two versions of the
+      # runtime that is serving requests.
+      class GoogleCloudApigeeV1CanaryEvaluation
+        include Google::Apis::Core::Hashable
+      
+        # Required. The stable version that is serving requests.
+        # Corresponds to the JSON property `control`
+        # @return [String]
+        attr_accessor :control
+      
+        # Output only. Create time of the canary evaluation.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Required. End time for the evaluation's analysis.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Labels that can be used to filter Apigee metrics.
+        # Corresponds to the JSON property `metricLabels`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1CanaryEvaluationMetricLabels]
+        attr_accessor :metric_labels
+      
+        # Output only. Name of the canary evalution.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. Start time for the canary evaluation's analysis.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # Output only. The current state of the canary evaluation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Required. The newer version that is serving requests.
+        # Corresponds to the JSON property `treatment`
+        # @return [String]
+        attr_accessor :treatment
+      
+        # Output only. The resulting verdict of the canary evaluations: NONE, PASS, or
+        # FAIL.
+        # Corresponds to the JSON property `verdict`
+        # @return [String]
+        attr_accessor :verdict
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @control = args[:control] if args.key?(:control)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @metric_labels = args[:metric_labels] if args.key?(:metric_labels)
+          @name = args[:name] if args.key?(:name)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @state = args[:state] if args.key?(:state)
+          @treatment = args[:treatment] if args.key?(:treatment)
+          @verdict = args[:verdict] if args.key?(:verdict)
+        end
+      end
+      
+      # Labels that can be used to filter Apigee metrics.
+      class GoogleCloudApigeeV1CanaryEvaluationMetricLabels
+        include Google::Apis::Core::Hashable
+      
+        # The environment ID associated with the metrics.
+        # Corresponds to the JSON property `env`
+        # @return [String]
+        attr_accessor :env
+      
+        # Required. The instance ID associated with the metrics. In Apigee Hybrid, the
+        # value is configured during installation.
+        # Corresponds to the JSON property `instance_id`
+        # @return [String]
+        attr_accessor :instance_id
+      
+        # Required. The location associated with the metrics.
+        # Corresponds to the JSON property `location`
+        # @return [String]
+        attr_accessor :location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @env = args[:env] if args.key?(:env)
+          @instance_id = args[:instance_id] if args.key?(:instance_id)
+          @location = args[:location] if args.key?(:location)
+        end
+      end
+      
+      # X.509 certificate as defined in RFC 5280.
       class GoogleCloudApigeeV1CertInfo
         include Google::Apis::Core::Hashable
       
-        # The X.509 basic constraints extension.
+        # X.509 basic constraints extension.
         # Corresponds to the JSON property `basicConstraints`
         # @return [String]
         attr_accessor :basic_constraints
       
-        # The X.509 validity / notAfter in milliseconds since the epoch.
+        # X.509 `notAfter` validity period in milliseconds since epoch.
         # Corresponds to the JSON property `expiryDate`
         # @return [Fixnum]
         attr_accessor :expiry_date
       
-        # "Yes" if certificate is valid, "No" if expired and "Not yet" if not yet valid.
+        # Flag that specifies whether the certificate is valid. Flag is set to `Yes` if
+        # the certificate is valid, `No` if expired, or `Not yet` if not yet valid.
         # Corresponds to the JSON property `isValid`
         # @return [String]
         attr_accessor :is_valid
       
-        # The X.509 issuer.
+        # X.509 issuer.
         # Corresponds to the JSON property `issuer`
         # @return [String]
         attr_accessor :issuer
       
-        # The public key component of the X.509 subject public key info.
+        # Public key component of the X.509 subject public key info.
         # Corresponds to the JSON property `publicKey`
         # @return [String]
         attr_accessor :public_key
       
-        # The X.509 serial number.
+        # X.509 serial number.
         # Corresponds to the JSON property `serialNumber`
         # @return [String]
         attr_accessor :serial_number
       
-        # The X.509 signatureAlgorithm.
+        # X.509 signatureAlgorithm.
         # Corresponds to the JSON property `sigAlgName`
         # @return [String]
         attr_accessor :sig_alg_name
       
-        # The X.509 subject.
+        # X.509 subject.
         # Corresponds to the JSON property `subject`
         # @return [String]
         attr_accessor :subject
       
-        # The X.509 subject alternative names (SANs) extension.
+        # X.509 subject alternative names (SANs) extension.
         # Corresponds to the JSON property `subjectAlternativeNames`
         # @return [Array<String>]
         attr_accessor :subject_alternative_names
       
-        # The X.509 validity / notBefore in milliseconds since the epoch.
+        # X.509 `notBefore` validity period in milliseconds since epoch.
         # Corresponds to the JSON property `validFrom`
         # @return [Fixnum]
         attr_accessor :valid_from
       
-        # The X.509 version.
+        # X.509 version.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -1083,7 +1249,7 @@ module Google
       class GoogleCloudApigeeV1Certificate
         include Google::Apis::Core::Hashable
       
-        # The chain of certificates under this name.
+        # Chain of certificates under this name.
         # Corresponds to the JSON property `certInfo`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1CertInfo>]
         attr_accessor :cert_info
@@ -1388,6 +1554,51 @@ module Google
         end
       end
       
+      # Data collector configuration.
+      class GoogleCloudApigeeV1DataCollector
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The time at which the data collector was created in milliseconds
+        # since the epoch.
+        # Corresponds to the JSON property `createdAt`
+        # @return [Fixnum]
+        attr_accessor :created_at
+      
+        # A description of the data collector.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Output only. The time at which the Data Collector was last updated in
+        # milliseconds since the epoch.
+        # Corresponds to the JSON property `lastModifiedAt`
+        # @return [Fixnum]
+        attr_accessor :last_modified_at
+      
+        # ID of the data collector. Must begin with `dc_`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Immutable. The type of data this data collector will collect.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @created_at = args[:created_at] if args.key?(:created_at)
+          @description = args[:description] if args.key?(:description)
+          @last_modified_at = args[:last_modified_at] if args.key?(:last_modified_at)
+          @name = args[:name] if args.key?(:name)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # Data collector and its configuration.
       class GoogleCloudApigeeV1DataCollectorConfig
         include Google::Apis::Core::Hashable
@@ -2897,8 +3108,9 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Optional. Customer Managed Encryption Key (CMEK) used for disk & volume
-        # encryption.
+        # Customer Managed Encryption Key (CMEK) used for disk and volume encryption.
+        # Required for Apigee paid subscriptions only. Use the following format: `
+        # projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+)`
         # Corresponds to the JSON property `diskEncryptionKeyName`
         # @return [String]
         attr_accessor :disk_encryption_key_name
@@ -3002,7 +3214,7 @@ module Google
         attr_accessor :deployed_revisions
       
         # The current routes deployed in the ingress routing table. A route which is
-        # missing will be shown with no destination environment.
+        # missing will appear in missing_routes.
         # Corresponds to the JSON property `deployedRoutes`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1InstanceDeploymentStatusDeployedRoute>]
         attr_accessor :deployed_routes
@@ -3139,16 +3351,16 @@ module Google
         end
       end
       
-      # A datastore for Certificates and Aliases
+      # Datastore for Certificates and Aliases.
       class GoogleCloudApigeeV1Keystore
         include Google::Apis::Core::Hashable
       
-        # Output only. The aliases in this keystore.
+        # Output only. Aliases in this keystore.
         # Corresponds to the JSON property `aliases`
         # @return [Array<String>]
         attr_accessor :aliases
       
-        # Required. The resource ID for this keystore. Values must match the regular
+        # Required. Resource ID for this keystore. Values must match the regular
         # expression `[\w[:space:]-.]`1,255``.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -3329,6 +3541,32 @@ module Google
         end
       end
       
+      # Response for ListDataCollectors.
+      class GoogleCloudApigeeV1ListDataCollectorsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Data collectors in the specified organization.
+        # Corresponds to the JSON property `dataCollectors`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1DataCollector>]
+        attr_accessor :data_collectors
+      
+        # Page token that you can include in a ListDataCollectors request to retrieve
+        # the next page. If omitted, no subsequent pages exist.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_collectors = args[:data_collectors] if args.key?(:data_collectors)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response for ListDatastores
       class GoogleCloudApigeeV1ListDatastoresResponse
         include Google::Apis::Core::Hashable
@@ -3574,6 +3812,32 @@ module Google
         end
       end
       
+      # Response for ListNatAddresses.
+      class GoogleCloudApigeeV1ListNatAddressesResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of NAT Addresses for the instance.
+        # Corresponds to the JSON property `natAddresses`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1NatAddress>]
+        attr_accessor :nat_addresses
+      
+        # Page token that you can include in a ListNatAddresses request to retrieve the
+        # next page of content. If omitted, no subsequent pages exist.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @nat_addresses = args[:nat_addresses] if args.key?(:nat_addresses)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # 
       class GoogleCloudApigeeV1ListOfDevelopersResponse
         include Google::Apis::Core::Hashable
@@ -3688,6 +3952,38 @@ module Google
         end
       end
       
+      # Apigee NAT(network address translation) address. A NAT address is a static
+      # external IP address used for Internet egress traffic.
+      class GoogleCloudApigeeV1NatAddress
+        include Google::Apis::Core::Hashable
+      
+        # Required. The static IPV4 address.
+        # Corresponds to the JSON property `ipAddress`
+        # @return [String]
+        attr_accessor :ip_address
+      
+        # Required. Resource ID of the NAT address.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. State of the nat address.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ip_address = args[:ip_address] if args.key?(:ip_address)
+          @name = args[:name] if args.key?(:name)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # Operation represents the pairing of REST resource path and the actions (verbs)
       # allowed on the resource path.
       class GoogleCloudApigeeV1Operation
@@ -3721,20 +4017,21 @@ module Google
       class GoogleCloudApigeeV1OperationConfig
         include Google::Apis::Core::Hashable
       
-        # Required. api_source represents either a proxy or remote service name for
-        # which the resources, methods and quota are associated with.
+        # Required. API proxy or remote service name with which the resources, methods,
+        # and quota are associated.
         # Corresponds to the JSON property `apiSource`
         # @return [String]
         attr_accessor :api_source
       
-        # custom attribute associated with the operation.
+        # Custom attributes associated with the operation.
         # Corresponds to the JSON property `attributes`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Attribute>]
         attr_accessor :attributes
       
-        # operations is the list of resource/methods pair, belonging to proxy/remote
-        # service, upon which quota will applied on. Note that currently we allow only a
-        # single operation. The call will fail if more than one is provided.
+        # List of resource/method pairs for the proxy/remote service, upon which quota
+        # will applied. **Note**: Currently, you can specify only a single resource/
+        # method pair. The call will fail if more than one resource/method pair is
+        # provided.
         # Corresponds to the JSON property `operations`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Operation>]
         attr_accessor :operations
@@ -3760,23 +4057,22 @@ module Google
         end
       end
       
-      # The OperationGroup contains a list of configuration details associated with
-      # Apigee proxies or Remote services. Remote services are non-Apigee Edge proxies.
-      # eg, Istio-Envoy.
+      # List of operation configuration details associated with Apigee API proxies or
+      # remote services. Remote services are non-Apigee proxies, such as Istio-Envoy.
       class GoogleCloudApigeeV1OperationGroup
         include Google::Apis::Core::Hashable
       
-        # Identfies whether the configuration is for Apigee proxy or a remote service.
-        # Possible values are "proxy" and "remoteservice". If none specified, the
-        # default is "proxy". "proxy" is used when Apigee proxies are associated with
-        # the API product. "remoteservice" is used when non-Apigee proxy like Envoy is
-        # used, and is associated with the API product.
+        # Flag that specifes whether the configuration is for Apigee API proxy or a
+        # remote service. Valid values are `proxy` or `remoteservice`. Defaults to `
+        # proxy`. Set to `proxy` when Apigee API proxies are associated with the API
+        # product. Set to `remoteservice` when non-Apigee proxies like Istio-Envoy are
+        # associated with the API product.
         # Corresponds to the JSON property `operationConfigType`
         # @return [String]
         attr_accessor :operation_config_type
       
-        # Required. A list of OperationConfig for either Apigee proxies or other other
-        # remote services, that are associated with this API product.
+        # Required. List of operation configurations for either Apigee API proxies or
+        # other remote services that are associated with this API product.
         # Corresponds to the JSON property `operationConfigs`
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1OperationConfig>]
         attr_accessor :operation_configs
@@ -4271,6 +4567,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :dimensions
       
+        # Hostname needs to be specified if query intends to run at host level. This
+        # field is only allowed when query is submitted by CreateHostAsyncQuery where
+        # analytics data will be grouped by organization and hostname.
+        # Corresponds to the JSON property `envgroupHostname`
+        # @return [String]
+        attr_accessor :envgroup_hostname
+      
         # Boolean expression that can be used to filter data. Filter expressions can be
         # combined using AND/OR terms and should be fully parenthesized to avoid
         # ambiguity. See Analytics metrics, dimensions, and filters reference https://
@@ -4335,6 +4638,7 @@ module Google
         def update!(**args)
           @csv_delimiter = args[:csv_delimiter] if args.key?(:csv_delimiter)
           @dimensions = args[:dimensions] if args.key?(:dimensions)
+          @envgroup_hostname = args[:envgroup_hostname] if args.key?(:envgroup_hostname)
           @filter = args[:filter] if args.key?(:filter)
           @group_by_time_unit = args[:group_by_time_unit] if args.key?(:group_by_time_unit)
           @limit = args[:limit] if args.key?(:limit)
@@ -4448,21 +4752,21 @@ module Google
       class GoogleCloudApigeeV1Quota
         include Google::Apis::Core::Hashable
       
-        # Required. The time interval over which the number of request messages is
+        # Required. Time interval over which the number of request messages is
         # calculated.
         # Corresponds to the JSON property `interval`
         # @return [String]
         attr_accessor :interval
       
-        # Required. Limit represents the upper bound count allowed for the time interval
-        # and time unit specified. Requests exceeding this limit will get rejected.
+        # Required. Upper limit allowed for the time interval and time unit specified.
+        # Requests exceeding this limit will be rejected.
         # Corresponds to the JSON property `limit`
         # @return [String]
         attr_accessor :limit
       
-        # The time unit defined for the `interval`. Valid values include minute, hour,
-        # day, or month. The default value is empty. If limit and interval are valid,
-        # the default value is "hour".
+        # Time unit defined for the `interval`. Valid values include `minute`, `hour`, `
+        # day`, or `month`. If `limit` and `interval` are valid, the default value is `
+        # hour`; otherwise, the default is null.
         # Corresponds to the JSON property `timeUnit`
         # @return [String]
         attr_accessor :time_unit
@@ -4877,7 +5181,7 @@ module Google
         # This value is set when the rule is created and will only update if the the
         # environment_id changes. It is used to determine if the runtime is up to date
         # with respect to this rule. This field is omitted from the IngressConfig unless
-        # the GetDeployedIngressConfig API is called with debug=true.
+        # the GetDeployedIngressConfig API is called with view=FULL.
         # Corresponds to the JSON property `envGroupRevision`
         # @return [Fixnum]
         attr_accessor :env_group_revision
@@ -4891,14 +5195,14 @@ module Google
         # The resource name of the proxy revision that is receiving this basepath in the
         # following format: `organizations/`org`/apis/`api`/revisions/`rev``. This field
         # is omitted from the IngressConfig unless the GetDeployedIngressConfig API is
-        # called with debug=true.
+        # called with view=FULL.
         # Corresponds to the JSON property `receiver`
         # @return [String]
         attr_accessor :receiver
       
         # The unix timestamp when this rule was updated. This is updated whenever
         # env_group_revision is updated. This field is omitted from the IngressConfig
-        # unless the GetDeployedIngressConfig API is called with debug=true.
+        # unless the GetDeployedIngressConfig API is called with view=FULL.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -5353,6 +5657,11 @@ module Google
         # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1StatsEnvironmentStats>]
         attr_accessor :environments
       
+        # This field contains a list of query results grouped by host.
+        # Corresponds to the JSON property `hosts`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1StatsHostStats>]
+        attr_accessor :hosts
+      
         # This message type encapsulates additional information about query execution.
         # Corresponds to the JSON property `metaData`
         # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metadata]
@@ -5365,6 +5674,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @environments = args[:environments] if args.key?(:environments)
+          @hosts = args[:hosts] if args.key?(:hosts)
           @meta_data = args[:meta_data] if args.key?(:meta_data)
         end
       end
@@ -5410,6 +5720,47 @@ module Google
         end
       end
       
+      # This message type encapsulates the hostname wrapper: "hosts": [ ` "metrics": [
+      # ` "name": "sum(message_count)", "values": [ "2.52056245E8" ] ` ], "name": "
+      # example.com" ` ]
+      class GoogleCloudApigeeV1StatsHostStats
+        include Google::Apis::Core::Hashable
+      
+        # This field contains the list of metrics grouped under dimensions.
+        # Corresponds to the JSON property `dimensions`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1DimensionMetric>]
+        attr_accessor :dimensions
+      
+        # In the final response, only one of the following fields will be present based
+        # on the dimensions provided. If no dimensions are provided, then only a top
+        # level metrics is provided. If dimensions are included, then there will be a
+        # top level dimensions field under hostnames which will contain metrics values
+        # and the dimension name. Example: "hosts": [ ` "dimensions": [ ` "metrics": [ `
+        # "name": "sum(message_count)", "values": [ "2.14049521E8" ] ` ], "name": "
+        # nit_proxy" ` ], "name": "example.com" ` ] OR "hosts": [ ` "metrics": [ ` "name"
+        # : "sum(message_count)", "values": [ "2.19026331E8" ] ` ], "name": "example.com"
+        # ` ] This field contains the list of metric values.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Metric>]
+        attr_accessor :metrics
+      
+        # This field contains the hostname used in query.
+        # 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)
+          @dimensions = args[:dimensions] if args.key?(:dimensions)
+          @metrics = args[:metrics] if args.key?(:metrics)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Pub/Sub subscription of an environment.
       class GoogleCloudApigeeV1Subscription
         include Google::Apis::Core::Hashable
@@ -5436,13 +5787,13 @@ module Google
       
         # Entity tag (ETag) used for optimistic concurrency control as a way to help
         # prevent simultaneous updates from overwriting each other. For example, when
-        # you call [getSyncAuthorization](getSyncAuthorization) an ETag is returned in
-        # the response. Pass that ETag when calling the [setSyncAuthorization](
-        # setSyncAuthorization) to ensure that you are updating the correct version. If
-        # you don't pass the ETag in the call to `setSyncAuthorization`, then the
-        # existing authorization is overwritten indiscriminately. **Note**: We strongly
-        # recommend that you use the ETag in the read-modify-write cycle to avoid race
-        # conditions.
+        # you call [getSyncAuthorization](organizations/getSyncAuthorization) an ETag is
+        # returned in the response. Pass that ETag when calling the [
+        # setSyncAuthorization](organizations/setSyncAuthorization) to ensure that you
+        # are updating the correct version. If you don't pass the ETag in the call to `
+        # setSyncAuthorization`, then the existing authorization is overwritten
+        # indiscriminately. **Note**: We strongly recommend that you use the ETag in the
+        # read-modify-write cycle to avoid race conditions.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]