From d0d22a2baa3c733d6def93ef2342d4045e6d10db Mon Sep 17 00:00:00 2001 From: Google APIs Date: Sat, 22 Aug 2020 00:38:17 +0000 Subject: [PATCH] Autogenerated update (2020-08-22) Update: - composer_v1 - composer_v1beta1 - file_v1 - file_v1beta1 - pubsublite_v1 - texttospeech_v1 - texttospeech_v1beta1 --- api_names_out.yaml | 45 ++ generated/google/apis/composer_v1.rb | 2 +- generated/google/apis/composer_v1/classes.rb | 432 +++++++--------- generated/google/apis/composer_v1/service.rb | 229 +++------ generated/google/apis/composer_v1beta1.rb | 2 +- .../google/apis/composer_v1beta1/classes.rb | 465 ++++++++---------- .../google/apis/composer_v1beta1/service.rb | 271 ++++------ generated/google/apis/file_v1.rb | 2 +- generated/google/apis/file_v1beta1.rb | 2 +- generated/google/apis/file_v1beta1/classes.rb | 165 +++++++ .../apis/file_v1beta1/representations.rb | 55 +++ generated/google/apis/file_v1beta1/service.rb | 222 +++++++++ .../google/apis/firebase_v1beta1/classes.rb | 28 +- .../apis/firebase_v1beta1/representations.rb | 2 + .../google/apis/firebase_v1beta1/service.rb | 9 +- generated/google/apis/groupsmigration_v1.rb | 35 ++ .../google/apis/groupsmigration_v1/classes.rb | 51 ++ .../groupsmigration_v1/representations.rb | 40 ++ .../google/apis/groupsmigration_v1/service.rb | 100 ++++ generated/google/apis/pubsublite_v1.rb | 2 +- .../google/apis/pubsublite_v1/classes.rb | 10 +- generated/google/apis/texttospeech_v1.rb | 2 +- .../google/apis/texttospeech_v1/service.rb | 8 +- generated/google/apis/texttospeech_v1beta1.rb | 2 +- .../apis/texttospeech_v1beta1/service.rb | 8 +- 25 files changed, 1333 insertions(+), 856 deletions(-) create mode 100644 generated/google/apis/groupsmigration_v1.rb create mode 100644 generated/google/apis/groupsmigration_v1/classes.rb create mode 100644 generated/google/apis/groupsmigration_v1/representations.rb create mode 100644 generated/google/apis/groupsmigration_v1/service.rb diff --git a/api_names_out.yaml b/api_names_out.yaml index a1ffdfba2..ef9e77486 100644 --- a/api_names_out.yaml +++ b/api_names_out.yaml @@ -94511,6 +94511,19 @@ "/file:v1/file.projects.locations.operations.list/pageToken": page_token "/file:v1/key": key "/file:v1/quotaUser": quota_user +"/file:v1beta1/Backup": backup +"/file:v1beta1/Backup/capacityGb": capacity_gb +"/file:v1beta1/Backup/createTime": create_time +"/file:v1beta1/Backup/description": description +"/file:v1beta1/Backup/downloadBytes": download_bytes +"/file:v1beta1/Backup/labels": labels +"/file:v1beta1/Backup/labels/label": label +"/file:v1beta1/Backup/name": name +"/file:v1beta1/Backup/sourceFileShare": source_file_share +"/file:v1beta1/Backup/sourceInstance": source_instance +"/file:v1beta1/Backup/sourceInstanceTier": source_instance_tier +"/file:v1beta1/Backup/state": state +"/file:v1beta1/Backup/storageBytes": storage_bytes "/file:v1beta1/CancelOperationRequest": cancel_operation_request "/file:v1beta1/ClientList": client_list "/file:v1beta1/ClientList/hostNames": host_names @@ -94539,6 +94552,7 @@ "/file:v1beta1/FileShareConfig/nfsExportOptions/nfs_export_option": nfs_export_option "/file:v1beta1/FileShareConfig/protocols": protocols "/file:v1beta1/FileShareConfig/protocols/protocol": protocol +"/file:v1beta1/FileShareConfig/sourceBackup": source_backup "/file:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance": google_cloud_saasaccelerator_management_providers_v1_instance "/file:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/consumerDefinedName": consumer_defined_name "/file:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/createTime": create_time @@ -94621,6 +94635,12 @@ "/file:v1beta1/Instance/state": state "/file:v1beta1/Instance/statusMessage": status_message "/file:v1beta1/Instance/tier": tier +"/file:v1beta1/ListBackupsResponse": list_backups_response +"/file:v1beta1/ListBackupsResponse/backups": backups +"/file:v1beta1/ListBackupsResponse/backups/backup": backup +"/file:v1beta1/ListBackupsResponse/nextPageToken": next_page_token +"/file:v1beta1/ListBackupsResponse/unreachable": unreachable +"/file:v1beta1/ListBackupsResponse/unreachable/unreachable": unreachable "/file:v1beta1/ListInstancesResponse": list_instances_response "/file:v1beta1/ListInstancesResponse/instances": instances "/file:v1beta1/ListInstancesResponse/instances/instance": instance @@ -94682,6 +94702,10 @@ "/file:v1beta1/OperationMetadata/statusDetail": status_detail "/file:v1beta1/OperationMetadata/target": target "/file:v1beta1/OperationMetadata/verb": verb +"/file:v1beta1/RestoreInstanceRequest": restore_instance_request +"/file:v1beta1/RestoreInstanceRequest/fileShare": file_share +"/file:v1beta1/RestoreInstanceRequest/sourceBackup": source_backup +"/file:v1beta1/RestoreInstanceRequest/sourceSnapshot": source_snapshot "/file:v1beta1/SmbExport": smb_export "/file:v1beta1/SmbExport/browsable": browsable "/file:v1beta1/SmbExport/fileShare": file_share @@ -94692,6 +94716,22 @@ "/file:v1beta1/Status/details/detail/detail": detail "/file:v1beta1/Status/message": message "/file:v1beta1/fields": fields +"/file:v1beta1/file.projects.locations.backups.create": create_project_location_backup +"/file:v1beta1/file.projects.locations.backups.create/backupId": backup_id +"/file:v1beta1/file.projects.locations.backups.create/parent": parent +"/file:v1beta1/file.projects.locations.backups.delete": delete_project_location_backup +"/file:v1beta1/file.projects.locations.backups.delete/name": name +"/file:v1beta1/file.projects.locations.backups.get": get_project_location_backup +"/file:v1beta1/file.projects.locations.backups.get/name": name +"/file:v1beta1/file.projects.locations.backups.list": list_project_location_backups +"/file:v1beta1/file.projects.locations.backups.list/filter": filter +"/file:v1beta1/file.projects.locations.backups.list/orderBy": order_by +"/file:v1beta1/file.projects.locations.backups.list/pageSize": page_size +"/file:v1beta1/file.projects.locations.backups.list/pageToken": page_token +"/file:v1beta1/file.projects.locations.backups.list/parent": parent +"/file:v1beta1/file.projects.locations.backups.patch": patch_project_location_backup +"/file:v1beta1/file.projects.locations.backups.patch/name": name +"/file:v1beta1/file.projects.locations.backups.patch/updateMask": update_mask "/file:v1beta1/file.projects.locations.get": get_project_location "/file:v1beta1/file.projects.locations.get/name": name "/file:v1beta1/file.projects.locations.instances.create": create_project_location_instance @@ -94710,6 +94750,8 @@ "/file:v1beta1/file.projects.locations.instances.patch": patch_project_location_instance "/file:v1beta1/file.projects.locations.instances.patch/name": name "/file:v1beta1/file.projects.locations.instances.patch/updateMask": update_mask +"/file:v1beta1/file.projects.locations.instances.restore": restore_instance +"/file:v1beta1/file.projects.locations.instances.restore/name": name "/file:v1beta1/file.projects.locations.list": list_project_locations "/file:v1beta1/file.projects.locations.list/filter": filter "/file:v1beta1/file.projects.locations.list/includeUnrevealedLocations": include_unrevealed_locations @@ -94769,6 +94811,7 @@ "/firebase:v1beta1/FirebaseAppInfo/appId": app_id "/firebase:v1beta1/FirebaseAppInfo/displayName": display_name "/firebase:v1beta1/FirebaseAppInfo/name": name +"/firebase:v1beta1/FirebaseAppInfo/namespace": namespace "/firebase:v1beta1/FirebaseAppInfo/platform": platform "/firebase:v1beta1/FirebaseProject": firebase_project "/firebase:v1beta1/FirebaseProject/displayName": display_name @@ -94869,6 +94912,7 @@ "/firebase:v1beta1/WebApp/displayName": display_name "/firebase:v1beta1/WebApp/name": name "/firebase:v1beta1/WebApp/projectId": project_id +"/firebase:v1beta1/WebApp/webId": web_id "/firebase:v1beta1/WebAppConfig": web_app_config "/firebase:v1beta1/WebAppConfig/apiKey": api_key "/firebase:v1beta1/WebAppConfig/appId": app_id @@ -94942,6 +94986,7 @@ "/firebase:v1beta1/firebase.projects.removeAnalytics": remove_project_analytics "/firebase:v1beta1/firebase.projects.removeAnalytics/parent": parent "/firebase:v1beta1/firebase.projects.searchApps": search_project_apps +"/firebase:v1beta1/firebase.projects.searchApps/filter": filter "/firebase:v1beta1/firebase.projects.searchApps/pageSize": page_size "/firebase:v1beta1/firebase.projects.searchApps/pageToken": page_token "/firebase:v1beta1/firebase.projects.searchApps/parent": parent diff --git a/generated/google/apis/composer_v1.rb b/generated/google/apis/composer_v1.rb index b66e0a924..937fa1a55 100644 --- a/generated/google/apis/composer_v1.rb +++ b/generated/google/apis/composer_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/composer/ module ComposerV1 VERSION = 'V1' - REVISION = '20200313' + REVISION = '20200817' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/composer_v1/classes.rb b/generated/google/apis/composer_v1/classes.rb index c651bf9b8..e3a70c6e2 100644 --- a/generated/google/apis/composer_v1/classes.rb +++ b/generated/google/apis/composer_v1/classes.rb @@ -22,13 +22,11 @@ module Google module Apis module ComposerV1 - # A generic empty message that you can re-use to avoid defining duplicated - # empty messages in your APIs. A typical example is to use it as the request - # or the response type of an API method. For instance: - # service Foo ` - # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -55,21 +53,19 @@ module Google # @return [String] attr_accessor :create_time - # Optional. User-defined labels for this environment. - # The labels map can contain no more than 64 entries. Entries of the labels - # map are UTF8 strings that comply with the following restrictions: - # * Keys must conform to regexp: \p`Ll`\p`Lo``0,62` - # * Values must conform to regexp: [\p`Ll`\p`Lo`\p`N`_-]`0,63` - # * Both keys and values are additionally constrained to be <= 128 bytes in - # size. + # Optional. User-defined labels for this environment. The labels map can contain + # no more than 64 entries. Entries of the labels map are UTF8 strings that + # comply with the following restrictions: * Keys must conform to regexp: \p`Ll`\ + # p`Lo``0,62` * Values must conform to regexp: [\p`Ll`\p`Lo`\p`N`_-]`0,63` * + # Both keys and values are additionally constrained to be <= 128 bytes in size. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # The resource name of the environment, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" - # EnvironmentId must start with a lowercase letter followed by up to 63 - # lowercase letters, numbers, or hyphens, and cannot end with a hyphen. + # The resource name of the environment, in the form: "projects/`projectId`/ + # locations/`locationId`/environments/`environmentId`" EnvironmentId must start + # with a lowercase letter followed by up to 63 lowercase letters, numbers, or + # hyphens, and cannot end with a hyphen. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -85,8 +81,7 @@ module Google attr_accessor :update_time # Output only. The UUID (Universally Unique IDentifier) associated with this - # environment. - # This value is generated when the environment is created. + # environment. This value is generated when the environment is created. # Corresponds to the JSON property `uuid` # @return [String] attr_accessor :uuid @@ -112,18 +107,16 @@ module Google include Google::Apis::Core::Hashable # Output only. The URI of the Apache Airflow Web UI hosted within this - # environment (see - # [Airflow web - # interface](/composer/docs/how-to/accessing/airflow-web-interface)). + # environment (see [Airflow web interface](/composer/docs/how-to/accessing/ + # airflow-web-interface)). # Corresponds to the JSON property `airflowUri` # @return [String] attr_accessor :airflow_uri # Output only. The Cloud Storage prefix of the DAGs for this environment. - # Although Cloud - # Storage objects reside in a flat namespace, a hierarchical file tree - # can be simulated using "/"-delimited object name prefixes. DAG objects for - # this environment reside in a simulated directory with the given prefix. + # Although Cloud Storage objects reside in a flat namespace, a hierarchical file + # tree can be simulated using "/"-delimited object name prefixes. DAG objects + # for this environment reside in a simulated directory with the given prefix. # Corresponds to the JSON property `dagGcsPrefix` # @return [String] attr_accessor :dag_gcs_prefix @@ -133,14 +126,14 @@ module Google # @return [String] attr_accessor :gke_cluster - # The configuration information for the Kubernetes Engine nodes running - # the Apache Airflow software. + # The configuration information for the Kubernetes Engine nodes running the + # Apache Airflow software. # Corresponds to the JSON property `nodeConfig` # @return [Google::Apis::ComposerV1::NodeConfig] attr_accessor :node_config - # The number of nodes in the Kubernetes Engine cluster that will be - # used to run this environment. + # The number of nodes in the Kubernetes Engine cluster that will be used to run + # this environment. # Corresponds to the JSON property `nodeCount` # @return [Fixnum] attr_accessor :node_count @@ -172,57 +165,48 @@ module Google end end - # Configuration for controlling how IPs are allocated in the - # GKE cluster running the Apache Airflow software. + # Configuration for controlling how IPs are allocated in the GKE cluster running + # the Apache Airflow software. class IpAllocationPolicy include Google::Apis::Core::Hashable - # Optional. The IP address range used to allocate IP addresses to pods in - # the GKE cluster. - # This field is applicable only when `use_ip_aliases` is true. - # Set to blank to have GKE choose a range with the default size. - # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific - # netmask. - # Set to a - # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range - # to use. + # Optional. The IP address range used to allocate IP addresses to pods in the + # GKE cluster. This field is applicable only when `use_ip_aliases` is true. Set + # to blank to have GKE choose a range with the default size. Set to /netmask (e. + # g. `/14`) to have GKE choose a range with a specific netmask. Set to a [CIDR]( + # http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. ` + # 10.96.0.0/14`) from the RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16. + # 0.0/12`, `192.168.0.0/16`) to pick a specific range to use. # Corresponds to the JSON property `clusterIpv4CidrBlock` # @return [String] attr_accessor :cluster_ipv4_cidr_block - # Optional. The name of the GKE cluster's secondary range used to allocate - # IP addresses to pods. - # This field is applicable only when `use_ip_aliases` is true. + # Optional. The name of the GKE cluster's secondary range used to allocate IP + # addresses to pods. This field is applicable only when `use_ip_aliases` is true. # Corresponds to the JSON property `clusterSecondaryRangeName` # @return [String] attr_accessor :cluster_secondary_range_name - # Optional. The IP address range of the services IP addresses in this - # GKE cluster. - # This field is applicable only when `use_ip_aliases` is true. - # Set to blank to have GKE choose a range with the default size. - # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific - # netmask. - # Set to a - # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range - # to use. + # Optional. The IP address range of the services IP addresses in this GKE + # cluster. This field is applicable only when `use_ip_aliases` is true. Set to + # blank to have GKE choose a range with the default size. Set to /netmask (e.g. ` + # /14`) to have GKE choose a range with a specific netmask. Set to a [CIDR](http: + # //en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96. + # 0.0/14`) from the RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12` + # , `192.168.0.0/16`) to pick a specific range to use. # Corresponds to the JSON property `servicesIpv4CidrBlock` # @return [String] attr_accessor :services_ipv4_cidr_block - # Optional. The name of the services' secondary range used to allocate - # IP addresses to the GKE cluster. - # This field is applicable only when `use_ip_aliases` is true. + # Optional. The name of the services' secondary range used to allocate IP + # addresses to the GKE cluster. This field is applicable only when ` + # use_ip_aliases` is true. # Corresponds to the JSON property `servicesSecondaryRangeName` # @return [String] attr_accessor :services_secondary_range_name - # Optional. Whether or not to enable Alias IPs in the GKE cluster. - # If `true`, a VPC-native cluster is created. + # Optional. Whether or not to enable Alias IPs in the GKE cluster. If `true`, a + # VPC-native cluster is created. # Corresponds to the JSON property `useIpAliases` # @return [Boolean] attr_accessor :use_ip_aliases @@ -246,14 +230,14 @@ module Google class ImageVersion include Google::Apis::Core::Hashable - # The string identifier of the ImageVersion, in the form: - # "composer-x.y.z-airflow-a.b(.c)" + # The string identifier of the ImageVersion, in the form: "composer-x.y.z- + # airflow-a.b(.c)" # Corresponds to the JSON property `imageVersionId` # @return [String] attr_accessor :image_version_id - # Whether this is the default ImageVersion used by Composer during - # environment creation if no input ImageVersion is specified. + # Whether this is the default ImageVersion used by Composer during environment + # creation if no input ImageVersion is specified. # Corresponds to the JSON property `isDefault` # @return [Boolean] attr_accessor :is_default @@ -351,106 +335,95 @@ module Google end end - # The configuration information for the Kubernetes Engine nodes running - # the Apache Airflow software. + # The configuration information for the Kubernetes Engine nodes running the + # Apache Airflow software. class NodeConfig include Google::Apis::Core::Hashable - # Optional. The disk size in GB used for node VMs. Minimum size is 20GB. - # If unspecified, defaults to 100GB. Cannot be updated. + # Optional. The disk size in GB used for node VMs. Minimum size is 20GB. If + # unspecified, defaults to 100GB. Cannot be updated. # Corresponds to the JSON property `diskSizeGb` # @return [Fixnum] attr_accessor :disk_size_gb - # Configuration for controlling how IPs are allocated in the - # GKE cluster running the Apache Airflow software. + # Configuration for controlling how IPs are allocated in the GKE cluster running + # the Apache Airflow software. # Corresponds to the JSON property `ipAllocationPolicy` # @return [Google::Apis::ComposerV1::IpAllocationPolicy] attr_accessor :ip_allocation_policy - # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which - # to deploy the VMs used to run the Apache Airflow software, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/zones/`zoneId`". - # This `location` must belong to the enclosing environment's project and - # location. If both this field and `nodeConfig.machineType` are specified, - # `nodeConfig.machineType` must belong to this `location`; if both are - # unspecified, the service will pick a zone in the Compute Engine region - # corresponding to the Cloud Composer location, and propagate that choice to - # both fields. If only one field (`location` or `nodeConfig.machineType`) is - # specified, the location information from the specified field will be - # propagated to the unspecified field. + # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which to + # deploy the VMs used to run the Apache Airflow software, specified as a [ + # relative resource name](/apis/design/resource_names#relative_resource_name). + # For example: "projects/`projectId`/zones/`zoneId`". This `location` must + # belong to the enclosing environment's project and location. If both this field + # and `nodeConfig.machineType` are specified, `nodeConfig.machineType` must + # belong to this `location`; if both are unspecified, the service will pick a + # zone in the Compute Engine region corresponding to the Cloud Composer location, + # and propagate that choice to both fields. If only one field (`location` or ` + # nodeConfig.machineType`) is specified, the location information from the + # specified field will be propagated to the unspecified field. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. The Compute Engine - # [machine type](/compute/docs/machine-types) used for cluster instances, - # specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/zones/`zoneId`/machineTypes/`machineTypeId`". - # The `machineType` must belong to the enclosing environment's project and - # location. If both this field and `nodeConfig.location` are specified, - # this `machineType` must belong to the `nodeConfig.location`; if both are - # unspecified, the service will pick a zone in the Compute Engine region - # corresponding to the Cloud Composer location, and propagate that choice to - # both fields. If exactly one of this field and `nodeConfig.location` is - # specified, the location information from the specified field will be - # propagated to the unspecified field. - # The `machineTypeId` must not be a [shared-core machine - # type](/compute/docs/machine-types#sharedcore). - # If this field is unspecified, the `machineTypeId` defaults - # to "n1-standard-1". + # Optional. The Compute Engine [machine type](/compute/docs/machine-types) used + # for cluster instances, specified as a [relative resource name](/apis/design/ + # resource_names#relative_resource_name). For example: "projects/`projectId`/ + # zones/`zoneId`/machineTypes/`machineTypeId`". The `machineType` must belong to + # the enclosing environment's project and location. If both this field and ` + # nodeConfig.location` are specified, this `machineType` must belong to the ` + # nodeConfig.location`; if both are unspecified, the service will pick a zone in + # the Compute Engine region corresponding to the Cloud Composer location, and + # propagate that choice to both fields. If exactly one of this field and ` + # nodeConfig.location` is specified, the location information from the specified + # field will be propagated to the unspecified field. The `machineTypeId` must + # not be a [shared-core machine type](/compute/docs/machine-types#sharedcore). + # If this field is unspecified, the `machineTypeId` defaults to "n1-standard-1". # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type - # Optional. The Compute Engine network to be used for machine - # communications, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/global/networks/`networkId`". - # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The - # network must belong to the environment's project. If unspecified, the - # "default" network ID in the environment's project is used. If a - # [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets) - # is provided, `nodeConfig.subnetwork` must also be provided. + # Optional. The Compute Engine network to be used for machine communications, + # specified as a [relative resource name](/apis/design/resource_names# + # relative_resource_name). For example: "projects/`projectId`/global/networks/` + # networkId`". [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. + # The network must belong to the environment's project. If unspecified, the " + # default" network ID in the environment's project is used. If a [Custom Subnet + # Network](/vpc/docs/vpc#vpc_networks_and_subnets) is provided, `nodeConfig. + # subnetwork` must also be provided. # Corresponds to the JSON property `network` # @return [String] attr_accessor :network - # Optional. The set of Google API scopes to be made available on all - # node VMs. If `oauth_scopes` is empty, defaults to - # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated. + # Optional. The set of Google API scopes to be made available on all node VMs. + # If `oauth_scopes` is empty, defaults to ["https://www.googleapis.com/auth/ + # cloud-platform"]. Cannot be updated. # Corresponds to the JSON property `oauthScopes` # @return [Array] attr_accessor :oauth_scopes - # Optional. The Google Cloud Platform Service Account to be used by the node - # VMs. If a service account is not specified, the "default" Compute Engine - # service account is used. Cannot be updated. + # Optional. The Google Cloud Platform Service Account to be used by the node VMs. + # If a service account is not specified, the "default" Compute Engine service + # account is used. Cannot be updated. # Corresponds to the JSON property `serviceAccount` # @return [String] attr_accessor :service_account - # Optional. The Compute Engine subnetwork to be used for machine - # communications, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/regions/`regionId`/subnetworks/`subnetworkId`" - # If a subnetwork is provided, `nodeConfig.network` must also be provided, - # and the subnetwork must belong to the enclosing environment's project and - # location. + # Optional. The Compute Engine subnetwork to be used for machine communications, + # specified as a [relative resource name](/apis/design/resource_names# + # relative_resource_name). For example: "projects/`projectId`/regions/`regionId`/ + # subnetworks/`subnetworkId`" If a subnetwork is provided, `nodeConfig.network` + # must also be provided, and the subnetwork must belong to the enclosing + # environment's project and location. # Corresponds to the JSON property `subnetwork` # @return [String] attr_accessor :subnetwork - # Optional. The list of instance tags applied to all node VMs. Tags are used - # to identify valid sources or targets for network firewalls. Each tag within - # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). - # Cannot be updated. + # Optional. The list of instance tags applied to all node VMs. Tags are used to + # identify valid sources or targets for network firewalls. Each tag within the + # list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). Cannot + # be updated. # Corresponds to the JSON property `tags` # @return [Array] attr_accessor :tags @@ -478,47 +451,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # If the value is `false`, it means the operation is still in progress. - # If `true`, the operation is completed, and either `error` or `response` is - # available. + # If the value is `false`, it means the operation is still in progress. If `true` + # , the operation is completed, and either `error` or `response` is available. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::ComposerV1::Status] attr_accessor :error - # Service-specific metadata associated with the operation. It typically - # contains progress information and common metadata such as create time. - # Some services might not provide such metadata. Any method that returns a - # long-running operation should document the metadata type, if any. + # Service-specific metadata associated with the operation. It typically contains + # progress information and common metadata such as create time. Some services + # might not provide such metadata. Any method that returns a long-running + # operation should document the metadata type, if any. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # The server-assigned name, which is only unique within the same service that - # originally returns it. If you use the default HTTP mapping, the - # `name` should be a resource name ending with `operations/`unique_id``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. If the original - # method returns no data on success, such as `Delete`, the response is - # `google.protobuf.Empty`. If the original method is standard - # `Get`/`Create`/`Update`, the response should be the resource. For other - # methods, the response should have the type `XxxResponse`, where `Xxx` - # is the original method name. For example, if the original method name - # is `TakeSnapshot()`, the inferred response type is - # `TakeSnapshotResponse`. + # The normal response of the operation in case of success. If the original + # method returns no data on success, such as `Delete`, the response is `google. + # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, + # the response should be the resource. For other methods, the response should + # have the type `XxxResponse`, where `Xxx` is the original method name. For + # example, if the original method name is `TakeSnapshot()`, the inferred + # response type is `TakeSnapshotResponse`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -557,8 +528,8 @@ module Google # @return [String] attr_accessor :operation_type - # Output only. The resource being operated on, as a [relative resource name]( - # /apis/design/resource_names#relative_resource_name). + # Output only. The resource being operated on, as a [relative resource name]( / + # apis/design/resource_names#relative_resource_name). # Corresponds to the JSON property `resource` # @return [String] attr_accessor :resource @@ -601,18 +572,16 @@ module Google alias_method :enable_private_endpoint?, :enable_private_endpoint # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. - # If - # left blank, the default value of '172.16.0.0/23' is used. + # If left blank, the default value of '172.16.0.0/23' is used. # Corresponds to the JSON property `masterIpv4CidrBlock` # @return [String] attr_accessor :master_ipv4_cidr_block # Output only. The IP range in CIDR notation to use for the hosted master - # network. This - # range is used for assigning internal IP addresses to the GKE cluster - # master or set of masters and to the internal load balancer virtual IP. - # This range must not overlap with any other ranges in use - # within the cluster's network. + # network. This range is used for assigning internal IP addresses to the GKE + # cluster master or set of masters and to the internal load balancer virtual IP. + # This range must not overlap with any other ranges in use within the cluster's + # network. # Corresponds to the JSON property `masterIpv4ReservedRange` # @return [String] attr_accessor :master_ipv4_reserved_range @@ -635,15 +604,14 @@ module Google include Google::Apis::Core::Hashable # Optional. The CIDR block from which IP range in tenant project will be - # reserved for - # Cloud SQL. Needs to be disjoint from `web_server_ipv4_cidr_block`. + # reserved for Cloud SQL. Needs to be disjoint from `web_server_ipv4_cidr_block`. # Corresponds to the JSON property `cloudSqlIpv4CidrBlock` # @return [String] attr_accessor :cloud_sql_ipv4_cidr_block - # Optional. If `true`, a Private IP Cloud Composer environment is created. - # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be - # set to true. + # Optional. If `true`, a Private IP Cloud Composer environment is created. If + # this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be set to + # true. # Corresponds to the JSON property `enablePrivateEnvironment` # @return [Boolean] attr_accessor :enable_private_environment @@ -656,9 +624,8 @@ module Google attr_accessor :private_cluster_config # Optional. The CIDR block from which IP range for web server will be reserved. - # Needs - # to be disjoint from `private_cluster_config.master_ipv4_cidr_block` and - # `cloud_sql_ipv4_cidr_block`. + # Needs to be disjoint from `private_cluster_config.master_ipv4_cidr_block` and ` + # cloud_sql_ipv4_cidr_block`. # Corresponds to the JSON property `webServerIpv4CidrBlock` # @return [String] attr_accessor :web_server_ipv4_cidr_block @@ -686,84 +653,65 @@ module Google class SoftwareConfig include Google::Apis::Core::Hashable - # Optional. Apache Airflow configuration properties to override. - # Property keys contain the section and property names, separated by a - # hyphen, for example "core-dags_are_paused_at_creation". Section names must - # not contain hyphens ("-"), opening square brackets ("["), or closing - # square brackets ("]"). The property name must not be empty and must not - # contain an equals sign ("=") or semicolon (";"). Section and property names - # must not contain a period ("."). Apache Airflow configuration property - # names must be written in - # [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can - # contain any character, and can be written in any lower/upper case format. - # Certain Apache Airflow configuration property values are - # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations# - # airflow_configuration_blacklists), - # and cannot be overridden. + # Optional. Apache Airflow configuration properties to override. Property keys + # contain the section and property names, separated by a hyphen, for example " + # core-dags_are_paused_at_creation". Section names must not contain hyphens ("-") + # , opening square brackets ("["), or closing square brackets ("]"). The + # property name must not be empty and must not contain an equals sign ("=") or + # semicolon (";"). Section and property names must not contain a period ("."). + # Apache Airflow configuration property names must be written in [snake_case]( + # https://en.wikipedia.org/wiki/Snake_case). Property values can contain any + # character, and can be written in any lower/upper case format. Certain Apache + # Airflow configuration property values are [blacklisted](/composer/docs/how-to/ + # managing/setting-airflow-configurations#airflow_configuration_blacklists), and + # cannot be overridden. # Corresponds to the JSON property `airflowConfigOverrides` # @return [Hash] attr_accessor :airflow_config_overrides # Optional. Additional environment variables to provide to the Apache Airflow - # scheduler, worker, and webserver processes. - # Environment variable names must match the regular expression - # `a-zA-Z_*`. They cannot specify Apache Airflow - # software configuration overrides (they cannot match the regular expression - # `AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+`), and they cannot match any of the - # following reserved names: - # * `AIRFLOW_HOME` - # * `C_FORCE_ROOT` - # * `CONTAINER_NAME` - # * `DAGS_FOLDER` - # * `GCP_PROJECT` - # * `GCS_BUCKET` - # * `GKE_CLUSTER_NAME` - # * `SQL_DATABASE` - # * `SQL_INSTANCE` - # * `SQL_PASSWORD` - # * `SQL_PROJECT` - # * `SQL_REGION` + # scheduler, worker, and webserver processes. Environment variable names must + # match the regular expression `a-zA-Z_*`. They cannot specify Apache Airflow + # software configuration overrides (they cannot match the regular expression ` + # AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+`), and they cannot match any of the following + # reserved names: * `AIRFLOW_HOME` * `C_FORCE_ROOT` * `CONTAINER_NAME` * ` + # DAGS_FOLDER` * `GCP_PROJECT` * `GCS_BUCKET` * `GKE_CLUSTER_NAME` * ` + # SQL_DATABASE` * `SQL_INSTANCE` * `SQL_PASSWORD` * `SQL_PROJECT` * `SQL_REGION` # * `SQL_USER` # Corresponds to the JSON property `envVariables` # @return [Hash] attr_accessor :env_variables - # The version of the software running in the environment. - # This encapsulates both the version of Cloud Composer functionality and the - # version of Apache Airflow. It must match the regular expression - # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. - # When used as input, the server also checks if the provided version is - # supported and denies the request for an unsupported version. - # The Cloud Composer portion of the version is a - # [semantic version](https://semver.org) or `latest`. When the patch version - # is omitted, the current Cloud Composer patch version is selected. - # When `latest` is provided instead of an explicit version number, - # the server replaces `latest` with the current Cloud Composer version - # and stores that version number in the same field. - # The portion of the image version that follows airflow- is an - # official Apache Airflow repository - # [release name](https://github.com/apache/incubator-airflow/releases). - # See also [Version - # List](/composer/docs/concepts/versioning/composer-versions). + # The version of the software running in the environment. This encapsulates both + # the version of Cloud Composer functionality and the version of Apache Airflow. + # It must match the regular expression `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)- + # airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. When used as input, the server also + # checks if the provided version is supported and denies the request for an + # unsupported version. The Cloud Composer portion of the version is a [semantic + # version](https://semver.org) or `latest`. When the patch version is omitted, + # the current Cloud Composer patch version is selected. When `latest` is + # provided instead of an explicit version number, the server replaces `latest` + # with the current Cloud Composer version and stores that version number in the + # same field. The portion of the image version that follows *airflow-* is an + # official Apache Airflow repository [release name](https://github.com/apache/ + # incubator-airflow/releases). See also [Version List](/composer/docs/concepts/ + # versioning/composer-versions). # Corresponds to the JSON property `imageVersion` # @return [String] attr_accessor :image_version - # Optional. Custom Python Package Index (PyPI) packages to be installed in - # the environment. - # Keys refer to the lowercase package name such as "numpy" - # and values are the lowercase extras and version specifier such as - # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a - # package without pinning it to a version specifier, use the empty string as - # the value. + # Optional. Custom Python Package Index (PyPI) packages to be installed in the + # environment. Keys refer to the lowercase package name such as "numpy" and + # values are the lowercase extras and version specifier such as "==1.12.0", "[ + # devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without + # pinning it to a version specifier, use the empty string as the value. # Corresponds to the JSON property `pypiPackages` # @return [Hash] attr_accessor :pypi_packages - # Optional. The major version of Python used to run the Apache Airflow - # scheduler, worker, and webserver processes. - # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be - # updated. + # Optional. The major version of Python used to run the Apache Airflow scheduler, + # worker, and webserver processes. Can be set to '2' or '3'. If not specified, + # the default is '2'. Cannot be updated. # Corresponds to the JSON property `pythonVersion` # @return [String] attr_accessor :python_version @@ -782,12 +730,12 @@ module Google end end - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable @@ -796,15 +744,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # A developer-facing error message, which should be in English. Any - # user-facing error message should be localized and sent in the - # google.rpc.Status.details field, or localized by the client. + # A developer-facing error message, which should be in English. Any user-facing + # error message should be localized and sent in the google.rpc.Status.details + # field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message diff --git a/generated/google/apis/composer_v1/service.rb b/generated/google/apis/composer_v1/service.rb index 560f6926b..a294ebfcf 100644 --- a/generated/google/apis/composer_v1/service.rb +++ b/generated/google/apis/composer_v1/service.rb @@ -49,8 +49,7 @@ module Google # Create a new environment. # @param [String] parent - # The parent must be of the form - # "projects/`projectId`/locations/`locationId`". + # The parent must be of the form "projects/`projectId`/locations/`locationId`". # @param [Google::Apis::ComposerV1::Environment] environment_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -83,8 +82,8 @@ module Google # Delete an environment. # @param [String] name - # The environment to delete, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The environment to delete, in the form: "projects/`projectId`/locations/` + # locationId`/environments/`environmentId`" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -114,8 +113,8 @@ module Google # Get an existing environment. # @param [String] name - # The resource name of the environment to get, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The resource name of the environment to get, in the form: "projects/`projectId` + # /locations/`locationId`/environments/`environmentId`" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -145,8 +144,8 @@ module Google # List environments. # @param [String] parent - # List environments in the given project and location, in the form: - # "projects/`projectId`/locations/`locationId`" + # List environments in the given project and location, in the form: "projects/` + # projectId`/locations/`locationId`" # @param [Fixnum] page_size # The maximum number of environments to return. # @param [String] page_token @@ -182,134 +181,66 @@ module Google # Update an environment. # @param [String] name - # The relative resource name of the environment to update, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The relative resource name of the environment to update, in the form: " + # projects/`projectId`/locations/`locationId`/environments/`environmentId`" # @param [Google::Apis::ComposerV1::Environment] environment_object # @param [String] update_mask # Required. A comma-separated list of paths, relative to `Environment`, of - # fields to update. - # For example, to set the version of scikit-learn to install in the - # environment to 0.19.0 and to remove an existing installation of - # numpy, the `updateMask` parameter would include the following two - # `paths` values: "config.softwareConfig.pypiPackages.scikit-learn" and - # "config.softwareConfig.pypiPackages.numpy". The included patch - # environment would specify the scikit-learn version as follows: - # ` - # "config":` - # "softwareConfig":` - # "pypiPackages":` - # "scikit-learn":"==0.19.0" - # ` - # ` - # ` - # ` - # Note that in the above example, any existing PyPI packages - # other than scikit-learn and numpy will be unaffected. - # Only one update type may be included in a single request's `updateMask`. - # For example, one cannot update both the PyPI packages and - # labels in the same request. However, it is possible to update multiple - # members of a map field simultaneously in the same request. For example, - # to set the labels "label1" and "label2" while clearing "label3" (assuming - # it already exists), one can - # provide the paths "labels.label1", "labels.label2", and "labels.label3" - # and populate the patch environment as follows: - # ` - # "labels":` - # "label1":"new-label1-value" - # "label2":"new-label2-value" - # ` - # ` - # Note that in the above example, any existing labels that are not - # included in the `updateMask` will be unaffected. - # It is also possible to replace an entire map field by providing the - # map field's path in the `updateMask`. The new value of the field will - # be that which is provided in the patch environment. For example, to - # delete all pre-existing user-specified PyPI packages and - # install botocore at version 1.7.14, the `updateMask` would contain - # the path "config.softwareConfig.pypiPackages", and - # the patch environment would be the following: - # ` - # "config":` - # "softwareConfig":` - # "pypiPackages":` - # "botocore":"==1.7.14" - # ` - # ` - # ` - # ` - # **Note:** Only the following fields can be updated: - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - #
MaskPurpose
config.softwareConfig.pypiPackages - # Replace all custom custom PyPI packages. If a replacement - # package map is not included in `environment`, all custom - # PyPI packages are cleared. It is an error to provide both this mask and a - # mask specifying an individual package.
config.softwareConfig.pypiPackages.packagenameUpdate the custom PyPI package packagename, - # preserving other packages. To delete the package, include it in - # `updateMask`, and omit the mapping for it in - # `environment.config.softwareConfig.pypiPackages`. It is an error - # to provide both a mask of this form and the - # "config.softwareConfig.pypiPackages" mask.
labelsReplace all environment labels. If a replacement labels map is not - # included in `environment`, all labels are cleared. It is an error to - # provide both this mask and a mask specifying one or more individual - # labels.
labels.labelNameSet the label named labelName, while preserving other - # labels. To delete the label, include it in `updateMask` and omit its - # mapping in `environment.labels`. It is an error to provide both a - # mask of this form and the "labels" mask.
config.nodeCountHorizontally scale the number of nodes in the environment. An integer - # greater than or equal to 3 must be provided in the `config.nodeCount` - # field. - #
config.softwareConfig.airflowConfigOverridesReplace all Apache Airflow config overrides. If a replacement config - # overrides map is not included in `environment`, all config overrides - # are cleared. - # It is an error to provide both this mask and a mask specifying one or - # more individual config overrides.
config.softwareConfig.airflowConfigOverrides.section-name - # Override the Apache Airflow config property name in the - # section named section, preserving other properties. To delete - # the property override, include it in `updateMask` and omit its mapping - # in `environment.config.softwareConfig.airflowConfigOverrides`. - # It is an error to provide both a mask of this form and the - # "config.softwareConfig.airflowConfigOverrides" mask.
config.softwareConfig.envVariablesReplace all environment variables. If a replacement environment + # fields to update. For example, to set the version of scikit-learn to install + # in the environment to 0.19.0 and to remove an existing installation of numpy, + # the `updateMask` parameter would include the following two `paths` values: " + # config.softwareConfig.pypiPackages.scikit-learn" and "config.softwareConfig. + # pypiPackages.numpy". The included patch environment would specify the scikit- + # learn version as follows: ` "config":` "softwareConfig":` "pypiPackages":` " + # scikit-learn":"==0.19.0" ` ` ` ` Note that in the above example, any existing + # PyPI packages other than scikit-learn and numpy will be unaffected. Only one + # update type may be included in a single request's `updateMask`. For example, + # one cannot update both the PyPI packages and labels in the same request. + # However, it is possible to update multiple members of a map field + # simultaneously in the same request. For example, to set the labels "label1" + # and "label2" while clearing "label3" (assuming it already exists), one can + # provide the paths "labels.label1", "labels.label2", and "labels.label3" and + # populate the patch environment as follows: ` "labels":` "label1":"new-label1- + # value" "label2":"new-label2-value" ` ` Note that in the above example, any + # existing labels that are not included in the `updateMask` will be unaffected. + # It is also possible to replace an entire map field by providing the map field' + # s path in the `updateMask`. The new value of the field will be that which is + # provided in the patch environment. For example, to delete all pre-existing + # user-specified PyPI packages and install botocore at version 1.7.14, the ` + # updateMask` would contain the path "config.softwareConfig.pypiPackages", and + # the patch environment would be the following: ` "config":` "softwareConfig":` " + # pypiPackages":` "botocore":"==1.7.14" ` ` ` ` **Note:** Only the following + # fields can be updated: *Mask* *Purpose* config.softwareConfig.pypiPackages + # Replace all custom custom PyPI packages. If a replacement package map is not + # included in `environment`, all custom PyPI packages are cleared. It is an + # error to provide both this mask and a mask specifying an individual package. + # config.softwareConfig.pypiPackages.packagename Update the custom PyPI package + # packagename, preserving other packages. To delete the package, include it in ` + # updateMask`, and omit the mapping for it in `environment.config.softwareConfig. + # pypiPackages`. It is an error to provide both a mask of this form and the " + # config.softwareConfig.pypiPackages" mask. labels Replace all environment + # labels. If a replacement labels map is not included in `environment`, all + # labels are cleared. It is an error to provide both this mask and a mask + # specifying one or more individual labels. labels.labelName Set the label named + # labelName, while preserving other labels. To delete the label, include it in ` + # updateMask` and omit its mapping in `environment.labels`. It is an error to + # provide both a mask of this form and the "labels" mask. config.nodeCount + # Horizontally scale the number of nodes in the environment. An integer greater + # than or equal to 3 must be provided in the `config.nodeCount` field. config. + # softwareConfig.airflowConfigOverrides Replace all Apache Airflow config + # overrides. If a replacement config overrides map is not included in ` + # environment`, all config overrides are cleared. It is an error to provide both + # this mask and a mask specifying one or more individual config overrides. + # config.softwareConfig.airflowConfigOverrides.section-name Override the Apache + # Airflow config property name in the section named section, preserving other + # properties. To delete the property override, include it in `updateMask` and + # omit its mapping in `environment.config.softwareConfig.airflowConfigOverrides`. + # It is an error to provide both a mask of this form and the "config. + # softwareConfig.airflowConfigOverrides" mask. config.softwareConfig. + # envVariables Replace all environment variables. If a replacement environment # variable map is not included in `environment`, all custom environment - # variables are cleared. - # It is an error to provide both this mask and a mask specifying one or - # more individual environment variables.
+ # variables are cleared. It is an error to provide both this mask and a mask + # specifying one or more individual environment variables. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -342,8 +273,8 @@ module Google # List ImageVersions for provided location. # @param [String] parent - # List ImageVersions in the given project and location, in the form: - # "projects/`projectId`/locations/`locationId`" + # List ImageVersions in the given project and location, in the form: "projects/` + # projectId`/locations/`locationId`" # @param [Fixnum] page_size # The maximum number of image_versions to return. # @param [String] page_token @@ -377,10 +308,10 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a long-running operation. This method indicates that the client is - # no longer interested in the operation result. It does not cancel the - # operation. If the server doesn't support this method, it returns - # `google.rpc.Code.UNIMPLEMENTED`. + # Deletes a long-running operation. This method indicates that the client is no + # longer interested in the operation result. It does not cancel the operation. + # If the server doesn't support this method, it returns `google.rpc.Code. + # UNIMPLEMENTED`. # @param [String] name # The name of the operation resource to be deleted. # @param [String] fields @@ -410,9 +341,8 @@ module Google execute_or_queue_command(command, &block) end - # Gets the latest state of a long-running operation. Clients can use this - # method to poll the operation result at intervals as recommended by the API - # service. + # Gets the latest state of a long-running operation. Clients can use this method + # to poll the operation result at intervals as recommended by the API service. # @param [String] name # The name of the operation resource. # @param [String] fields @@ -442,15 +372,14 @@ module Google execute_or_queue_command(command, &block) end - # Lists operations that match the specified filter in the request. If the - # server doesn't support this method, it returns `UNIMPLEMENTED`. - # NOTE: the `name` binding allows API services to override the binding - # to use different resource name schemes, such as `users/*/operations`. To - # override the binding, API services can add a binding such as - # `"/v1/`name=users/*`/operations"` to their service configuration. - # For backwards compatibility, the default name includes the operations - # collection id, however overriding users must ensure the name binding - # is the parent resource, without the operations collection id. + # Lists operations that match the specified filter in the request. If the server + # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` + # binding allows API services to override the binding to use different resource + # name schemes, such as `users/*/operations`. To override the binding, API + # services can add a binding such as `"/v1/`name=users/*`/operations"` to their + # service configuration. For backwards compatibility, the default name includes + # the operations collection id, however overriding users must ensure the name + # binding is the parent resource, without the operations collection id. # @param [String] name # The name of the operation's parent resource. # @param [String] filter diff --git a/generated/google/apis/composer_v1beta1.rb b/generated/google/apis/composer_v1beta1.rb index f7c8ad7c0..aaabb6dc9 100644 --- a/generated/google/apis/composer_v1beta1.rb +++ b/generated/google/apis/composer_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/composer/ module ComposerV1beta1 VERSION = 'V1beta1' - REVISION = '20200616' + REVISION = '20200817' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/composer_v1beta1/classes.rb b/generated/google/apis/composer_v1beta1/classes.rb index 468312e0c..ff4b45b89 100644 --- a/generated/google/apis/composer_v1beta1/classes.rb +++ b/generated/google/apis/composer_v1beta1/classes.rb @@ -31,13 +31,11 @@ module Google # @return [String] attr_accessor :description - # IP address or range, defined using CIDR notation, of requests that this - # rule applies to. - # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32` - # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`. - #

IP range prefixes should be properly truncated. For example, - # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6, - # `2001:db8::1/32` should be truncated to `2001:db8::/32`. + # IP address or range, defined using CIDR notation, of requests that this rule + # applies to. Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32` or ` + # 2001:0db8:0000:0042:0000:8a2e:0370:7334`. IP range prefixes should be properly + # truncated. For example, `1.2.3.4/24` should be truncated to `1.2.3.0/24`. + # Similarly, for IPv6, `2001:db8::1/32` should be truncated to `2001:db8::/32`. # Corresponds to the JSON property `value` # @return [String] attr_accessor :value @@ -58,9 +56,9 @@ module Google class DatabaseConfig include Google::Apis::Core::Hashable - # Optional. Cloud SQL machine type used by Airflow database. - # It has to be one of: db-n1-standard-2, db-n1-standard-4, db-n1-standard-8 - # or db-n1-standard-16. If not specified, db-n1-standard-2 will be used. + # Optional. Cloud SQL machine type used by Airflow database. It has to be one of: + # db-n1-standard-2, db-n1-standard-4, db-n1-standard-8 or db-n1-standard-16. If + # not specified, db-n1-standard-2 will be used. # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type @@ -75,13 +73,11 @@ module Google end end - # A generic empty message that you can re-use to avoid defining duplicated - # empty messages in your APIs. A typical example is to use it as the request - # or the response type of an API method. For instance: - # service Foo ` - # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -108,21 +104,19 @@ module Google # @return [String] attr_accessor :create_time - # Optional. User-defined labels for this environment. - # The labels map can contain no more than 64 entries. Entries of the labels - # map are UTF8 strings that comply with the following restrictions: - # * Keys must conform to regexp: \p`Ll`\p`Lo``0,62` - # * Values must conform to regexp: [\p`Ll`\p`Lo`\p`N`_-]`0,63` - # * Both keys and values are additionally constrained to be <= 128 bytes in - # size. + # Optional. User-defined labels for this environment. The labels map can contain + # no more than 64 entries. Entries of the labels map are UTF8 strings that + # comply with the following restrictions: * Keys must conform to regexp: \p`Ll`\ + # p`Lo``0,62` * Values must conform to regexp: [\p`Ll`\p`Lo`\p`N`_-]`0,63` * + # Both keys and values are additionally constrained to be <= 128 bytes in size. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # The resource name of the environment, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" - # EnvironmentId must start with a lowercase letter followed by up to 63 - # lowercase letters, numbers, or hyphens, and cannot end with a hyphen. + # The resource name of the environment, in the form: "projects/`projectId`/ + # locations/`locationId`/environments/`environmentId`" EnvironmentId must start + # with a lowercase letter followed by up to 63 lowercase letters, numbers, or + # hyphens, and cannot end with a hyphen. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -138,8 +132,7 @@ module Google attr_accessor :update_time # Output only. The UUID (Universally Unique IDentifier) associated with this - # environment. - # This value is generated when the environment is created. + # environment. This value is generated when the environment is created. # Corresponds to the JSON property `uuid` # @return [String] attr_accessor :uuid @@ -165,18 +158,16 @@ module Google include Google::Apis::Core::Hashable # Output only. The URI of the Apache Airflow Web UI hosted within this - # environment (see - # [Airflow web - # interface](/composer/docs/how-to/accessing/airflow-web-interface)). + # environment (see [Airflow web interface](/composer/docs/how-to/accessing/ + # airflow-web-interface)). # Corresponds to the JSON property `airflowUri` # @return [String] attr_accessor :airflow_uri # Output only. The Cloud Storage prefix of the DAGs for this environment. - # Although Cloud - # Storage objects reside in a flat namespace, a hierarchical file tree - # can be simulated using "/"-delimited object name prefixes. DAG objects for - # this environment reside in a simulated directory with the given prefix. + # Although Cloud Storage objects reside in a flat namespace, a hierarchical file + # tree can be simulated using "/"-delimited object name prefixes. DAG objects + # for this environment reside in a simulated directory with the given prefix. # Corresponds to the JSON property `dagGcsPrefix` # @return [String] attr_accessor :dag_gcs_prefix @@ -192,14 +183,14 @@ module Google # @return [String] attr_accessor :gke_cluster - # The configuration information for the Kubernetes Engine nodes running - # the Apache Airflow software. + # The configuration information for the Kubernetes Engine nodes running the + # Apache Airflow software. # Corresponds to the JSON property `nodeConfig` # @return [Google::Apis::ComposerV1beta1::NodeConfig] attr_accessor :node_config - # The number of nodes in the Kubernetes Engine cluster that will be - # used to run this environment. + # The number of nodes in the Kubernetes Engine cluster that will be used to run + # this environment. # Corresponds to the JSON property `nodeCount` # @return [Fixnum] attr_accessor :node_count @@ -244,63 +235,52 @@ module Google end end - # Configuration for controlling how IPs are allocated in the - # GKE cluster. + # Configuration for controlling how IPs are allocated in the GKE cluster. class IpAllocationPolicy include Google::Apis::Core::Hashable - # Optional. The IP address range used to allocate IP addresses to pods in - # the cluster. - # This field is applicable only when `use_ip_aliases` is true. - # Set to blank to have GKE choose a range with the default size. - # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific - # netmask. - # Set to a - # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range - # to use. - # Specify `cluster_secondary_range_name` or `cluster_ipv4_cidr_block` - # but not both. + # Optional. The IP address range used to allocate IP addresses to pods in the + # cluster. This field is applicable only when `use_ip_aliases` is true. Set to + # blank to have GKE choose a range with the default size. Set to /netmask (e.g. ` + # /14`) to have GKE choose a range with a specific netmask. Set to a [CIDR](http: + # //en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96. + # 0.0/14`) from the RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12` + # , `192.168.0.0/16`) to pick a specific range to use. Specify ` + # cluster_secondary_range_name` or `cluster_ipv4_cidr_block` but not both. # Corresponds to the JSON property `clusterIpv4CidrBlock` # @return [String] attr_accessor :cluster_ipv4_cidr_block - # Optional. The name of the cluster's secondary range used to allocate - # IP addresses to pods. Specify either `cluster_secondary_range_name` - # or `cluster_ipv4_cidr_block` but not both. - # This field is applicable only when `use_ip_aliases` is true. + # Optional. The name of the cluster's secondary range used to allocate IP + # addresses to pods. Specify either `cluster_secondary_range_name` or ` + # cluster_ipv4_cidr_block` but not both. This field is applicable only when ` + # use_ip_aliases` is true. # Corresponds to the JSON property `clusterSecondaryRangeName` # @return [String] attr_accessor :cluster_secondary_range_name - # Optional. The IP address range of the services IP addresses in this - # cluster. - # This field is applicable only when `use_ip_aliases` is true. - # Set to blank to have GKE choose a range with the default size. - # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific - # netmask. - # Set to a - # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) - # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. - # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range - # to use. - # Specify `services_secondary_range_name` or `services_ipv4_cidr_block` - # but not both. + # Optional. The IP address range of the services IP addresses in this cluster. + # This field is applicable only when `use_ip_aliases` is true. Set to blank to + # have GKE choose a range with the default size. Set to /netmask (e.g. `/14`) to + # have GKE choose a range with a specific netmask. Set to a [CIDR](http://en. + # wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/ + # 14`) from the RFC-1918 private networks (e.g. `10.0.0.0/8`, `172.16.0.0/12`, ` + # 192.168.0.0/16`) to pick a specific range to use. Specify ` + # services_secondary_range_name` or `services_ipv4_cidr_block` but not both. # Corresponds to the JSON property `servicesIpv4CidrBlock` # @return [String] attr_accessor :services_ipv4_cidr_block - # Optional. The name of the services' secondary range used to allocate - # IP addresses to the cluster. Specify either `services_secondary_range_name` - # or `services_ipv4_cidr_block` but not both. - # This field is applicable only when `use_ip_aliases` is true. + # Optional. The name of the services' secondary range used to allocate IP + # addresses to the cluster. Specify either `services_secondary_range_name` or ` + # services_ipv4_cidr_block` but not both. This field is applicable only when ` + # use_ip_aliases` is true. # Corresponds to the JSON property `servicesSecondaryRangeName` # @return [String] attr_accessor :services_secondary_range_name - # Optional. Whether or not to enable Alias IPs in the GKE cluster. - # If `true`, a VPC-native cluster is created. + # Optional. Whether or not to enable Alias IPs in the GKE cluster. If `true`, a + # VPC-native cluster is created. # Corresponds to the JSON property `useIpAliases` # @return [Boolean] attr_accessor :use_ip_aliases @@ -324,14 +304,14 @@ module Google class ImageVersion include Google::Apis::Core::Hashable - # The string identifier of the ImageVersion, in the form: - # "composer-x.y.z-airflow-a.b(.c)" + # The string identifier of the ImageVersion, in the form: "composer-x.y.z- + # airflow-a.b(.c)" # Corresponds to the JSON property `imageVersionId` # @return [String] attr_accessor :image_version_id - # Whether this is the default ImageVersion used by Composer during - # environment creation if no input ImageVersion is specified. + # Whether this is the default ImageVersion used by Composer during environment + # creation if no input ImageVersion is specified. # Corresponds to the JSON property `isDefault` # @return [Boolean] attr_accessor :is_default @@ -429,106 +409,93 @@ module Google end end - # The configuration information for the Kubernetes Engine nodes running - # the Apache Airflow software. + # The configuration information for the Kubernetes Engine nodes running the + # Apache Airflow software. class NodeConfig include Google::Apis::Core::Hashable - # Optional. The disk size in GB used for node VMs. Minimum size is 20GB. - # If unspecified, defaults to 100GB. Cannot be updated. + # Optional. The disk size in GB used for node VMs. Minimum size is 20GB. If + # unspecified, defaults to 100GB. Cannot be updated. # Corresponds to the JSON property `diskSizeGb` # @return [Fixnum] attr_accessor :disk_size_gb - # Configuration for controlling how IPs are allocated in the - # GKE cluster. + # Configuration for controlling how IPs are allocated in the GKE cluster. # Corresponds to the JSON property `ipAllocationPolicy` # @return [Google::Apis::ComposerV1beta1::IpAllocationPolicy] attr_accessor :ip_allocation_policy - # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which - # to deploy the VMs used to run the Apache Airflow software, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/zones/`zoneId`". - # This `location` must belong to the enclosing environment's project and - # location. If both this field and `nodeConfig.machineType` are specified, - # `nodeConfig.machineType` must belong to this `location`; if both are - # unspecified, the service will pick a zone in the Compute Engine region - # corresponding to the Cloud Composer location, and propagate that choice to - # both fields. If only one field (`location` or `nodeConfig.machineType`) is - # specified, the location information from the specified field will be - # propagated to the unspecified field. + # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which to + # deploy the VMs used to run the Apache Airflow software, specified as a [ + # relative resource name](/apis/design/resource_names#relative_resource_name). + # For example: "projects/`projectId`/zones/`zoneId`". This `location` must + # belong to the enclosing environment's project and location. If both this field + # and `nodeConfig.machineType` are specified, `nodeConfig.machineType` must + # belong to this `location`; if both are unspecified, the service will pick a + # zone in the Compute Engine region corresponding to the Cloud Composer location, + # and propagate that choice to both fields. If only one field (`location` or ` + # nodeConfig.machineType`) is specified, the location information from the + # specified field will be propagated to the unspecified field. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. The Compute Engine - # [machine type](/compute/docs/machine-types) used for cluster instances, - # specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/zones/`zoneId`/machineTypes/`machineTypeId`". - # The `machineType` must belong to the enclosing environment's project and - # location. If both this field and `nodeConfig.location` are specified, - # this `machineType` must belong to the `nodeConfig.location`; if both are - # unspecified, the service will pick a zone in the Compute Engine region - # corresponding to the Cloud Composer location, and propagate that choice to - # both fields. If exactly one of this field and `nodeConfig.location` is - # specified, the location information from the specified field will be - # propagated to the unspecified field. - # The `machineTypeId` must not be a [shared-core machine - # type](/compute/docs/machine-types#sharedcore). - # If this field is unspecified, the `machineTypeId` defaults - # to "n1-standard-1". + # Optional. The Compute Engine [machine type](/compute/docs/machine-types) used + # for cluster instances, specified as a [relative resource name](/apis/design/ + # resource_names#relative_resource_name). For example: "projects/`projectId`/ + # zones/`zoneId`/machineTypes/`machineTypeId`". The `machineType` must belong to + # the enclosing environment's project and location. If both this field and ` + # nodeConfig.location` are specified, this `machineType` must belong to the ` + # nodeConfig.location`; if both are unspecified, the service will pick a zone in + # the Compute Engine region corresponding to the Cloud Composer location, and + # propagate that choice to both fields. If exactly one of this field and ` + # nodeConfig.location` is specified, the location information from the specified + # field will be propagated to the unspecified field. The `machineTypeId` must + # not be a [shared-core machine type](/compute/docs/machine-types#sharedcore). + # If this field is unspecified, the `machineTypeId` defaults to "n1-standard-1". # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type - # Optional. The Compute Engine network to be used for machine - # communications, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/global/networks/`networkId`". - # If unspecified, the default network in the environment's project is used. - # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets) - # is provided, `nodeConfig.subnetwork` must also be provided. For - # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see - # `nodeConfig.subnetwork`. + # Optional. The Compute Engine network to be used for machine communications, + # specified as a [relative resource name](/apis/design/resource_names# + # relative_resource_name). For example: "projects/`projectId`/global/networks/` + # networkId`". If unspecified, the default network in the environment's project + # is used. If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets) + # is provided, `nodeConfig.subnetwork` must also be provided. For [Shared VPC](/ + # vpc/docs/shared-vpc) subnetwork requirements, see `nodeConfig.subnetwork`. # Corresponds to the JSON property `network` # @return [String] attr_accessor :network - # Optional. The set of Google API scopes to be made available on all - # node VMs. If `oauth_scopes` is empty, defaults to - # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated. + # Optional. The set of Google API scopes to be made available on all node VMs. + # If `oauth_scopes` is empty, defaults to ["https://www.googleapis.com/auth/ + # cloud-platform"]. Cannot be updated. # Corresponds to the JSON property `oauthScopes` # @return [Array] attr_accessor :oauth_scopes - # Optional. The Google Cloud Platform Service Account to be used by the node - # VMs. If a service account is not specified, the "default" Compute Engine - # service account is used. Cannot be updated. + # Optional. The Google Cloud Platform Service Account to be used by the node VMs. + # If a service account is not specified, the "default" Compute Engine service + # account is used. Cannot be updated. # Corresponds to the JSON property `serviceAccount` # @return [String] attr_accessor :service_account - # Optional. The Compute Engine subnetwork to be used for machine - # communications, specified as a - # [relative resource - # name](/apis/design/resource_names#relative_resource_name). For example: - # "projects/`projectId`/regions/`regionId`/subnetworks/`subnetworkId`" - # If a subnetwork is provided, `nodeConfig.network` must also be provided, - # and the subnetwork must belong to the enclosing environment's project and - # location. + # Optional. The Compute Engine subnetwork to be used for machine communications, + # specified as a [relative resource name](/apis/design/resource_names# + # relative_resource_name). For example: "projects/`projectId`/regions/`regionId`/ + # subnetworks/`subnetworkId`" If a subnetwork is provided, `nodeConfig.network` + # must also be provided, and the subnetwork must belong to the enclosing + # environment's project and location. # Corresponds to the JSON property `subnetwork` # @return [String] attr_accessor :subnetwork - # Optional. The list of instance tags applied to all node VMs. Tags are used - # to identify valid sources or targets for network firewalls. Each tag within - # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). - # Cannot be updated. + # Optional. The list of instance tags applied to all node VMs. Tags are used to + # identify valid sources or targets for network firewalls. Each tag within the + # list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt). Cannot + # be updated. # Corresponds to the JSON property `tags` # @return [Array] attr_accessor :tags @@ -556,47 +523,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # If the value is `false`, it means the operation is still in progress. - # If `true`, the operation is completed, and either `error` or `response` is - # available. + # If the value is `false`, it means the operation is still in progress. If `true` + # , the operation is completed, and either `error` or `response` is available. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::ComposerV1beta1::Status] attr_accessor :error - # Service-specific metadata associated with the operation. It typically - # contains progress information and common metadata such as create time. - # Some services might not provide such metadata. Any method that returns a - # long-running operation should document the metadata type, if any. + # Service-specific metadata associated with the operation. It typically contains + # progress information and common metadata such as create time. Some services + # might not provide such metadata. Any method that returns a long-running + # operation should document the metadata type, if any. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # The server-assigned name, which is only unique within the same service that - # originally returns it. If you use the default HTTP mapping, the - # `name` should be a resource name ending with `operations/`unique_id``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. If the original - # method returns no data on success, such as `Delete`, the response is - # `google.protobuf.Empty`. If the original method is standard - # `Get`/`Create`/`Update`, the response should be the resource. For other - # methods, the response should have the type `XxxResponse`, where `Xxx` - # is the original method name. For example, if the original method name - # is `TakeSnapshot()`, the inferred response type is - # `TakeSnapshotResponse`. + # The normal response of the operation in case of success. If the original + # method returns no data on success, such as `Delete`, the response is `google. + # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, + # the response should be the resource. For other methods, the response should + # have the type `XxxResponse`, where `Xxx` is the original method name. For + # example, if the original method name is `TakeSnapshot()`, the inferred + # response type is `TakeSnapshotResponse`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -635,8 +600,8 @@ module Google # @return [String] attr_accessor :operation_type - # Output only. The resource being operated on, as a [relative resource name]( - # /apis/design/resource_names#relative_resource_name). + # Output only. The resource being operated on, as a [relative resource name]( / + # apis/design/resource_names#relative_resource_name). # Corresponds to the JSON property `resource` # @return [String] attr_accessor :resource @@ -679,18 +644,16 @@ module Google alias_method :enable_private_endpoint?, :enable_private_endpoint # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. - # If - # left blank, the default value of '172.16.0.0/23' is used. + # If left blank, the default value of '172.16.0.0/23' is used. # Corresponds to the JSON property `masterIpv4CidrBlock` # @return [String] attr_accessor :master_ipv4_cidr_block # Output only. The IP range in CIDR notation to use for the hosted master - # network. This - # range is used for assigning internal IP addresses to the cluster - # master or set of masters and to the internal load balancer virtual IP. - # This range must not overlap with any other ranges in use - # within the cluster's network. + # network. This range is used for assigning internal IP addresses to the cluster + # master or set of masters and to the internal load balancer virtual IP. This + # range must not overlap with any other ranges in use within the cluster's + # network. # Corresponds to the JSON property `masterIpv4ReservedRange` # @return [String] attr_accessor :master_ipv4_reserved_range @@ -713,14 +676,13 @@ module Google include Google::Apis::Core::Hashable # Optional. The CIDR block from which IP range in tenant project will be - # reserved for - # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block + # reserved for Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block # Corresponds to the JSON property `cloudSqlIpv4CidrBlock` # @return [String] attr_accessor :cloud_sql_ipv4_cidr_block - # Optional. If `true`, a Private IP Cloud Composer environment is created. - # If this field is true, `use_ip_aliases` must be true. + # Optional. If `true`, a Private IP Cloud Composer environment is created. If + # this field is true, `use_ip_aliases` must be true. # Corresponds to the JSON property `enablePrivateEnvironment` # @return [Boolean] attr_accessor :enable_private_environment @@ -733,8 +695,7 @@ module Google attr_accessor :private_cluster_config # Optional. The CIDR block from which IP range for web server will be reserved. - # Needs - # to be disjoint from private_cluster_config.master_ipv4_cidr_block and + # Needs to be disjoint from private_cluster_config.master_ipv4_cidr_block and # cloud_sql_ipv4_cidr_block. # Corresponds to the JSON property `webServerIpv4CidrBlock` # @return [String] @@ -763,84 +724,65 @@ module Google class SoftwareConfig include Google::Apis::Core::Hashable - # Optional. Apache Airflow configuration properties to override. - # Property keys contain the section and property names, separated by a - # hyphen, for example "core-dags_are_paused_at_creation". Section names must - # not contain hyphens ("-"), opening square brackets ("["), or closing - # square brackets ("]"). The property name must not be empty and must not - # contain an equals sign ("=") or semicolon (";"). Section and property names - # must not contain a period ("."). Apache Airflow configuration property - # names must be written in - # [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can - # contain any character, and can be written in any lower/upper case format. - # Certain Apache Airflow configuration property values are - # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations# - # airflow_configuration_blacklists), - # and cannot be overridden. + # Optional. Apache Airflow configuration properties to override. Property keys + # contain the section and property names, separated by a hyphen, for example " + # core-dags_are_paused_at_creation". Section names must not contain hyphens ("-") + # , opening square brackets ("["), or closing square brackets ("]"). The + # property name must not be empty and must not contain an equals sign ("=") or + # semicolon (";"). Section and property names must not contain a period ("."). + # Apache Airflow configuration property names must be written in [snake_case]( + # https://en.wikipedia.org/wiki/Snake_case). Property values can contain any + # character, and can be written in any lower/upper case format. Certain Apache + # Airflow configuration property values are [blacklisted](/composer/docs/how-to/ + # managing/setting-airflow-configurations#airflow_configuration_blacklists), and + # cannot be overridden. # Corresponds to the JSON property `airflowConfigOverrides` # @return [Hash] attr_accessor :airflow_config_overrides # Optional. Additional environment variables to provide to the Apache Airflow - # scheduler, worker, and webserver processes. - # Environment variable names must match the regular expression - # `a-zA-Z_*`. They cannot specify Apache Airflow - # software configuration overrides (they cannot match the regular expression - # `AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+`), and they cannot match any of the - # following reserved names: - # * `AIRFLOW_HOME` - # * `C_FORCE_ROOT` - # * `CONTAINER_NAME` - # * `DAGS_FOLDER` - # * `GCP_PROJECT` - # * `GCS_BUCKET` - # * `GKE_CLUSTER_NAME` - # * `SQL_DATABASE` - # * `SQL_INSTANCE` - # * `SQL_PASSWORD` - # * `SQL_PROJECT` - # * `SQL_REGION` + # scheduler, worker, and webserver processes. Environment variable names must + # match the regular expression `a-zA-Z_*`. They cannot specify Apache Airflow + # software configuration overrides (they cannot match the regular expression ` + # AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+`), and they cannot match any of the following + # reserved names: * `AIRFLOW_HOME` * `C_FORCE_ROOT` * `CONTAINER_NAME` * ` + # DAGS_FOLDER` * `GCP_PROJECT` * `GCS_BUCKET` * `GKE_CLUSTER_NAME` * ` + # SQL_DATABASE` * `SQL_INSTANCE` * `SQL_PASSWORD` * `SQL_PROJECT` * `SQL_REGION` # * `SQL_USER` # Corresponds to the JSON property `envVariables` # @return [Hash] attr_accessor :env_variables - # The version of the software running in the environment. - # This encapsulates both the version of Cloud Composer functionality and the - # version of Apache Airflow. It must match the regular expression - # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. - # When used as input, the server also checks if the provided version is - # supported and denies the request for an unsupported version. - # The Cloud Composer portion of the version is a - # [semantic version](https://semver.org) or `latest`. When the patch version - # is omitted, the current Cloud Composer patch version is selected. - # When `latest` is provided instead of an explicit version number, - # the server replaces `latest` with the current Cloud Composer version - # and stores that version number in the same field. - # The portion of the image version that follows airflow- is an - # official Apache Airflow repository - # [release name](https://github.com/apache/incubator-airflow/releases). - # See also [Version - # List](/composer/docs/concepts/versioning/composer-versions). + # The version of the software running in the environment. This encapsulates both + # the version of Cloud Composer functionality and the version of Apache Airflow. + # It must match the regular expression `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)- + # airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`. When used as input, the server also + # checks if the provided version is supported and denies the request for an + # unsupported version. The Cloud Composer portion of the version is a [semantic + # version](https://semver.org) or `latest`. When the patch version is omitted, + # the current Cloud Composer patch version is selected. When `latest` is + # provided instead of an explicit version number, the server replaces `latest` + # with the current Cloud Composer version and stores that version number in the + # same field. The portion of the image version that follows *airflow-* is an + # official Apache Airflow repository [release name](https://github.com/apache/ + # incubator-airflow/releases). See also [Version List](/composer/docs/concepts/ + # versioning/composer-versions). # Corresponds to the JSON property `imageVersion` # @return [String] attr_accessor :image_version - # Optional. Custom Python Package Index (PyPI) packages to be installed in - # the environment. - # Keys refer to the lowercase package name such as "numpy" - # and values are the lowercase extras and version specifier such as - # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a - # package without pinning it to a version specifier, use the empty string as - # the value. + # Optional. Custom Python Package Index (PyPI) packages to be installed in the + # environment. Keys refer to the lowercase package name such as "numpy" and + # values are the lowercase extras and version specifier such as "==1.12.0", "[ + # devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without + # pinning it to a version specifier, use the empty string as the value. # Corresponds to the JSON property `pypiPackages` # @return [Hash] attr_accessor :pypi_packages - # Optional. The major version of Python used to run the Apache Airflow - # scheduler, worker, and webserver processes. - # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be - # updated. + # Optional. The major version of Python used to run the Apache Airflow scheduler, + # worker, and webserver processes. Can be set to '2' or '3'. If not specified, + # the default is '2'. Cannot be updated. # Corresponds to the JSON property `pythonVersion` # @return [String] attr_accessor :python_version @@ -859,12 +801,12 @@ module Google end end - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable @@ -873,15 +815,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # A developer-facing error message, which should be in English. Any - # user-facing error message should be localized and sent in the - # google.rpc.Status.details field, or localized by the client. + # A developer-facing error message, which should be in English. Any user-facing + # error message should be localized and sent in the google.rpc.Status.details + # field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message @@ -902,12 +844,11 @@ module Google class WebServerConfig include Google::Apis::Core::Hashable - # Optional. Machine type on which Airflow web server is running. - # It has to be one of: composer-n1-webserver-2, composer-n1-webserver-4 or - # composer-n1-webserver-8. - # If not specified, composer-n1-webserver-2 will be used. - # Value custom is returned only in response, if Airflow web server parameters - # were manually changed to a non-standard values. + # Optional. Machine type on which Airflow web server is running. It has to be + # one of: composer-n1-webserver-2, composer-n1-webserver-4 or composer-n1- + # webserver-8. If not specified, composer-n1-webserver-2 will be used. Value + # custom is returned only in response, if Airflow web server parameters were + # manually changed to a non-standard values. # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type diff --git a/generated/google/apis/composer_v1beta1/service.rb b/generated/google/apis/composer_v1beta1/service.rb index a1af07df2..599d23b59 100644 --- a/generated/google/apis/composer_v1beta1/service.rb +++ b/generated/google/apis/composer_v1beta1/service.rb @@ -49,8 +49,7 @@ module Google # Create a new environment. # @param [String] parent - # The parent must be of the form - # "projects/`projectId`/locations/`locationId`". + # The parent must be of the form "projects/`projectId`/locations/`locationId`". # @param [Google::Apis::ComposerV1beta1::Environment] environment_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -83,8 +82,8 @@ module Google # Delete an environment. # @param [String] name - # The environment to delete, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The environment to delete, in the form: "projects/`projectId`/locations/` + # locationId`/environments/`environmentId`" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -114,8 +113,8 @@ module Google # Get an existing environment. # @param [String] name - # The resource name of the environment to get, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The resource name of the environment to get, in the form: "projects/`projectId` + # /locations/`locationId`/environments/`environmentId`" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -145,8 +144,8 @@ module Google # List environments. # @param [String] parent - # List environments in the given project and location, in the form: - # "projects/`projectId`/locations/`locationId`" + # List environments in the given project and location, in the form: "projects/` + # projectId`/locations/`locationId`" # @param [Fixnum] page_size # The maximum number of environments to return. # @param [String] page_token @@ -182,162 +181,78 @@ module Google # Update an environment. # @param [String] name - # The relative resource name of the environment to update, in the form: - # "projects/`projectId`/locations/`locationId`/environments/`environmentId`" + # The relative resource name of the environment to update, in the form: " + # projects/`projectId`/locations/`locationId`/environments/`environmentId`" # @param [Google::Apis::ComposerV1beta1::Environment] environment_object # @param [String] update_mask # Required. A comma-separated list of paths, relative to `Environment`, of - # fields to update. - # For example, to set the version of scikit-learn to install in the - # environment to 0.19.0 and to remove an existing installation of - # argparse, the `updateMask` parameter would include the following two - # `paths` values: "config.softwareConfig.pypiPackages.scikit-learn" and - # "config.softwareConfig.pypiPackages.argparse". The included patch - # environment would specify the scikit-learn version as follows: - # ` - # "config":` - # "softwareConfig":` - # "pypiPackages":` - # "scikit-learn":"==0.19.0" - # ` - # ` - # ` - # ` - # Note that in the above example, any existing PyPI packages - # other than scikit-learn and argparse will be unaffected. - # Only one update type may be included in a single request's `updateMask`. - # For example, one cannot update both the PyPI packages and - # labels in the same request. However, it is possible to update multiple - # members of a map field simultaneously in the same request. For example, - # to set the labels "label1" and "label2" while clearing "label3" (assuming - # it already exists), one can - # provide the paths "labels.label1", "labels.label2", and "labels.label3" - # and populate the patch environment as follows: - # ` - # "labels":` - # "label1":"new-label1-value" - # "label2":"new-label2-value" - # ` - # ` - # Note that in the above example, any existing labels that are not - # included in the `updateMask` will be unaffected. - # It is also possible to replace an entire map field by providing the - # map field's path in the `updateMask`. The new value of the field will - # be that which is provided in the patch environment. For example, to - # delete all pre-existing user-specified PyPI packages and - # install botocore at version 1.7.14, the `updateMask` would contain - # the path "config.softwareConfig.pypiPackages", and - # the patch environment would be the following: - # ` - # "config":` - # "softwareConfig":` - # "pypiPackages":` - # "botocore":"==1.7.14" - # ` - # ` - # ` - # ` - # Note: Only the following fields can be updated: - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - # - #
MaskPurpose
config.softwareConfig.pypiPackages - # Replace all custom custom PyPI packages. If a replacement - # package map is not included in `environment`, all custom - # PyPI packages are cleared. It is an error to provide both this mask and a - # mask specifying an individual package.
config.softwareConfig.pypiPackages.packagenameUpdate the custom PyPI package packagename, - # preserving other packages. To delete the package, include it in - # `updateMask`, and omit the mapping for it in - # `environment.config.softwareConfig.pypiPackages`. It is an error - # to provide both a mask of this form and the - # "config.softwareConfig.pypiPackages" mask.
labelsReplace all environment labels. If a replacement labels map is not - # included in `environment`, all labels are cleared. It is an error to - # provide both this mask and a mask specifying one or more individual - # labels.
labels.labelNameSet the label named labelName, while preserving other - # labels. To delete the label, include it in `updateMask` and omit its - # mapping in `environment.labels`. It is an error to provide both a - # mask of this form and the "labels" mask.
config.nodeCountHorizontally scale the number of nodes in the environment. An integer - # greater than or equal to 3 must be provided in the `config.nodeCount` - # field. - #
config.webServerNetworkAccessControlReplace the environment's current WebServerNetworkAccessControl. - #
config.softwareConfig.airflowConfigOverridesReplace all Apache Airflow config overrides. If a replacement config - # overrides map is not included in `environment`, all config overrides - # are cleared. - # It is an error to provide both this mask and a mask specifying one or - # more individual config overrides.
config.softwareConfig.airflowConfigOverrides.section-name - # Override the Apache Airflow config property name in the - # section named section, preserving other properties. To delete - # the property override, include it in `updateMask` and omit its mapping - # in `environment.config.softwareConfig.airflowConfigOverrides`. - # It is an error to provide both a mask of this form and the - # "config.softwareConfig.airflowConfigOverrides" mask.
config.softwareConfig.envVariablesReplace all environment variables. If a replacement environment - # variable map is not included in `environment`, all custom environment - # variables are cleared. - # It is an error to provide both this mask and a mask specifying one or - # more individual environment variables.
config.softwareConfig.imageVersionUpgrade the version of the environment in-place. Refer to - # `SoftwareConfig.image_version` for information on how to format the new - # image version. Additionally, the new image version cannot effect a version - # downgrade and must match the current image version's Composer major - # version and Airflow major and minor versions. Consult the - # Cloud - # Composer Version List for valid values.
config.databaseConfig.machineTypeCloud SQL machine type used by Airflow database. - # It has to be one of: db-n1-standard-2, db-n1-standard-4, db-n1-standard-8 - # or db-n1-standard-16.
config.webServerConfig.machineTypeMachine type on which Airflow web server is running. - # It has to be one of: composer-n1-webserver-2, composer-n1-webserver-4 or - # composer-n1-webserver-8. - #
+ # fields to update. For example, to set the version of scikit-learn to install + # in the environment to 0.19.0 and to remove an existing installation of + # argparse, the `updateMask` parameter would include the following two `paths` + # values: "config.softwareConfig.pypiPackages.scikit-learn" and "config. + # softwareConfig.pypiPackages.argparse". The included patch environment would + # specify the scikit-learn version as follows: ` "config":` "softwareConfig":` " + # pypiPackages":` "scikit-learn":"==0.19.0" ` ` ` ` Note that in the above + # example, any existing PyPI packages other than scikit-learn and argparse will + # be unaffected. Only one update type may be included in a single request's ` + # updateMask`. For example, one cannot update both the PyPI packages and labels + # in the same request. However, it is possible to update multiple members of a + # map field simultaneously in the same request. For example, to set the labels " + # label1" and "label2" while clearing "label3" (assuming it already exists), one + # can provide the paths "labels.label1", "labels.label2", and "labels.label3" + # and populate the patch environment as follows: ` "labels":` "label1":"new- + # label1-value" "label2":"new-label2-value" ` ` Note that in the above example, + # any existing labels that are not included in the `updateMask` will be + # unaffected. It is also possible to replace an entire map field by providing + # the map field's path in the `updateMask`. The new value of the field will be + # that which is provided in the patch environment. For example, to delete all + # pre-existing user-specified PyPI packages and install botocore at version 1.7. + # 14, the `updateMask` would contain the path "config.softwareConfig. + # pypiPackages", and the patch environment would be the following: ` "config":` " + # softwareConfig":` "pypiPackages":` "botocore":"==1.7.14" ` ` ` ` *Note:* Only + # the following fields can be updated: *Mask* *Purpose* config.softwareConfig. + # pypiPackages Replace all custom custom PyPI packages. If a replacement package + # map is not included in `environment`, all custom PyPI packages are cleared. It + # is an error to provide both this mask and a mask specifying an individual + # package. config.softwareConfig.pypiPackages.packagename Update the custom PyPI + # package packagename, preserving other packages. To delete the package, include + # it in `updateMask`, and omit the mapping for it in `environment.config. + # softwareConfig.pypiPackages`. It is an error to provide both a mask of this + # form and the "config.softwareConfig.pypiPackages" mask. labels Replace all + # environment labels. If a replacement labels map is not included in ` + # environment`, all labels are cleared. It is an error to provide both this mask + # and a mask specifying one or more individual labels. labels.labelName Set the + # label named labelName, while preserving other labels. To delete the label, + # include it in `updateMask` and omit its mapping in `environment.labels`. It is + # an error to provide both a mask of this form and the "labels" mask. config. + # nodeCount Horizontally scale the number of nodes in the environment. An + # integer greater than or equal to 3 must be provided in the `config.nodeCount` + # field. config.webServerNetworkAccessControl Replace the environment's current + # WebServerNetworkAccessControl. config.softwareConfig.airflowConfigOverrides + # Replace all Apache Airflow config overrides. If a replacement config overrides + # map is not included in `environment`, all config overrides are cleared. It is + # an error to provide both this mask and a mask specifying one or more + # individual config overrides. config.softwareConfig.airflowConfigOverrides. + # section-name Override the Apache Airflow config property name in the section + # named section, preserving other properties. To delete the property override, + # include it in `updateMask` and omit its mapping in `environment.config. + # softwareConfig.airflowConfigOverrides`. It is an error to provide both a mask + # of this form and the "config.softwareConfig.airflowConfigOverrides" mask. + # config.softwareConfig.envVariables Replace all environment variables. If a + # replacement environment variable map is not included in `environment`, all + # custom environment variables are cleared. It is an error to provide both this + # mask and a mask specifying one or more individual environment variables. + # config.softwareConfig.imageVersion Upgrade the version of the environment in- + # place. Refer to `SoftwareConfig.image_version` for information on how to + # format the new image version. Additionally, the new image version cannot + # effect a version downgrade and must match the current image version's Composer + # major version and Airflow major and minor versions. Consult the Cloud Composer + # Version List for valid values. config.databaseConfig.machineType Cloud SQL + # machine type used by Airflow database. It has to be one of: db-n1-standard-2, + # db-n1-standard-4, db-n1-standard-8 or db-n1-standard-16. config. + # webServerConfig.machineType Machine type on which Airflow web server is + # running. It has to be one of: composer-n1-webserver-2, composer-n1-webserver-4 + # or composer-n1-webserver-8. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -370,8 +285,8 @@ module Google # List ImageVersions for provided location. # @param [String] parent - # List ImageVersions in the given project and location, in the form: - # "projects/`projectId`/locations/`locationId`" + # List ImageVersions in the given project and location, in the form: "projects/` + # projectId`/locations/`locationId`" # @param [Fixnum] page_size # The maximum number of image_versions to return. # @param [String] page_token @@ -405,10 +320,10 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a long-running operation. This method indicates that the client is - # no longer interested in the operation result. It does not cancel the - # operation. If the server doesn't support this method, it returns - # `google.rpc.Code.UNIMPLEMENTED`. + # Deletes a long-running operation. This method indicates that the client is no + # longer interested in the operation result. It does not cancel the operation. + # If the server doesn't support this method, it returns `google.rpc.Code. + # UNIMPLEMENTED`. # @param [String] name # The name of the operation resource to be deleted. # @param [String] fields @@ -438,9 +353,8 @@ module Google execute_or_queue_command(command, &block) end - # Gets the latest state of a long-running operation. Clients can use this - # method to poll the operation result at intervals as recommended by the API - # service. + # Gets the latest state of a long-running operation. Clients can use this method + # to poll the operation result at intervals as recommended by the API service. # @param [String] name # The name of the operation resource. # @param [String] fields @@ -470,15 +384,14 @@ module Google execute_or_queue_command(command, &block) end - # Lists operations that match the specified filter in the request. If the - # server doesn't support this method, it returns `UNIMPLEMENTED`. - # NOTE: the `name` binding allows API services to override the binding - # to use different resource name schemes, such as `users/*/operations`. To - # override the binding, API services can add a binding such as - # `"/v1/`name=users/*`/operations"` to their service configuration. - # For backwards compatibility, the default name includes the operations - # collection id, however overriding users must ensure the name binding - # is the parent resource, without the operations collection id. + # Lists operations that match the specified filter in the request. If the server + # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` + # binding allows API services to override the binding to use different resource + # name schemes, such as `users/*/operations`. To override the binding, API + # services can add a binding such as `"/v1/`name=users/*`/operations"` to their + # service configuration. For backwards compatibility, the default name includes + # the operations collection id, however overriding users must ensure the name + # binding is the parent resource, without the operations collection id. # @param [String] name # The name of the operation's parent resource. # @param [String] filter diff --git a/generated/google/apis/file_v1.rb b/generated/google/apis/file_v1.rb index 751facb1c..ddeb2aafb 100644 --- a/generated/google/apis/file_v1.rb +++ b/generated/google/apis/file_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/filestore/ module FileV1 VERSION = 'V1' - REVISION = '20200806' + REVISION = '20200819' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/file_v1beta1.rb b/generated/google/apis/file_v1beta1.rb index a32d4c0af..96d56d9eb 100644 --- a/generated/google/apis/file_v1beta1.rb +++ b/generated/google/apis/file_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/filestore/ module FileV1beta1 VERSION = 'V1beta1' - REVISION = '20200806' + REVISION = '20200819' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/file_v1beta1/classes.rb b/generated/google/apis/file_v1beta1/classes.rb index 9134d8abc..0abf87d83 100644 --- a/generated/google/apis/file_v1beta1/classes.rb +++ b/generated/google/apis/file_v1beta1/classes.rb @@ -22,6 +22,93 @@ module Google module Apis module FileV1beta1 + # A Cloud Filestore backup. + class Backup + include Google::Apis::Core::Hashable + + # Output only. Capacity of the backup. This would be the size of the file share + # when the backup is restored. + # Corresponds to the JSON property `capacityGb` + # @return [Fixnum] + attr_accessor :capacity_gb + + # Output only. The time when the backup was created. + # Corresponds to the JSON property `createTime` + # @return [String] + attr_accessor :create_time + + # A description of the backup with 2048 characters or less. Requests with longer + # descriptions will be rejected. + # Corresponds to the JSON property `description` + # @return [String] + attr_accessor :description + + # Output only. Amount of bytes that will be downloaded if the backup is restored + # Corresponds to the JSON property `downloadBytes` + # @return [Fixnum] + attr_accessor :download_bytes + + # Resource labels to represent user provided metadata. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + + # Output only. The resource name of the backup, in the format projects/` + # project_id`/locations/`location_id`/backups/`backup_id`. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # Name of the file share in the source Cloud Filestore instance that the backup + # is created from. + # Corresponds to the JSON property `sourceFileShare` + # @return [String] + attr_accessor :source_file_share + + # The resource name of the source Cloud Filestore instance, in the format + # projects/`project_id`/locations/`location_id`/instances/`instance_id`, used to + # create this backup. + # Corresponds to the JSON property `sourceInstance` + # @return [String] + attr_accessor :source_instance + + # Output only. The service tier of the source Cloud Filestore instance that this + # backup is created from. + # Corresponds to the JSON property `sourceInstanceTier` + # @return [String] + attr_accessor :source_instance_tier + + # Output only. The backup state. + # Corresponds to the JSON property `state` + # @return [String] + attr_accessor :state + + # Output only. The size of the storage used by the backup. As backups share + # storage, this number is expected to change with backup creation/deletion. + # Corresponds to the JSON property `storageBytes` + # @return [Fixnum] + attr_accessor :storage_bytes + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @capacity_gb = args[:capacity_gb] if args.key?(:capacity_gb) + @create_time = args[:create_time] if args.key?(:create_time) + @description = args[:description] if args.key?(:description) + @download_bytes = args[:download_bytes] if args.key?(:download_bytes) + @labels = args[:labels] if args.key?(:labels) + @name = args[:name] if args.key?(:name) + @source_file_share = args[:source_file_share] if args.key?(:source_file_share) + @source_instance = args[:source_instance] if args.key?(:source_instance) + @source_instance_tier = args[:source_instance_tier] if args.key?(:source_instance_tier) + @state = args[:state] if args.key?(:state) + @storage_bytes = args[:storage_bytes] if args.key?(:storage_bytes) + end + end + # The request message for Operations.CancelOperation. class CancelOperationRequest include Google::Apis::Core::Hashable @@ -72,6 +159,12 @@ module Google # @return [Array] attr_accessor :nfs_export_options + # The resource name of the backup, in the format projects/`project_id`/locations/ + # `location_id`/backups/`backup_id`, that this file share has been restored from. + # Corresponds to the JSON property `sourceBackup` + # @return [String] + attr_accessor :source_backup + def initialize(**args) update!(**args) end @@ -81,6 +174,7 @@ module Google @capacity_gb = args[:capacity_gb] if args.key?(:capacity_gb) @name = args[:name] if args.key?(:name) @nfs_export_options = args[:nfs_export_options] if args.key?(:nfs_export_options) + @source_backup = args[:source_backup] if args.key?(:source_backup) end end @@ -547,6 +641,42 @@ module Google end end + # ListBackupsResponse is the result of ListBackupsRequest. + class ListBackupsResponse + include Google::Apis::Core::Hashable + + # A list of backups in the project for the specified location. If the `location` + # value in the request is "-", the response contains a list of backups from all + # locations. If any location is unreachable, the response will only return + # backups in reachable locations and the "unreachable" field will be populated + # with a list of unreachable locations. + # Corresponds to the JSON property `backups` + # @return [Array] + attr_accessor :backups + + # The token you can use to retrieve the next page of results. Not returned if + # there are no more results in the list. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + # Locations that could not be reached. + # Corresponds to the JSON property `unreachable` + # @return [Array] + attr_accessor :unreachable + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @backups = args[:backups] if args.key?(:backups) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + @unreachable = args[:unreachable] if args.key?(:unreachable) + end + end + # ListInstancesResponse is the result of ListInstancesRequest. class ListInstancesResponse include Google::Apis::Core::Hashable @@ -902,6 +1032,41 @@ module Google end end + # RestoreInstanceRequest restores an existing instances's file share from a + # snapshot or backup. + class RestoreInstanceRequest + include Google::Apis::Core::Hashable + + # Required. Name of the file share in the Cloud Filestore instance that the + # snapshot is being restored to. + # Corresponds to the JSON property `fileShare` + # @return [String] + attr_accessor :file_share + + # The resource name of the backup, in the format projects/`project_id`/locations/ + # `location_id`/backups/`backup_id`. + # Corresponds to the JSON property `sourceBackup` + # @return [String] + attr_accessor :source_backup + + # The resource name of the snapshot, in the format projects/`project_id`/ + # locations/`location_id`/snapshots/`snapshot_id`. + # Corresponds to the JSON property `sourceSnapshot` + # @return [String] + attr_accessor :source_snapshot + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @file_share = args[:file_share] if args.key?(:file_share) + @source_backup = args[:source_backup] if args.key?(:source_backup) + @source_snapshot = args[:source_snapshot] if args.key?(:source_snapshot) + end + end + # The `Status` type defines a logical error model that is suitable for different # programming environments, including REST APIs and RPC APIs. It is used by [ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of diff --git a/generated/google/apis/file_v1beta1/representations.rb b/generated/google/apis/file_v1beta1/representations.rb index 4c603aca3..2968ea6df 100644 --- a/generated/google/apis/file_v1beta1/representations.rb +++ b/generated/google/apis/file_v1beta1/representations.rb @@ -22,6 +22,12 @@ module Google module Apis module FileV1beta1 + class Backup + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class CancelOperationRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -94,6 +100,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class ListBackupsResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ListInstancesResponse class Representation < Google::Apis::Core::JsonRepresentation; end @@ -142,12 +154,35 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class RestoreInstanceRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class Status class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class Backup + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :capacity_gb, :numeric_string => true, as: 'capacityGb' + property :create_time, as: 'createTime' + property :description, as: 'description' + property :download_bytes, :numeric_string => true, as: 'downloadBytes' + hash :labels, as: 'labels' + property :name, as: 'name' + property :source_file_share, as: 'sourceFileShare' + property :source_instance, as: 'sourceInstance' + property :source_instance_tier, as: 'sourceInstanceTier' + property :state, as: 'state' + property :storage_bytes, :numeric_string => true, as: 'storageBytes' + end + end + class CancelOperationRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -167,6 +202,7 @@ module Google property :name, as: 'name' collection :nfs_export_options, as: 'nfsExportOptions', class: Google::Apis::FileV1beta1::NfsExportOptions, decorator: Google::Apis::FileV1beta1::NfsExportOptions::Representation + property :source_backup, as: 'sourceBackup' end end @@ -279,6 +315,16 @@ module Google end end + class ListBackupsResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :backups, as: 'backups', class: Google::Apis::FileV1beta1::Backup, decorator: Google::Apis::FileV1beta1::Backup::Representation + + property :next_page_token, as: 'nextPageToken' + collection :unreachable, as: 'unreachable' + end + end + class ListInstancesResponse # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -364,6 +410,15 @@ module Google end end + class RestoreInstanceRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :file_share, as: 'fileShare' + property :source_backup, as: 'sourceBackup' + property :source_snapshot, as: 'sourceSnapshot' + end + end + class Status # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/file_v1beta1/service.rb b/generated/google/apis/file_v1beta1/service.rb index 227612bbb..e3e19b29a 100644 --- a/generated/google/apis/file_v1beta1/service.rb +++ b/generated/google/apis/file_v1beta1/service.rb @@ -119,6 +119,194 @@ module Google execute_or_queue_command(command, &block) end + # Creates a backup. + # @param [String] parent + # Required. The backup's project and location, in the format projects/` + # project_id`/locations/`location`. In Cloud Filestore, backup locations map to + # GCP regions, for example **us-west1**. + # @param [Google::Apis::FileV1beta1::Backup] backup_object + # @param [String] backup_id + # Required. The ID to use for the backup. The ID must be unique within the + # specified project and location. This value must start with a lowercase letter + # followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end + # with a hyphen. + # @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::FileV1beta1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::Operation] + # + # @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_project_location_backup(parent, backup_object = nil, backup_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1beta1/{+parent}/backups', options) + command.request_representation = Google::Apis::FileV1beta1::Backup::Representation + command.request_object = backup_object + command.response_representation = Google::Apis::FileV1beta1::Operation::Representation + command.response_class = Google::Apis::FileV1beta1::Operation + command.params['parent'] = parent unless parent.nil? + command.query['backupId'] = backup_id unless backup_id.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 backup. + # @param [String] name + # Required. The backup resource name, in the format projects/`project_id`/ + # locations/`location`/backups/`backup_id` + # @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::FileV1beta1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::Operation] + # + # @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_project_location_backup(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v1beta1/{+name}', options) + command.response_representation = Google::Apis::FileV1beta1::Operation::Representation + command.response_class = Google::Apis::FileV1beta1::Operation + 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 the details of a specific backup. + # @param [String] name + # Required. The backup resource name, in the format projects/`project_id`/ + # locations/`location`/backups/`backup_id`. + # @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::FileV1beta1::Backup] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::Backup] + # + # @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_project_location_backup(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1beta1/{+name}', options) + command.response_representation = Google::Apis::FileV1beta1::Backup::Representation + command.response_class = Google::Apis::FileV1beta1::Backup + 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 all backups in a project for either a specified location or for all + # locations. + # @param [String] parent + # Required. The project and location for which to retrieve backup information, + # in the format projects/`project_id`/locations/`location`. In Cloud Filestore, + # backup locations map to GCP regions, for example **us-west1**. To retrieve + # backup information for all locations, use "-" for the `location` value. + # @param [String] filter + # List filter. + # @param [String] order_by + # Sort results. Supported values are "name", "name desc" or "" (unsorted). + # @param [Fixnum] page_size + # The maximum number of items to return. + # @param [String] page_token + # The next_page_token value to use if there are additional results to retrieve + # for this list request. + # @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::FileV1beta1::ListBackupsResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::ListBackupsResponse] + # + # @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_project_location_backups(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1beta1/{+parent}/backups', options) + command.response_representation = Google::Apis::FileV1beta1::ListBackupsResponse::Representation + command.response_class = Google::Apis::FileV1beta1::ListBackupsResponse + command.params['parent'] = parent unless parent.nil? + command.query['filter'] = filter unless filter.nil? + command.query['orderBy'] = order_by unless order_by.nil? + command.query['pageSize'] = page_size unless page_size.nil? + command.query['pageToken'] = page_token unless page_token.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 the settings of a specific backup. + # @param [String] name + # Output only. The resource name of the backup, in the format projects/` + # project_id`/locations/`location_id`/backups/`backup_id`. + # @param [Google::Apis::FileV1beta1::Backup] backup_object + # @param [String] update_mask + # Required. Mask of fields to update. At least one path must be supplied in this + # field. + # @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::FileV1beta1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::Operation] + # + # @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_project_location_backup(name, backup_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'v1beta1/{+name}', options) + command.request_representation = Google::Apis::FileV1beta1::Backup::Representation + command.request_object = backup_object + command.response_representation = Google::Apis::FileV1beta1::Operation::Representation + command.response_class = Google::Apis::FileV1beta1::Operation + command.params['name'] = name unless name.nil? + command.query['updateMask'] = update_mask unless update_mask.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 an instance. # @param [String] parent # Required. The instance's project and location, in the format projects/` @@ -308,6 +496,40 @@ module Google execute_or_queue_command(command, &block) end + # Restores an existing instance's file share from a snapshot or backup. + # @param [String] name + # Required. The resource name of the instance, in the format projects/` + # project_id`/locations/`location_id`/instances/`instance_id`. + # @param [Google::Apis::FileV1beta1::RestoreInstanceRequest] restore_instance_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::FileV1beta1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::FileV1beta1::Operation] + # + # @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 restore_instance(name, restore_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1beta1/{+name}:restore', options) + command.request_representation = Google::Apis::FileV1beta1::RestoreInstanceRequest::Representation + command.request_object = restore_instance_request_object + command.response_representation = Google::Apis::FileV1beta1::Operation::Representation + command.response_class = Google::Apis::FileV1beta1::Operation + 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 + # Starts asynchronous cancellation on a long-running operation. The server makes # a best effort to cancel the operation, but success is not guaranteed. If the # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. diff --git a/generated/google/apis/firebase_v1beta1/classes.rb b/generated/google/apis/firebase_v1beta1/classes.rb index 6f852ef36..5bc223cfa 100644 --- a/generated/google/apis/firebase_v1beta1/classes.rb +++ b/generated/google/apis/firebase_v1beta1/classes.rb @@ -379,9 +379,9 @@ module Google class FirebaseAppInfo include Google::Apis::Core::Hashable - # Immutable. The globally unique, Firebase-assigned identifier for the `WebApp`. - # This identifier should be treated as an opaque token, as the data format is - # not specified. + # Output only. Immutable. The globally unique, Firebase-assigned identifier for + # the `WebApp`. This identifier should be treated as an opaque token, as the + # data format is not specified. # Corresponds to the JSON property `appId` # @return [String] attr_accessor :app_id @@ -398,6 +398,17 @@ module Google # @return [String] attr_accessor :name + # Output only. Immutable. The platform-specific identifier of the App. *Note:* + # For most use cases, use `appId`, which is the canonical, globally unique + # identifier for referencing an App. This string is derived from a native + # identifier for each platform: `packageName` for an `AndroidApp`, `bundleId` + # for an `IosApp`, and `webId` for a `WebApp`. Its contents should be treated as + # opaque, as the native identifier format may change as platforms evolve. This + # string is only unique within a `FirebaseProject` and its associated Apps. + # Corresponds to the JSON property `namespace` + # @return [String] + attr_accessor :namespace + # The platform of the Firebase App. # Corresponds to the JSON property `platform` # @return [String] @@ -412,6 +423,7 @@ module Google @app_id = args[:app_id] if args.key?(:app_id) @display_name = args[:display_name] if args.key?(:display_name) @name = args[:name] if args.key?(:name) + @namespace = args[:namespace] if args.key?(:namespace) @platform = args[:platform] if args.key?(:platform) end end @@ -1178,6 +1190,15 @@ module Google # @return [String] attr_accessor :project_id + # Output only. Immutable. A unique, Firebase-assigned identifier for the `WebApp` + # . This identifier is only used to populate the `namespace` value for the ` + # WebApp`. For most use cases, use `appId` to identify or reference the App. The + # `webId` value is only unique within a `FirebaseProject` and its associated + # Apps. + # Corresponds to the JSON property `webId` + # @return [String] + attr_accessor :web_id + def initialize(**args) update!(**args) end @@ -1189,6 +1210,7 @@ module Google @display_name = args[:display_name] if args.key?(:display_name) @name = args[:name] if args.key?(:name) @project_id = args[:project_id] if args.key?(:project_id) + @web_id = args[:web_id] if args.key?(:web_id) end end diff --git a/generated/google/apis/firebase_v1beta1/representations.rb b/generated/google/apis/firebase_v1beta1/representations.rb index 414f0c3ea..96d722c8a 100644 --- a/generated/google/apis/firebase_v1beta1/representations.rb +++ b/generated/google/apis/firebase_v1beta1/representations.rb @@ -313,6 +313,7 @@ module Google property :app_id, as: 'appId' property :display_name, as: 'displayName' property :name, as: 'name' + property :namespace, as: 'namespace' property :platform, as: 'platform' end end @@ -511,6 +512,7 @@ module Google property :display_name, as: 'displayName' property :name, as: 'name' property :project_id, as: 'projectId' + property :web_id, as: 'webId' end end diff --git a/generated/google/apis/firebase_v1beta1/service.rb b/generated/google/apis/firebase_v1beta1/service.rb index cddb5397c..7d74b5da2 100644 --- a/generated/google/apis/firebase_v1beta1/service.rb +++ b/generated/google/apis/firebase_v1beta1/service.rb @@ -493,6 +493,12 @@ module Google # The parent FirebaseProject for which to list Apps, in the format: projects/ # PROJECT_IDENTIFIER Refer to the `FirebaseProject` [`name`](../projects# # FirebaseProject.FIELDS.name) field for details about PROJECT_IDENTIFIER values. + # @param [String] filter + # A query string compatible with Google's [AIP-160](https://google.aip.dev/160) + # standard. Use any of the following fields in a query: * [`appId`](../projects. + # apps#FirebaseProjectInfo.FIELDS.app_id) * [`namespace`](../projects.apps# + # FirebaseProjectInfo.FIELDS.namespace) * [`platform`](../projects.apps# + # FirebaseProjectInfo.FIELDS.platform) # @param [Fixnum] page_size # The maximum number of Apps to return in the response. The server may return # fewer than this value at its discretion. If no value is specified (or too @@ -518,11 +524,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 search_project_apps(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) + def search_project_apps(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) command = make_simple_command(:get, 'v1beta1/{+parent}:searchApps', options) command.response_representation = Google::Apis::FirebaseV1beta1::SearchFirebaseAppsResponse::Representation command.response_class = Google::Apis::FirebaseV1beta1::SearchFirebaseAppsResponse command.params['parent'] = parent unless parent.nil? + command.query['filter'] = filter unless filter.nil? command.query['pageSize'] = page_size unless page_size.nil? command.query['pageToken'] = page_token unless page_token.nil? command.query['fields'] = fields unless fields.nil? diff --git a/generated/google/apis/groupsmigration_v1.rb b/generated/google/apis/groupsmigration_v1.rb new file mode 100644 index 000000000..d10a0e3df --- /dev/null +++ b/generated/google/apis/groupsmigration_v1.rb @@ -0,0 +1,35 @@ +# Copyright 2015 Google Inc. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +require 'google/apis/groupsmigration_v1/service.rb' +require 'google/apis/groupsmigration_v1/classes.rb' +require 'google/apis/groupsmigration_v1/representations.rb' + +module Google + module Apis + # Groups Migration API + # + # The Groups Migration API allows domain administrators to archive emails into + # Google groups. + # + # @see https://developers.google.com/google-apps/groups-migration/ + module GroupsmigrationV1 + VERSION = 'V1' + REVISION = '20200813' + + # Manage messages in groups on your domain + AUTH_APPS_GROUPS_MIGRATION = 'https://www.googleapis.com/auth/apps.groups.migration' + end + end +end diff --git a/generated/google/apis/groupsmigration_v1/classes.rb b/generated/google/apis/groupsmigration_v1/classes.rb new file mode 100644 index 000000000..2841ab3cf --- /dev/null +++ b/generated/google/apis/groupsmigration_v1/classes.rb @@ -0,0 +1,51 @@ +# Copyright 2015 Google Inc. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +require 'date' +require 'google/apis/core/base_service' +require 'google/apis/core/json_representation' +require 'google/apis/core/hashable' +require 'google/apis/errors' + +module Google + module Apis + module GroupsmigrationV1 + + # JSON response template for groups migration API. + class Groups + include Google::Apis::Core::Hashable + + # The kind of insert resource this is. + # Corresponds to the JSON property `kind` + # @return [String] + attr_accessor :kind + + # The status of the insert request. + # Corresponds to the JSON property `responseCode` + # @return [String] + attr_accessor :response_code + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @kind = args[:kind] if args.key?(:kind) + @response_code = args[:response_code] if args.key?(:response_code) + end + end + end + end +end diff --git a/generated/google/apis/groupsmigration_v1/representations.rb b/generated/google/apis/groupsmigration_v1/representations.rb new file mode 100644 index 000000000..c05350d6d --- /dev/null +++ b/generated/google/apis/groupsmigration_v1/representations.rb @@ -0,0 +1,40 @@ +# Copyright 2015 Google Inc. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +require 'date' +require 'google/apis/core/base_service' +require 'google/apis/core/json_representation' +require 'google/apis/core/hashable' +require 'google/apis/errors' + +module Google + module Apis + module GroupsmigrationV1 + + class Groups + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Groups + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :kind, as: 'kind' + property :response_code, as: 'responseCode' + end + end + end + end +end diff --git a/generated/google/apis/groupsmigration_v1/service.rb b/generated/google/apis/groupsmigration_v1/service.rb new file mode 100644 index 000000000..5b726173f --- /dev/null +++ b/generated/google/apis/groupsmigration_v1/service.rb @@ -0,0 +1,100 @@ +# Copyright 2015 Google Inc. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +require 'google/apis/core/base_service' +require 'google/apis/core/json_representation' +require 'google/apis/core/hashable' +require 'google/apis/errors' + +module Google + module Apis + module GroupsmigrationV1 + # Groups Migration API + # + # The Groups Migration API allows domain administrators to archive emails into + # Google groups. + # + # @example + # require 'google/apis/groupsmigration_v1' + # + # Groupsmigration = Google::Apis::GroupsmigrationV1 # Alias the module + # service = Groupsmigration::GroupsMigrationService.new + # + # @see https://developers.google.com/google-apps/groups-migration/ + class GroupsMigrationService < Google::Apis::Core::BaseService + # @return [String] + # API key. Your API key identifies your project and provides you with API access, + # quota, and reports. Required unless you provide an OAuth 2.0 token. + attr_accessor :key + + # @return [String] + # 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. + attr_accessor :quota_user + + def initialize + super('https://www.googleapis.com/', '') + @batch_path = 'batch/groupsmigration/v1' + end + + # Inserts a new mail into the archive of the Google group. + # @param [String] group_id + # The group ID + # @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 [IO, String] upload_source + # IO stream or filename containing content to upload + # @param [String] content_type + # Content type of the uploaded content. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::GroupsmigrationV1::Groups] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::GroupsmigrationV1::Groups] + # + # @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 insert_archive(group_id, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block) + if upload_source.nil? + command = make_simple_command(:post, 'groups/v1/groups/{groupId}/archive', options) + else + command = make_upload_command(:post, 'groups/v1/groups/{groupId}/archive', options) + command.upload_source = upload_source + command.upload_content_type = content_type + end + command.response_representation = Google::Apis::GroupsmigrationV1::Groups::Representation + command.response_class = Google::Apis::GroupsmigrationV1::Groups + command.params['groupId'] = group_id unless group_id.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 + + def apply_command_defaults(command) + command.query['key'] = key unless key.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + end + end + end + end +end diff --git a/generated/google/apis/pubsublite_v1.rb b/generated/google/apis/pubsublite_v1.rb index a68272710..f4b1cab1e 100644 --- a/generated/google/apis/pubsublite_v1.rb +++ b/generated/google/apis/pubsublite_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/pubsub/lite/docs module PubsubliteV1 VERSION = 'V1' - REVISION = '20200803' + REVISION = '20200818' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/pubsublite_v1/classes.rb b/generated/google/apis/pubsublite_v1/classes.rb index d0d152fd8..39ca9ff95 100644 --- a/generated/google/apis/pubsublite_v1/classes.rb +++ b/generated/google/apis/pubsublite_v1/classes.rb @@ -224,10 +224,12 @@ module Google # @return [Fixnum] attr_accessor :count - # Every partition in the topic is allocated throughput equivalent to `scale` - # times the standard partition throughput (4 MiB/s). This is also reflected in - # the cost of this topic; a topic with `scale` of 2 and count of 10 is charged - # for 20 partitions. This value must be in the range [1,4]. + # DEPRECATED: Use capacity instead which can express a superset of + # configurations. Every partition in the topic is allocated throughput + # equivalent to `scale` times the standard partition throughput (4 MiB/s). This + # is also reflected in the cost of this topic; a topic with `scale` of 2 and + # count of 10 is charged for 20 partitions. This value must be in the range [1,4] + # . # Corresponds to the JSON property `scale` # @return [Fixnum] attr_accessor :scale diff --git a/generated/google/apis/texttospeech_v1.rb b/generated/google/apis/texttospeech_v1.rb index 8c6bf7db0..07c4c9f4f 100644 --- a/generated/google/apis/texttospeech_v1.rb +++ b/generated/google/apis/texttospeech_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/text-to-speech/ module TexttospeechV1 VERSION = 'V1' - REVISION = '20200807' + REVISION = '20200814' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/texttospeech_v1/service.rb b/generated/google/apis/texttospeech_v1/service.rb index c5007e0ee..350aa5e38 100644 --- a/generated/google/apis/texttospeech_v1/service.rb +++ b/generated/google/apis/texttospeech_v1/service.rb @@ -83,10 +83,10 @@ module Google # Optional. Recommended. [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) # language tag. If specified, the ListVoices call will only return voices that # can be used to synthesize this language_code. E.g. when specifying "en-NZ", - # you will get supported "en-*" voices; when specifying "no", you will get - # supported "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices; specifying " - # zh" will also get supported "cmn-*" voices; specifying "zh-hk" will also get - # supported "yue-*" voices. + # you will get supported "en-\*" voices; when specifying "no", you will get + # supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; + # specifying "zh" will also get supported "cmn-\*" voices; specifying "zh-hk" + # will also get supported "yue-\*" voices. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user diff --git a/generated/google/apis/texttospeech_v1beta1.rb b/generated/google/apis/texttospeech_v1beta1.rb index 592062e12..b180825f8 100644 --- a/generated/google/apis/texttospeech_v1beta1.rb +++ b/generated/google/apis/texttospeech_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/text-to-speech/ module TexttospeechV1beta1 VERSION = 'V1beta1' - REVISION = '20200807' + REVISION = '20200814' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/texttospeech_v1beta1/service.rb b/generated/google/apis/texttospeech_v1beta1/service.rb index 540c3e87d..17568fad5 100644 --- a/generated/google/apis/texttospeech_v1beta1/service.rb +++ b/generated/google/apis/texttospeech_v1beta1/service.rb @@ -83,10 +83,10 @@ module Google # Optional. Recommended. [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) # language tag. If specified, the ListVoices call will only return voices that # can be used to synthesize this language_code. E.g. when specifying "en-NZ", - # you will get supported "en-*" voices; when specifying "no", you will get - # supported "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices; specifying " - # zh" will also get supported "cmn-*" voices; specifying "zh-hk" will also get - # supported "yue-*" voices. + # you will get supported "en-\*" voices; when specifying "no", you will get + # supported "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; + # specifying "zh" will also get supported "cmn-\*" voices; specifying "zh-hk" + # will also get supported "yue-\*" voices. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user