google-api-client 0.43.0 → 0.48.0

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

@@ -22,12 +22,11 @@ module Google
     module ApigeeV1
       # Apigee API
       #
-      # The Apigee API lets you programmatically manage Apigee hybrid with a set of
-      #  RESTful operations, including: - Create, edit, and delete API proxies - Manage
-      #  users - Deploy and undeploy proxy revisions - Configure environments For
-      #  information on using the APIs described in this section, see Get started using
-      #  the APIs. *Note:* This product is available as a free trial for a time period
-      #  of 60 days.
+      # Use the Apigee API to programmatically develop and manage APIs with a set of
+      #  RESTful operations. Develop and secure API proxies, deploy and undeploy API
+      #  proxy revisions, monitor APIs, configure environments, manage users, and more.
+      #  Get started using the APIs. *Note:* This product is available as a free trial
+      #  for a time period of 60 days.
       #
       # @example
       #    require 'google/apis/apigee_v1'
@@ -84,8 +83,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an Apigee organization. See [Create an organization](https://docs.
-        # apigee.com/hybrid/latest/precog-provision).
+        # Creates an Apigee organization. See [Create an Apigee organization](https://
+        # cloud.google.com/apigee/docs/api-platform/get-started/create-org).
         # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Organization] google_cloud_apigee_v1_organization_object
         # @param [String] parent
         #   Required. Name of the GCP project in which to associate the Apigee
@@ -120,8 +119,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the profile for an Apigee organization. See [Organizations](https://docs.
-        # apigee.com/hybrid/latest/terminology#organizations).
+        # Gets the profile for an Apigee organization. See [Understanding organizations](
+        # https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-
+        # structure).
         # @param [String] name
         #   Required. Apigee organization name in the following format: `organizations/`
         #   org``
@@ -156,6 +156,9 @@ module Google
         # @param [String] name
         #   Required. Name of the deployed configuration for the organization in the
         #   following format: 'organizations/`org`/deployedIngressConfig'.
+        # @param [String] view
+        #   When set to FULL, additional details about the specific deployments receiving
+        #   traffic will be included in the IngressConfig response's RoutingRules.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -173,11 +176,12 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_organization_deployed_ingress_config(name, fields: nil, quota_user: nil, options: nil, &block)
+        def get_organization_deployed_ingress_config(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1IngressConfig::Representation
           command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1IngressConfig
           command.params['name'] = name unless name.nil?
+          command.query['view'] = view unless view.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -189,9 +193,9 @@ module Google
         # calling [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. For more information, see [Enable Synchronizer access](https:
-        # //docs.apigee.com/hybrid/latest/synchronizer-access#enable-synchronizer-access)
-        # . **Note**: Available to Apigee hybrid only.
+        # indiscriminately. For more information, see [Configure the Synchronizer](https:
+        # //cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**:
+        # Available to Apigee hybrid only.
         # @param [String] name
         #   Required. Name of the Apigee organization. Use the following structure in your
         #   request: `organizations/`org``
@@ -226,8 +230,8 @@ module Google
         end
         
         # Lists the Apigee organizations and associated GCP projects that you have
-        # permission to access. See [Organizations](https://docs.apigee.com/hybrid/
-        # latest/terminology#organizations).
+        # permission to access. See [Understanding organizations](https://cloud.google.
+        # com/apigee/docs/api-platform/fundamentals/organization-structure).
         # @param [String] parent
         #   Required. Use the following structure in your request: `organizations`
         # @param [String] fields
@@ -263,9 +267,9 @@ module Google
         # to ensure that you are updating the correct version. To get an ETag, call [
         # getSyncAuthorization](getSyncAuthorization). If you don't pass the ETag in the
         # call to `setSyncAuthorization`, then the existing authorization is overwritten
-        # indiscriminately. For more information, see [Enable Synchronizer access](https:
-        # //docs.apigee.com/hybrid/latest/synchronizer-access#enable-synchronizer-access)
-        # . **Note**: Available to Apigee hybrid only.
+        # indiscriminately. For more information, see [Configure the Synchronizer](https:
+        # //cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**:
+        # Available to Apigee hybrid only.
         # @param [String] name
         #   Required. Name of the Apigee organization. Use the following structure in your
         #   request: `organizations/`org``
@@ -2913,8 +2917,8 @@ module Google
         
         # Lists all attachments of an environment group.
         # @param [String] parent
-        #   Required. Name of the organization in the following format: `organizations/`
-        #   org``.
+        #   Required. Name of the environment group in the following format: `
+        #   organizations/`org`/envgroups/`envgroup``.
         # @param [Fixnum] page_size
         #   Maximum number of environment group attachments to return. The page size
         #   defaults to 25.
@@ -3114,9 +3118,9 @@ module Google
         end
         
         # Gets the IAM policy on an environment. For more information, see [Manage users,
-        # roles, and permissions using the API](https://docs.apigee.com/hybrid/latest/
-        # manage-users-roles). You must have the `apigee.environments.getIamPolicy`
-        # permission to call this API.
+        # roles, and permissions using the API](https://cloud.google.com/apigee/docs/
+        # api-platform/system-administration/manage-users-roles). You must have the `
+        # apigee.environments.getIamPolicy` permission to call this API.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being requested. See the
         #   operation documentation for the appropriate value for this field.
@@ -3158,8 +3162,9 @@ module Google
         
         # Sets the IAM policy on an environment, if the policy already exists it will be
         # replaced. For more information, see [Manage users, roles, and permissions
-        # using the API](https://docs.apigee.com/hybrid/latest/manage-users-roles). You
-        # must have the `apigee.environments.setIamPolicy` permission to call this API.
+        # using the API](https://cloud.google.com/apigee/docs/api-platform/system-
+        # administration/manage-users-roles). You must have the `apigee.environments.
+        # setIamPolicy` permission to call this API.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified. See the
         #   operation documentation for the appropriate value for this field.
@@ -3582,22 +3587,36 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Undeploys an API proxy revision from an environment. Because multiple
-        # revisions of the same API proxy can be deployed in the same environment if the
-        # base paths are different, you must specify the revision number of the API
-        # proxy.
+        # Deploys a revision of an API proxy. If another revision of the same API proxy
+        # revision is currently deployed, set the `override` parameter to `true` to have
+        # this revision replace the currently deployed revision. You cannot invoke an
+        # API proxy until it has been deployed to an environment. After you deploy an
+        # API proxy revision, you cannot edit it. To edit the API proxy, you must create
+        # and deploy a new revision. For a request path `organizations/`org`/
+        # environments/`env`/apis/`api`/revisions/`rev`/deployments`, two permissions
+        # are required: * `apigee.deployments.create` on the resource `organizations/`
+        # org`/environments/`env`` * `apigee.proxyrevisions.deploy` on the resource `
+        # organizations/`org`/apis/`api`/revisions/`rev``
         # @param [String] name
         #   Required. Name of the API proxy revision deployment in the following format: `
         #   organizations/`org`/environments/`env`/apis/`api`/revisions/`rev``
+        # @param [Boolean] override
+        #   Flag that specifies whether the new deployment replaces other deployed
+        #   revisions of the API proxy in the environment. Set override to true to replace
+        #   other deployed revisions. By default, override is false and the deployment is
+        #   rejected if other revisions of the API proxy are deployed in the environment.
         # @param [Boolean] sequenced_rollout
-        #   If true, a best-effort attempt will be made to remove the environment group
-        #   routing rules corresponding to this deployment before removing the deployment
-        #   from the runtime. This is likely to be a rare use case; it is only needed when
-        #   the intended effect of undeploying this proxy is to cause the traffic it
-        #   currently handles to be rerouted to some other existing proxy in the
-        #   environment group. The GenerateUndeployChangeReport API may be used to examine
-        #   routing changes before issuing the undeployment request, and its response will
-        #   indicate if a sequenced rollout is recommended for the undeployment.
+        #   If true, a best-effort attempt will be made to roll out the routing rules
+        #   corresponding to this deployment and the environment changes to add this
+        #   deployment in a safe order. This reduces the risk of downtime that could be
+        #   caused by changing the environment group's routing before the new destination
+        #   for the affected traffic is ready to receive it. This should only be necessary
+        #   if the new deployment will be capturing traffic from another environment under
+        #   a shared environment group or if traffic will be rerouted to a different
+        #   environment due to a basepath removal. The GenerateDeployChangeReport API may
+        #   be used to examine routing changes before issuing the deployment request, and
+        #   its response will indicate if a sequenced rollout is recommended for the
+        #   deployment.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3607,19 +3626,20 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::ApigeeV1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::ApigeeV1::GoogleProtobufEmpty]
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def deployments_organization_environment_api_revision(name, sequenced_rollout: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'v1/{+name}/deployments', options)
-          command.response_representation = Google::Apis::ApigeeV1::GoogleProtobufEmpty::Representation
-          command.response_class = Google::Apis::ApigeeV1::GoogleProtobufEmpty
+        def deploy_organization_environment_api_revision(name, override: nil, sequenced_rollout: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}/deployments', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment
           command.params['name'] = name unless name.nil?
+          command.query['override'] = override unless override.nil?
           command.query['sequencedRollout'] = sequenced_rollout unless sequenced_rollout.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -3659,6 +3679,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Undeploys an API proxy revision from an environment. For a request path `
+        # organizations/`org`/environments/`env`/apis/`api`/revisions/`rev`/deployments`,
+        # two permissions are required: * `apigee.deployments.delete` on the resource `
+        # organizations/`org`/environments/`env`` * `apigee.proxyrevisions.undeploy` on
+        # the resource `organizations/`org`/apis/`api`/revisions/`rev``
+        # @param [String] name
+        #   Required. Name of the API proxy revision deployment in the following format: `
+        #   organizations/`org`/environments/`env`/apis/`api`/revisions/`rev``
+        # @param [Boolean] sequenced_rollout
+        #   If true, a best-effort attempt will be made to remove the environment group
+        #   routing rules corresponding to this deployment before removing the deployment
+        #   from the runtime. This is likely to be a rare use case; it is only needed when
+        #   the intended effect of undeploying this proxy is to cause the traffic it
+        #   currently handles to be rerouted to some other existing proxy in the
+        #   environment group. The GenerateUndeployChangeReport API may be used to examine
+        #   routing changes before issuing the undeployment request, and its response will
+        #   indicate if a sequenced rollout is recommended for the undeployment.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleProtobufEmpty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def undeploy_organization_environment_api_revision(name, sequenced_rollout: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}/deployments', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleProtobufEmpty
+          command.params['name'] = name unless name.nil?
+          command.query['sequencedRollout'] = sequenced_rollout unless sequenced_rollout.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a debug session for a deployed API Proxy revision.
         # @param [String] parent
         #   Required. The resource name of the API Proxy revision deployment for which to
@@ -3841,13 +3906,14 @@ module Google
         # traffic routing changes that would result from this deployment being created.
         # Any potential routing conflicts or unsafe changes will be reported in the
         # response. This routing analysis is not performed for a non-dry-run
-        # DeployApiProxy request.
+        # DeployApiProxy request. For a request path `organizations/`org`/environments/`
+        # env`/apis/`api`/revisions/`rev`/deployments:generateDeployChangeReport`, two
+        # permissions are required: * `apigee.deployments.create` on the resource `
+        # organizations/`org`/environments/`env`` * `apigee.proxyrevisions.deploy` on
+        # the resource `organizations/`org`/apis/`api`/revisions/`rev``
         # @param [String] name
         #   Name of the API proxy revision deployment in the following format: `
         #   organizations/`org`/environments/`env`/apis/`api`/revisions/`rev``
-        # @param [String] basepath
-        #   Base path where the API proxy revision should be deployed. Defaults to '/' if
-        #   not provided.
         # @param [Boolean] override
         #   Flag that specifies whether to force the deployment of the new revision over
         #   the currently deployed revision by overriding conflict checks.
@@ -3868,12 +3934,11 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def generate_organization_environment_api_revision_deployment_deploy_change_report(name, basepath: nil, override: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def generate_organization_environment_api_revision_deployment_deploy_change_report(name, override: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/{+name}/deployments:generateDeployChangeReport', options)
           command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeploymentChangeReport::Representation
           command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeploymentChangeReport
           command.params['name'] = name unless name.nil?
-          command.query['basepath'] = basepath unless basepath.nil?
           command.query['override'] = override unless override.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -3886,7 +3951,12 @@ module Google
         # detect possible traffic routing changes that would result from this deployment
         # being removed. Any potential routing conflicts or unsafe changes will be
         # reported in the response. This routing analysis is not performed for a non-dry-
-        # run UndeployApiProxy request.
+        # run UndeployApiProxy request. For a request path `organizations/`org`/
+        # environments/`env`/apis/`api`/revisions/`rev`/deployments:
+        # generateUndeployChangeReport`, two permissions are required: * `apigee.
+        # deployments.delete` on the resource `organizations/`org`/environments/`env`` *
+        # `apigee.proxyrevisions.undeploy` on the resource `organizations/`org`/apis/`
+        # api`/revisions/`rev``
         # @param [String] name
         #   Name of the API proxy revision deployment in the following format: `
         #   organizations/`org`/environments/`env`/apis/`api`/revisions/`rev``
@@ -4189,11 +4259,13 @@ module Google
         # controlled by the `format` query parameter: * `keycertfile` - Separate PEM-
         # encoded key and certificate files are uploaded. The request must have `Content-
         # Type: multipart/form-data` and include fields `keyFile` and `certFile`. If
-        # uploading to a truststore, omit `keyFile`. * `pkcs12` - A PKCS12 file is
-        # uploaded. The request must have `Content-Type: multipart/form-data` with the
-        # file provided in the only field. * `selfsignedcert` - A new private key and
-        # certificate are generated. The request must have `Content-Type: application/
-        # json` and a body of CertificateGenerationSpec.
+        # uploading to a truststore, omit `keyFile`. A `password` field should be
+        # provided for encrypted keys. * `pkcs12` - A PKCS12 file is uploaded. The
+        # request must have `Content-Type: multipart/form-data` with the file provided
+        # in the `file` field and a `password` field if the file is encrypted. * `
+        # selfsignedcert` - A new private key and certificate are generated. The request
+        # must have `Content-Type: application/json` and a body of
+        # CertificateGenerationSpec.
         # @param [String] parent
         #   Required. The name of the keystore. Must be of the form `organizations/`
         #   organization`/environments/`environment`/keystores/`keystore``.
@@ -4866,7 +4938,8 @@ module Google
         
         # Creates a resource file. Specify the `Content-Type` as `application/octet-
         # stream` or `multipart/form-data`. For more information about resource files,
-        # see [Resource files](/api-platform/develop/resource-files).
+        # see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/
+        # resource-files).
         # @param [String] parent
         #   Required. Name of the environment in which to create the resource file in the
         #   following format: `organizations/`org`/environments/`env``.
@@ -4908,7 +4981,8 @@ module Google
         end
         
         # Deletes a resource file. For more information about resource files, see [
-        # Resource files](/api-platform/develop/resource-files).
+        # Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/
+        # resource-files).
         # @param [String] parent
         #   Required. Name of the environment in the following format: `organizations/`org`
         #   /environments/`env``.
@@ -4947,7 +5021,8 @@ module Google
         end
         
         # Gets the contents of a resource file. For more information about resource
-        # files, see [Resource files](/api-platform/develop/resource-files).
+        # files, see [Resource files](https://cloud.google.com/apigee/docs/api-platform/
+        # develop/resource-files).
         # @param [String] parent
         #   Required. Name of the environment in the following format: `organizations/`org`
         #   /environments/`env``.
@@ -4985,8 +5060,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all resource files. For more information about resource files, see [
-        # Resource files](/api-platform/develop/resource-files).
+        # Lists all resource files, optionally filtering by type. For more information
+        # about resource files, see [Resource files](https://cloud.google.com/apigee/
+        # docs/api-platform/develop/resource-files).
         # @param [String] parent
         #   Required. Name of the environment in which to list resource files in the
         #   following format: `organizations/`org`/environments/`env``.
@@ -5020,8 +5096,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all resource files. For more information about resource files, see [
-        # Resource files](/api-platform/develop/resource-files).
+        # Lists all resource files, optionally filtering by type. For more information
+        # about resource files, see [Resource files](https://cloud.google.com/apigee/
+        # docs/api-platform/develop/resource-files).
         # @param [String] parent
         #   Required. Name of the environment in which to list resource files in the
         #   following format: `organizations/`org`/environments/`env``.
@@ -5057,7 +5134,8 @@ module Google
         
         # Updates a resource file. Specify the `Content-Type` as `application/octet-
         # stream` or `multipart/form-data`. For more information about resource files,
-        # see [Resource files](/api-platform/develop/resource-files).
+        # see [Resource files](https://cloud.google.com/apigee/docs/api-platform/develop/
+        # resource-files).
         # @param [String] parent
         #   Required. Name of the environment in the following format: `organizations/`org`
         #   /environments/`env``.
@@ -5129,11 +5207,26 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Undeploys a shared flow revision from an environment.
+        # Deploys a revision of a shared flow. If another revision of the same shared
+        # flow is currently deployed, set the `override` parameter to `true` to have
+        # this revision replace the currently deployed revision. You cannot use a shared
+        # flow until it has been deployed to an environment. For a request path `
+        # organizations/`org`/environments/`env`/sharedflows/`sf`/revisions/`rev`/
+        # deployments`, two permissions are required: * `apigee.deployments.create` on
+        # the resource `organizations/`org`/environments/`env`` * `apigee.
+        # sharedflowrevisions.deploy` on the resource `organizations/`org`/sharedflows/`
+        # sf`/revisions/`rev``
         # @param [String] name
-        #   Required. Name of the shared flow revision to undeploy in the following format:
-        #   `organizations/`org`/environments/`env`/sharedflows/`sharedflow`/revisions/`
-        #   rev``
+        #   Required. Name of the shared flow revision to deploy in the following format: `
+        #   organizations/`org`/environments/`env`/sharedflows/`sharedflow`/revisions/`rev`
+        #   `
+        # @param [Boolean] override
+        #   Flag that specifies whether to force the deployment of the new revision over
+        #   the currently deployed revision by overriding conflict checks. If an existing
+        #   shared flow revision is deployed, to ensure seamless deployment with no
+        #   downtime, set this parameter to `true`. In this case, hybrid deploys the new
+        #   revision fully before undeploying the existing revision. If set to `false`,
+        #   you must undeploy the existing revision before deploying the new revision.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -5143,19 +5236,20 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::ApigeeV1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::ApigeeV1::GoogleProtobufEmpty]
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def deployments_organization_environment_sharedflow_revision(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'v1/{+name}/deployments', options)
-          command.response_representation = Google::Apis::ApigeeV1::GoogleProtobufEmpty::Representation
-          command.response_class = Google::Apis::ApigeeV1::GoogleProtobufEmpty
+        def deploy_organization_environment_sharedflow_revision(name, override: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}/deployments', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1Deployment
           command.params['name'] = name unless name.nil?
+          command.query['override'] = override unless override.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -5194,6 +5288,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Undeploys a shared flow revision from an environment. For a request path `
+        # organizations/`org`/environments/`env`/sharedflows/`sf`/revisions/`rev`/
+        # deployments`, two permissions are required: * `apigee.deployments.delete` on
+        # the resource `organizations/`org`/environments/`env`` * `apigee.
+        # sharedflowrevisions.undeploy` on the resource `organizations/`org`/sharedflows/
+        # `sf`/revisions/`rev``
+        # @param [String] name
+        #   Required. Name of the shared flow revision to undeploy in the following format:
+        #   `organizations/`org`/environments/`env`/sharedflows/`sharedflow`/revisions/`
+        #   rev``
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleProtobufEmpty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def undeploy_organization_environment_sharedflow_revision(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}/deployments', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleProtobufEmpty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieve metrics grouped by dimensions. The types of metrics you can retrieve
         # include traffic, message counts, API call latency, response size, and cache
         # hits and counts. Dimensions let you view metrics in meaningful groups. The
@@ -6369,6 +6500,202 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Creates a new category on the portal.
+        # @param [String] parent
+        #   Required. Name of the portal. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site``
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategoryData] google_cloud_apigee_v1_api_category_data_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_organization_site_apicategory(parent, google_cloud_apigee_v1_api_category_data_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/apicategories', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategoryData::Representation
+          command.request_object = google_cloud_apigee_v1_api_category_data_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a category from the portal.
+        # @param [String] name
+        #   Required. Name of the category. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site`/apicategories/`apicategory``
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiResponseWrapper] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiResponseWrapper]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_organization_site_apicategory(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiResponseWrapper::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiResponseWrapper
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a category on the portal.
+        # @param [String] name
+        #   Required. Name of the category. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site`/apicategories/`apicategory``
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_site_apicategory(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the categories on the portal.
+        # @param [String] parent
+        #   Required. Name of the portal. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site``
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiCategoriesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiCategoriesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_site_apicategories(parent, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/apicategories', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiCategoriesResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiCategoriesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a category on the portal.
+        # @param [String] name
+        #   Required. Name of the category. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site`/apicategories/`apicategory``
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategoryData] google_cloud_apigee_v1_api_category_data_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_organization_site_apicategory(name, google_cloud_apigee_v1_api_category_data_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategoryData::Representation
+          command.request_object = google_cloud_apigee_v1_api_category_data_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiCategory
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Provisions a new Apigee organization with a functioning runtime. This is the
+        # standard way to create trial organizations for a free Apigee trial.
+        # @param [String] project
+        #   Required. Name of the GCP project with which to associate the Apigee
+        #   organization.
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ProvisionOrganizationRequest] google_cloud_apigee_v1_provision_organization_request_object
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def provision_project_organization(project, google_cloud_apigee_v1_provision_organization_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+project}:provisionOrganization', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ProvisionOrganizationRequest::Representation
+          command.request_object = google_cloud_apigee_v1_provision_organization_request_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleLongrunningOperation
+          command.params['project'] = project unless project.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected