diff --git a/api_names_out.yaml b/api_names_out.yaml index d27e9dd2a..cf059e8ae 100644 --- a/api_names_out.yaml +++ b/api_names_out.yaml @@ -100862,6 +100862,8 @@ "/healthcare:v1beta1/Finding/infoType": info_type "/healthcare:v1beta1/Finding/quote": quote "/healthcare:v1beta1/Finding/start": start +"/healthcare:v1beta1/GcsSource": gcs_source +"/healthcare:v1beta1/GcsSource/uri": uri "/healthcare:v1beta1/GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination": google_cloud_healthcare_v1beta1_annotation_big_query_destination "/healthcare:v1beta1/GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination/force": force "/healthcare:v1beta1/GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination/schemaType": schema_type @@ -100959,6 +100961,9 @@ "/healthcare:v1beta1/ImportDicomDataRequest": import_dicom_data_request "/healthcare:v1beta1/ImportDicomDataRequest/gcsSource": gcs_source "/healthcare:v1beta1/ImportDicomDataResponse": import_dicom_data_response +"/healthcare:v1beta1/ImportMessagesRequest": import_messages_request +"/healthcare:v1beta1/ImportMessagesRequest/gcsSource": gcs_source +"/healthcare:v1beta1/ImportMessagesResponse": import_messages_response "/healthcare:v1beta1/ImportResourcesRequest": import_resources_request "/healthcare:v1beta1/ImportResourcesRequest/contentStructure": content_structure "/healthcare:v1beta1/ImportResourcesRequest/gcsSource": gcs_source @@ -101400,6 +101405,8 @@ "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.getIamPolicy": get_project_location_dataset_hl7_v2_store_iam_policy "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.getIamPolicy/options.requestedPolicyVersion": options_requested_policy_version "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.getIamPolicy/resource": resource +"/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.import": import_hl7_v2_store_messages +"/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.import/name": name "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.list": list_project_location_dataset_hl7_v2_stores "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.list/filter": filter "/healthcare:v1beta1/healthcare.projects.locations.datasets.hl7V2Stores.list/pageSize": page_size @@ -106066,6 +106073,10 @@ "/manufacturers:v1/manufacturers.accounts.products.uploadProduct/name": name "/manufacturers:v1/manufacturers.accounts.products.uploadProduct/parent": parent "/manufacturers:v1/quotaUser": quota_user +"/memcache:v1/ApplyParametersRequest": apply_parameters_request +"/memcache:v1/ApplyParametersRequest/applyAll": apply_all +"/memcache:v1/ApplyParametersRequest/nodeIds": node_ids +"/memcache:v1/ApplyParametersRequest/nodeIds/node_id": node_id "/memcache:v1/AuditConfig": audit_config "/memcache:v1/AuditConfig/auditLogConfigs": audit_log_configs "/memcache:v1/AuditConfig/auditLogConfigs/audit_log_config": audit_log_config @@ -106086,6 +106097,14 @@ "/memcache:v1/Expr/expression": expression "/memcache:v1/Expr/location": location "/memcache:v1/Expr/title": title +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata": google_cloud_memcache_v1_operation_metadata +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/apiVersion": api_version +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/cancelRequested": cancel_requested +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/createTime": create_time +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/endTime": end_time +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/statusDetail": status_detail +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/target": target +"/memcache:v1/GoogleCloudMemcacheV1OperationMetadata/verb": verb "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1Instance": google_cloud_saasaccelerator_management_providers_v1_instance "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/consumerDefinedName": consumer_defined_name "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/createTime": create_time @@ -106138,6 +106157,36 @@ "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/nodes": nodes "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/nodes/node": node "/memcache:v1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/tier": tier +"/memcache:v1/Instance": instance +"/memcache:v1/Instance/authorizedNetwork": authorized_network +"/memcache:v1/Instance/createTime": create_time +"/memcache:v1/Instance/discoveryEndpoint": discovery_endpoint +"/memcache:v1/Instance/displayName": display_name +"/memcache:v1/Instance/instanceMessages": instance_messages +"/memcache:v1/Instance/instanceMessages/instance_message": instance_message +"/memcache:v1/Instance/labels": labels +"/memcache:v1/Instance/labels/label": label +"/memcache:v1/Instance/memcacheFullVersion": memcache_full_version +"/memcache:v1/Instance/memcacheNodes": memcache_nodes +"/memcache:v1/Instance/memcacheNodes/memcache_node": memcache_node +"/memcache:v1/Instance/memcacheVersion": memcache_version +"/memcache:v1/Instance/name": name +"/memcache:v1/Instance/nodeConfig": node_config +"/memcache:v1/Instance/nodeCount": node_count +"/memcache:v1/Instance/parameters": parameters +"/memcache:v1/Instance/state": state +"/memcache:v1/Instance/updateTime": update_time +"/memcache:v1/Instance/zones": zones +"/memcache:v1/Instance/zones/zone": zone +"/memcache:v1/InstanceMessage": instance_message +"/memcache:v1/InstanceMessage/code": code +"/memcache:v1/InstanceMessage/message": message +"/memcache:v1/ListInstancesResponse": list_instances_response +"/memcache:v1/ListInstancesResponse/nextPageToken": next_page_token +"/memcache:v1/ListInstancesResponse/resources": resources +"/memcache:v1/ListInstancesResponse/resources/resource": resource +"/memcache:v1/ListInstancesResponse/unreachable": unreachable +"/memcache:v1/ListInstancesResponse/unreachable/unreachable": unreachable "/memcache:v1/ListLocationsResponse": list_locations_response "/memcache:v1/ListLocationsResponse/locations": locations "/memcache:v1/ListLocationsResponse/locations/location": location @@ -106157,6 +106206,20 @@ "/memcache:v1/LocationMetadata": location_metadata "/memcache:v1/LocationMetadata/availableZones": available_zones "/memcache:v1/LocationMetadata/availableZones/available_zone": available_zone +"/memcache:v1/MemcacheParameters": memcache_parameters +"/memcache:v1/MemcacheParameters/id": id +"/memcache:v1/MemcacheParameters/params": params +"/memcache:v1/MemcacheParameters/params/param": param +"/memcache:v1/Node": node +"/memcache:v1/Node/host": host +"/memcache:v1/Node/nodeId": node_id +"/memcache:v1/Node/parameters": parameters +"/memcache:v1/Node/port": port +"/memcache:v1/Node/state": state +"/memcache:v1/Node/zone": zone +"/memcache:v1/NodeConfig": node_config +"/memcache:v1/NodeConfig/cpuCount": cpu_count +"/memcache:v1/NodeConfig/memorySizeMb": memory_size_mb "/memcache:v1/Operation": operation "/memcache:v1/Operation/done": done "/memcache:v1/Operation/error": error @@ -106195,18 +106258,41 @@ "/memcache:v1/TestIamPermissionsResponse": test_iam_permissions_response "/memcache:v1/TestIamPermissionsResponse/permissions": permissions "/memcache:v1/TestIamPermissionsResponse/permissions/permission": permission +"/memcache:v1/UpdateParametersRequest": update_parameters_request +"/memcache:v1/UpdateParametersRequest/parameters": parameters +"/memcache:v1/UpdateParametersRequest/updateMask": update_mask "/memcache:v1/ZoneMetadata": zone_metadata "/memcache:v1/fields": fields "/memcache:v1/key": key "/memcache:v1/memcache.projects.locations.get": get_project_location "/memcache:v1/memcache.projects.locations.get/name": name +"/memcache:v1/memcache.projects.locations.instances.applyParameters": apply_instance_parameters +"/memcache:v1/memcache.projects.locations.instances.applyParameters/name": name +"/memcache:v1/memcache.projects.locations.instances.create": create_project_location_instance +"/memcache:v1/memcache.projects.locations.instances.create/instanceId": instance_id +"/memcache:v1/memcache.projects.locations.instances.create/parent": parent +"/memcache:v1/memcache.projects.locations.instances.delete": delete_project_location_instance +"/memcache:v1/memcache.projects.locations.instances.delete/name": name +"/memcache:v1/memcache.projects.locations.instances.get": get_project_location_instance +"/memcache:v1/memcache.projects.locations.instances.get/name": name "/memcache:v1/memcache.projects.locations.instances.getIamPolicy": get_project_location_instance_iam_policy "/memcache:v1/memcache.projects.locations.instances.getIamPolicy/options.requestedPolicyVersion": options_requested_policy_version "/memcache:v1/memcache.projects.locations.instances.getIamPolicy/resource": resource +"/memcache:v1/memcache.projects.locations.instances.list": list_project_location_instances +"/memcache:v1/memcache.projects.locations.instances.list/filter": filter +"/memcache:v1/memcache.projects.locations.instances.list/orderBy": order_by +"/memcache:v1/memcache.projects.locations.instances.list/pageSize": page_size +"/memcache:v1/memcache.projects.locations.instances.list/pageToken": page_token +"/memcache:v1/memcache.projects.locations.instances.list/parent": parent +"/memcache:v1/memcache.projects.locations.instances.patch": patch_project_location_instance +"/memcache:v1/memcache.projects.locations.instances.patch/name": name +"/memcache:v1/memcache.projects.locations.instances.patch/updateMask": update_mask "/memcache:v1/memcache.projects.locations.instances.setIamPolicy": set_instance_iam_policy "/memcache:v1/memcache.projects.locations.instances.setIamPolicy/resource": resource "/memcache:v1/memcache.projects.locations.instances.testIamPermissions": test_instance_iam_permissions "/memcache:v1/memcache.projects.locations.instances.testIamPermissions/resource": resource +"/memcache:v1/memcache.projects.locations.instances.updateParameters": update_instance_parameters +"/memcache:v1/memcache.projects.locations.instances.updateParameters/name": name "/memcache:v1/memcache.projects.locations.list": list_project_locations "/memcache:v1/memcache.projects.locations.list/filter": filter "/memcache:v1/memcache.projects.locations.list/name": name @@ -111160,6 +111246,11 @@ "/people:v1/Membership/contactGroupMembership": contact_group_membership "/people:v1/Membership/domainMembership": domain_membership "/people:v1/Membership/metadata": metadata +"/people:v1/MiscKeyword": misc_keyword +"/people:v1/MiscKeyword/formattedType": formatted_type +"/people:v1/MiscKeyword/metadata": metadata +"/people:v1/MiscKeyword/type": type +"/people:v1/MiscKeyword/value": value "/people:v1/ModifyContactGroupMembersRequest": modify_contact_group_members_request "/people:v1/ModifyContactGroupMembersRequest/resourceNamesToAdd": resource_names_to_add "/people:v1/ModifyContactGroupMembersRequest/resourceNamesToAdd/resource_names_to_add": resource_names_to_add @@ -111245,6 +111336,8 @@ "/people:v1/Person/memberships": memberships "/people:v1/Person/memberships/membership": membership "/people:v1/Person/metadata": metadata +"/people:v1/Person/miscKeywords": misc_keywords +"/people:v1/Person/miscKeywords/misc_keyword": misc_keyword "/people:v1/Person/names": names "/people:v1/Person/names/name": name "/people:v1/Person/nicknames": nicknames @@ -123313,6 +123406,153 @@ "/servicecontrol:v1/servicecontrol.services.report/serviceName": service_name "/servicecontrol:v1/servicecontrol.services.startReconciliation": start_service_reconciliation "/servicecontrol:v1/servicecontrol.services.startReconciliation/serviceName": service_name +"/servicecontrol:v2/Api": api +"/servicecontrol:v2/Api/operation": operation +"/servicecontrol:v2/Api/protocol": protocol +"/servicecontrol:v2/Api/service": service +"/servicecontrol:v2/Api/version": version +"/servicecontrol:v2/AttributeContext": attribute_context +"/servicecontrol:v2/AttributeContext/api": api +"/servicecontrol:v2/AttributeContext/destination": destination +"/servicecontrol:v2/AttributeContext/extensions": extensions +"/servicecontrol:v2/AttributeContext/extensions/extension": extension +"/servicecontrol:v2/AttributeContext/extensions/extension/extension": extension +"/servicecontrol:v2/AttributeContext/origin": origin +"/servicecontrol:v2/AttributeContext/request": request +"/servicecontrol:v2/AttributeContext/resource": resource +"/servicecontrol:v2/AttributeContext/response": response +"/servicecontrol:v2/AttributeContext/source": source +"/servicecontrol:v2/AuditLog": audit_log +"/servicecontrol:v2/AuditLog/authenticationInfo": authentication_info +"/servicecontrol:v2/AuditLog/authorizationInfo": authorization_info +"/servicecontrol:v2/AuditLog/authorizationInfo/authorization_info": authorization_info +"/servicecontrol:v2/AuditLog/metadata": metadata +"/servicecontrol:v2/AuditLog/metadata/metadatum": metadatum +"/servicecontrol:v2/AuditLog/methodName": method_name +"/servicecontrol:v2/AuditLog/numResponseItems": num_response_items +"/servicecontrol:v2/AuditLog/request": request +"/servicecontrol:v2/AuditLog/request/request": request +"/servicecontrol:v2/AuditLog/requestMetadata": request_metadata +"/servicecontrol:v2/AuditLog/resourceLocation": resource_location +"/servicecontrol:v2/AuditLog/resourceName": resource_name +"/servicecontrol:v2/AuditLog/resourceOriginalState": resource_original_state +"/servicecontrol:v2/AuditLog/resourceOriginalState/resource_original_state": resource_original_state +"/servicecontrol:v2/AuditLog/response": response +"/servicecontrol:v2/AuditLog/response/response": response +"/servicecontrol:v2/AuditLog/serviceData": service_data +"/servicecontrol:v2/AuditLog/serviceData/service_datum": service_datum +"/servicecontrol:v2/AuditLog/serviceName": service_name +"/servicecontrol:v2/AuditLog/status": status +"/servicecontrol:v2/Auth": auth +"/servicecontrol:v2/Auth/accessLevels": access_levels +"/servicecontrol:v2/Auth/accessLevels/access_level": access_level +"/servicecontrol:v2/Auth/audiences": audiences +"/servicecontrol:v2/Auth/audiences/audience": audience +"/servicecontrol:v2/Auth/claims": claims +"/servicecontrol:v2/Auth/claims/claim": claim +"/servicecontrol:v2/Auth/presenter": presenter +"/servicecontrol:v2/Auth/principal": principal +"/servicecontrol:v2/AuthenticationInfo": authentication_info +"/servicecontrol:v2/AuthenticationInfo/authoritySelector": authority_selector +"/servicecontrol:v2/AuthenticationInfo/principalEmail": principal_email +"/servicecontrol:v2/AuthenticationInfo/principalSubject": principal_subject +"/servicecontrol:v2/AuthenticationInfo/serviceAccountDelegationInfo": service_account_delegation_info +"/servicecontrol:v2/AuthenticationInfo/serviceAccountDelegationInfo/service_account_delegation_info": service_account_delegation_info +"/servicecontrol:v2/AuthenticationInfo/serviceAccountKeyName": service_account_key_name +"/servicecontrol:v2/AuthenticationInfo/thirdPartyPrincipal": third_party_principal +"/servicecontrol:v2/AuthenticationInfo/thirdPartyPrincipal/third_party_principal": third_party_principal +"/servicecontrol:v2/AuthorizationInfo": authorization_info +"/servicecontrol:v2/AuthorizationInfo/granted": granted +"/servicecontrol:v2/AuthorizationInfo/permission": permission +"/servicecontrol:v2/AuthorizationInfo/resource": resource +"/servicecontrol:v2/AuthorizationInfo/resourceAttributes": resource_attributes +"/servicecontrol:v2/CheckRequest": check_request +"/servicecontrol:v2/CheckRequest/attributes": attributes +"/servicecontrol:v2/CheckRequest/resources": resources +"/servicecontrol:v2/CheckRequest/resources/resource": resource +"/servicecontrol:v2/CheckRequest/serviceConfigId": service_config_id +"/servicecontrol:v2/CheckResponse": check_response +"/servicecontrol:v2/CheckResponse/headers": headers +"/servicecontrol:v2/CheckResponse/headers/header": header +"/servicecontrol:v2/CheckResponse/status": status +"/servicecontrol:v2/FirstPartyPrincipal": first_party_principal +"/servicecontrol:v2/FirstPartyPrincipal/principalEmail": principal_email +"/servicecontrol:v2/FirstPartyPrincipal/serviceMetadata": service_metadata +"/servicecontrol:v2/FirstPartyPrincipal/serviceMetadata/service_metadatum": service_metadatum +"/servicecontrol:v2/Peer": peer +"/servicecontrol:v2/Peer/ip": ip +"/servicecontrol:v2/Peer/labels": labels +"/servicecontrol:v2/Peer/labels/label": label +"/servicecontrol:v2/Peer/port": port +"/servicecontrol:v2/Peer/principal": principal +"/servicecontrol:v2/Peer/regionCode": region_code +"/servicecontrol:v2/ReportRequest": report_request +"/servicecontrol:v2/ReportRequest/operations": operations +"/servicecontrol:v2/ReportRequest/operations/operation": operation +"/servicecontrol:v2/ReportRequest/serviceConfigId": service_config_id +"/servicecontrol:v2/ReportResponse": report_response +"/servicecontrol:v2/Request": request +"/servicecontrol:v2/Request/auth": auth +"/servicecontrol:v2/Request/headers": headers +"/servicecontrol:v2/Request/headers/header": header +"/servicecontrol:v2/Request/host": host +"/servicecontrol:v2/Request/id": id +"/servicecontrol:v2/Request/method": method_prop +"/servicecontrol:v2/Request/path": path +"/servicecontrol:v2/Request/protocol": protocol +"/servicecontrol:v2/Request/query": query +"/servicecontrol:v2/Request/reason": reason +"/servicecontrol:v2/Request/scheme": scheme +"/servicecontrol:v2/Request/size": size +"/servicecontrol:v2/Request/time": time +"/servicecontrol:v2/RequestMetadata": request_metadata +"/servicecontrol:v2/RequestMetadata/callerIp": caller_ip +"/servicecontrol:v2/RequestMetadata/callerNetwork": caller_network +"/servicecontrol:v2/RequestMetadata/callerSuppliedUserAgent": caller_supplied_user_agent +"/servicecontrol:v2/RequestMetadata/destinationAttributes": destination_attributes +"/servicecontrol:v2/RequestMetadata/requestAttributes": request_attributes +"/servicecontrol:v2/Resource": resource +"/servicecontrol:v2/Resource/labels": labels +"/servicecontrol:v2/Resource/labels/label": label +"/servicecontrol:v2/Resource/name": name +"/servicecontrol:v2/Resource/service": service +"/servicecontrol:v2/Resource/type": type +"/servicecontrol:v2/ResourceInfo": resource_info +"/servicecontrol:v2/ResourceInfo/name": name +"/servicecontrol:v2/ResourceInfo/permission": permission +"/servicecontrol:v2/ResourceInfo/type": type +"/servicecontrol:v2/ResourceLocation": resource_location +"/servicecontrol:v2/ResourceLocation/currentLocations": current_locations +"/servicecontrol:v2/ResourceLocation/currentLocations/current_location": current_location +"/servicecontrol:v2/ResourceLocation/originalLocations": original_locations +"/servicecontrol:v2/ResourceLocation/originalLocations/original_location": original_location +"/servicecontrol:v2/Response": response +"/servicecontrol:v2/Response/code": code +"/servicecontrol:v2/Response/headers": headers +"/servicecontrol:v2/Response/headers/header": header +"/servicecontrol:v2/Response/size": size +"/servicecontrol:v2/Response/time": time +"/servicecontrol:v2/ServiceAccountDelegationInfo": service_account_delegation_info +"/servicecontrol:v2/ServiceAccountDelegationInfo/firstPartyPrincipal": first_party_principal +"/servicecontrol:v2/ServiceAccountDelegationInfo/thirdPartyPrincipal": third_party_principal +"/servicecontrol:v2/SpanContext": span_context +"/servicecontrol:v2/SpanContext/spanName": span_name +"/servicecontrol:v2/Status": status +"/servicecontrol:v2/Status/code": code +"/servicecontrol:v2/Status/details": details +"/servicecontrol:v2/Status/details/detail": detail +"/servicecontrol:v2/Status/details/detail/detail": detail +"/servicecontrol:v2/Status/message": message +"/servicecontrol:v2/ThirdPartyPrincipal": third_party_principal +"/servicecontrol:v2/ThirdPartyPrincipal/thirdPartyClaims": third_party_claims +"/servicecontrol:v2/ThirdPartyPrincipal/thirdPartyClaims/third_party_claim": third_party_claim +"/servicecontrol:v2/fields": fields +"/servicecontrol:v2/key": key +"/servicecontrol:v2/quotaUser": quota_user +"/servicecontrol:v2/servicecontrol.services.check": check_service +"/servicecontrol:v2/servicecontrol.services.check/serviceName": service_name +"/servicecontrol:v2/servicecontrol.services.report": report_service +"/servicecontrol:v2/servicecontrol.services.report/serviceName": service_name "/servicedirectory:v1beta1/Binding": binding "/servicedirectory:v1beta1/Binding/condition": condition "/servicedirectory:v1beta1/Binding/members": members diff --git a/generated/google/apis/datacatalog_v1beta1.rb b/generated/google/apis/datacatalog_v1beta1.rb index 11539e2ca..182460807 100644 --- a/generated/google/apis/datacatalog_v1beta1.rb +++ b/generated/google/apis/datacatalog_v1beta1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/data-catalog/docs/ module DatacatalogV1beta1 VERSION = 'V1beta1' - REVISION = '20200719' + REVISION = '20200728' # 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/datacatalog_v1beta1/classes.rb b/generated/google/apis/datacatalog_v1beta1/classes.rb index e72ac8e55..5da4a0a49 100644 --- a/generated/google/apis/datacatalog_v1beta1/classes.rb +++ b/generated/google/apis/datacatalog_v1beta1/classes.rb @@ -26,57 +26,69 @@ module Google class Binding include Google::Apis::Core::Hashable - # Represents a textual expression in the Common Expression Language (CEL) syntax. - # CEL is a C-like expression language. The syntax and semantics of CEL are - # documented at https://github.com/google/cel-spec. Example (Comparison): title: - # "Summary size limit" description: "Determines if a summary is less than 100 - # chars" expression: "document.summary.size() < 100" Example (Equality): title: " - # Requestor is owner" description: "Determines if requestor is the document - # owner" expression: "document.owner == request.auth.claims.email" Example ( - # Logic): title: "Public documents" description: "Determine whether the document - # should be publicly visible" expression: "document.type != 'private' && - # document.type != 'internal'" Example (Data Manipulation): title: "Notification - # string" description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" The - # exact variables and functions that may be referenced within an expression are - # determined by the service that evaluates it. See the service documentation for - # additional information. + # Represents a textual expression in the Common Expression Language (CEL) + # syntax. CEL is a C-like expression language. The syntax and semantics of CEL + # are documented at https://github.com/google/cel-spec. + # Example (Comparison): + # title: "Summary size limit" + # description: "Determines if a summary is less than 100 chars" + # expression: "document.summary.size() < 100" + # Example (Equality): + # title: "Requestor is owner" + # description: "Determines if requestor is the document owner" + # expression: "document.owner == request.auth.claims.email" + # Example (Logic): + # title: "Public documents" + # description: "Determine whether the document should be publicly visible" + # expression: "document.type != 'private' && document.type != 'internal'" + # Example (Data Manipulation): + # title: "Notification string" + # description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" + # The exact variables and functions that may be referenced within an expression + # are determined by the service that evaluates it. See the service + # documentation for additional information. # Corresponds to the JSON property `condition` # @return [Google::Apis::DatacatalogV1beta1::Expr] attr_accessor :condition - # Specifies the identities requesting access for a Cloud Platform resource. ` - # members` can have the following values: * `allUsers`: A special identifier - # that represents anyone who is on the internet; with or without a Google - # account. * `allAuthenticatedUsers`: A special identifier that represents - # anyone who is authenticated with a Google account or a service account. * ` - # user:`emailid``: An email address that represents a specific Google account. - # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email - # address that represents a service account. For example, `my-other-app@appspot. - # gserviceaccount.com`. * `group:`emailid``: An email address that represents a - # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid= - # `uniqueid``: An email address (plus unique identifier) representing a user - # that has been recently deleted. For example, `alice@example.com?uid= - # 123456789012345678901`. If the user is recovered, this value reverts to `user:` - # emailid`` and the recovered user retains the role in the binding. * `deleted: - # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a service account that has been recently deleted. For - # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to `serviceAccount:` - # emailid`` and the undeleted service account retains the role in the binding. * - # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently deleted. For - # example, `admins@example.com?uid=123456789012345678901`. If the group is - # recovered, this value reverts to `group:`emailid`` and the recovered group - # retains the role in the binding. * `domain:`domain``: The G Suite domain ( - # primary) that represents all the users of that domain. For example, `google. - # com` or `example.com`. + # Specifies the identities requesting access for a Cloud Platform resource. + # `members` can have the following values: + # * `allUsers`: A special identifier that represents anyone who is + # on the internet; with or without a Google account. + # * `allAuthenticatedUsers`: A special identifier that represents anyone + # who is authenticated with a Google account or a service account. + # * `user:`emailid``: An email address that represents a specific Google + # account. For example, `alice@example.com` . + # * `serviceAccount:`emailid``: An email address that represents a service + # account. For example, `my-other-app@appspot.gserviceaccount.com`. + # * `group:`emailid``: An email address that represents a Google group. + # For example, `admins@example.com`. + # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a user that has been recently deleted. For + # example, `alice@example.com?uid=123456789012345678901`. If the user is + # recovered, this value reverts to `user:`emailid`` and the recovered user + # retains the role in the binding. + # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus + # unique identifier) representing a service account that has been recently + # deleted. For example, + # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + # If the service account is undeleted, this value reverts to + # `serviceAccount:`emailid`` and the undeleted service account retains the + # role in the binding. + # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a Google group that has been recently + # deleted. For example, `admins@example.com?uid=123456789012345678901`. If + # the group is recovered, this value reverts to `group:`emailid`` and the + # recovered group retains the role in the binding. + # * `domain:`domain``: The G Suite domain (primary) that represents all the + # users of that domain. For example, `google.com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members - # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor` - # , or `roles/owner`. + # Role that is assigned to `members`. + # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role @@ -93,11 +105,13 @@ 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 @@ -110,43 +124,52 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) syntax. - # CEL is a C-like expression language. The syntax and semantics of CEL are - # documented at https://github.com/google/cel-spec. Example (Comparison): title: - # "Summary size limit" description: "Determines if a summary is less than 100 - # chars" expression: "document.summary.size() < 100" Example (Equality): title: " - # Requestor is owner" description: "Determines if requestor is the document - # owner" expression: "document.owner == request.auth.claims.email" Example ( - # Logic): title: "Public documents" description: "Determine whether the document - # should be publicly visible" expression: "document.type != 'private' && - # document.type != 'internal'" Example (Data Manipulation): title: "Notification - # string" description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" The - # exact variables and functions that may be referenced within an expression are - # determined by the service that evaluates it. See the service documentation for - # additional information. + # Represents a textual expression in the Common Expression Language (CEL) + # syntax. CEL is a C-like expression language. The syntax and semantics of CEL + # are documented at https://github.com/google/cel-spec. + # Example (Comparison): + # title: "Summary size limit" + # description: "Determines if a summary is less than 100 chars" + # expression: "document.summary.size() < 100" + # Example (Equality): + # title: "Requestor is owner" + # description: "Determines if requestor is the document owner" + # expression: "document.owner == request.auth.claims.email" + # Example (Logic): + # title: "Public documents" + # description: "Determine whether the document should be publicly visible" + # expression: "document.type != 'private' && document.type != 'internal'" + # Example (Data Manipulation): + # title: "Notification string" + # description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" + # The exact variables and functions that may be referenced within an expression + # are determined by the service that evaluates it. See the service + # documentation for additional information. class Expr include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which describes - # the expression, e.g. when hovered over it in a UI. + # Optional. Description of the expression. This is a longer text which + # describes the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Textual representation of an expression in Common Expression Language syntax. + # Textual representation of an expression in Common Expression Language + # syntax. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression - # Optional. String indicating the location of the expression for error reporting, - # e.g. a file name and a position in the file. + # Optional. String indicating the location of the expression for error + # reporting, e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. Title for the expression, i.e. a short string describing its purpose. - # This can be used e.g. in UIs which allow to enter the expression. + # Optional. Title for the expression, i.e. a short string describing + # its purpose. This can be used e.g. in UIs which allow to enter the + # expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title @@ -187,13 +210,15 @@ module Google class GetPolicyOptions include Google::Apis::Core::Hashable - # Optional. The policy format version to be returned. Valid values are 0, 1, and - # 3. Requests specifying an invalid value will be rejected. Requests for - # policies with any conditional bindings must specify version 3. Policies - # without any conditional bindings may specify any valid value or leave the - # field unset. To learn which resources support conditions in their IAM policies, - # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ - # resource-policies). + # Optional. The policy format version to be returned. + # Valid values are 0, 1, and 3. Requests specifying an invalid value will be + # rejected. + # Requests for policies with any conditional bindings must specify version 3. + # Policies without any conditional bindings may specify any valid value or + # leave the field unset. + # To learn which resources support conditions in their IAM policies, see the + # [IAM + # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). # Corresponds to the JSON property `requestedPolicyVersion` # @return [Fixnum] attr_accessor :requested_policy_version @@ -209,14 +234,17 @@ module Google end # Spec for a group of BigQuery tables with name pattern `[prefix]YYYYMMDD`. - # Context: https://cloud.google.com/bigquery/docs/partitioned-tables# + # Context: + # https://cloud.google.com/bigquery/docs/partitioned-tables# # partitioning_versus_sharding class GoogleCloudDatacatalogV1beta1BigQueryDateShardedSpec include Google::Apis::Core::Hashable # Output only. The Data Catalog resource name of the dataset entry the current - # table belongs to, for example, `projects/`project_id`/locations/`location`/ - # entrygroups/`entry_group_id`/entries/`entry_id``. + # table + # belongs to, for example, + # `projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/ + # entries/`entry_id``. # Corresponds to the JSON property `dataset` # @return [String] attr_accessor :dataset @@ -227,8 +255,9 @@ module Google attr_accessor :shard_count # Output only. The table name prefix of the shards. The name of any given shard - # is `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the ` - # table_prefix` is `MyTable`. + # is + # `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the + # `table_prefix` is `MyTable`. # Corresponds to the JSON property `tablePrefix` # @return [String] attr_accessor :table_prefix @@ -292,8 +321,9 @@ module Google attr_accessor :description # Optional. A column's mode indicates whether the values in this column are - # required, nullable, etc. Only `NULLABLE`, `REQUIRED` and `REPEATED` are - # supported. Default mode is `NULLABLE`. + # required, + # nullable, etc. Only `NULLABLE`, `REQUIRED` and `REPEATED` are supported. + # Default mode is `NULLABLE`. # Corresponds to the JSON property `mode` # @return [String] attr_accessor :mode @@ -322,17 +352,21 @@ module Google end end - # Entry Metadata. A Data Catalog Entry resource represents another resource in - # Google Cloud Platform (such as a BigQuery dataset or a Pub/Sub topic), or + # Entry Metadata. + # A Data Catalog Entry resource represents another resource in Google + # Cloud Platform (such as a BigQuery dataset or a Pub/Sub topic), or # outside of Google Cloud Platform. Clients can use the `linked_resource` field # in the Entry resource to refer to the original resource ID of the source - # system. An Entry resource contains resource details, such as its schema. An - # Entry can also be used to attach flexible metadata, such as a Tag. + # system. + # An Entry resource contains resource details, such as its schema. An Entry can + # also be used to attach flexible metadata, such as a + # Tag. class GoogleCloudDatacatalogV1beta1Entry include Google::Apis::Core::Hashable # Spec for a group of BigQuery tables with name pattern `[prefix]YYYYMMDD`. - # Context: https://cloud.google.com/bigquery/docs/partitioned-tables# + # Context: + # https://cloud.google.com/bigquery/docs/partitioned-tables# # partitioning_versus_sharding # Corresponds to the JSON property `bigqueryDateShardedSpec` # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1BigQueryDateShardedSpec] @@ -343,15 +377,15 @@ module Google # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1BigQueryTableSpec] attr_accessor :bigquery_table_spec - # Entry description, which can consist of several sentences or paragraphs that - # describe entry contents. Default value is an empty string. + # Entry description, which can consist of several sentences or paragraphs + # that describe entry contents. Default value is an empty string. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description # Display information such as title and description. A short name to identify - # the entry, for example, "Analytics Data - Jan 2011". Default value is an empty - # string. + # the entry, for example, "Analytics Data - Jan 2011". Default value is an + # empty string. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name @@ -367,21 +401,26 @@ module Google # @return [String] attr_accessor :integrated_system - # The resource this metadata entry refers to. For Google Cloud Platform - # resources, `linked_resource` is the [full name of the resource](https://cloud. - # google.com/apis/design/resource_names#full_resource_name). For example, the ` - # linked_resource` for a table resource from BigQuery is: * //bigquery. - # googleapis.com/projects/projectId/datasets/datasetId/tables/tableId Output - # only when Entry is of type in the EntryType enum. For entries with - # user_specified_type, this field is optional and defaults to an empty string. + # The resource this metadata entry refers to. + # For Google Cloud Platform resources, `linked_resource` is the [full name of + # the + # resource](https://cloud.google.com/apis/design/resource_names# + # full_resource_name). + # For example, the `linked_resource` for a table resource from BigQuery is: + # * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/ + # tableId + # Output only when Entry is of type in the EntryType enum. For entries with + # user_specified_type, this field is optional and defaults to an empty + # string. # Corresponds to the JSON property `linkedResource` # @return [String] attr_accessor :linked_resource - # The Data Catalog resource name of the entry in URL format. Example: * projects/ - # `project_id`/locations/`location`/entryGroups/`entry_group_id`/entries/` - # entry_id` Note that this Entry and its child resources may not actually be - # stored in the location in this name. + # The Data Catalog resource name of the entry in URL format. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` + # Note that this Entry and its child resources may not actually be stored in + # the location in this name. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -396,27 +435,30 @@ module Google # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SystemTimestamps] attr_accessor :source_system_timestamps - # The type of the entry. Only used for Entries with types in the EntryType enum. + # The type of the entry. + # Only used for Entries with types in the EntryType enum. # Corresponds to the JSON property `type` # @return [String] attr_accessor :type # This field indicates the entry's source system that Data Catalog does not - # integrate with. `user_specified_system` strings must begin with a letter or - # underscore and can only contain letters, numbers, and underscores; are case - # insensitive; must be at least 1 character and at most 64 characters long. + # integrate with. `user_specified_system` strings must begin with a letter + # or underscore and can only contain letters, numbers, and underscores; are + # case insensitive; must be at least 1 character and at most 64 characters + # long. # Corresponds to the JSON property `userSpecifiedSystem` # @return [String] attr_accessor :user_specified_system - # Entry type if it does not fit any of the input-allowed values listed in ` - # EntryType` enum above. When creating an entry, users should check the enum - # values first, if nothing matches the entry to be created, then provide a - # custom value, for example "my_special_type". `user_specified_type` strings - # must begin with a letter or underscore and can only contain letters, numbers, - # and underscores; are case insensitive; must be at least 1 character and at - # most 64 characters long. Currently, only FILESET enum value is allowed. All - # other entries created through Data Catalog must use `user_specified_type`. + # Entry type if it does not fit any of the input-allowed values listed in + # `EntryType` enum above. When creating an entry, users should check the + # enum values first, if nothing matches the entry to be created, then + # provide a custom value, for example "my_special_type". + # `user_specified_type` strings must begin with a letter or underscore and + # can only contain letters, numbers, and underscores; are case insensitive; + # must be at least 1 character and at most 64 characters long. + # Currently, only FILESET enum value is allowed. All other entries created + # through Data Catalog must use `user_specified_type`. # Corresponds to the JSON property `userSpecifiedType` # @return [String] attr_accessor :user_specified_type @@ -443,8 +485,9 @@ module Google end end - # EntryGroup Metadata. An EntryGroup resource represents a logical grouping of - # zero or more Data Catalog Entry resources. + # EntryGroup Metadata. + # An EntryGroup resource represents a logical grouping of zero or more + # Data Catalog Entry resources. class GoogleCloudDatacatalogV1beta1EntryGroup include Google::Apis::Core::Hashable @@ -453,22 +496,23 @@ module Google # @return [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SystemTimestamps] attr_accessor :data_catalog_timestamps - # Entry group description, which can consist of several sentences or paragraphs - # that describe entry group contents. Default value is an empty string. + # Entry group description, which can consist of several sentences or + # paragraphs that describe entry group contents. Default value is an empty + # string. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # A short name to identify the entry group, for example, "analytics data - jan - # 2011". Default value is an empty string. + # A short name to identify the entry group, for example, + # "analytics data - jan 2011". Default value is an empty string. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # The resource name of the entry group in URL format. Example: * projects/` - # project_id`/locations/`location`/entryGroups/`entry_group_id` Note that this - # EntryGroup and its child resources may not actually be stored in the location - # in this name. + # The resource name of the entry group in URL format. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` + # Note that this EntryGroup and its child resources may not actually be + # stored in the location in this name. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -486,7 +530,8 @@ module Google end end - # Response message for ExportTaxonomies. + # Response message for + # ExportTaxonomies. class GoogleCloudDatacatalogV1beta1ExportTaxonomiesResponse include Google::Apis::Core::Hashable @@ -536,14 +581,14 @@ module Google # The set of allowed values for this enum. This set must not be empty, the # display names of the values in this set must not be empty and the display - # names of the values must be case-insensitively unique within this set. The - # order of items in this list is preserved. This field can be used to Required - # on create; optional on update. The set of allowed values for this enum. This - # set must not be empty, the display names of the values in this set must not be - # empty and the display names of the values must be case-insensitively unique - # within this set. Currently, enum values can only be added to the list of - # allowed values. Deletion and renaming of enum values are not supported. Can - # have up to 500 allowed values. + # names of the values must be case-insensitively unique within this set. + # The order of items in this list is preserved. This field can be used to + # Required on create; optional on update. The set of allowed values for + # this enum. This set must not be empty, the display names of the values in + # this set must not be empty and the display names of the values must be + # case-insensitively unique within this set. Currently, enum values can + # only be added to the list of allowed values. Deletion and renaming of + # enum values are not supported. Can have up to 500 allowed values. # Corresponds to the JSON property `allowedValues` # @return [Array] attr_accessor :allowed_values @@ -612,28 +657,38 @@ module Google class GoogleCloudDatacatalogV1beta1GcsFilesetSpec include Google::Apis::Core::Hashable - # Required. Patterns to identify a set of files in Google Cloud Storage. See [ - # Cloud Storage documentation](https://cloud.google.com/storage/docs/gsutil/ - # addlhelp/WildcardNames) for more information. Note that bucket wildcards are - # currently not supported. Examples of valid file_patterns: * `gs://bucket_name/ - # dir/*`: matches all files within `bucket_name/dir` directory. * `gs:// - # bucket_name/dir/**`: matches all files in `bucket_name/dir` spanning all - # subdirectories. * `gs://bucket_name/file*`: matches files prefixed by `file` - # in `bucket_name` * `gs://bucket_name/??.txt`: matches files with two - # characters followed by `.txt` in `bucket_name` * `gs://bucket_name/[aeiou].txt` - # : matches files that contain a single vowel character followed by `.txt` in ` - # bucket_name` * `gs://bucket_name/[a-m].txt`: matches files that contain `a`, ` - # b`, ... or `m` followed by `.txt` in `bucket_name` * `gs://bucket_name/a/*/b`: - # matches all files in `bucket_name` that match `a/*/b` pattern, such as `a/c/b`, - # `a/d/b` * `gs://another_bucket/a.txt`: matches `gs://another_bucket/a.txt` - # You can combine wildcards to provide more powerful matches, for example: * `gs: - # //bucket_name/[a-m]??.j*g` + # Required. Patterns to identify a set of files in Google Cloud Storage. + # See [Cloud Storage + # documentation](https://cloud.google.com/storage/docs/gsutil/addlhelp/ + # WildcardNames) + # for more information. Note that bucket wildcards are currently not + # supported. + # Examples of valid file_patterns: + # * `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir` + # directory. + # * `gs://bucket_name/dir/**`: matches all files in `bucket_name/dir` + # spanning all subdirectories. + # * `gs://bucket_name/file*`: matches files prefixed by `file` in + # `bucket_name` + # * `gs://bucket_name/??.txt`: matches files with two characters followed by + # `.txt` in `bucket_name` + # * `gs://bucket_name/[aeiou].txt`: matches files that contain a single + # vowel character followed by `.txt` in + # `bucket_name` + # * `gs://bucket_name/[a-m].txt`: matches files that contain `a`, `b`, ... + # or `m` followed by `.txt` in `bucket_name` + # * `gs://bucket_name/a/*/b`: matches all files in `bucket_name` that match + # `a/*/b` pattern, such as `a/c/b`, `a/d/b` + # * `gs://another_bucket/a.txt`: matches `gs://another_bucket/a.txt` + # You can combine wildcards to provide more powerful matches, for example: + # * `gs://bucket_name/[a-m]??.j*g` # Corresponds to the JSON property `filePatterns` # @return [Array] attr_accessor :file_patterns # Output only. Sample files contained in this fileset, not all files contained - # in this fileset are represented here. + # in this + # fileset are represented here. # Corresponds to the JSON property `sampleGcsFileSpecs` # @return [Array] attr_accessor :sample_gcs_file_specs @@ -649,7 +704,8 @@ module Google end end - # Request message for ImportTaxonomies. + # Request message for + # ImportTaxonomies. class GoogleCloudDatacatalogV1beta1ImportTaxonomiesRequest include Google::Apis::Core::Hashable @@ -668,7 +724,8 @@ module Google end end - # Response message for ImportTaxonomies. + # Response message for + # ImportTaxonomies. class GoogleCloudDatacatalogV1beta1ImportTaxonomiesResponse include Google::Apis::Core::Hashable @@ -706,7 +763,8 @@ module Google end end - # Response message for ListEntries. + # Response message for + # ListEntries. class GoogleCloudDatacatalogV1beta1ListEntriesResponse include Google::Apis::Core::Hashable @@ -732,7 +790,8 @@ module Google end end - # Response message for ListEntryGroups. + # Response message for + # ListEntryGroups. class GoogleCloudDatacatalogV1beta1ListEntryGroupsResponse include Google::Apis::Core::Hashable @@ -758,12 +817,13 @@ module Google end end - # Response message for ListPolicyTags. + # Response message for + # ListPolicyTags. class GoogleCloudDatacatalogV1beta1ListPolicyTagsResponse include Google::Apis::Core::Hashable - # Token used to retrieve the next page of results, or empty if there are no more - # results in the list. + # Token used to retrieve the next page of results, or empty if there are no + # more results in the list. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -784,7 +844,8 @@ module Google end end - # Response message for ListTags. + # Response message for + # ListTags. class GoogleCloudDatacatalogV1beta1ListTagsResponse include Google::Apis::Core::Hashable @@ -810,12 +871,13 @@ module Google end end - # Response message for ListTaxonomies. + # Response message for + # ListTaxonomies. class GoogleCloudDatacatalogV1beta1ListTaxonomiesResponse include Google::Apis::Core::Hashable - # Token used to retrieve the next page of results, or empty if there are no more - # results in the list. + # Token used to retrieve the next page of results, or empty if there are no + # more results in the list. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -836,10 +898,10 @@ module Google end end - # Denotes one policy tag in a taxonomy (e.g. ssn). Policy Tags can be defined in - # a hierarchy. For example, consider the following hierarchy: Geolocation -> ( - # LatLong, City, ZipCode). PolicyTag "Geolocation" contains three child policy - # tags: "LatLong", "City", and "ZipCode". + # Denotes one policy tag in a taxonomy (e.g. ssn). Policy Tags can be defined + # in a hierarchy. For example, consider the following hierarchy: + # Geolocation -> (LatLong, City, ZipCode). PolicyTag "Geolocation" + # contains three child policy tags: "LatLong", "City", and "ZipCode". class GoogleCloudDatacatalogV1beta1PolicyTag include Google::Apis::Core::Hashable @@ -848,34 +910,36 @@ module Google # @return [Array] attr_accessor :child_policy_tags - # Description of this policy tag. It must: contain only unicode characters, tabs, - # newlines, carriage returns and page breaks; and be at most 2000 bytes long - # when encoded in UTF-8. If not set, defaults to an empty description. If not - # set, defaults to an empty description. + # Description of this policy tag. It must: contain only unicode characters, + # tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes + # long when encoded in UTF-8. If not set, defaults to an empty description. + # If not set, defaults to an empty description. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description # Required. User defined name of this policy tag. It must: be unique within the - # parent taxonomy; contain only unicode letters, numbers, underscores, dashes - # and spaces; not start or end with spaces; and be at most 200 bytes long when + # parent + # taxonomy; contain only unicode letters, numbers, underscores, dashes and + # spaces; not start or end with spaces; and be at most 200 bytes long when # encoded in UTF-8. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # Output only. Resource name of this policy tag, whose format is: "projects/` - # project_number`/locations/`location_id`/taxonomies/`taxonomy_id`/policyTags/` - # id`". + # Output only. Resource name of this policy tag, whose format is: + # "projects/`project_number`/locations/`location_id`/taxonomies/`taxonomy_id`/ + # policyTags/`id`". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Resource name of this policy tag's parent policy tag (e.g. for the "LatLong" - # policy tag in the example above, this field contains the resource name of the " - # Geolocation" policy tag). If empty, it means this policy tag is a top level - # policy tag (e.g. this field is empty for the "Geolocation" policy tag in the - # example above). If not set, defaults to an empty string. + # Resource name of this policy tag's parent policy tag (e.g. for the + # "LatLong" policy tag in the example above, this field contains the + # resource name of the "Geolocation" policy tag). If empty, it means this + # policy tag is a top level policy tag (e.g. this field is empty for the + # "Geolocation" policy tag in the example above). If not set, defaults to an + # empty string. # Corresponds to the JSON property `parentPolicyTag` # @return [String] attr_accessor :parent_policy_tag @@ -894,7 +958,8 @@ module Google end end - # Request message for RenameTagTemplateFieldEnumValue. + # Request message for + # RenameTagTemplateFieldEnumValue. class GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldEnumValueRequest include Google::Apis::Core::Hashable @@ -914,7 +979,8 @@ module Google end end - # Request message for RenameTagTemplateField. + # Request message for + # RenameTagTemplateField. class GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest include Google::Apis::Core::Hashable @@ -938,7 +1004,8 @@ module Google include Google::Apis::Core::Hashable # Required. Schema of columns. A maximum of 10,000 columns and sub-columns can - # be specified. + # be + # specified. # Corresponds to the JSON property `columns` # @return [Array] attr_accessor :columns @@ -953,14 +1020,17 @@ module Google end end - # Request message for SearchCatalog. + # Request message for + # SearchCatalog. class GoogleCloudDatacatalogV1beta1SearchCatalogRequest include Google::Apis::Core::Hashable - # Specifies the ordering of results, currently supported case-sensitive choices - # are: * `relevance`, only supports descending * `last_modified_timestamp [asc| - # desc]`, defaults to descending if not specified If not specified, defaults to ` - # relevance` descending. + # Specifies the ordering of results, currently supported case-sensitive + # choices are: + # * `relevance`, only supports descending + # * `last_modified_timestamp [asc|desc]`, defaults to descending if not + # specified + # If not specified, defaults to `relevance` descending. # Corresponds to the JSON property `orderBy` # @return [String] attr_accessor :order_by @@ -971,20 +1041,25 @@ module Google # @return [Fixnum] attr_accessor :page_size - # Optional. Pagination token returned in an earlier SearchCatalogResponse. - # next_page_token, which indicates that this is a continuation of a prior - # SearchCatalogRequest call, and that the system should return the next page of - # data. If empty, the first page is returned. + # Optional. Pagination token returned in an earlier + # SearchCatalogResponse.next_page_token, which + # indicates that this is a continuation of a prior + # SearchCatalogRequest + # call, and that the system should return the next page of data. If empty, + # the first page is returned. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token # Required. The query string in search query syntax. The query must be non-empty. - # Query strings can be simple as "x" or more qualified as: * name:x * column:x * - # description:y Note: Query tokens need to have a minimum of 3 characters for - # substring matching to work correctly. See [Data Catalog Search Syntax](https:// - # cloud.google.com/data-catalog/docs/how-to/search-reference) for more - # information. + # Query strings can be simple as "x" or more qualified as: + # * name:x + # * column:x + # * description:y + # Note: Query tokens need to have a minimum of 3 characters for substring + # matching to work correctly. See [Data Catalog Search + # Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + # for more information. # Corresponds to the JSON property `query` # @return [String] attr_accessor :query @@ -1012,40 +1087,63 @@ module Google class GoogleCloudDatacatalogV1beta1SearchCatalogRequestScope include Google::Apis::Core::Hashable - # If `true`, include Google Cloud Platform (GCP) public datasets in the search - # results. Info on GCP public datasets is available at https://cloud.google.com/ - # public-datasets/. By default, GCP public datasets are excluded. + # If `true`, include Google Cloud Platform (GCP) public datasets in the + # search results. Info on GCP public datasets is available at + # https://cloud.google.com/public-datasets/. By default, GCP public + # datasets are excluded. # Corresponds to the JSON property `includeGcpPublicDatasets` # @return [Boolean] attr_accessor :include_gcp_public_datasets alias_method :include_gcp_public_datasets?, :include_gcp_public_datasets - # The list of organization IDs to search within. To find your organization ID, - # follow instructions in https://cloud.google.com/resource-manager/docs/creating- - # managing-organization. + # The list of organization IDs to search within. To find your organization + # ID, follow instructions in + # https://cloud.google.com/resource-manager/docs/creating-managing-organization. # Corresponds to the JSON property `includeOrgIds` # @return [Array] attr_accessor :include_org_ids - # The list of project IDs to search within. To learn more about the distinction - # between project names/IDs/numbers, go to https://cloud.google.com/docs/ - # overview/#projects. + # The list of project IDs to search within. To learn more about the + # distinction between project names/IDs/numbers, go to + # https://cloud.google.com/docs/overview/#projects. # Corresponds to the JSON property `includeProjectIds` # @return [Array] attr_accessor :include_project_ids - # Optional. The list of locations to search within. 1. If empty, search will be - # performed in all locations; 2. If any of the locations are NOT in the valid - # locations list, error will be returned; 3. Otherwise, search only the given - # locations for matching results. Typical usage is to leave this field empty. - # When a location is unreachable as returned in the `SearchCatalogResponse. - # unreachable` field, users can repeat the search request with this parameter - # set to get additional information on the error. Valid locations: * asia-east1 * - # asia-east2 * asia-northeast1 * asia-northeast2 * asia-northeast3 * asia- - # south1 * asia-southeast1 * australia-southeast1 * eu * europe-north1 * europe- - # west1 * europe-west2 * europe-west3 * europe-west4 * europe-west6 * global * - # northamerica-northeast1 * southamerica-east1 * us * us-central1 * us-east1 * - # us-east4 * us-west1 * us-west2 + # Optional. The list of locations to search within. + # 1. If empty, search will be performed in all locations; + # 2. If any of the locations are NOT in the valid locations list, error + # will be returned; + # 3. Otherwise, search only the given locations for matching results. + # Typical usage is to leave this field empty. When a location is + # unreachable as returned in the `SearchCatalogResponse.unreachable` field, + # users can repeat the search request with this parameter set to get + # additional information on the error. + # Valid locations: + # * asia-east1 + # * asia-east2 + # * asia-northeast1 + # * asia-northeast2 + # * asia-northeast3 + # * asia-south1 + # * asia-southeast1 + # * australia-southeast1 + # * eu + # * europe-north1 + # * europe-west1 + # * europe-west2 + # * europe-west3 + # * europe-west4 + # * europe-west6 + # * global + # * northamerica-northeast1 + # * southamerica-east1 + # * us + # * us-central1 + # * us-east1 + # * us-east4 + # * us-west1 + # * us-west2 # Corresponds to the JSON property `restrictedLocations` # @return [Array] attr_accessor :restricted_locations @@ -1063,7 +1161,8 @@ module Google end end - # Response message for SearchCatalog. + # Response message for + # SearchCatalog. class GoogleCloudDatacatalogV1beta1SearchCatalogResponse include Google::Apis::Core::Hashable @@ -1078,9 +1177,9 @@ module Google attr_accessor :results # Unreachable locations. Search result does not include data from those - # locations. Users can get additional information on the error by repeating the - # search request with a more restrictive parameter -- setting the value for ` - # SearchDataCatalogRequest.scope.include_locations`. + # locations. Users can get additional information on the error by repeating + # the search request with a more restrictive parameter -- setting the value + # for `SearchDataCatalogRequest.scope.include_locations`. # Corresponds to the JSON property `unreachable` # @return [Array] attr_accessor :unreachable @@ -1102,24 +1201,28 @@ module Google class GoogleCloudDatacatalogV1beta1SearchCatalogResult include Google::Apis::Core::Hashable - # The full name of the cloud resource the entry belongs to. See: https://cloud. - # google.com/apis/design/resource_names#full_resource_name. Example: * `// - # bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId` + # The full name of the cloud resource the entry belongs to. See: + # https://cloud.google.com/apis/design/resource_names#full_resource_name. + # Example: + # * `//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/ + # tableId` # Corresponds to the JSON property `linkedResource` # @return [String] attr_accessor :linked_resource - # The relative resource name of the resource in URL format. Examples: * ` - # projects/`project_id`/locations/`location_id`/entryGroups/`entry_group_id`/ - # entries/`entry_id`` * `projects/`project_id`/tagTemplates/`tag_template_id`` + # The relative resource name of the resource in URL format. + # Examples: + # * `projects/`project_id`/locations/`location_id`/entryGroups/`entry_group_id`/ + # entries/`entry_id`` + # * `projects/`project_id`/tagTemplates/`tag_template_id`` # Corresponds to the JSON property `relativeResourceName` # @return [String] attr_accessor :relative_resource_name # Sub-type of the search result. This is a dot-delimited description of the # resource's full type, and is the same as the value callers would provide in - # the "type" search facet. Examples: `entry.table`, `entry.dataStream`, ` - # tagTemplate`. + # the "type" search facet. Examples: `entry.table`, `entry.dataStream`, + # `tagTemplate`. # Corresponds to the JSON property `searchResultSubtype` # @return [String] attr_accessor :search_result_subtype @@ -1152,9 +1255,9 @@ module Google # @return [Array] attr_accessor :child_policy_tags - # Description of the serialized policy tag. The length of the description is - # limited to 2000 bytes when encoded in UTF-8. If not set, defaults to an empty - # description. + # Description of the serialized policy tag. The length of the + # description is limited to 2000 bytes when encoded in UTF-8. If not set, + # defaults to an empty description. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description @@ -1164,8 +1267,8 @@ module Google # @return [String] attr_accessor :display_name - # Resource name of the policy tag. This field will be ignored when calling - # ImportTaxonomies. + # Resource name of the policy tag. + # This field will be ignored when calling ImportTaxonomies. # Corresponds to the JSON property `policyTag` # @return [String] attr_accessor :policy_tag @@ -1188,9 +1291,9 @@ module Google class GoogleCloudDatacatalogV1beta1SerializedTaxonomy include Google::Apis::Core::Hashable - # Description of the serialized taxonomy. The length of the description is - # limited to 2000 bytes when encoded in UTF-8. If not set, defaults to an empty - # description. + # Description of the serialized taxonomy. The length of the + # description is limited to 2000 bytes when encoded in UTF-8. If not set, + # defaults to an empty description. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description @@ -1254,10 +1357,12 @@ module Google include Google::Apis::Core::Hashable # Output only. If the table is a dated shard, i.e., with name pattern `[prefix] - # YYYYMMDD`, `grouped_entry` is the Data Catalog resource name of the date - # sharded grouped entry, for example, `projects/`project_id`/locations/`location` - # /entrygroups/`entry_group_id`/entries/`entry_id``. Otherwise, `grouped_entry` - # is empty. + # YYYYMMDD`, + # `grouped_entry` is the Data Catalog resource name of the date sharded + # grouped entry, for example, + # `projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/ + # entries/`entry_id``. + # Otherwise, `grouped_entry` is empty. # Corresponds to the JSON property `groupedEntry` # @return [String] attr_accessor :grouped_entry @@ -1273,38 +1378,42 @@ module Google end # Tags are used to attach custom metadata to Data Catalog resources. Tags - # conform to the specifications within their tag template. See [Data Catalog IAM] - # (https://cloud.google.com/data-catalog/docs/concepts/iam) for information on - # the permissions needed to create or view tags. + # conform to the specifications within their tag template. + # See [Data Catalog + # IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for information + # on the permissions needed to create or view tags. class GoogleCloudDatacatalogV1beta1Tag include Google::Apis::Core::Hashable - # Resources like Entry can have schemas associated with them. This scope allows - # users to attach tags to an individual column based on that schema. For - # attaching a tag to a nested column, use `.` to separate the column names. - # Example: * `outer_column.inner_column` + # Resources like Entry can have schemas associated with them. This scope + # allows users to attach tags to an individual column based on that schema. + # For attaching a tag to a nested column, use `.` to separate the column + # names. Example: + # * `outer_column.inner_column` # Corresponds to the JSON property `column` # @return [String] attr_accessor :column # Required. This maps the ID of a tag field to the value of and additional - # information about that field. Valid field IDs are defined by the tag's - # template. A tag must have at least 1 field and at most 500 fields. + # information + # about that field. Valid field IDs are defined by the tag's template. A tag + # must have at least 1 field and at most 500 fields. # Corresponds to the JSON property `fields` # @return [Hash] attr_accessor :fields - # The resource name of the tag in URL format. Example: * projects/`project_id`/ - # locations/`location`/entrygroups/`entry_group_id`/entries/`entry_id`/tags/` - # tag_id` where `tag_id` is a system-generated identifier. Note that this Tag - # may not actually be stored in the location in this name. + # The resource name of the tag in URL format. Example: + # * projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/ + # entries/`entry_id`/tags/`tag_id` + # where `tag_id` is a system-generated identifier. + # Note that this Tag may not actually be stored in the location in this name. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Required. The resource name of the tag template that this tag uses. Example: * - # projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` This - # field cannot be modified after creation. + # Required. The resource name of the tag template that this tag uses. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` + # This field cannot be modified after creation. # Corresponds to the JSON property `template` # @return [String] attr_accessor :template @@ -1328,7 +1437,8 @@ module Google end end - # Contains the value and supporting information for a field within a Tag. + # Contains the value and supporting information for a field within + # a Tag. class GoogleCloudDatacatalogV1beta1TagField include Google::Apis::Core::Hashable @@ -1354,9 +1464,11 @@ module Google attr_accessor :enum_value # Output only. The order of this field with respect to other fields in this tag. - # It can be set in Tag. For example, a higher value can indicate a more - # important field. The value can be negative. Multiple fields can have the same - # order, and field orders within a tag do not have to be sequential. + # It can be + # set in Tag. For + # example, a higher value can indicate a more important field. The value can + # be negative. Multiple fields can have the same order, and field orders + # within a tag do not have to be sequential. # Corresponds to the JSON property `order` # @return [Fixnum] attr_accessor :order @@ -1406,13 +1518,15 @@ module Google end end - # A tag template defines a tag, which can have one or more typed fields. The - # template is used to create and attach the tag to GCP resources. [Tag template + # A tag template defines a tag, which can have one or more typed fields. + # The template is used to create and attach the tag to GCP resources. + # [Tag template # roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog- - # roles) provide permissions to create, edit, and use the template. See, for - # example, the [TagTemplate User](https://cloud.google.com/data-catalog/docs/how- - # to/template-user) role, which includes permission to use the tag template to - # tag resources. + # roles) + # provide permissions to create, edit, and use the template. See, for example, + # the [TagTemplate + # User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role, + # which includes permission to use the tag template to tag resources. class GoogleCloudDatacatalogV1beta1TagTemplate include Google::Apis::Core::Hashable @@ -1421,21 +1535,21 @@ module Google # @return [String] attr_accessor :display_name - # Required. Map of tag template field IDs to the settings for the field. This - # map is an exhaustive list of the allowed fields. This map must contain at - # least one field and at most 500 fields. The keys to this map are tag template - # field IDs. Field IDs can contain letters (both uppercase and lowercase), - # numbers (0-9) and underscores (_). Field IDs must be at least 1 character long - # and at most 64 characters long. Field IDs must start with a letter or - # underscore. + # Required. Map of tag template field IDs to the settings for the field. + # This map is an exhaustive list of the allowed fields. This map must contain + # at least one field and at most 500 fields. + # The keys to this map are tag template field IDs. Field IDs can contain + # letters (both uppercase and lowercase), numbers (0-9) and underscores (_). + # Field IDs must be at least 1 character long and at most + # 64 characters long. Field IDs must start with a letter or underscore. # Corresponds to the JSON property `fields` # @return [Hash] attr_accessor :fields - # The resource name of the tag template in URL format. Example: * projects/` - # project_id`/locations/`location`/tagTemplates/`tag_template_id` Note that this - # TagTemplate and its child resources may not actually be stored in the location - # in this name. + # The resource name of the tag template in URL format. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` + # Note that this TagTemplate and its child resources may not actually be + # stored in the location in this name. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -1468,17 +1582,19 @@ module Google alias_method :is_required?, :is_required # Output only. The resource name of the tag template field in URL format. - # Example: * projects/`project_id`/locations/`location`/tagTemplates/` - # tag_template`/fields/`field` Note that this TagTemplateField may not actually - # be stored in the location in this name. + # Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template`/ + # fields/`field` + # Note that this TagTemplateField may not actually be stored in the location + # in this name. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The order of this field with respect to other fields in this tag template. A - # higher value indicates a more important field. The value can be negative. - # Multiple fields can have the same order, and field orders within a tag do not - # have to be sequential. + # The order of this field with respect to other fields in this tag + # template. A higher value indicates a more important field. The value can + # be negative. Multiple fields can have the same order, and field orders + # within a tag do not have to be sequential. # Corresponds to the JSON property `order` # @return [Fixnum] attr_accessor :order @@ -1511,28 +1627,30 @@ module Google include Google::Apis::Core::Hashable # Optional. A list of policy types that are activated for this taxonomy. If not - # set, defaults to an empty list. + # set, + # defaults to an empty list. # Corresponds to the JSON property `activatedPolicyTypes` # @return [Array] attr_accessor :activated_policy_types # Optional. Description of this taxonomy. It must: contain only unicode - # characters, tabs, newlines, carriage returns and page breaks; and be at most - # 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty - # description. + # characters, + # tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes + # long when encoded in UTF-8. If not set, defaults to an empty description. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description # Required. User defined name of this taxonomy. It must: contain only unicode - # letters, numbers, underscores, dashes and spaces; not start or end with spaces; - # and be at most 200 bytes long when encoded in UTF-8. + # letters, + # numbers, underscores, dashes and spaces; not start or end with spaces; and + # be at most 200 bytes long when encoded in UTF-8. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # Output only. Resource name of this taxonomy, whose format is: "projects/` - # project_number`/locations/`location_id`/taxonomies/`id`". + # Output only. Resource name of this taxonomy, whose format is: + # "projects/`project_number`/locations/`location_id`/taxonomies/`id`". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -1570,73 +1688,111 @@ module Google end # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. - # A `binding` binds one or more `members` to a single `role`. Members can be - # user accounts, service accounts, Google groups, and domains (such as G Suite). - # A `role` is a named list of permissions; each `role` can be an IAM predefined - # role or a user-created custom role. For some types of Google Cloud resources, - # a `binding` can also specify a `condition`, which is a logical expression that - # allows access to a resource only if the expression evaluates to `true`. A - # condition can add constraints based on attributes of the request, the resource, - # or both. To learn which resources support conditions in their IAM policies, - # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ - # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ - # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " - # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ - # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. - # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " - # title": "expirable access", "description": "Does not grant access after Sep - # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` - # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - - # members: - user:mike@example.com - group:admins@example.com - domain:google. - # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ - # resourcemanager.organizationAdmin - members: - user:eve@example.com role: - # roles/resourcemanager.organizationViewer condition: title: expirable access - # description: Does not grant access after Sep 2020 expression: request.time < - # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a - # description of IAM and its features, see the [IAM documentation](https://cloud. - # google.com/iam/docs/). + # controls for Google Cloud resources. + # A `Policy` is a collection of `bindings`. A `binding` binds one or more + # `members` to a single `role`. Members can be user accounts, service accounts, + # Google groups, and domains (such as G Suite). A `role` is a named list of + # permissions; each `role` can be an IAM predefined role or a user-created + # custom role. + # For some types of Google Cloud resources, a `binding` can also specify a + # `condition`, which is a logical expression that allows access to a resource + # only if the expression evaluates to `true`. A condition can add constraints + # based on attributes of the request, the resource, or both. To learn which + # resources support conditions in their IAM policies, see the + # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- + # policies). + # **JSON example:** + # ` + # "bindings": [ + # ` + # "role": "roles/resourcemanager.organizationAdmin", + # "members": [ + # "user:mike@example.com", + # "group:admins@example.com", + # "domain:google.com", + # "serviceAccount:my-project-id@appspot.gserviceaccount.com" + # ] + # `, + # ` + # "role": "roles/resourcemanager.organizationViewer", + # "members": [ + # "user:eve@example.com" + # ], + # "condition": ` + # "title": "expirable access", + # "description": "Does not grant access after Sep 2020", + # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') + # ", + # ` + # ` + # ], + # "etag": "BwWWja0YfJA=", + # "version": 3 + # ` + # **YAML example:** + # bindings: + # - members: + # - user:mike@example.com + # - group:admins@example.com + # - domain:google.com + # - serviceAccount:my-project-id@appspot.gserviceaccount.com + # role: roles/resourcemanager.organizationAdmin + # - members: + # - user:eve@example.com + # role: roles/resourcemanager.organizationViewer + # condition: + # title: expirable access + # description: Does not grant access after Sep 2020 + # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') + # - etag: BwWWja0YfJA= + # - version: 3 + # For a description of IAM and its features, see the + # [IAM documentation](https://cloud.google.com/iam/docs/). class Policy include Google::Apis::Core::Hashable - # Associates a list of `members` to a `role`. Optionally, may specify a ` - # condition` that determines how and when the `bindings` are applied. Each of - # the `bindings` must contain at least one member. + # Associates a list of `members` to a `role`. Optionally, may specify a + # `condition` that determines how and when the `bindings` are applied. Each + # of the `bindings` must contain at least one member. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings - # `etag` is used for optimistic concurrency control as a way to help prevent - # simultaneous updates of a policy from overwriting each other. It is strongly - # suggested that systems make use of the `etag` in the read-modify-write cycle - # to perform policy updates in order to avoid race conditions: An `etag` is - # returned in the response to `getIamPolicy`, and systems are expected to put - # that etag in the request to `setIamPolicy` to ensure that their change will be - # applied to the same version of the policy. **Important:** If you use IAM - # Conditions, you must include the `etag` field whenever you call `setIamPolicy`. - # If you omit this field, then IAM allows you to overwrite a version `3` policy - # with a version `1` policy, and all of the conditions in the version `3` policy - # are lost. + # `etag` is used for optimistic concurrency control as a way to help + # prevent simultaneous updates of a policy from overwriting each other. + # It is strongly suggested that systems make use of the `etag` in the + # read-modify-write cycle to perform policy updates in order to avoid race + # conditions: An `etag` is returned in the response to `getIamPolicy`, and + # systems are expected to put that etag in the request to `setIamPolicy` to + # ensure that their change will be applied to the same version of the policy. + # **Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows + # you to overwrite a version `3` policy with a version `1` policy, and all of + # the conditions in the version `3` policy are lost. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. - # Requests that specify an invalid value are rejected. Any operation that - # affects conditional role bindings must specify version `3`. This requirement - # applies to the following operations: * Getting a policy that includes a - # conditional role binding * Adding a conditional role binding to a policy * - # Changing a conditional role binding in a policy * Removing any role binding, - # with or without a condition, from a policy that includes conditions ** - # Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you - # to overwrite a version `3` policy with a version `1` policy, and all of the - # conditions in the version `3` policy are lost. If a policy does not include - # any conditions, operations on that policy may specify any valid version or - # leave the field unset. To learn which resources support conditions in their - # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/ - # conditions/resource-policies). + # Specifies the format of the policy. + # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value + # are rejected. + # Any operation that affects conditional role bindings must specify version + # `3`. This requirement applies to the following operations: + # * Getting a policy that includes a conditional role binding + # * Adding a conditional role binding to a policy + # * Changing a conditional role binding in a policy + # * Removing any role binding, with or without a condition, from a policy + # that includes conditions + # **Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows + # you to overwrite a version `3` policy with a version `1` policy, and all of + # the conditions in the version `3` policy are lost. + # If a policy does not include any conditions, operations on that policy may + # specify any valid version or leave the field unset. + # To learn which resources support conditions in their IAM policies, see the + # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- + # policies). # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version @@ -1658,32 +1814,66 @@ module Google include Google::Apis::Core::Hashable # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. - # A `binding` binds one or more `members` to a single `role`. Members can be - # user accounts, service accounts, Google groups, and domains (such as G Suite). - # A `role` is a named list of permissions; each `role` can be an IAM predefined - # role or a user-created custom role. For some types of Google Cloud resources, - # a `binding` can also specify a `condition`, which is a logical expression that - # allows access to a resource only if the expression evaluates to `true`. A - # condition can add constraints based on attributes of the request, the resource, - # or both. To learn which resources support conditions in their IAM policies, - # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ - # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ - # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " - # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ - # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. - # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " - # title": "expirable access", "description": "Does not grant access after Sep - # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` - # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - - # members: - user:mike@example.com - group:admins@example.com - domain:google. - # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ - # resourcemanager.organizationAdmin - members: - user:eve@example.com role: - # roles/resourcemanager.organizationViewer condition: title: expirable access - # description: Does not grant access after Sep 2020 expression: request.time < - # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a - # description of IAM and its features, see the [IAM documentation](https://cloud. - # google.com/iam/docs/). + # controls for Google Cloud resources. + # A `Policy` is a collection of `bindings`. A `binding` binds one or more + # `members` to a single `role`. Members can be user accounts, service accounts, + # Google groups, and domains (such as G Suite). A `role` is a named list of + # permissions; each `role` can be an IAM predefined role or a user-created + # custom role. + # For some types of Google Cloud resources, a `binding` can also specify a + # `condition`, which is a logical expression that allows access to a resource + # only if the expression evaluates to `true`. A condition can add constraints + # based on attributes of the request, the resource, or both. To learn which + # resources support conditions in their IAM policies, see the + # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- + # policies). + # **JSON example:** + # ` + # "bindings": [ + # ` + # "role": "roles/resourcemanager.organizationAdmin", + # "members": [ + # "user:mike@example.com", + # "group:admins@example.com", + # "domain:google.com", + # "serviceAccount:my-project-id@appspot.gserviceaccount.com" + # ] + # `, + # ` + # "role": "roles/resourcemanager.organizationViewer", + # "members": [ + # "user:eve@example.com" + # ], + # "condition": ` + # "title": "expirable access", + # "description": "Does not grant access after Sep 2020", + # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') + # ", + # ` + # ` + # ], + # "etag": "BwWWja0YfJA=", + # "version": 3 + # ` + # **YAML example:** + # bindings: + # - members: + # - user:mike@example.com + # - group:admins@example.com + # - domain:google.com + # - serviceAccount:my-project-id@appspot.gserviceaccount.com + # role: roles/resourcemanager.organizationAdmin + # - members: + # - user:eve@example.com + # role: roles/resourcemanager.organizationViewer + # condition: + # title: expirable access + # description: Does not grant access after Sep 2020 + # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') + # - etag: BwWWja0YfJA= + # - version: 3 + # For a description of IAM and its features, see the + # [IAM documentation](https://cloud.google.com/iam/docs/). # Corresponds to the JSON property `policy` # @return [Google::Apis::DatacatalogV1beta1::Policy] attr_accessor :policy @@ -1702,9 +1892,10 @@ module Google class TestIamPermissionsRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with wildcards - # (such as '*' or 'storage.*') are not allowed. For more information see [IAM - # Overview](https://cloud.google.com/iam/docs/overview#permissions). + # The set of permissions to check for the `resource`. Permissions with + # wildcards (such as '*' or 'storage.*') are not allowed. For more + # information see + # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -1723,7 +1914,8 @@ module Google class TestIamPermissionsResponse include Google::Apis::Core::Hashable - # A subset of `TestPermissionsRequest.permissions` that the caller is allowed. + # A subset of `TestPermissionsRequest.permissions` that the caller is + # allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions diff --git a/generated/google/apis/datacatalog_v1beta1/service.rb b/generated/google/apis/datacatalog_v1beta1/service.rb index 864cdce9a..c9060ab55 100644 --- a/generated/google/apis/datacatalog_v1beta1/service.rb +++ b/generated/google/apis/datacatalog_v1beta1/service.rb @@ -48,15 +48,19 @@ module Google @batch_path = 'batch' end - # Searches Data Catalog for multiple resources like entries, tags that match a - # query. This is a custom method (https://cloud.google.com/apis/design/ - # custom_methods) and does not return the complete resource, only the resource - # identifier and high level fields. Clients can subsequentally call `Get` - # methods. Note that Data Catalog search queries do not guarantee full recall. - # Query results that match your query may not be returned, even in subsequent + # Searches Data Catalog for multiple resources like entries, tags that + # match a query. + # This is a custom method + # (https://cloud.google.com/apis/design/custom_methods) and does not return + # the complete resource, only the resource identifier and high level + # fields. Clients can subsequentally call `Get` methods. + # Note that Data Catalog search queries do not guarantee full recall. Query + # results that match your query may not be returned, even in subsequent # result pages. Also note that results returned (and not returned) can vary - # across repeated search queries. See [Data Catalog Search Syntax](https://cloud. - # google.com/data-catalog/docs/how-to/search-reference) for more information. + # across repeated search queries. + # See [Data Catalog Search + # Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + # for more information. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1SearchCatalogRequest] google_cloud_datacatalog_v1beta1_search_catalog_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -86,22 +90,28 @@ module Google execute_or_queue_command(command, &block) end - # Get an entry by target resource name. This method allows clients to use the - # resource name from the source Google Cloud Platform service to get the Data - # Catalog Entry. + # Get an entry by target resource name. This method allows clients to use + # the resource name from the source Google Cloud Platform service to get the + # Data Catalog Entry. # @param [String] linked_resource - # The full name of the Google Cloud Platform resource the Data Catalog entry - # represents. See: https://cloud.google.com/apis/design/resource_names# - # full_resource_name. Full names are case-sensitive. Examples: * //bigquery. - # googleapis.com/projects/projectId/datasets/datasetId/tables/tableId * //pubsub. - # googleapis.com/projects/projectId/topics/topicId + # The full name of the Google Cloud Platform resource the Data Catalog + # entry represents. See: + # https://cloud.google.com/apis/design/resource_names#full_resource_name. + # Full names are case-sensitive. + # Examples: + # * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/ + # tableId + # * //pubsub.googleapis.com/projects/projectId/topics/topicId # @param [String] sql_resource - # The SQL name of the entry. SQL names are case-sensitive. Examples: * `pubsub. - # project_id.topic_id` * ``pubsub.project_id.`topic.id.with.dots` `` * `bigquery. - # table.project_id.dataset_id.table_id` * `bigquery.dataset.project_id. - # dataset_id` * `datacatalog.entry.project_id.location_id.entry_group_id. - # entry_id` `*_id`s shoud satisfy the standard SQL rules for identifiers. https:/ - # /cloud.google.com/bigquery/docs/reference/standard-sql/lexical. + # The SQL name of the entry. SQL names are case-sensitive. + # Examples: + # * `pubsub.project_id.topic_id` + # * ``pubsub.project_id.`topic.id.with.dots` `` + # * `bigquery.table.project_id.dataset_id.table_id` + # * `bigquery.dataset.project_id.dataset_id` + # * `datacatalog.entry.project_id.location_id.entry_group_id.entry_id` + # `*_id`s shoud satisfy the standard SQL rules for identifiers. + # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -131,18 +141,21 @@ module Google end # A maximum of 10,000 entry groups may be created per organization across all - # locations. Users should enable the Data Catalog API in the project identified - # by the `parent` parameter (see [Data Catalog Resource Project] (https://cloud. - # google.com/data-catalog/docs/concepts/resource-project) for more information). + # locations. + # Users should enable the Data Catalog API in the project identified by + # the `parent` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] parent - # Required. The name of the project this entry group is in. Example: * projects/` - # project_id`/locations/`location` Note that this EntryGroup and its child - # resources may not actually be stored in the location in this name. + # Required. The name of the project this entry group is in. Example: + # * projects/`project_id`/locations/`location` + # Note that this EntryGroup and its child resources may not actually be + # stored in the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup] google_cloud_datacatalog_v1beta1_entry_group_object # @param [String] entry_group_id - # Required. The id of the entry group to create. The id must begin with a letter - # or underscore, contain only English letters, numbers and underscores, and be - # at most 64 characters. + # Required. The id of the entry group to create. + # The id must begin with a letter or underscore, contain only English + # letters, numbers and underscores, and be at most 64 characters. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -174,12 +187,13 @@ module Google end # Deletes an EntryGroup. Only entry groups that do not contain entries can be - # deleted. Users should enable the Data Catalog API in the project identified by - # the `name` parameter (see [Data Catalog Resource Project] (https://cloud. - # google.com/data-catalog/docs/concepts/resource-project) for more information). + # deleted. Users should enable the Data Catalog API in the project + # identified by the `name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # Required. The name of the entry group. For example, `projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id``. + # Required. The name of the entry group. For example, + # `projects/`project_id`/locations/`location`/entryGroups/`entry_group_id``. # @param [Boolean] force # Optional. If true, deletes all entries in the entry group. # @param [String] fields @@ -212,8 +226,8 @@ module Google # Gets an EntryGroup. # @param [String] name - # Required. The name of the entry group. For example, `projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id``. + # Required. The name of the entry group. For example, + # `projects/`project_id`/locations/`location`/entryGroups/`entry_group_id``. # @param [String] read_mask # The fields to return. If not set or empty, all fields are returned. # @param [String] fields @@ -244,18 +258,23 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a resource. A `NOT_FOUND` error is returned - # if the resource does not exist. An empty policy is returned if the resource - # exists but does not have a policy set on it. Supported resources are: - Tag - # templates. - Entries. - Entry groups. Note, this method cannot be used to - # manage policies for BigQuery, Pub/Sub and any external Google Cloud Platform - # resources synced to Data Catalog. Callers must have following Google IAM - # permission - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag - # templates. - `datacatalog.entries.getIamPolicy` to get policies on entries. - ` - # datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. + # Gets the access control policy for a resource. A `NOT_FOUND` error + # is returned if the resource does not exist. An empty policy is returned + # if the resource exists but does not have a policy set on it. + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # Callers must have following Google IAM permission + # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + # templates. + # - `datacatalog.entries.getIamPolicy` to get policies on entries. + # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -289,14 +308,17 @@ module Google # Lists entry groups. # @param [String] parent # Required. The name of the location that contains the entry groups, which can - # be provided in URL format. Example: * projects/`project_id`/locations/` - # location` + # be + # provided in URL format. Example: + # * projects/`project_id`/locations/`location` # @param [Fixnum] page_size # Optional. The maximum number of items to return. Default is 10. Max limit is - # 1000. Throws an invalid argument for `page_size > 1000`. + # 1000. + # Throws an invalid argument for `page_size > 1000`. # @param [String] page_token # Optional. Token that specifies which page is requested. If empty, the first - # page is returned. + # page is + # returned. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -328,13 +350,14 @@ module Google # Updates an EntryGroup. The user should enable the Data Catalog API in the # project identified by the `entry_group.name` parameter (see [Data Catalog - # Resource Project] (https://cloud.google.com/data-catalog/docs/concepts/ - # resource-project) for more information). + # Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # The resource name of the entry group in URL format. Example: * projects/` - # project_id`/locations/`location`/entryGroups/`entry_group_id` Note that this - # EntryGroup and its child resources may not actually be stored in the location - # in this name. + # The resource name of the entry group in URL format. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` + # Note that this EntryGroup and its child resources may not actually be + # stored in the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1EntryGroup] google_cloud_datacatalog_v1beta1_entry_group_object # @param [String] update_mask # The fields to update on the entry group. If absent or empty, all modifiable @@ -369,17 +392,22 @@ module Google execute_or_queue_command(command, &block) end - # Sets the access control policy for a resource. Replaces any existing policy. - # Supported resources are: - Tag templates. - Entries. - Entry groups. Note, - # this method cannot be used to manage policies for BigQuery, Pub/Sub and any - # external Google Cloud Platform resources synced to Data Catalog. Callers must - # have following Google IAM permission - `datacatalog.tagTemplates.setIamPolicy` - # to set policies on tag templates. - `datacatalog.entries.setIamPolicy` to set - # policies on entries. - `datacatalog.entryGroups.setIamPolicy` to set policies - # on entry groups. + # Sets the access control policy for a resource. Replaces any existing + # policy. + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # Callers must have following Google IAM permission + # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag + # templates. + # - `datacatalog.entries.setIamPolicy` to set policies on entries. + # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -410,15 +438,20 @@ module Google execute_or_queue_command(command, &block) end - # Returns the caller's permissions on a resource. If the resource does not exist, - # an empty set of permissions is returned (We don't return a `NOT_FOUND` error). - # Supported resources are: - Tag templates. - Entries. - Entry groups. Note, - # this method cannot be used to manage policies for BigQuery, Pub/Sub and any - # external Google Cloud Platform resources synced to Data Catalog. A caller is - # not required to have Google IAM permission to make this request. + # Returns the caller's permissions on a resource. + # If the resource does not exist, an empty set of permissions is returned + # (We don't return a `NOT_FOUND` error). + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # A caller is not required to have Google IAM permission to make this + # request. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -449,16 +482,18 @@ module Google execute_or_queue_command(command, &block) end - # Creates an entry. Only entries of 'FILESET' type or user-specified type can be - # created. Users should enable the Data Catalog API in the project identified by - # the `parent` parameter (see [Data Catalog Resource Project] (https://cloud. - # google.com/data-catalog/docs/concepts/resource-project) for more information). + # Creates an entry. Only entries of 'FILESET' type or user-specified type can + # be created. + # Users should enable the Data Catalog API in the project identified by + # the `parent` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # A maximum of 100,000 entries may be created per entry group. # @param [String] parent - # Required. The name of the entry group this entry is in. Example: * projects/` - # project_id`/locations/`location`/entryGroups/`entry_group_id` Note that this - # Entry and its child resources may not actually be stored in the location in - # this name. + # Required. The name of the entry group this entry is in. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` + # Note that this Entry and its child resources may not actually be stored in + # the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] google_cloud_datacatalog_v1beta1_entry_object # @param [String] entry_id # Required. The id of the entry to create. @@ -492,13 +527,17 @@ module Google execute_or_queue_command(command, &block) end - # Deletes an existing entry. Only entries created through CreateEntry method can - # be deleted. Users should enable the Data Catalog API in the project identified - # by the `name` parameter (see [Data Catalog Resource Project] (https://cloud. - # google.com/data-catalog/docs/concepts/resource-project) for more information). + # Deletes an existing entry. Only entries created through + # CreateEntry + # method can be deleted. + # Users should enable the Data Catalog API in the project identified by + # the `name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # Required. The name of the entry. Example: * projects/`project_id`/locations/` - # location`/entryGroups/`entry_group_id`/entries/`entry_id` + # Required. The name of the entry. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -528,8 +567,9 @@ module Google # Gets an entry. # @param [String] name - # Required. The name of the entry. Example: * projects/`project_id`/locations/` - # location`/entryGroups/`entry_group_id`/entries/`entry_id` + # Required. The name of the entry. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -557,18 +597,23 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a resource. A `NOT_FOUND` error is returned - # if the resource does not exist. An empty policy is returned if the resource - # exists but does not have a policy set on it. Supported resources are: - Tag - # templates. - Entries. - Entry groups. Note, this method cannot be used to - # manage policies for BigQuery, Pub/Sub and any external Google Cloud Platform - # resources synced to Data Catalog. Callers must have following Google IAM - # permission - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag - # templates. - `datacatalog.entries.getIamPolicy` to get policies on entries. - ` - # datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. + # Gets the access control policy for a resource. A `NOT_FOUND` error + # is returned if the resource does not exist. An empty policy is returned + # if the resource exists but does not have a policy set on it. + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # Callers must have following Google IAM permission + # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + # templates. + # - `datacatalog.entries.getIamPolicy` to get policies on entries. + # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -601,9 +646,9 @@ module Google # Lists entries. # @param [String] parent - # Required. The name of the entry group that contains the entries, which can be - # provided in URL format. Example: * projects/`project_id`/locations/`location`/ - # entryGroups/`entry_group_id` + # Required. The name of the entry group that contains the entries, which can + # be provided in URL format. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` # @param [Fixnum] page_size # The maximum number of items to return. Default is 10. Max limit is 1000. # Throws an invalid argument for `page_size > 1000`. @@ -611,9 +656,10 @@ module Google # Token that specifies which page is requested. If empty, the first page is # returned. # @param [String] read_mask - # The fields to return for each Entry. If not set or empty, all fields are - # returned. For example, setting read_mask to contain only one path "name" will - # cause ListEntries to return a list of Entries with only "name" field. + # The fields to return for each Entry. If not set or empty, all + # fields are returned. + # For example, setting read_mask to contain only one path "name" will cause + # ListEntries to return a list of Entries with only "name" field. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -644,24 +690,38 @@ module Google execute_or_queue_command(command, &block) end - # Updates an existing entry. Users should enable the Data Catalog API in the - # project identified by the `entry.name` parameter (see [Data Catalog Resource - # Project] (https://cloud.google.com/data-catalog/docs/concepts/resource-project) - # for more information). + # Updates an existing entry. + # Users should enable the Data Catalog API in the project identified by + # the `entry.name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # The Data Catalog resource name of the entry in URL format. Example: * projects/ - # `project_id`/locations/`location`/entryGroups/`entry_group_id`/entries/` - # entry_id` Note that this Entry and its child resources may not actually be - # stored in the location in this name. + # The Data Catalog resource name of the entry in URL format. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` + # Note that this Entry and its child resources may not actually be stored in + # the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Entry] google_cloud_datacatalog_v1beta1_entry_object # @param [String] update_mask - # The fields to update on the entry. If absent or empty, all modifiable fields - # are updated. The following fields are modifiable: * For entries with type ` - # DATA_STREAM`: * `schema` * For entries with type `FILESET` * `schema` * ` - # display_name` * `description` * `gcs_fileset_spec` * `gcs_fileset_spec. - # file_patterns` * For entries with `user_specified_type` * `schema` * ` - # display_name` * `description` * user_specified_type * user_specified_system * - # linked_resource * source_system_timestamps + # The fields to update on the entry. If absent or empty, all modifiable + # fields are updated. + # The following fields are modifiable: + # * For entries with type `DATA_STREAM`: + # * `schema` + # * For entries with type `FILESET` + # * `schema` + # * `display_name` + # * `description` + # * `gcs_fileset_spec` + # * `gcs_fileset_spec.file_patterns` + # * For entries with `user_specified_type` + # * `schema` + # * `display_name` + # * `description` + # * user_specified_type + # * user_specified_system + # * linked_resource + # * source_system_timestamps # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -692,15 +752,20 @@ module Google execute_or_queue_command(command, &block) end - # Returns the caller's permissions on a resource. If the resource does not exist, - # an empty set of permissions is returned (We don't return a `NOT_FOUND` error). - # Supported resources are: - Tag templates. - Entries. - Entry groups. Note, - # this method cannot be used to manage policies for BigQuery, Pub/Sub and any - # external Google Cloud Platform resources synced to Data Catalog. A caller is - # not required to have Google IAM permission to make this request. + # Returns the caller's permissions on a resource. + # If the resource does not exist, an empty set of permissions is returned + # (We don't return a `NOT_FOUND` error). + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # A caller is not required to have Google IAM permission to make this + # request. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -731,17 +796,23 @@ module Google execute_or_queue_command(command, &block) end - # Creates a tag on an Entry. Note: The project identified by the `parent` - # parameter for the [tag](https://cloud.google.com/data-catalog/docs/reference/ - # rest/v1beta1/projects.locations.entryGroups.entries.tags/create#path- - # parameters) and the [tag template](https://cloud.google.com/data-catalog/docs/ - # reference/rest/v1beta1/projects.locations.tagTemplates/create#path-parameters) + # Creates a tag on an Entry. + # Note: The project identified by the `parent` parameter for the + # [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/ + # projects.locations.entryGroups.entries.tags/create#path-parameters) + # and the + # [tag + # template](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/ + # projects.locations.tagTemplates/create#path-parameters) # used to create the tag must be from the same organization. # @param [String] parent # Required. The name of the resource to attach this tag to. Tags can be attached - # to Entries. Example: * projects/`project_id`/locations/`location`/entryGroups/` - # entry_group_id`/entries/`entry_id` Note that this Tag and its child resources - # may not actually be stored in the location in this name. + # to + # Entries. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` + # Note that this Tag and its child resources may not actually be stored in + # the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -774,9 +845,9 @@ module Google # Deletes a tag. # @param [String] name - # Required. The name of the tag to delete. Example: * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id`/entries/`entry_id`/tags/` - # tag_id` + # Required. The name of the tag to delete. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id`/tags/`tag_id` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -807,9 +878,13 @@ module Google # Lists the tags on an Entry. # @param [String] parent # Required. The name of the Data Catalog resource to list the tags of. The - # resource could be an Entry or an EntryGroup. Examples: * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id` * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id`/entries/`entry_id` + # resource + # could be an Entry or an + # EntryGroup. + # Examples: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` # @param [Fixnum] page_size # The maximum number of tags to return. Default is 10. Max limit is 1000. # @param [String] page_token @@ -846,14 +921,15 @@ module Google # Updates an existing tag. # @param [String] name - # The resource name of the tag in URL format. Example: * projects/`project_id`/ - # locations/`location`/entrygroups/`entry_group_id`/entries/`entry_id`/tags/` - # tag_id` where `tag_id` is a system-generated identifier. Note that this Tag - # may not actually be stored in the location in this name. + # The resource name of the tag in URL format. Example: + # * projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/ + # entries/`entry_id`/tags/`tag_id` + # where `tag_id` is a system-generated identifier. + # Note that this Tag may not actually be stored in the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object # @param [String] update_mask - # The fields to update on the Tag. If absent or empty, all modifiable fields are - # updated. Currently the only modifiable field is the field `fields`. + # The fields to update on the Tag. If absent or empty, all modifiable fields + # are updated. Currently the only modifiable field is the field `fields`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -884,17 +960,23 @@ module Google execute_or_queue_command(command, &block) end - # Creates a tag on an Entry. Note: The project identified by the `parent` - # parameter for the [tag](https://cloud.google.com/data-catalog/docs/reference/ - # rest/v1beta1/projects.locations.entryGroups.entries.tags/create#path- - # parameters) and the [tag template](https://cloud.google.com/data-catalog/docs/ - # reference/rest/v1beta1/projects.locations.tagTemplates/create#path-parameters) + # Creates a tag on an Entry. + # Note: The project identified by the `parent` parameter for the + # [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/ + # projects.locations.entryGroups.entries.tags/create#path-parameters) + # and the + # [tag + # template](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/ + # projects.locations.tagTemplates/create#path-parameters) # used to create the tag must be from the same organization. # @param [String] parent # Required. The name of the resource to attach this tag to. Tags can be attached - # to Entries. Example: * projects/`project_id`/locations/`location`/entryGroups/` - # entry_group_id`/entries/`entry_id` Note that this Tag and its child resources - # may not actually be stored in the location in this name. + # to + # Entries. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` + # Note that this Tag and its child resources may not actually be stored in + # the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -927,9 +1009,9 @@ module Google # Deletes a tag. # @param [String] name - # Required. The name of the tag to delete. Example: * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id`/entries/`entry_id`/tags/` - # tag_id` + # Required. The name of the tag to delete. Example: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id`/tags/`tag_id` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -960,9 +1042,13 @@ module Google # Lists the tags on an Entry. # @param [String] parent # Required. The name of the Data Catalog resource to list the tags of. The - # resource could be an Entry or an EntryGroup. Examples: * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id` * projects/`project_id`/ - # locations/`location`/entryGroups/`entry_group_id`/entries/`entry_id` + # resource + # could be an Entry or an + # EntryGroup. + # Examples: + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id` + # * projects/`project_id`/locations/`location`/entryGroups/`entry_group_id`/ + # entries/`entry_id` # @param [Fixnum] page_size # The maximum number of tags to return. Default is 10. Max limit is 1000. # @param [String] page_token @@ -999,14 +1085,15 @@ module Google # Updates an existing tag. # @param [String] name - # The resource name of the tag in URL format. Example: * projects/`project_id`/ - # locations/`location`/entrygroups/`entry_group_id`/entries/`entry_id`/tags/` - # tag_id` where `tag_id` is a system-generated identifier. Note that this Tag - # may not actually be stored in the location in this name. + # The resource name of the tag in URL format. Example: + # * projects/`project_id`/locations/`location`/entrygroups/`entry_group_id`/ + # entries/`entry_id`/tags/`tag_id` + # where `tag_id` is a system-generated identifier. + # Note that this Tag may not actually be stored in the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Tag] google_cloud_datacatalog_v1beta1_tag_object # @param [String] update_mask - # The fields to update on the Tag. If absent or empty, all modifiable fields are - # updated. Currently the only modifiable field is the field `fields`. + # The fields to update on the Tag. If absent or empty, all modifiable fields + # are updated. Currently the only modifiable field is the field `fields`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1037,14 +1124,16 @@ module Google execute_or_queue_command(command, &block) end - # Creates a tag template. The user should enable the Data Catalog API in the - # project identified by the `parent` parameter (see [Data Catalog Resource + # Creates a tag template. The user should enable the Data Catalog API in + # the project identified by the `parent` parameter (see [Data Catalog + # Resource # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) # for more information). # @param [String] parent - # Required. The name of the project and the template location [region](https:// - # cloud.google.com/data-catalog/docs/concepts/regions. Example: * projects/` - # project_id`/locations/us-central1 + # Required. The name of the project and the template location + # [region](https://cloud.google.com/data-catalog/docs/concepts/regions. + # Example: + # * projects/`project_id`/locations/us-central1 # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] google_cloud_datacatalog_v1beta1_tag_template_object # @param [String] tag_template_id # Required. The id of the tag template to create. @@ -1078,17 +1167,18 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a tag template and all tags using the template. Users should enable - # the Data Catalog API in the project identified by the `name` parameter (see [ - # Data Catalog Resource Project] (https://cloud.google.com/data-catalog/docs/ - # concepts/resource-project) for more information). + # Deletes a tag template and all tags using the template. + # Users should enable the Data Catalog API in the project identified by + # the `name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # Required. The name of the tag template to delete. Example: * projects/` - # project_id`/locations/`location`/tagTemplates/`tag_template_id` + # Required. The name of the tag template to delete. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` # @param [Boolean] force - # Required. Currently, this field must always be set to `true`. This confirms - # the deletion of any possible tags using this template. `force = false` will be - # supported in the future. + # Required. Currently, this field must always be set to `true`. + # This confirms the deletion of any possible tags using this template. + # `force = false` will be supported in the future. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1119,8 +1209,8 @@ module Google # Gets a tag template. # @param [String] name - # Required. The name of the tag template. Example: * projects/`project_id`/ - # locations/`location`/tagTemplates/`tag_template_id` + # Required. The name of the tag template. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1148,18 +1238,23 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a resource. A `NOT_FOUND` error is returned - # if the resource does not exist. An empty policy is returned if the resource - # exists but does not have a policy set on it. Supported resources are: - Tag - # templates. - Entries. - Entry groups. Note, this method cannot be used to - # manage policies for BigQuery, Pub/Sub and any external Google Cloud Platform - # resources synced to Data Catalog. Callers must have following Google IAM - # permission - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag - # templates. - `datacatalog.entries.getIamPolicy` to get policies on entries. - ` - # datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. + # Gets the access control policy for a resource. A `NOT_FOUND` error + # is returned if the resource does not exist. An empty policy is returned + # if the resource exists but does not have a policy set on it. + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # Callers must have following Google IAM permission + # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + # templates. + # - `datacatalog.entries.getIamPolicy` to get policies on entries. + # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1190,22 +1285,24 @@ module Google execute_or_queue_command(command, &block) end - # Updates a tag template. This method cannot be used to update the fields of a - # template. The tag template fields are represented as separate resources and - # should be updated using their own create/update/delete methods. Users should - # enable the Data Catalog API in the project identified by the `tag_template. - # name` parameter (see [Data Catalog Resource Project] (https://cloud.google.com/ - # data-catalog/docs/concepts/resource-project) for more information). + # Updates a tag template. This method cannot be used to update the fields of + # a template. The tag template fields are represented as separate resources + # and should be updated using their own create/update/delete methods. + # Users should enable the Data Catalog API in the project identified by + # the `tag_template.name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # The resource name of the tag template in URL format. Example: * projects/` - # project_id`/locations/`location`/tagTemplates/`tag_template_id` Note that this - # TagTemplate and its child resources may not actually be stored in the location - # in this name. + # The resource name of the tag template in URL format. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id` + # Note that this TagTemplate and its child resources may not actually be + # stored in the location in this name. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplate] google_cloud_datacatalog_v1beta1_tag_template_object # @param [String] update_mask - # The field mask specifies the parts of the template to overwrite. Allowed - # fields: * `display_name` If absent or empty, all of the allowed fields above - # will be updated. + # The field mask specifies the parts of the template to overwrite. + # Allowed fields: + # * `display_name` + # If absent or empty, all of the allowed fields above will be updated. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1236,17 +1333,22 @@ module Google execute_or_queue_command(command, &block) end - # Sets the access control policy for a resource. Replaces any existing policy. - # Supported resources are: - Tag templates. - Entries. - Entry groups. Note, - # this method cannot be used to manage policies for BigQuery, Pub/Sub and any - # external Google Cloud Platform resources synced to Data Catalog. Callers must - # have following Google IAM permission - `datacatalog.tagTemplates.setIamPolicy` - # to set policies on tag templates. - `datacatalog.entries.setIamPolicy` to set - # policies on entries. - `datacatalog.entryGroups.setIamPolicy` to set policies - # on entry groups. + # Sets the access control policy for a resource. Replaces any existing + # policy. + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # Callers must have following Google IAM permission + # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag + # templates. + # - `datacatalog.entries.setIamPolicy` to set policies on entries. + # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1277,15 +1379,20 @@ module Google execute_or_queue_command(command, &block) end - # Returns the caller's permissions on a resource. If the resource does not exist, - # an empty set of permissions is returned (We don't return a `NOT_FOUND` error). - # Supported resources are: - Tag templates. - Entries. - Entry groups. Note, - # this method cannot be used to manage policies for BigQuery, Pub/Sub and any - # external Google Cloud Platform resources synced to Data Catalog. A caller is - # not required to have Google IAM permission to make this request. + # Returns the caller's permissions on a resource. + # If the resource does not exist, an empty set of permissions is returned + # (We don't return a `NOT_FOUND` error). + # Supported resources are: + # - Tag templates. + # - Entries. + # - Entry groups. + # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + # and any external Google Cloud Platform resources synced to Data Catalog. + # A caller is not required to have Google IAM permission to make this + # request. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1316,20 +1423,23 @@ module Google execute_or_queue_command(command, &block) end - # Creates a field in a tag template. The user should enable the Data Catalog API - # in the project identified by the `parent` parameter (see [Data Catalog - # Resource Project](https://cloud.google.com/data-catalog/docs/concepts/resource- - # project) for more information). + # Creates a field in a tag template. The user should enable the Data Catalog + # API in the project identified by the `parent` parameter (see + # [Data Catalog Resource + # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + # for more information). # @param [String] parent - # Required. The name of the project and the template location [region](https:// - # cloud.google.com/data-catalog/docs/concepts/regions). Example: * projects/` - # project_id`/locations/us-central1/tagTemplates/`tag_template_id` + # Required. The name of the project and the template location + # [region](https://cloud.google.com/data-catalog/docs/concepts/regions). + # Example: + # * projects/`project_id`/locations/us-central1/tagTemplates/`tag_template_id` # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] google_cloud_datacatalog_v1beta1_tag_template_field_object # @param [String] tag_template_field_id - # Required. The ID of the tag template field to create. Field ids can contain - # letters (both uppercase and lowercase), numbers (0-9), underscores (_) and - # dashes (-). Field IDs must be at least 1 character long and at most 128 - # characters long. Field IDs must also be unique within their template. + # Required. The ID of the tag template field to create. + # Field ids can contain letters (both uppercase and lowercase), numbers + # (0-9), underscores (_) and dashes (-). Field IDs must be at least 1 + # character long and at most 128 characters long. Field IDs must also be + # unique within their template. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1360,18 +1470,19 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a field in a tag template and all uses of that field. Users should - # enable the Data Catalog API in the project identified by the `name` parameter ( - # see [Data Catalog Resource Project] (https://cloud.google.com/data-catalog/ - # docs/concepts/resource-project) for more information). + # Deletes a field in a tag template and all uses of that field. + # Users should enable the Data Catalog API in the project identified by + # the `name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # Required. The name of the tag template field to delete. Example: * projects/` - # project_id`/locations/`location`/tagTemplates/`tag_template_id`/fields/` - # tag_template_field_id` + # Required. The name of the tag template field to delete. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/ + # fields/`tag_template_field_id` # @param [Boolean] force - # Required. Currently, this field must always be set to `true`. This confirms - # the deletion of this field from any tags using this field. `force = false` - # will be supported in the future. + # Required. Currently, this field must always be set to `true`. + # This confirms the deletion of this field from any tags using this field. + # `force = false` will be supported in the future. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1401,22 +1512,27 @@ module Google end # Updates a field in a tag template. This method cannot be used to update the - # field type. Users should enable the Data Catalog API in the project identified - # by the `name` parameter (see [Data Catalog Resource Project] (https://cloud. - # google.com/data-catalog/docs/concepts/resource-project) for more information). + # field type. Users should enable the Data Catalog API in the project + # identified by the `name` parameter (see [Data Catalog Resource Project] + # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + # more information). # @param [String] name - # Required. The name of the tag template field. Example: * projects/`project_id`/ - # locations/`location`/tagTemplates/`tag_template_id`/fields/` - # tag_template_field_id` + # Required. The name of the tag template field. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/ + # fields/`tag_template_field_id` # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1TagTemplateField] google_cloud_datacatalog_v1beta1_tag_template_field_object # @param [String] update_mask # Optional. The field mask specifies the parts of the template to be updated. - # Allowed fields: * `display_name` * `type.enum_type` * `is_required` If ` - # update_mask` is not set or empty, all of the allowed fields above will be - # updated. When updating an enum type, the provided values will be merged with - # the existing values. Therefore, enum values can only be added, existing enum - # values cannot be deleted nor renamed. Updating a template field from optional - # to required is NOT allowed. + # Allowed fields: + # * `display_name` + # * `type.enum_type` + # * `is_required` + # If `update_mask` is not set or empty, all of the allowed fields above will + # be updated. + # When updating an enum type, the provided values will be merged with the + # existing values. Therefore, enum values can only be added, existing enum + # values cannot be deleted nor renamed. Updating a template field from + # optional to required is NOT allowed. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1447,14 +1563,15 @@ module Google execute_or_queue_command(command, &block) end - # Renames a field in a tag template. The user should enable the Data Catalog API - # in the project identified by the `name` parameter (see [Data Catalog Resource + # Renames a field in a tag template. The user should enable the Data Catalog + # API in the project identified by the `name` parameter (see [Data Catalog + # Resource # Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) # for more information). # @param [String] name - # Required. The name of the tag template. Example: * projects/`project_id`/ - # locations/`location`/tagTemplates/`tag_template_id`/fields/` - # tag_template_field_id` + # Required. The name of the tag template. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/ + # fields/`tag_template_field_id` # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldRequest] google_cloud_datacatalog_v1beta1_rename_tag_template_field_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1486,12 +1603,12 @@ module Google end # Renames an enum value in a tag template. The enum values have to be unique - # within one enum field. Thus, an enum value cannot be renamed with a name used - # in any other enum value within the same enum field. + # within one enum field. Thus, an enum value cannot be renamed with a name + # used in any other enum value within the same enum field. # @param [String] name - # Required. The name of the enum field value. Example: * projects/`project_id`/ - # locations/`location`/tagTemplates/`tag_template_id`/fields/` - # tag_template_field_id`/enumValues/`enum_value_display_name` + # Required. The name of the enum field value. Example: + # * projects/`project_id`/locations/`location`/tagTemplates/`tag_template_id`/ + # fields/`tag_template_field_id`/enumValues/`enum_value_display_name` # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1RenameTagTemplateFieldEnumValueRequest] google_cloud_datacatalog_v1beta1_rename_tag_template_field_enum_value_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1555,11 +1672,11 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a taxonomy. This operation will also delete all policy tags in this - # taxonomy along with their associated policies. + # Deletes a taxonomy. This operation will also delete all + # policy tags in this taxonomy along with their associated policies. # @param [String] name - # Required. Resource name of the taxonomy to be deleted. All policy tags in this - # taxonomy will also be deleted. + # Required. Resource name of the taxonomy to be deleted. All policy tags in + # this taxonomy will also be deleted. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1587,12 +1704,12 @@ module Google execute_or_queue_command(command, &block) end - # Exports all taxonomies and their policy tags in a project. This method - # generates SerializedTaxonomy protos with nested policy tags that can be used - # as an input for future ImportTaxonomies calls. + # Exports all taxonomies and their policy tags in a project. + # This method generates SerializedTaxonomy protos with nested policy tags + # that can be used as an input for future ImportTaxonomies calls. # @param [String] parent - # Required. Resource name of the project that taxonomies to be exported will - # share. + # Required. Resource name of the project that taxonomies to be exported + # will share. # @param [Boolean] serialized_taxonomies # Export taxonomies as serialized taxonomies. # @param [Array, String] taxonomies @@ -1658,8 +1775,8 @@ module Google # Gets the IAM policy for a taxonomy or a policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1690,9 +1807,10 @@ module Google execute_or_queue_command(command, &block) end - # Imports all taxonomies and their policy tags to a project as new taxonomies. - # This method provides a bulk taxonomy / policy tag creation using nested proto - # structure. + # Imports all taxonomies and their policy tags to a project as new + # taxonomies. + # This method provides a bulk taxonomy / policy tag creation using nested + # proto structure. # @param [String] parent # Required. Resource name of project that the imported taxonomies will belong to. # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1ImportTaxonomiesRequest] google_cloud_datacatalog_v1beta1_import_taxonomies_request_object @@ -1725,13 +1843,13 @@ module Google execute_or_queue_command(command, &block) end - # Lists all taxonomies in a project in a particular location that the caller has - # permission to view. + # Lists all taxonomies in a project in a particular location that the caller + # has permission to view. # @param [String] parent # Required. Resource name of the project to list the taxonomies of. # @param [Fixnum] page_size - # The maximum number of items to return. Must be a value between 1 and 1000. If - # not set, defaults to 50. + # The maximum number of items to return. Must be a value between 1 and 1000. + # If not set, defaults to 50. # @param [String] page_token # The next_page_token value returned from a previous list request, if any. If # not set, defaults to an empty string. @@ -1766,13 +1884,15 @@ module Google # Updates a taxonomy. # @param [String] name - # Output only. Resource name of this taxonomy, whose format is: "projects/` - # project_number`/locations/`location_id`/taxonomies/`id`". + # Output only. Resource name of this taxonomy, whose format is: + # "projects/`project_number`/locations/`location_id`/taxonomies/`id`". # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1Taxonomy] google_cloud_datacatalog_v1beta1_taxonomy_object # @param [String] update_mask - # The update mask applies to the resource. For the `FieldMask` definition, see + # The update mask applies to the resource. For the `FieldMask` definition, + # see # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf# - # fieldmask If not set, defaults to all of the fields that are allowed to update. + # fieldmask + # If not set, defaults to all of the fields that are allowed to update. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1805,8 +1925,8 @@ module Google # Sets the IAM policy for a taxonomy or a policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1837,11 +1957,11 @@ module Google execute_or_queue_command(command, &block) end - # Returns the permissions that a caller has on the specified taxonomy or policy - # tag. + # Returns the permissions that a caller has on the specified taxonomy or + # policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1968,8 +2088,8 @@ module Google # Gets the IAM policy for a taxonomy or a policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2004,8 +2124,8 @@ module Google # @param [String] parent # Required. Resource name of the taxonomy to list the policy tags of. # @param [Fixnum] page_size - # The maximum number of items to return. Must be a value between 1 and 1000. If - # not set, defaults to 50. + # The maximum number of items to return. Must be a value between 1 and 1000. + # If not set, defaults to 50. # @param [String] page_token # The next_page_token value returned from a previous List request, if any. If # not set, defaults to an empty string. @@ -2040,18 +2160,19 @@ module Google # Updates a policy tag. # @param [String] name - # Output only. Resource name of this policy tag, whose format is: "projects/` - # project_number`/locations/`location_id`/taxonomies/`taxonomy_id`/policyTags/` - # id`". + # Output only. Resource name of this policy tag, whose format is: + # "projects/`project_number`/locations/`location_id`/taxonomies/`taxonomy_id`/ + # policyTags/`id`". # @param [Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1beta1PolicyTag] google_cloud_datacatalog_v1beta1_policy_tag_object # @param [String] update_mask # The update mask applies to the resource. Only display_name, description and # parent_policy_tag can be updated and thus can be listed in the mask. If # update_mask is not provided, all allowed fields (i.e. display_name, - # description and parent) will be updated. For more information including the ` - # FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/ - # reference/google.protobuf#fieldmask If not set, defaults to all of the fields - # that are allowed to update. + # description and parent) will be updated. For more information including the + # `FieldMask` definition, see + # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf# + # fieldmask + # If not set, defaults to all of the fields that are allowed to update. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2084,8 +2205,8 @@ module Google # Sets the IAM policy for a taxonomy or a policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2116,11 +2237,11 @@ module Google execute_or_queue_command(command, &block) end - # Returns the permissions that a caller has on the specified taxonomy or policy - # tag. + # Returns the permissions that a caller has on the specified taxonomy or + # policy tag. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. See the - # operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. # @param [Google::Apis::DatacatalogV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. diff --git a/generated/google/apis/healthcare_v1.rb b/generated/google/apis/healthcare_v1.rb index f9da270a7..ed2826014 100644 --- a/generated/google/apis/healthcare_v1.rb +++ b/generated/google/apis/healthcare_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/healthcare module HealthcareV1 VERSION = 'V1' - REVISION = '20200713' + REVISION = '20200723' # 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/healthcare_v1/service.rb b/generated/google/apis/healthcare_v1/service.rb index 09e47378b..a70b67fd1 100644 --- a/generated/google/apis/healthcare_v1/service.rb +++ b/generated/google/apis/healthcare_v1/service.rb @@ -990,6 +990,9 @@ module Google # are equivalent to the GET requests specified in the Retrieve transaction. # The method returns an Operation which # will be marked successful when the deletion is complete. + # Warning: Inserting instances into a study while a delete operation is + # running for that study could result in the new instances not appearing in + # search results until the deletion operation finishes. # @param [String] parent # @param [String] dicom_web_path # The path of the DeleteStudy request. For example, `studies/`study_uid``. @@ -1227,6 +1230,9 @@ module Google # Retrieve transaction. # The method returns an Operation which # will be marked successful when the deletion is complete. + # Warning: Inserting instances into a series while a delete operation is + # running for that series could result in the new instances not appearing in + # search results until the deletion operation finishes. # @param [String] parent # The name of the DICOM store that is being accessed. For example, # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ @@ -2146,19 +2152,19 @@ module Google # Maximum number of resources in a page. Defaults to 100. # @param [String] _page_token # Used to retrieve the next or previous page of results - # when using pagination. Value should be set to the value of page_token set - # in next or previous page links' urls. Next and previous page are returned + # when using pagination. Set `_page_token` to the value of _page_token set + # in next or previous page links' url. Next and previous page are returned # in the response bundle's links field, where `link.relation` is "previous" # or "next". - # Omit `page_token` if no previous request has been made. + # Omit `_page_token` if no previous request has been made. # @param [String] _since # If provided, only resources updated after this time are - # exported. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. + # returned. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. # For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. # The time must be specified to the second and include a time zone. # @param [String] _type # String of comma-delimited FHIR resource types. If provided, only resources - # of the specified resource type(s) will be returned. + # of the specified resource type(s) are returned. # @param [String] end_ # The response includes records prior to the end date. If no end date is # provided, all records subsequent to the start date are in scope. @@ -3097,12 +3103,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a message and sends a notification to the Cloud Pub/Sub topic. If - # configured, the MLLP adapter listens to messages created by this method and - # sends those back to the hospital. A successful response indicates the - # message has been persisted to storage and a Cloud Pub/Sub notification has - # been sent. Sending to the hospital by the MLLP adapter happens - # asynchronously. + # Parses and stores an HL7v2 message. This method triggers an asynchronous + # notification to any Cloud Pub/Sub topic configured in + # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the + # filtering matches the message. If an MLLP adapter is configured to listen + # to a Cloud Pub/Sub topic, the adapter transmits the message when a + # notification is received. # @param [String] parent # The name of the dataset this message belongs to. # @param [Google::Apis::HealthcareV1::CreateMessageRequest] create_message_request_object @@ -3199,9 +3205,15 @@ module Google execute_or_queue_command(command, &block) end - # Ingests a new HL7v2 message from the hospital and sends a notification to - # the Cloud Pub/Sub topic. Return is an HL7v2 ACK message if the message was - # successfully stored. Otherwise an error is returned. + # Parses and stores an HL7v2 message. This method triggers an asynchronous + # notification to any Cloud Pub/Sub topic configured in + # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the + # filtering matches the message. If an MLLP adapter is configured to listen + # to a Cloud Pub/Sub topic, the adapter transmits the message when a + # notification is received. This method also generates a response + # containing an HL7v2 acknowledgement (`ACK`) message when successful or a + # negative acknowledgement (`NACK`) message in case of error, suitable for + # replying to HL7v2 interface systems that expect these acknowledgements. # @param [String] parent # The name of the HL7v2 store this message belongs to. # @param [Google::Apis::HealthcareV1::IngestMessageRequest] ingest_message_request_object diff --git a/generated/google/apis/healthcare_v1beta1.rb b/generated/google/apis/healthcare_v1beta1.rb index 021b70f11..41d29b366 100644 --- a/generated/google/apis/healthcare_v1beta1.rb +++ b/generated/google/apis/healthcare_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/healthcare module HealthcareV1beta1 VERSION = 'V1beta1' - REVISION = '20200713' + REVISION = '20200723' # 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/healthcare_v1beta1/classes.rb b/generated/google/apis/healthcare_v1beta1/classes.rb index 017733cdb..9f48e1c39 100644 --- a/generated/google/apis/healthcare_v1beta1/classes.rb +++ b/generated/google/apis/healthcare_v1beta1/classes.rb @@ -1075,8 +1075,8 @@ module Google end end - # Response for failed annotation export operations. This structure is - # included in error + # Response for failed annotation export operations. This structure + # is included in error # details upon operation completion. class ExportAnnotationsErrorDetails include Google::Apis::Core::Hashable @@ -1144,7 +1144,8 @@ module Google class ExportAnnotationsResponse include Google::Apis::Core::Hashable - # The annotation_store used for the export operation, in the format of + # The annotation_store used for the export operation, + # in the format of # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ # annotationStores/`annotation_store_id``. # Corresponds to the JSON property `annotationStore` @@ -1176,7 +1177,7 @@ module Google class ExportDicomDataRequest include Google::Apis::Core::Hashable - # The BigQuery table where the server writes the output. + # The BigQuery table where the server writes output. # Corresponds to the JSON property `bigqueryDestination` # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1DicomBigQueryDestination] attr_accessor :bigquery_destination @@ -1611,6 +1612,39 @@ module Google end end + # Specifies the configuration for importing data from Cloud Storage. + class GcsSource + include Google::Apis::Core::Hashable + + # Points to a Cloud Storage URI containing file(s) to import. + # The URI must be in the following format: `gs://`bucket_id`/`object_id``. + # The URI can include wildcards in `object_id` and thus identify multiple + # files. Supported wildcards: + # * `*` to match 0 or more non-separator characters + # * `**` to match 0 or more characters (including separators). Must be used + # at the end of a path and with no other wildcards in the + # path. Can also be used with a file extension (such as .ndjson), which + # imports all files with the extension in the specified directory and + # its sub-directories. For example, `gs://my-bucket/my-directory/**.ndjson` + # imports all files with `.ndjson` extensions in `my-directory/` and its + # sub-directories. + # * `?` to match 1 character + # Files matching the wildcard are expected to contain content only, no + # metadata. + # Corresponds to the JSON property `uri` + # @return [String] + attr_accessor :uri + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @uri = args[:uri] if args.key?(:uri) + end + end + # The BigQuery table for export. class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination include Google::Apis::Core::Hashable @@ -1750,14 +1784,13 @@ module Google end end - # The BigQuery table where the server writes the output. + # The BigQuery table where the server writes output. class GoogleCloudHealthcareV1beta1DicomBigQueryDestination include Google::Apis::Core::Hashable - # If the destination table already exists and this flag is `TRUE`, the table - # is overwritten by the contents of the DICOM store. If the flag is not - # set and the destination table already exists, the export call returns an - # error. + # This flag is being replaced by write_disposition which provides additional + # options. force=false is equivalent to WRITE_EMPTY and force=true is + # equivalent to WRITE_TRUNCATE. # Corresponds to the JSON property `force` # @return [Boolean] attr_accessor :force @@ -1885,9 +1918,9 @@ module Google # @return [String] attr_accessor :dataset_uri - # If this flag is `TRUE`, all tables will be deleted from the dataset before - # the new exported tables are written. If the flag is not set and the - # destination dataset contains tables, the export call returns an error. + # This flag is being replaced by write_disposition which provides additional + # options. force=false is equivalent to WRITE_EMPTY and force=true is + # equivalent to WRITE_TRUNCATE. # Corresponds to the JSON property `force` # @return [Boolean] attr_accessor :force @@ -2510,16 +2543,16 @@ module Google class ImportAnnotationsResponse include Google::Apis::Core::Hashable - # The annotation_store that the annotations were imported to. The name - # is in the format + # The annotation_store that the annotations were imported to, + # in the format # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ # annotationStores/`annotation_store_id``. # Corresponds to the JSON property `annotationStore` # @return [String] attr_accessor :annotation_store - # The number of the input annotations. All input have been imported - # successfully. + # The number of the input annotations. All input have been + # imported successfully. # Corresponds to the JSON property `successCount` # @return [Fixnum] attr_accessor :success_count @@ -2591,6 +2624,41 @@ module Google end end + # Request to import messages. + class ImportMessagesRequest + include Google::Apis::Core::Hashable + + # Specifies the configuration for importing data from Cloud Storage. + # Corresponds to the JSON property `gcsSource` + # @return [Google::Apis::HealthcareV1beta1::GcsSource] + attr_accessor :gcs_source + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @gcs_source = args[:gcs_source] if args.key?(:gcs_source) + end + end + + # Final response of importing messages. + # This structure is included in the + # response to describe the detailed + # outcome. It is only included when the operation finishes successfully. + class ImportMessagesResponse + include Google::Apis::Core::Hashable + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + end + end + # Request to import resources. class ImportResourcesRequest include Google::Apis::Core::Hashable @@ -3722,7 +3790,7 @@ module Google # @return [Array] attr_accessor :schemas - # Determines how messages that don't parse successfully are handled. + # Determines how messages that fail to parse are handled. # Corresponds to the JSON property `schematizedParsingType` # @return [String] attr_accessor :schematized_parsing_type diff --git a/generated/google/apis/healthcare_v1beta1/representations.rb b/generated/google/apis/healthcare_v1beta1/representations.rb index 04c31d037..b51a5ac5f 100644 --- a/generated/google/apis/healthcare_v1beta1/representations.rb +++ b/generated/google/apis/healthcare_v1beta1/representations.rb @@ -280,6 +280,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class GcsSource + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination class Representation < Google::Apis::Core::JsonRepresentation; end @@ -454,6 +460,18 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class ImportMessagesRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ImportMessagesResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ImportResourcesRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -1129,6 +1147,13 @@ module Google end end + class GcsSource + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :uri, as: 'uri' + end + end + class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1375,6 +1400,20 @@ module Google end end + class ImportMessagesRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :gcs_source, as: 'gcsSource', class: Google::Apis::HealthcareV1beta1::GcsSource, decorator: Google::Apis::HealthcareV1beta1::GcsSource::Representation + + end + end + + class ImportMessagesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + end + end + class ImportResourcesRequest # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/healthcare_v1beta1/service.rb b/generated/google/apis/healthcare_v1beta1/service.rb index f03576a9a..396d16024 100644 --- a/generated/google/apis/healthcare_v1beta1/service.rb +++ b/generated/google/apis/healthcare_v1beta1/service.rb @@ -547,7 +547,8 @@ module Google # Errors are logged to Cloud Logging # (see [Viewing logs](/healthcare/docs/how-tos/logging)). # @param [String] eval_store - # The Annotation store to compare against `golden_store`, in the format of + # The Annotation store to compare against `golden_store`, in the + # format of # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ # annotationStores/`annotation_store_id``. # @param [Google::Apis::HealthcareV1beta1::EvaluateAnnotationStoreRequest] evaluate_annotation_store_request_object @@ -720,8 +721,8 @@ module Google # Errors are also logged to Cloud Logging # (see [Viewing logs](/healthcare/docs/how-tos/logging)). # @param [String] annotation_store - # The name of the Annotation store to which the server imports annotations, - # in the format + # The name of the Annotation store to which the server imports + # annotations, in the format # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ # annotationStores/`annotation_store_id``. # @param [Google::Apis::HealthcareV1beta1::ImportAnnotationsRequest] import_annotations_request_object @@ -3013,14 +3014,14 @@ module Google # Maximum number of resources in a page. Defaults to 100. # @param [String] _page_token # Used to retrieve the next or previous page of results - # when using pagination. Value should be set to the value of `page_token` set - # in next or previous page links' URLs. Next and previous page are returned + # when using pagination. Set `_page_token` to the value of _page_token set + # in next or previous page links' url. Next and previous page are returned # in the response bundle's links field, where `link.relation` is "previous" # or "next". - # Omit `page_token` if no previous request has been made. + # Omit `_page_token` if no previous request has been made. # @param [String] _since # If provided, only resources updated after this time are - # exported. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. + # returned. The time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. # For example, `2015-02-07T13:28:17.239+02:00` or `2017-01-01T00:00:00Z`. # The time must be specified to the second and include a time zone. # @param [String] _type @@ -4014,6 +4015,70 @@ module Google execute_or_queue_command(command, &block) end + # Import messages to the HL7v2 store by loading data from the specified + # sources. This method is optimized to load large quantities of data using + # import semantics that ignore some HL7v2 store configuration options and are + # not suitable for all use cases. It is primarily intended to load data into + # an empty HL7v2 store that is not being used by other clients. + # An existing message will be overwritten if a duplicate message is imported. + # A duplicate message is a message with the same raw bytes as a message that + # already exists in this HL7v2 store. When a message is overwritten, its + # labels will also be overwritten. + # The import operation is idempotent unless the input data contains multiple + # valid messages with the same raw bytes but different labels. In that case, + # after the import completes, the store contains exactly one message + # with those raw bytes but there is no ordering guarantee on which version + # of the labels it has. The operation result counters do not count + # duplicated raw bytes as an error and count one success for each message in + # the input, which might result in a success count larger than the number + # of messages in the HL7v2 store. + # If some messages fail to import, for example due to parsing errors, + # successfully imported messages are not rolled back. + # This method returns an Operation that can + # be used to track the status of the import by calling + # GetOperation. + # Immediate fatal errors appear in the + # error field, errors are also logged + # to Cloud Logging (see [Viewing + # logs](/healthcare/docs/how-tos/logging)). Otherwise, when the operation + # finishes, a response of type ImportMessagesResponse is returned in the + # response field. + # The metadata field type for this + # operation is OperationMetadata. + # @param [String] name + # The name of the target HL7v2 store, in the format + # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/ + # hl7v2Stores/`hl7v2_store_id`` + # @param [Google::Apis::HealthcareV1beta1::ImportMessagesRequest] import_messages_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::HealthcareV1beta1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::HealthcareV1beta1::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 import_hl7_v2_store_messages(name, import_messages_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1beta1/{+name}:import', options) + command.request_representation = Google::Apis::HealthcareV1beta1::ImportMessagesRequest::Representation + command.request_object = import_messages_request_object + command.response_representation = Google::Apis::HealthcareV1beta1::Operation::Representation + command.response_class = Google::Apis::HealthcareV1beta1::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 + # Lists the HL7v2 stores in the given dataset. # @param [String] parent # Name of the dataset. @@ -4171,12 +4236,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a message and sends a notification to the Cloud Pub/Sub topic. If - # configured, the MLLP adapter listens to messages created by this method and - # sends those back to the hospital. A successful response indicates the - # message has been persisted to storage and a Cloud Pub/Sub notification has - # been sent. Sending to the hospital by the MLLP adapter happens - # asynchronously. + # Parses and stores an HL7v2 message. This method triggers an asynchronous + # notification to any Cloud Pub/Sub topic configured in + # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the + # filtering matches the message. If an MLLP adapter is configured to listen + # to a Cloud Pub/Sub topic, the adapter transmits the message when a + # notification is received. # @param [String] parent # The name of the dataset this message belongs to. # @param [Google::Apis::HealthcareV1beta1::CreateMessageRequest] create_message_request_object @@ -4273,9 +4338,15 @@ module Google execute_or_queue_command(command, &block) end - # Ingests a new HL7v2 message from the hospital and sends a notification to - # the Cloud Pub/Sub topic. Return is an HL7v2 ACK message if the message was - # successfully stored. Otherwise an error is returned. + # Parses and stores an HL7v2 message. This method triggers an asynchronous + # notification to any Cloud Pub/Sub topic configured in + # projects.locations.datasets.hl7V2Stores.Hl7V2NotificationConfig, if the + # filtering matches the message. If an MLLP adapter is configured to listen + # to a Cloud Pub/Sub topic, the adapter transmits the message when a + # notification is received. This method also generates a response + # containing an HL7v2 acknowledgement (`ACK`) message when successful or a + # negative acknowledgement (`NACK`) message in case of error, suitable for + # replying to HL7v2 interface systems that expect these acknowledgements. # @param [String] parent # The name of the HL7v2 store this message belongs to. # @param [Google::Apis::HealthcareV1beta1::IngestMessageRequest] ingest_message_request_object diff --git a/generated/google/apis/logging_v2.rb b/generated/google/apis/logging_v2.rb index a86a14155..0e8859efd 100644 --- a/generated/google/apis/logging_v2.rb +++ b/generated/google/apis/logging_v2.rb @@ -28,7 +28,7 @@ module Google # @see https://cloud.google.com/logging/docs/ module LoggingV2 VERSION = 'V2' - REVISION = '20200619' + REVISION = '20200724' # 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/logging_v2/classes.rb b/generated/google/apis/logging_v2/classes.rb index 4eae59bbf..015cf37e2 100644 --- a/generated/google/apis/logging_v2/classes.rb +++ b/generated/google/apis/logging_v2/classes.rb @@ -1195,9 +1195,9 @@ module Google # deleting or altering it stops data collection and makes the metric type's # existing data unusable.The following are specific rules for service defined # Monitoring metric descriptors: - # type, metric_kind, value_type, description, display_name, launch_stage fields - # are all required. The unit field must be specified if the value_type is any - # of DOUBLE, INT64, DISTRIBUTION. + # type, metric_kind, value_type and description fields are all required. The + # unit field must be specified if the value_type is any of DOUBLE, INT64, + # DISTRIBUTION. # Maximum of default 500 metric descriptors per service is allowed. # Maximum of default 10 labels per metric descriptor is allowed.The default # maximum limit can be overridden. Please follow https://cloud.google.com/ @@ -1394,9 +1394,9 @@ module Google # deleting or altering it stops data collection and makes the metric type's # existing data unusable.The following are specific rules for service defined # Monitoring metric descriptors: - # type, metric_kind, value_type, description, display_name, launch_stage fields - # are all required. The unit field must be specified if the value_type is any - # of DOUBLE, INT64, DISTRIBUTION. + # type, metric_kind, value_type and description fields are all required. The + # unit field must be specified if the value_type is any of DOUBLE, INT64, + # DISTRIBUTION. # Maximum of default 500 metric descriptors per service is allowed. # Maximum of default 10 labels per metric descriptor is allowed.The default # maximum limit can be overridden. Please follow https://cloud.google.com/ diff --git a/generated/google/apis/memcache_v1.rb b/generated/google/apis/memcache_v1.rb index d016e5cdf..842e36be9 100644 --- a/generated/google/apis/memcache_v1.rb +++ b/generated/google/apis/memcache_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/memorystore/ module MemcacheV1 VERSION = 'V1' - REVISION = '20200721' + REVISION = '20200729' # 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/memcache_v1/classes.rb b/generated/google/apis/memcache_v1/classes.rb index 71cc13ef3..f721262f5 100644 --- a/generated/google/apis/memcache_v1/classes.rb +++ b/generated/google/apis/memcache_v1/classes.rb @@ -22,110 +22,22 @@ module Google module Apis module MemcacheV1 - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # `, - # ` - # "log_type": "ADMIN_READ" - # ` - # ] - # `, - # ` - # "service": "sampleservice.googleapis.com", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ" - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:aliya@example.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts jose@example.com from DATA_READ logging, and - # aliya@example.com from DATA_WRITE logging. - class AuditConfig + # Request for ApplyParameters. + class ApplyParametersRequest include Google::Apis::Core::Hashable - # The configuration for logging of each type of permission. - # Corresponds to the JSON property `auditLogConfigs` - # @return [Array] - attr_accessor :audit_log_configs + # Whether to apply instance-level parameter group to all nodes. If set to + # true, will explicitly restrict users from specifying any nodes, and apply + # parameter group updates to all nodes within the instance. + # Corresponds to the JSON property `applyAll` + # @return [Boolean] + attr_accessor :apply_all + alias_method :apply_all?, :apply_all - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. - # Corresponds to the JSON property `service` - # @return [String] - attr_accessor :service - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @audit_log_configs = args[:audit_log_configs] if args.key?(:audit_log_configs) - @service = args[:service] if args.key?(:service) - end - end - - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # jose@example.com from DATA_READ logging. - class AuditLogConfig - include Google::Apis::Core::Hashable - - # Specifies the identities that do not cause logging for this type of - # permission. - # Follows the same format of Binding.members. - # Corresponds to the JSON property `exemptedMembers` + # Nodes to which we should apply the instance-level parameter group. + # Corresponds to the JSON property `nodeIds` # @return [Array] - attr_accessor :exempted_members - - # The log type that this config enables. - # Corresponds to the JSON property `logType` - # @return [String] - attr_accessor :log_type + attr_accessor :node_ids def initialize(**args) update!(**args) @@ -133,91 +45,8 @@ module Google # Update properties of this object def update!(**args) - @exempted_members = args[:exempted_members] if args.key?(:exempted_members) - @log_type = args[:log_type] if args.key?(:log_type) - end - end - - # Associates `members` with a `role`. - class Binding - include Google::Apis::Core::Hashable - - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. - # Corresponds to the JSON property `condition` - # @return [Google::Apis::MemcacheV1::Expr] - attr_accessor :condition - - # Specifies the identities requesting access for a Cloud Platform resource. - # `members` can have the following values: - # * `allUsers`: A special identifier that represents anyone who is - # on the internet; with or without a Google account. - # * `allAuthenticatedUsers`: A special identifier that represents anyone - # who is authenticated with a Google account or a service account. - # * `user:`emailid``: An email address that represents a specific Google - # account. For example, `alice@example.com` . - # * `serviceAccount:`emailid``: An email address that represents a service - # account. For example, `my-other-app@appspot.gserviceaccount.com`. - # * `group:`emailid``: An email address that represents a Google group. - # For example, `admins@example.com`. - # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a user that has been recently deleted. For - # example, `alice@example.com?uid=123456789012345678901`. If the user is - # recovered, this value reverts to `user:`emailid`` and the recovered user - # retains the role in the binding. - # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus - # unique identifier) representing a service account that has been recently - # deleted. For example, - # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to - # `serviceAccount:`emailid`` and the undeleted service account retains the - # role in the binding. - # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently - # deleted. For example, `admins@example.com?uid=123456789012345678901`. If - # the group is recovered, this value reverts to `group:`emailid`` and the - # recovered group retains the role in the binding. - # * `domain:`domain``: The G Suite domain (primary) that represents all the - # users of that domain. For example, `google.com` or `example.com`. - # Corresponds to the JSON property `members` - # @return [Array] - attr_accessor :members - - # Role that is assigned to `members`. - # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. - # Corresponds to the JSON property `role` - # @return [String] - attr_accessor :role - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @condition = args[:condition] if args.key?(:condition) - @members = args[:members] if args.key?(:members) - @role = args[:role] if args.key?(:role) + @apply_all = args[:apply_all] if args.key?(:apply_all) + @node_ids = args[:node_ids] if args.key?(:node_ids) end end @@ -253,55 +82,48 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. - class Expr + # Represents the metadata of a long-running operation. + class GoogleCloudMemcacheV1OperationMetadata include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. - # Corresponds to the JSON property `description` + # Output only. API version used to start the operation. + # Corresponds to the JSON property `apiVersion` # @return [String] - attr_accessor :description + attr_accessor :api_version - # Textual representation of an expression in Common Expression Language - # syntax. - # Corresponds to the JSON property `expression` - # @return [String] - attr_accessor :expression + # Output only. Identifies whether the user has requested cancellation + # of the operation. Operations that have successfully been cancelled + # have Operation.error value with a google.rpc.Status.code of 1, + # corresponding to `Code.CANCELLED`. + # Corresponds to the JSON property `cancelRequested` + # @return [Boolean] + attr_accessor :cancel_requested + alias_method :cancel_requested?, :cancel_requested - # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. - # Corresponds to the JSON property `location` + # Output only. Time when the operation was created. + # Corresponds to the JSON property `createTime` # @return [String] - attr_accessor :location + attr_accessor :create_time - # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. - # Corresponds to the JSON property `title` + # Output only. Time when the operation finished running. + # Corresponds to the JSON property `endTime` # @return [String] - attr_accessor :title + attr_accessor :end_time + + # Output only. Human-readable status of the operation, if any. + # Corresponds to the JSON property `statusDetail` + # @return [String] + attr_accessor :status_detail + + # Output only. Server-defined resource path for the target of the operation. + # Corresponds to the JSON property `target` + # @return [String] + attr_accessor :target + + # Output only. Name of the verb executed by the operation. + # Corresponds to the JSON property `verb` + # @return [String] + attr_accessor :verb def initialize(**args) update!(**args) @@ -309,10 +131,13 @@ module Google # Update properties of this object def update!(**args) - @description = args[:description] if args.key?(:description) - @expression = args[:expression] if args.key?(:expression) - @location = args[:location] if args.key?(:location) - @title = args[:title] if args.key?(:title) + @api_version = args[:api_version] if args.key?(:api_version) + @cancel_requested = args[:cancel_requested] if args.key?(:cancel_requested) + @create_time = args[:create_time] if args.key?(:create_time) + @end_time = args[:end_time] if args.key?(:end_time) + @status_detail = args[:status_detail] if args.key?(:status_detail) + @target = args[:target] if args.key?(:target) + @verb = args[:verb] if args.key?(:verb) end end @@ -713,6 +538,199 @@ module Google end end + # + class Instance + include Google::Apis::Core::Hashable + + # The full name of the Google Compute Engine + # [network](/compute/docs/networks-and-firewalls#networks) to which the + # instance is connected. If left unspecified, the `default` network + # will be used. + # Corresponds to the JSON property `authorizedNetwork` + # @return [String] + attr_accessor :authorized_network + + # Output only. The time the instance was created. + # Corresponds to the JSON property `createTime` + # @return [String] + attr_accessor :create_time + + # Output only. Endpoint for Discovery API + # Corresponds to the JSON property `discoveryEndpoint` + # @return [String] + attr_accessor :discovery_endpoint + + # User provided name for the instance only used for display + # purposes. Cannot be more than 80 characters. + # Corresponds to the JSON property `displayName` + # @return [String] + attr_accessor :display_name + + # List of messages that describe current statuses of memcached instance. + # Corresponds to the JSON property `instanceMessages` + # @return [Array] + attr_accessor :instance_messages + + # Resource labels to represent user-provided metadata. + # Refer to cloud documentation on labels for more details. + # https://cloud.google.com/compute/docs/labeling-resources + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + + # Output only. The full version of memcached server running on this instance. + # System automatically determines the full memcached version for an instance + # based on the input MemcacheVersion. + # The full version format will be "memcached-1.5.16". + # Corresponds to the JSON property `memcacheFullVersion` + # @return [String] + attr_accessor :memcache_full_version + + # Output only. List of Memcached nodes. + # Refer to [Node] message for more details. + # Corresponds to the JSON property `memcacheNodes` + # @return [Array] + attr_accessor :memcache_nodes + + # The major version of Memcached software. + # If not provided, latest supported version will be used. Currently the + # latest supported major version is MEMCACHE_1_5. + # The minor version will be automatically determined by our system based on + # the latest supported minor version. + # Corresponds to the JSON property `memcacheVersion` + # @return [String] + attr_accessor :memcache_version + + # Required. Unique name of the resource in this scope including project and + # location using the form: + # `projects/`project_id`/locations/`location_id`/instances/`instance_id`` + # Note: Memcached instances are managed and addressed at regional level so + # location_id here refers to a GCP region; however, users may choose which + # zones Memcached nodes within an instances should be provisioned in. + # Refer to [zones] field for more details. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # Configuration for a Memcached Node. + # Corresponds to the JSON property `nodeConfig` + # @return [Google::Apis::MemcacheV1::NodeConfig] + attr_accessor :node_config + + # Required. Number of nodes in the Memcached instance. + # Corresponds to the JSON property `nodeCount` + # @return [Fixnum] + attr_accessor :node_count + + # Optional: User defined parameters to apply to the memcached process + # on each node. + # Corresponds to the JSON property `parameters` + # @return [Google::Apis::MemcacheV1::MemcacheParameters] + attr_accessor :parameters + + # Output only. The state of this Memcached instance. + # Corresponds to the JSON property `state` + # @return [String] + attr_accessor :state + + # Output only. The time the instance was updated. + # Corresponds to the JSON property `updateTime` + # @return [String] + attr_accessor :update_time + + # Zones where Memcached nodes should be provisioned in. + # Memcached nodes will be equally distributed across these zones. If not + # provided, the service will by default create nodes in all zones in the + # region for the instance. + # Corresponds to the JSON property `zones` + # @return [Array] + attr_accessor :zones + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @authorized_network = args[:authorized_network] if args.key?(:authorized_network) + @create_time = args[:create_time] if args.key?(:create_time) + @discovery_endpoint = args[:discovery_endpoint] if args.key?(:discovery_endpoint) + @display_name = args[:display_name] if args.key?(:display_name) + @instance_messages = args[:instance_messages] if args.key?(:instance_messages) + @labels = args[:labels] if args.key?(:labels) + @memcache_full_version = args[:memcache_full_version] if args.key?(:memcache_full_version) + @memcache_nodes = args[:memcache_nodes] if args.key?(:memcache_nodes) + @memcache_version = args[:memcache_version] if args.key?(:memcache_version) + @name = args[:name] if args.key?(:name) + @node_config = args[:node_config] if args.key?(:node_config) + @node_count = args[:node_count] if args.key?(:node_count) + @parameters = args[:parameters] if args.key?(:parameters) + @state = args[:state] if args.key?(:state) + @update_time = args[:update_time] if args.key?(:update_time) + @zones = args[:zones] if args.key?(:zones) + end + end + + # + class InstanceMessage + include Google::Apis::Core::Hashable + + # A code that correspond to one type of user-facing message. + # Corresponds to the JSON property `code` + # @return [String] + attr_accessor :code + + # Message on memcached instance which will be exposed to users. + # Corresponds to the JSON property `message` + # @return [String] + attr_accessor :message + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @code = args[:code] if args.key?(:code) + @message = args[:message] if args.key?(:message) + end + end + + # Response for ListInstances. + class ListInstancesResponse + include Google::Apis::Core::Hashable + + # Token to retrieve the next page of results, or empty if there are no more + # results in the list. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + # A list of Memcached instances in the project in the specified location, + # or across all locations. + # If the `location_id` in the parent field of the request is "-", all regions + # available to the project are queried, and the results aggregated. + # Corresponds to the JSON property `resources` + # @return [Array] + attr_accessor :resources + + # 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) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + @resources = args[:resources] if args.key?(:resources) + @unreachable = args[:unreachable] if args.key?(:unreachable) + end + end + # The response message for Locations.ListLocations. class ListLocationsResponse include Google::Apis::Core::Hashable @@ -831,6 +849,110 @@ module Google end end + # + class MemcacheParameters + include Google::Apis::Core::Hashable + + # Output only. The unique ID associated with this set of parameters. Users + # can use this id to determine if the parameters associated with the instance + # differ from the parameters associated with the nodes and any action needs + # to be taken to apply parameters on nodes. + # Corresponds to the JSON property `id` + # @return [String] + attr_accessor :id + + # User defined set of parameters to use in the memcached process. + # Corresponds to the JSON property `params` + # @return [Hash] + attr_accessor :params + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @id = args[:id] if args.key?(:id) + @params = args[:params] if args.key?(:params) + end + end + + # + class Node + include Google::Apis::Core::Hashable + + # Output only. Hostname or IP address of the Memcached node used by the + # clients to connect to the Memcached server on this node. + # Corresponds to the JSON property `host` + # @return [String] + attr_accessor :host + + # Output only. Identifier of the Memcached node. The node id does not + # include project or location like the Memcached instance name. + # Corresponds to the JSON property `nodeId` + # @return [String] + attr_accessor :node_id + + # User defined parameters currently applied to the node. + # Corresponds to the JSON property `parameters` + # @return [Google::Apis::MemcacheV1::MemcacheParameters] + attr_accessor :parameters + + # Output only. The port number of the Memcached server on this node. + # Corresponds to the JSON property `port` + # @return [Fixnum] + attr_accessor :port + + # Output only. Current state of the Memcached node. + # Corresponds to the JSON property `state` + # @return [String] + attr_accessor :state + + # Output only. Location (GCP Zone) for the Memcached node. + # Corresponds to the JSON property `zone` + # @return [String] + attr_accessor :zone + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @host = args[:host] if args.key?(:host) + @node_id = args[:node_id] if args.key?(:node_id) + @parameters = args[:parameters] if args.key?(:parameters) + @port = args[:port] if args.key?(:port) + @state = args[:state] if args.key?(:state) + @zone = args[:zone] if args.key?(:zone) + end + end + + # Configuration for a Memcached Node. + class NodeConfig + include Google::Apis::Core::Hashable + + # Required. Number of cpus per Memcached node. + # Corresponds to the JSON property `cpuCount` + # @return [Fixnum] + attr_accessor :cpu_count + + # Required. Memory size in MiB for each Memcached node. + # Corresponds to the JSON property `memorySizeMb` + # @return [Fixnum] + attr_accessor :memory_size_mb + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @cpu_count = args[:cpu_count] if args.key?(:cpu_count) + @memory_size_mb = args[:memory_size_mb] if args.key?(:memory_size_mb) + end + end + # This resource represents a long-running operation that is the result of a # network API call. class Operation @@ -954,222 +1076,6 @@ module Google end end - # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). - class Policy - include Google::Apis::Core::Hashable - - # Specifies cloud audit logging configuration for this policy. - # Corresponds to the JSON property `auditConfigs` - # @return [Array] - attr_accessor :audit_configs - - # Associates a list of `members` to a `role`. Optionally, may specify a - # `condition` that determines how and when the `bindings` are applied. Each - # of the `bindings` must contain at least one member. - # Corresponds to the JSON property `bindings` - # @return [Array] - attr_accessor :bindings - - # `etag` is used for optimistic concurrency control as a way to help - # prevent simultaneous updates of a policy from overwriting each other. - # It is strongly suggested that systems make use of the `etag` in the - # read-modify-write cycle to perform policy updates in order to avoid race - # conditions: An `etag` is returned in the response to `getIamPolicy`, and - # systems are expected to put that etag in the request to `setIamPolicy` to - # ensure that their change will be applied to the same version of the policy. - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # Corresponds to the JSON property `etag` - # NOTE: Values are automatically base64 encoded/decoded in the client library. - # @return [String] - attr_accessor :etag - - # Specifies the format of the policy. - # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value - # are rejected. - # Any operation that affects conditional role bindings must specify version - # `3`. This requirement applies to the following operations: - # * Getting a policy that includes a conditional role binding - # * Adding a conditional role binding to a policy - # * Changing a conditional role binding in a policy - # * Removing any role binding, with or without a condition, from a policy - # that includes conditions - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # If a policy does not include any conditions, operations on that policy may - # specify any valid version or leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # Corresponds to the JSON property `version` - # @return [Fixnum] - attr_accessor :version - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @audit_configs = args[:audit_configs] if args.key?(:audit_configs) - @bindings = args[:bindings] if args.key?(:bindings) - @etag = args[:etag] if args.key?(:etag) - @version = args[:version] if args.key?(:version) - end - end - - # Request message for `SetIamPolicy` method. - class SetIamPolicyRequest - include Google::Apis::Core::Hashable - - # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). - # Corresponds to the JSON property `policy` - # @return [Google::Apis::MemcacheV1::Policy] - attr_accessor :policy - - # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # `paths: "bindings, etag"` - # Corresponds to the JSON property `updateMask` - # @return [String] - attr_accessor :update_mask - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @policy = args[:policy] if args.key?(:policy) - @update_mask = args[:update_mask] if args.key?(:update_mask) - 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 @@ -1209,17 +1115,19 @@ module Google end end - # Request message for `TestIamPermissions` method. - class TestIamPermissionsRequest + # Request for UpdateParameters. + class UpdateParametersRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with - # wildcards (such as '*' or 'storage.*') are not allowed. For more - # information see - # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). - # Corresponds to the JSON property `permissions` - # @return [Array] - attr_accessor :permissions + # The parameters to apply to the instance. + # Corresponds to the JSON property `parameters` + # @return [Google::Apis::MemcacheV1::MemcacheParameters] + attr_accessor :parameters + + # Required. Mask of fields to update. + # Corresponds to the JSON property `updateMask` + # @return [String] + attr_accessor :update_mask def initialize(**args) update!(**args) @@ -1227,27 +1135,8 @@ module Google # Update properties of this object def update!(**args) - @permissions = args[:permissions] if args.key?(:permissions) - end - end - - # Response message for `TestIamPermissions` method. - class TestIamPermissionsResponse - include Google::Apis::Core::Hashable - - # A subset of `TestPermissionsRequest.permissions` that the caller is - # allowed. - # Corresponds to the JSON property `permissions` - # @return [Array] - attr_accessor :permissions - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @permissions = args[:permissions] if args.key?(:permissions) + @parameters = args[:parameters] if args.key?(:parameters) + @update_mask = args[:update_mask] if args.key?(:update_mask) end end diff --git a/generated/google/apis/memcache_v1/representations.rb b/generated/google/apis/memcache_v1/representations.rb index 0b2122d86..cb08c6089 100644 --- a/generated/google/apis/memcache_v1/representations.rb +++ b/generated/google/apis/memcache_v1/representations.rb @@ -22,19 +22,7 @@ module Google module Apis module MemcacheV1 - class AuditConfig - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class AuditLogConfig - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class Binding + class ApplyParametersRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport @@ -52,7 +40,7 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class Expr + class GoogleCloudMemcacheV1OperationMetadata class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport @@ -106,6 +94,24 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class Instance + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class InstanceMessage + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ListInstancesResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ListLocationsResponse class Representation < Google::Apis::Core::JsonRepresentation; end @@ -130,6 +136,24 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class MemcacheParameters + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Node + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class NodeConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class Operation class Representation < Google::Apis::Core::JsonRepresentation; end @@ -142,31 +166,13 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class Policy - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class SetIamPolicyRequest - 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 TestIamPermissionsRequest - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - - class TestIamPermissionsResponse + class UpdateParametersRequest class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport @@ -178,30 +184,11 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class AuditConfig + class ApplyParametersRequest # @private class Representation < Google::Apis::Core::JsonRepresentation - collection :audit_log_configs, as: 'auditLogConfigs', class: Google::Apis::MemcacheV1::AuditLogConfig, decorator: Google::Apis::MemcacheV1::AuditLogConfig::Representation - - property :service, as: 'service' - end - end - - class AuditLogConfig - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :exempted_members, as: 'exemptedMembers' - property :log_type, as: 'logType' - end - end - - class Binding - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :condition, as: 'condition', class: Google::Apis::MemcacheV1::Expr, decorator: Google::Apis::MemcacheV1::Expr::Representation - - collection :members, as: 'members' - property :role, as: 'role' + property :apply_all, as: 'applyAll' + collection :node_ids, as: 'nodeIds' end end @@ -217,13 +204,16 @@ module Google end end - class Expr + class GoogleCloudMemcacheV1OperationMetadata # @private class Representation < Google::Apis::Core::JsonRepresentation - property :description, as: 'description' - property :expression, as: 'expression' - property :location, as: 'location' - property :title, as: 'title' + property :api_version, as: 'apiVersion' + property :cancel_requested, as: 'cancelRequested' + property :create_time, as: 'createTime' + property :end_time, as: 'endTime' + property :status_detail, as: 'statusDetail' + property :target, as: 'target' + property :verb, as: 'verb' end end @@ -318,6 +308,50 @@ module Google end end + class Instance + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :authorized_network, as: 'authorizedNetwork' + property :create_time, as: 'createTime' + property :discovery_endpoint, as: 'discoveryEndpoint' + property :display_name, as: 'displayName' + collection :instance_messages, as: 'instanceMessages', class: Google::Apis::MemcacheV1::InstanceMessage, decorator: Google::Apis::MemcacheV1::InstanceMessage::Representation + + hash :labels, as: 'labels' + property :memcache_full_version, as: 'memcacheFullVersion' + collection :memcache_nodes, as: 'memcacheNodes', class: Google::Apis::MemcacheV1::Node, decorator: Google::Apis::MemcacheV1::Node::Representation + + property :memcache_version, as: 'memcacheVersion' + property :name, as: 'name' + property :node_config, as: 'nodeConfig', class: Google::Apis::MemcacheV1::NodeConfig, decorator: Google::Apis::MemcacheV1::NodeConfig::Representation + + property :node_count, as: 'nodeCount' + property :parameters, as: 'parameters', class: Google::Apis::MemcacheV1::MemcacheParameters, decorator: Google::Apis::MemcacheV1::MemcacheParameters::Representation + + property :state, as: 'state' + property :update_time, as: 'updateTime' + collection :zones, as: 'zones' + end + end + + class InstanceMessage + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :code, as: 'code' + property :message, as: 'message' + end + end + + class ListInstancesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :next_page_token, as: 'nextPageToken' + collection :resources, as: 'resources', class: Google::Apis::MemcacheV1::Instance, decorator: Google::Apis::MemcacheV1::Instance::Representation + + collection :unreachable, as: 'unreachable' + end + end + class ListLocationsResponse # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -355,6 +389,35 @@ module Google end end + class MemcacheParameters + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :id, as: 'id' + hash :params, as: 'params' + end + end + + class Node + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :host, as: 'host' + property :node_id, as: 'nodeId' + property :parameters, as: 'parameters', class: Google::Apis::MemcacheV1::MemcacheParameters, decorator: Google::Apis::MemcacheV1::MemcacheParameters::Representation + + property :port, as: 'port' + property :state, as: 'state' + property :zone, as: 'zone' + end + end + + class NodeConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :cpu_count, as: 'cpuCount' + property :memory_size_mb, as: 'memorySizeMb' + end + end + class Operation # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -380,27 +443,6 @@ module Google end end - class Policy - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :audit_configs, as: 'auditConfigs', class: Google::Apis::MemcacheV1::AuditConfig, decorator: Google::Apis::MemcacheV1::AuditConfig::Representation - - collection :bindings, as: 'bindings', class: Google::Apis::MemcacheV1::Binding, decorator: Google::Apis::MemcacheV1::Binding::Representation - - property :etag, :base64 => true, as: 'etag' - property :version, as: 'version' - end - end - - class SetIamPolicyRequest - # @private - class Representation < Google::Apis::Core::JsonRepresentation - property :policy, as: 'policy', class: Google::Apis::MemcacheV1::Policy, decorator: Google::Apis::MemcacheV1::Policy::Representation - - property :update_mask, as: 'updateMask' - end - end - class Status # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -410,17 +452,12 @@ module Google end end - class TestIamPermissionsRequest + class UpdateParametersRequest # @private class Representation < Google::Apis::Core::JsonRepresentation - collection :permissions, as: 'permissions' - end - end + property :parameters, as: 'parameters', class: Google::Apis::MemcacheV1::MemcacheParameters, decorator: Google::Apis::MemcacheV1::MemcacheParameters::Representation - class TestIamPermissionsResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :permissions, as: 'permissions' + property :update_mask, as: 'updateMask' end end diff --git a/generated/google/apis/memcache_v1/service.rb b/generated/google/apis/memcache_v1/service.rb index ccd302066..bb5090a08 100644 --- a/generated/google/apis/memcache_v1/service.rb +++ b/generated/google/apis/memcache_v1/service.rb @@ -117,22 +117,13 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a resource. - # Returns an empty policy if the resource exists and does not have a policy - # set. - # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. - # @param [Fixnum] options_requested_policy_version - # Optional. The policy format version to be returned. - # Valid values are 0, 1, and 3. Requests specifying an invalid value will be - # rejected. - # Requests for policies with any conditional bindings must specify version 3. - # Policies without any conditional bindings may specify any valid value or - # leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM - # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + # ApplyParameters will update current set of Parameters to the set of + # specified nodes of the Memcached Instance. + # @param [String] name + # Required. Resource name of the Memcached instance for which parameter group + # updates + # should be applied. + # @param [Google::Apis::MemcacheV1::ApplyParametersRequest] apply_parameters_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -142,32 +133,40 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::MemcacheV1::Policy] parsed result object + # @yieldparam result [Google::Apis::MemcacheV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::MemcacheV1::Policy] + # @return [Google::Apis::MemcacheV1::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 get_project_location_instance_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options) - command.response_representation = Google::Apis::MemcacheV1::Policy::Representation - command.response_class = Google::Apis::MemcacheV1::Policy - command.params['resource'] = resource unless resource.nil? - command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil? + def apply_instance_parameters(name, apply_parameters_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+name}:applyParameters', options) + command.request_representation = Google::Apis::MemcacheV1::ApplyParametersRequest::Representation + command.request_object = apply_parameters_request_object + command.response_representation = Google::Apis::MemcacheV1::Operation::Representation + command.response_class = Google::Apis::MemcacheV1::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 - # Sets the access control policy on the specified resource. Replaces any - # existing policy. - # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. - # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. - # @param [Google::Apis::MemcacheV1::SetIamPolicyRequest] set_iam_policy_request_object + # Creates a new Instance in a given project and location. + # @param [String] parent + # Required. The resource name of the instance location using the form: + # `projects/`project_id`/locations/`location_id`` + # where `location_id` refers to a GCP region + # @param [Google::Apis::MemcacheV1::Instance] instance_object + # @param [String] instance_id + # Required. The logical name of the Memcached instance in the user + # project with the following restrictions: + # * Must contain only lowercase letters, numbers, and hyphens. + # * Must start with a letter. + # * Must be between 1-40 characters. + # * Must end with a number or a letter. + # * Must be unique within the user project / location # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -177,36 +176,32 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::MemcacheV1::Policy] parsed result object + # @yieldparam result [Google::Apis::MemcacheV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::MemcacheV1::Policy] + # @return [Google::Apis::MemcacheV1::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 set_instance_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options) - command.request_representation = Google::Apis::MemcacheV1::SetIamPolicyRequest::Representation - command.request_object = set_iam_policy_request_object - command.response_representation = Google::Apis::MemcacheV1::Policy::Representation - command.response_class = Google::Apis::MemcacheV1::Policy - command.params['resource'] = resource unless resource.nil? + def create_project_location_instance(parent, instance_object = nil, instance_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+parent}/instances', options) + command.request_representation = Google::Apis::MemcacheV1::Instance::Representation + command.request_object = instance_object + command.response_representation = Google::Apis::MemcacheV1::Operation::Representation + command.response_class = Google::Apis::MemcacheV1::Operation + command.params['parent'] = parent unless parent.nil? + command.query['instanceId'] = instance_id unless instance_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 - # Returns permissions that a caller has on the specified resource. - # If the resource does not exist, this will return an empty set of - # permissions, not a `NOT_FOUND` error. - # Note: This operation is designed to be used for building permission-aware - # UIs and command-line tools, not for authorization checking. This operation - # may "fail open" without warning. - # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. - # @param [Google::Apis::MemcacheV1::TestIamPermissionsRequest] test_iam_permissions_request_object + # Deletes a single Instance. + # @param [String] name + # Required. Memcached instance resource name in the format: + # `projects/`project_id`/locations/`location_id`/instances/`instance_id`` + # where `location_id` refers to a GCP region # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -216,21 +211,182 @@ module Google # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::MemcacheV1::TestIamPermissionsResponse] parsed result object + # @yieldparam result [Google::Apis::MemcacheV1::Operation] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::MemcacheV1::TestIamPermissionsResponse] + # @return [Google::Apis::MemcacheV1::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 test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options) - command.request_representation = Google::Apis::MemcacheV1::TestIamPermissionsRequest::Representation - command.request_object = test_iam_permissions_request_object - command.response_representation = Google::Apis::MemcacheV1::TestIamPermissionsResponse::Representation - command.response_class = Google::Apis::MemcacheV1::TestIamPermissionsResponse - command.params['resource'] = resource unless resource.nil? + def delete_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v1/{+name}', options) + command.response_representation = Google::Apis::MemcacheV1::Operation::Representation + command.response_class = Google::Apis::MemcacheV1::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 details of a single Instance. + # @param [String] name + # Required. Memcached instance resource name in the format: + # `projects/`project_id`/locations/`location_id`/instances/`instance_id`` + # where `location_id` refers to a GCP region + # @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::MemcacheV1::Instance] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::MemcacheV1::Instance] + # + # @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_instance(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/{+name}', options) + command.response_representation = Google::Apis::MemcacheV1::Instance::Representation + command.response_class = Google::Apis::MemcacheV1::Instance + 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 Instances in a given project and location. + # @param [String] parent + # Required. The resource name of the instance location using the form: + # `projects/`project_id`/locations/`location_id`` + # where `location_id` refers to a GCP region + # @param [String] filter + # List filter. For example, exclude all Memcached instances with name as + # my-instance by specifying "name != my-instance". + # @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. + # If not specified, a default value of 1000 will be used by the service. + # Regardless of the page_size value, the response may include a partial list + # and a caller should only rely on response's + # next_page_token + # to determine if there are more instances left to be queried. + # @param [String] page_token + # The next_page_token value returned from a previous List request, + # if any. + # @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::MemcacheV1::ListInstancesResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::MemcacheV1::ListInstancesResponse] + # + # @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_instances(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, 'v1/{+parent}/instances', options) + command.response_representation = Google::Apis::MemcacheV1::ListInstancesResponse::Representation + command.response_class = Google::Apis::MemcacheV1::ListInstancesResponse + 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 an existing Instance in a given project and location. + # @param [String] name + # Required. Unique name of the resource in this scope including project and + # location using the form: + # `projects/`project_id`/locations/`location_id`/instances/`instance_id`` + # Note: Memcached instances are managed and addressed at regional level so + # location_id here refers to a GCP region; however, users may choose which + # zones Memcached nodes within an instances should be provisioned in. + # Refer to [zones] field for more details. + # @param [Google::Apis::MemcacheV1::Instance] instance_object + # @param [String] update_mask + # Required. Mask of fields to update. + # * `displayName` + # @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::MemcacheV1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::MemcacheV1::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_instance(name, instance_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'v1/{+name}', options) + command.request_representation = Google::Apis::MemcacheV1::Instance::Representation + command.request_object = instance_object + command.response_representation = Google::Apis::MemcacheV1::Operation::Representation + command.response_class = Google::Apis::MemcacheV1::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 + + # Updates the defined Memcached Parameters for an existing Instance. + # This method only stages the parameters, it must be followed by + # ApplyParameters to apply the parameters to nodes of the Memcached Instance. + # @param [String] name + # Required. Resource name of the Memcached instance for which the parameters + # should be + # updated. + # @param [Google::Apis::MemcacheV1::UpdateParametersRequest] update_parameters_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::MemcacheV1::Operation] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::MemcacheV1::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 update_instance_parameters(name, update_parameters_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'v1/{+name}:updateParameters', options) + command.request_representation = Google::Apis::MemcacheV1::UpdateParametersRequest::Representation + command.request_object = update_parameters_request_object + command.response_representation = Google::Apis::MemcacheV1::Operation::Representation + command.response_class = Google::Apis::MemcacheV1::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) diff --git a/generated/google/apis/people_v1.rb b/generated/google/apis/people_v1.rb index a67f73cbc..72bedd762 100644 --- a/generated/google/apis/people_v1.rb +++ b/generated/google/apis/people_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://developers.google.com/people/ module PeopleV1 VERSION = 'V1' - REVISION = '20200727' + REVISION = '20200730' # See, edit, download, and permanently delete your contacts AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts' diff --git a/generated/google/apis/people_v1/classes.rb b/generated/google/apis/people_v1/classes.rb index 1a690dec4..c7f15f034 100644 --- a/generated/google/apis/people_v1/classes.rb +++ b/generated/google/apis/people_v1/classes.rb @@ -470,9 +470,9 @@ module Google # the copy mask with metadata and membership fields if not set. Valid values are: # * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # Corresponds to the JSON property `readMask` # @return [String] attr_accessor :read_mask @@ -1187,6 +1187,44 @@ module Google end end + # A person's miscellaneous keyword. + class MiscKeyword + include Google::Apis::Core::Hashable + + # Output only. The type of the miscellaneous keyword translated and formatted in + # the viewer's account locale or the `Accept-Language` HTTP header locale. + # Corresponds to the JSON property `formattedType` + # @return [String] + attr_accessor :formatted_type + + # Metadata about a field. + # Corresponds to the JSON property `metadata` + # @return [Google::Apis::PeopleV1::FieldMetadata] + attr_accessor :metadata + + # The miscellaneous keyword type. + # Corresponds to the JSON property `type` + # @return [String] + attr_accessor :type + + # The value of the miscellaneous keyword. + # Corresponds to the JSON property `value` + # @return [String] + attr_accessor :value + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @formatted_type = args[:formatted_type] if args.key?(:formatted_type) + @metadata = args[:metadata] if args.key?(:metadata) + @type = args[:type] if args.key?(:type) + @value = args[:value] if args.key?(:value) + end + end + # A request to modify an existing contact group's members. Contacts can be # removed from any group but they can only be added to a user group or " # myContacts" or "starred" system groups. @@ -1624,6 +1662,11 @@ module Google # @return [Google::Apis::PeopleV1::PersonMetadata] attr_accessor :metadata + # The person's miscellaneous keywords. + # Corresponds to the JSON property `miscKeywords` + # @return [Array] + attr_accessor :misc_keywords + # The person's names. This field is a singleton for contact sources. # Corresponds to the JSON property `names` # @return [Array] @@ -1732,6 +1775,7 @@ module Google @locales = args[:locales] if args.key?(:locales) @memberships = args[:memberships] if args.key?(:memberships) @metadata = args[:metadata] if args.key?(:metadata) + @misc_keywords = args[:misc_keywords] if args.key?(:misc_keywords) @names = args[:names] if args.key?(:names) @nicknames = args[:nicknames] if args.key?(:nicknames) @occupations = args[:occupations] if args.key?(:occupations) @@ -2344,9 +2388,9 @@ module Google # empty if not set, which will skip the post mutate get. Valid values are: * # addresses * ageRanges * biographies * birthdays * calendarUrls * coverPhotos * # emailAddresses * events * externalIds * genders * imClients * interests * - # locales * memberships * metadata * names * nicknames * occupations * - # organizations * phoneNumbers * photos * relations * residences * sipAddresses * - # skills * urls * userDefined + # locales * memberships * metadata * miscKeywords * names * nicknames * + # occupations * organizations * phoneNumbers * photos * relations * residences * + # sipAddresses * skills * urls * userDefined # Corresponds to the JSON property `personFields` # @return [String] attr_accessor :person_fields diff --git a/generated/google/apis/people_v1/representations.rb b/generated/google/apis/people_v1/representations.rb index 942d3ff57..9a6487f9e 100644 --- a/generated/google/apis/people_v1/representations.rb +++ b/generated/google/apis/people_v1/representations.rb @@ -220,6 +220,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class MiscKeyword + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ModifyContactGroupMembersRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -717,6 +723,17 @@ module Google end end + class MiscKeyword + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :formatted_type, as: 'formattedType' + property :metadata, as: 'metadata', class: Google::Apis::PeopleV1::FieldMetadata, decorator: Google::Apis::PeopleV1::FieldMetadata::Representation + + property :type, as: 'type' + property :value, as: 'value' + end + end + class ModifyContactGroupMembersRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -836,6 +853,8 @@ module Google property :metadata, as: 'metadata', class: Google::Apis::PeopleV1::PersonMetadata, decorator: Google::Apis::PeopleV1::PersonMetadata::Representation + collection :misc_keywords, as: 'miscKeywords', class: Google::Apis::PeopleV1::MiscKeyword, decorator: Google::Apis::PeopleV1::MiscKeyword::Representation + collection :names, as: 'names', class: Google::Apis::PeopleV1::Name, decorator: Google::Apis::PeopleV1::Name::Representation collection :nicknames, as: 'nicknames', class: Google::Apis::PeopleV1::Nickname, decorator: Google::Apis::PeopleV1::Nickname::Representation diff --git a/generated/google/apis/people_v1/service.rb b/generated/google/apis/people_v1/service.rb index b01a3c25a..fe3e26cd2 100644 --- a/generated/google/apis/people_v1/service.rb +++ b/generated/google/apis/people_v1/service.rb @@ -393,8 +393,9 @@ module Google # all fields if not set. Valid values are: * addresses * ageRanges * biographies # * birthdays * calendarUrls * coverPhotos * emailAddresses * events * # externalIds * genders * imClients * interests * locales * memberships * - # metadata * names * nicknames * occupations * organizations * phoneNumbers * - # photos * relations * residences * sipAddresses * skills * urls * userDefined + # metadata * miscKeywords * names * nicknames * occupations * organizations * + # phoneNumbers * photos * relations * residences * sipAddresses * skills * urls * + # userDefined # @param [Array, String] sources # Optional. A mask of what source types to return. Defaults to ReadSourceType. # CONTACT and ReadSourceType.PROFILE if not set. @@ -467,9 +468,9 @@ module Google # empty if not set, which will skip the post mutate get. Valid values are: * # addresses * ageRanges * biographies * birthdays * calendarUrls * coverPhotos * # emailAddresses * events * externalIds * genders * imClients * interests * - # locales * memberships * metadata * names * nicknames * occupations * - # organizations * phoneNumbers * photos * relations * residences * sipAddresses * - # skills * urls * userDefined + # locales * memberships * metadata * miscKeywords * names * nicknames * + # occupations * organizations * phoneNumbers * photos * relations * residences * + # sipAddresses * skills * urls * userDefined # @param [Array, String] sources # Optional. A mask of what source types to return. Defaults to ReadSourceType. # CONTACT and ReadSourceType.PROFILE if not set. @@ -517,9 +518,9 @@ module Google # Multiple fields can be specified by separating them with commas. Valid values # are: * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # @param [String] request_mask_include_field # Required. Comma-separated list of person fields to be included in the response. # Each path should start with `person.`: for example, `person.names` or `person. @@ -565,9 +566,9 @@ module Google # Multiple fields can be specified by separating them with commas. Valid values # are: * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # @param [String] request_mask_include_field # Required. Comma-separated list of person fields to be included in the response. # Each path should start with `person.`: for example, `person.names` or `person. @@ -630,9 +631,9 @@ module Google # Multiple fields can be specified by separating them with commas. Valid values # are: * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # @param [Boolean] request_sync_token # Optional. Whether the response should include `next_sync_token`, which can be # used to get all changes since the last request. For subsequent sync requests @@ -698,9 +699,9 @@ module Google # Multiple fields can be specified by separating them with commas. Valid values # are: * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # @param [Array, String] sources # Required. Directory sources to return. # @param [String] fields @@ -758,8 +759,9 @@ module Google # all fields if not set. Valid values are: * addresses * ageRanges * biographies # * birthdays * calendarUrls * coverPhotos * emailAddresses * events * # externalIds * genders * imClients * interests * locales * memberships * - # metadata * names * nicknames * occupations * organizations * phoneNumbers * - # photos * relations * residences * sipAddresses * skills * urls * userDefined + # metadata * miscKeywords * names * nicknames * occupations * organizations * + # phoneNumbers * photos * relations * residences * sipAddresses * skills * urls * + # userDefined # @param [Array, String] sources # Optional. A mask of what source types to return. Defaults to ReadSourceType. # CONTACT and ReadSourceType.PROFILE if not set. @@ -768,9 +770,9 @@ module Google # Multiple fields can be specified by separating them with commas. All updated # fields will be replaced. Valid values are: * addresses * biographies * # birthdays * calendarUrls * emailAddresses * events * externalIds * genders * - # imClients * interests * locales * memberships * names * nicknames * - # occupations * organizations * phoneNumbers * relations * residences * - # sipAddresses * urls * userDefined + # imClients * interests * locales * memberships * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * relations * + # residences * sipAddresses * urls * userDefined # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -854,9 +856,9 @@ module Google # Multiple fields can be specified by separating them with commas. Valid values # are: * addresses * ageRanges * biographies * birthdays * calendarUrls * # coverPhotos * emailAddresses * events * externalIds * genders * imClients * - # interests * locales * memberships * metadata * names * nicknames * occupations - # * organizations * phoneNumbers * photos * relations * residences * - # sipAddresses * skills * urls * userDefined + # interests * locales * memberships * metadata * miscKeywords * names * + # nicknames * occupations * organizations * phoneNumbers * photos * relations * + # residences * sipAddresses * skills * urls * userDefined # @param [String] request_mask_include_field # Required. Comma-separated list of person fields to be included in the response. # Each path should start with `person.`: for example, `person.names` or `person. diff --git a/generated/google/apis/recommendationengine_v1beta1.rb b/generated/google/apis/recommendationengine_v1beta1.rb index 1edf73afd..b313f7d1b 100644 --- a/generated/google/apis/recommendationengine_v1beta1.rb +++ b/generated/google/apis/recommendationengine_v1beta1.rb @@ -24,10 +24,10 @@ module Google # recommendation systems without requiring a high level of expertise in machine # learning, recommendation system, or Google Cloud. # - # @see https://cloud.google.com/recommendations/docs/ + # @see https://cloud.google.com/recommendations-ai/docs module RecommendationengineV1beta1 VERSION = 'V1beta1' - REVISION = '20200706' + REVISION = '20200728' # 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/recommendationengine_v1beta1/classes.rb b/generated/google/apis/recommendationengine_v1beta1/classes.rb index 7aac64662..8a3c04a8e 100644 --- a/generated/google/apis/recommendationengine_v1beta1/classes.rb +++ b/generated/google/apis/recommendationengine_v1beta1/classes.rb @@ -174,8 +174,10 @@ module Google # @return [String] attr_accessor :dataset_id - # Required. Intermediate gcs dir used for the import. - # . + # Optional. Intermediate Cloud Storage directory used for the import. Can be + # specified + # if one wants to have the BigQuery export to a specific Cloud Storage + # directory. # Corresponds to the JSON property `gcsStagingDir` # @return [String] attr_accessor :gcs_staging_dir @@ -1056,9 +1058,9 @@ module Google # * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional") # * filterOutOfStockItems tag=(-"promotional") # * filterOutOfStockItems - # If your filter blocks all prediction results, generic (unfiltered) popular - # items are returned. This behavior can be overridden by setting - # `strictFiltering` to true in `PredictRequest.params`. + # If your filter blocks all prediction results, nothing will be returned. If + # you want generic (unfiltered) popular items to be returned instead, set + # `strictFiltering` to false in `PredictRequest.params`. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter @@ -1097,9 +1099,9 @@ module Google # field in the prediction response. The given 'score' indicates the # probability of an item being clicked/purchased given the user's context # and history. - # * `strictFiltering`: Boolean. If set to true, the service will return empty - # instead of generic (unfiltered) popular items if your filter blocks all - # prediction results. + # * `strictFiltering`: Boolean. True by default. If set to false, the service + # will return generic (unfiltered) popular items instead of empty if your + # filter blocks all prediction results. # Corresponds to the JSON property `params` # @return [Hash] attr_accessor :params diff --git a/generated/google/apis/recommendationengine_v1beta1/service.rb b/generated/google/apis/recommendationengine_v1beta1/service.rb index a5ae62f46..c5862b3bc 100644 --- a/generated/google/apis/recommendationengine_v1beta1/service.rb +++ b/generated/google/apis/recommendationengine_v1beta1/service.rb @@ -32,7 +32,7 @@ module Google # Recommendationengine = Google::Apis::RecommendationengineV1beta1 # Alias the module # service = Recommendationengine::RecommendationsAIService.new # - # @see https://cloud.google.com/recommendations/docs/ + # @see https://cloud.google.com/recommendations-ai/docs class RecommendationsAIService < Google::Apis::Core::BaseService # @return [String] # API key. Your API key identifies your project and provides you with API access, diff --git a/generated/google/apis/servicecontrol_v2.rb b/generated/google/apis/servicecontrol_v2.rb new file mode 100644 index 000000000..0de52148a --- /dev/null +++ b/generated/google/apis/servicecontrol_v2.rb @@ -0,0 +1,38 @@ +# 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/servicecontrol_v2/service.rb' +require 'google/apis/servicecontrol_v2/classes.rb' +require 'google/apis/servicecontrol_v2/representations.rb' + +module Google + module Apis + # Service Control API + # + # Provides control plane functionality to managed services, such as logging, + # monitoring, and status checks. + # + # @see https://cloud.google.com/service-control/ + module ServicecontrolV2 + VERSION = 'V2' + REVISION = '20200727' + + # View and manage your data across Google Cloud Platform services + AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' + + # Manage your Google Service Control data + AUTH_SERVICECONTROL = 'https://www.googleapis.com/auth/servicecontrol' + end + end +end diff --git a/generated/google/apis/servicecontrol_v2/classes.rb b/generated/google/apis/servicecontrol_v2/classes.rb new file mode 100644 index 000000000..39f2f156c --- /dev/null +++ b/generated/google/apis/servicecontrol_v2/classes.rb @@ -0,0 +1,1121 @@ +# 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 ServicecontrolV2 + + # This message defines attributes associated with API operations, such as + # a network API request. The terminology is based on the conventions used + # by Google APIs, Istio, and OpenAPI. + class Api + include Google::Apis::Core::Hashable + + # The API operation name. For gRPC requests, it is the fully qualified API + # method name, such as "google.pubsub.v1.Publisher.Publish". For OpenAPI + # requests, it is the `operationId`, such as "getPet". + # Corresponds to the JSON property `operation` + # @return [String] + attr_accessor :operation + + # The API protocol used for sending the request, such as "http", "https", + # "grpc", or "internal". + # Corresponds to the JSON property `protocol` + # @return [String] + attr_accessor :protocol + + # The API service name. It is a logical identifier for a networked API, + # such as "pubsub.googleapis.com". The naming syntax depends on the + # API management system being used for handling the request. + # Corresponds to the JSON property `service` + # @return [String] + attr_accessor :service + + # The API version associated with the API operation above, such as "v1" or + # "v1alpha1". + # Corresponds to the JSON property `version` + # @return [String] + attr_accessor :version + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @operation = args[:operation] if args.key?(:operation) + @protocol = args[:protocol] if args.key?(:protocol) + @service = args[:service] if args.key?(:service) + @version = args[:version] if args.key?(:version) + end + end + + # This message defines the standard attribute vocabulary for Google APIs. + # An attribute is a piece of metadata that describes an activity on a network + # service. For example, the size of an HTTP request, or the status code of + # an HTTP response. + # Each attribute has a type and a name, which is logically defined as + # a proto message field in `AttributeContext`. The field type becomes the + # attribute type, and the field path becomes the attribute name. For example, + # the attribute `source.ip` maps to field `AttributeContext.source.ip`. + # This message definition is guaranteed not to have any wire breaking change. + # So you can use it directly for passing attributes across different systems. + # NOTE: Different system may generate different subset of attributes. Please + # verify the system specification before relying on an attribute generated + # a system. + class AttributeContext + include Google::Apis::Core::Hashable + + # This message defines attributes associated with API operations, such as + # a network API request. The terminology is based on the conventions used + # by Google APIs, Istio, and OpenAPI. + # Corresponds to the JSON property `api` + # @return [Google::Apis::ServicecontrolV2::Api] + attr_accessor :api + + # This message defines attributes for a node that handles a network request. + # The node can be either a service or an application that sends, forwards, + # or receives the request. Service peers should fill in + # `principal` and `labels` as appropriate. + # Corresponds to the JSON property `destination` + # @return [Google::Apis::ServicecontrolV2::Peer] + attr_accessor :destination + + # Supports extensions for advanced use cases, such as logs and metrics. + # Corresponds to the JSON property `extensions` + # @return [Array>] + attr_accessor :extensions + + # This message defines attributes for a node that handles a network request. + # The node can be either a service or an application that sends, forwards, + # or receives the request. Service peers should fill in + # `principal` and `labels` as appropriate. + # Corresponds to the JSON property `origin` + # @return [Google::Apis::ServicecontrolV2::Peer] + attr_accessor :origin + + # This message defines attributes for an HTTP request. If the actual + # request is not an HTTP request, the runtime system should try to map + # the actual request to an equivalent HTTP request. + # Corresponds to the JSON property `request` + # @return [Google::Apis::ServicecontrolV2::Request] + attr_accessor :request + + # This message defines core attributes for a resource. A resource is an + # addressable (named) entity provided by the destination service. For + # example, a file stored on a network storage service. + # Corresponds to the JSON property `resource` + # @return [Google::Apis::ServicecontrolV2::Resource] + attr_accessor :resource + + # This message defines attributes for a typical network response. It + # generally models semantics of an HTTP response. + # Corresponds to the JSON property `response` + # @return [Google::Apis::ServicecontrolV2::Response] + attr_accessor :response + + # This message defines attributes for a node that handles a network request. + # The node can be either a service or an application that sends, forwards, + # or receives the request. Service peers should fill in + # `principal` and `labels` as appropriate. + # Corresponds to the JSON property `source` + # @return [Google::Apis::ServicecontrolV2::Peer] + attr_accessor :source + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @api = args[:api] if args.key?(:api) + @destination = args[:destination] if args.key?(:destination) + @extensions = args[:extensions] if args.key?(:extensions) + @origin = args[:origin] if args.key?(:origin) + @request = args[:request] if args.key?(:request) + @resource = args[:resource] if args.key?(:resource) + @response = args[:response] if args.key?(:response) + @source = args[:source] if args.key?(:source) + end + end + + # Common audit log format for Google Cloud Platform API operations. + class AuditLog + include Google::Apis::Core::Hashable + + # Authentication information for the operation. + # Corresponds to the JSON property `authenticationInfo` + # @return [Google::Apis::ServicecontrolV2::AuthenticationInfo] + attr_accessor :authentication_info + + # Authorization information. If there are multiple + # resources or permissions involved, then there is + # one AuthorizationInfo element for each `resource, permission` tuple. + # Corresponds to the JSON property `authorizationInfo` + # @return [Array] + attr_accessor :authorization_info + + # Other service-specific data about the request, response, and other + # information associated with the current audited event. + # Corresponds to the JSON property `metadata` + # @return [Hash] + attr_accessor :metadata + + # The name of the service method or operation. + # For API calls, this should be the name of the API method. + # For example, + # "google.cloud.bigquery.v2.TableService.InsertTable" + # "google.logging.v2.ConfigServiceV2.CreateSink" + # Corresponds to the JSON property `methodName` + # @return [String] + attr_accessor :method_name + + # The number of items returned from a List or Query API method, + # if applicable. + # Corresponds to the JSON property `numResponseItems` + # @return [Fixnum] + attr_accessor :num_response_items + + # The operation request. This may not include all request parameters, + # such as those that are too large, privacy-sensitive, or duplicated + # elsewhere in the log record. + # It should never include user-generated data, such as file contents. + # When the JSON object represented here has a proto equivalent, the proto + # name will be indicated in the `@type` property. + # Corresponds to the JSON property `request` + # @return [Hash] + attr_accessor :request + + # Metadata about the request. + # Corresponds to the JSON property `requestMetadata` + # @return [Google::Apis::ServicecontrolV2::RequestMetadata] + attr_accessor :request_metadata + + # Location information about a resource. + # Corresponds to the JSON property `resourceLocation` + # @return [Google::Apis::ServicecontrolV2::ResourceLocation] + attr_accessor :resource_location + + # The resource or collection that is the target of the operation. + # The name is a scheme-less URI, not including the API service name. + # For example: + # "projects/PROJECT_ID/zones/us-central1-a/instances" + # "projects/PROJECT_ID/datasets/DATASET_ID" + # Corresponds to the JSON property `resourceName` + # @return [String] + attr_accessor :resource_name + + # The resource's original state before mutation. Present only for + # operations which have successfully modified the targeted resource(s). + # In general, this field should contain all changed fields, except those + # that are already been included in `request`, `response`, `metadata` or + # `service_data` fields. + # When the JSON object represented here has a proto equivalent, + # the proto name will be indicated in the `@type` property. + # Corresponds to the JSON property `resourceOriginalState` + # @return [Hash] + attr_accessor :resource_original_state + + # The operation response. This may not include all response elements, + # such as those that are too large, privacy-sensitive, or duplicated + # elsewhere in the log record. + # It should never include user-generated data, such as file contents. + # When the JSON object represented here has a proto equivalent, the proto + # name will be indicated in the `@type` property. + # Corresponds to the JSON property `response` + # @return [Hash] + attr_accessor :response + + # Deprecated. Use the `metadata` field instead. + # Other service-specific data about the request, response, and other + # activities. + # Corresponds to the JSON property `serviceData` + # @return [Hash] + attr_accessor :service_data + + # The name of the API service performing the operation. For example, + # `"compute.googleapis.com"`. + # Corresponds to the JSON property `serviceName` + # @return [String] + attr_accessor :service_name + + # 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 `status` + # @return [Google::Apis::ServicecontrolV2::Status] + attr_accessor :status + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @authentication_info = args[:authentication_info] if args.key?(:authentication_info) + @authorization_info = args[:authorization_info] if args.key?(:authorization_info) + @metadata = args[:metadata] if args.key?(:metadata) + @method_name = args[:method_name] if args.key?(:method_name) + @num_response_items = args[:num_response_items] if args.key?(:num_response_items) + @request = args[:request] if args.key?(:request) + @request_metadata = args[:request_metadata] if args.key?(:request_metadata) + @resource_location = args[:resource_location] if args.key?(:resource_location) + @resource_name = args[:resource_name] if args.key?(:resource_name) + @resource_original_state = args[:resource_original_state] if args.key?(:resource_original_state) + @response = args[:response] if args.key?(:response) + @service_data = args[:service_data] if args.key?(:service_data) + @service_name = args[:service_name] if args.key?(:service_name) + @status = args[:status] if args.key?(:status) + end + end + + # This message defines request authentication attributes. Terminology is + # based on the JSON Web Token (JWT) standard, but the terms also + # correlate to concepts in other standards. + class Auth + include Google::Apis::Core::Hashable + + # A list of access level resource names that allow resources to be + # accessed by authenticated requester. It is part of Secure GCP processing + # for the incoming request. An access level string has the format: + # "//`api_service_name`/accessPolicies/`policy_id`/accessLevels/`short_name`" + # Example: + # "//accesscontextmanager.googleapis.com/accessPolicies/MY_POLICY_ID/ + # accessLevels/MY_LEVEL" + # Corresponds to the JSON property `accessLevels` + # @return [Array] + attr_accessor :access_levels + + # The intended audience(s) for this authentication information. Reflects + # the audience (`aud`) claim within a JWT. The audience + # value(s) depends on the `issuer`, but typically include one or more of + # the following pieces of information: + # * The services intended to receive the credential. For example, + # ["https://pubsub.googleapis.com/", "https://storage.googleapis.com/"]. + # * A set of service-based scopes. For example, + # ["https://www.googleapis.com/auth/cloud-platform"]. + # * The client id of an app, such as the Firebase project id for JWTs + # from Firebase Auth. + # Consult the documentation for the credential issuer to determine the + # information provided. + # Corresponds to the JSON property `audiences` + # @return [Array] + attr_accessor :audiences + + # Structured claims presented with the credential. JWTs include + # ``key: value`` pairs for standard and private claims. The following + # is a subset of the standard required and optional claims that would + # typically be presented for a Google-based JWT: + # `'iss': 'accounts.google.com', + # 'sub': '113289723416554971153', + # 'aud': ['123456789012', 'pubsub.googleapis.com'], + # 'azp': '123456789012.apps.googleusercontent.com', + # 'email': 'jsmith@example.com', + # 'iat': 1353601026, + # 'exp': 1353604926` + # SAML assertions are similarly specified, but with an identity provider + # dependent structure. + # Corresponds to the JSON property `claims` + # @return [Hash] + attr_accessor :claims + + # The authorized presenter of the credential. Reflects the optional + # Authorized Presenter (`azp`) claim within a JWT or the + # OAuth client id. For example, a Google Cloud Platform client id looks + # as follows: "123456789012.apps.googleusercontent.com". + # Corresponds to the JSON property `presenter` + # @return [String] + attr_accessor :presenter + + # The authenticated principal. Reflects the issuer (`iss`) and subject + # (`sub`) claims within a JWT. The issuer and subject should be `/` + # delimited, with `/` percent-encoded within the subject fragment. For + # Google accounts, the principal format is: + # "https://accounts.google.com/`id`" + # Corresponds to the JSON property `principal` + # @return [String] + attr_accessor :principal + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @access_levels = args[:access_levels] if args.key?(:access_levels) + @audiences = args[:audiences] if args.key?(:audiences) + @claims = args[:claims] if args.key?(:claims) + @presenter = args[:presenter] if args.key?(:presenter) + @principal = args[:principal] if args.key?(:principal) + end + end + + # Authentication information for the operation. + class AuthenticationInfo + include Google::Apis::Core::Hashable + + # The authority selector specified by the requestor, if any. + # It is not guaranteed that the principal was allowed to use this authority. + # Corresponds to the JSON property `authoritySelector` + # @return [String] + attr_accessor :authority_selector + + # The email address of the authenticated user (or service account on behalf + # of third party principal) making the request. For privacy reasons, the + # principal email address is redacted for all read-only operations that fail + # with a "permission denied" error. + # Corresponds to the JSON property `principalEmail` + # @return [String] + attr_accessor :principal_email + + # String representation of identity of requesting party. + # Populated for both first and third party identities. + # Corresponds to the JSON property `principalSubject` + # @return [String] + attr_accessor :principal_subject + + # Identity delegation history of an authenticated service account that makes + # the request. It contains information on the real authorities that try to + # access GCP resources by delegating on a service account. When multiple + # authorities present, they are guaranteed to be sorted based on the original + # ordering of the identity delegation events. + # Corresponds to the JSON property `serviceAccountDelegationInfo` + # @return [Array] + attr_accessor :service_account_delegation_info + + # The name of the service account key used to create or exchange + # credentials for authenticating the service account making the request. + # This is a scheme-less URI full resource name. For example: + # "//iam.googleapis.com/projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT`/keys/` + # key`" + # Corresponds to the JSON property `serviceAccountKeyName` + # @return [String] + attr_accessor :service_account_key_name + + # The third party identification (if any) of the authenticated user making + # the request. + # When the JSON object represented here has a proto equivalent, the proto + # name will be indicated in the `@type` property. + # Corresponds to the JSON property `thirdPartyPrincipal` + # @return [Hash] + attr_accessor :third_party_principal + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @authority_selector = args[:authority_selector] if args.key?(:authority_selector) + @principal_email = args[:principal_email] if args.key?(:principal_email) + @principal_subject = args[:principal_subject] if args.key?(:principal_subject) + @service_account_delegation_info = args[:service_account_delegation_info] if args.key?(:service_account_delegation_info) + @service_account_key_name = args[:service_account_key_name] if args.key?(:service_account_key_name) + @third_party_principal = args[:third_party_principal] if args.key?(:third_party_principal) + end + end + + # Authorization information for the operation. + class AuthorizationInfo + include Google::Apis::Core::Hashable + + # Whether or not authorization for `resource` and `permission` + # was granted. + # Corresponds to the JSON property `granted` + # @return [Boolean] + attr_accessor :granted + alias_method :granted?, :granted + + # The required IAM permission. + # Corresponds to the JSON property `permission` + # @return [String] + attr_accessor :permission + + # The resource being accessed, as a REST-style string. For example: + # bigquery.googleapis.com/projects/PROJECTID/datasets/DATASETID + # Corresponds to the JSON property `resource` + # @return [String] + attr_accessor :resource + + # This message defines core attributes for a resource. A resource is an + # addressable (named) entity provided by the destination service. For + # example, a file stored on a network storage service. + # Corresponds to the JSON property `resourceAttributes` + # @return [Google::Apis::ServicecontrolV2::Resource] + attr_accessor :resource_attributes + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @granted = args[:granted] if args.key?(:granted) + @permission = args[:permission] if args.key?(:permission) + @resource = args[:resource] if args.key?(:resource) + @resource_attributes = args[:resource_attributes] if args.key?(:resource_attributes) + end + end + + # Request message for the Check method. + class CheckRequest + include Google::Apis::Core::Hashable + + # This message defines the standard attribute vocabulary for Google APIs. + # An attribute is a piece of metadata that describes an activity on a network + # service. For example, the size of an HTTP request, or the status code of + # an HTTP response. + # Each attribute has a type and a name, which is logically defined as + # a proto message field in `AttributeContext`. The field type becomes the + # attribute type, and the field path becomes the attribute name. For example, + # the attribute `source.ip` maps to field `AttributeContext.source.ip`. + # This message definition is guaranteed not to have any wire breaking change. + # So you can use it directly for passing attributes across different systems. + # NOTE: Different system may generate different subset of attributes. Please + # verify the system specification before relying on an attribute generated + # a system. + # Corresponds to the JSON property `attributes` + # @return [Google::Apis::ServicecontrolV2::AttributeContext] + attr_accessor :attributes + + # Describes the resources and the policies applied to each resource. + # Corresponds to the JSON property `resources` + # @return [Array] + attr_accessor :resources + + # Specifies the version of the service configuration that should be used to + # process the request. Must not be empty. Set this field to 'latest' to + # specify using the latest configuration. + # Corresponds to the JSON property `serviceConfigId` + # @return [String] + attr_accessor :service_config_id + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @attributes = args[:attributes] if args.key?(:attributes) + @resources = args[:resources] if args.key?(:resources) + @service_config_id = args[:service_config_id] if args.key?(:service_config_id) + end + end + + # Response message for the Check method. + class CheckResponse + include Google::Apis::Core::Hashable + + # Returns a set of request contexts generated from the `CheckRequest`. + # Corresponds to the JSON property `headers` + # @return [Hash] + attr_accessor :headers + + # 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 `status` + # @return [Google::Apis::ServicecontrolV2::Status] + attr_accessor :status + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @headers = args[:headers] if args.key?(:headers) + @status = args[:status] if args.key?(:status) + end + end + + # First party identity principal. + class FirstPartyPrincipal + include Google::Apis::Core::Hashable + + # The email address of a Google account. + # . + # Corresponds to the JSON property `principalEmail` + # @return [String] + attr_accessor :principal_email + + # Metadata about the service that uses the service account. + # . + # Corresponds to the JSON property `serviceMetadata` + # @return [Hash] + attr_accessor :service_metadata + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @principal_email = args[:principal_email] if args.key?(:principal_email) + @service_metadata = args[:service_metadata] if args.key?(:service_metadata) + end + end + + # This message defines attributes for a node that handles a network request. + # The node can be either a service or an application that sends, forwards, + # or receives the request. Service peers should fill in + # `principal` and `labels` as appropriate. + class Peer + include Google::Apis::Core::Hashable + + # The IP address of the peer. + # Corresponds to the JSON property `ip` + # @return [String] + attr_accessor :ip + + # The labels associated with the peer. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + + # The network port of the peer. + # Corresponds to the JSON property `port` + # @return [Fixnum] + attr_accessor :port + + # The identity of this peer. Similar to `Request.auth.principal`, but + # relative to the peer instead of the request. For example, the + # idenity associated with a load balancer that forwared the request. + # Corresponds to the JSON property `principal` + # @return [String] + attr_accessor :principal + + # The CLDR country/region code associated with the above IP address. + # If the IP address is private, the `region_code` should reflect the + # physical location where this peer is running. + # Corresponds to the JSON property `regionCode` + # @return [String] + attr_accessor :region_code + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @ip = args[:ip] if args.key?(:ip) + @labels = args[:labels] if args.key?(:labels) + @port = args[:port] if args.key?(:port) + @principal = args[:principal] if args.key?(:principal) + @region_code = args[:region_code] if args.key?(:region_code) + end + end + + # Request message for the Report method. + class ReportRequest + include Google::Apis::Core::Hashable + + # Describes the list of operations to be reported. Each operation is + # represented as an AttributeContext, and contains all attributes around an + # API access. + # Corresponds to the JSON property `operations` + # @return [Array] + attr_accessor :operations + + # Specifies the version of the service configuration that should be used to + # process the request. Must not be empty. Set this field to 'latest' to + # specify using the latest configuration. + # Corresponds to the JSON property `serviceConfigId` + # @return [String] + attr_accessor :service_config_id + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @operations = args[:operations] if args.key?(:operations) + @service_config_id = args[:service_config_id] if args.key?(:service_config_id) + end + end + + # Response message for the Report method. + # If the request contains any invalid data, the server returns an RPC error. + class ReportResponse + include Google::Apis::Core::Hashable + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + end + end + + # This message defines attributes for an HTTP request. If the actual + # request is not an HTTP request, the runtime system should try to map + # the actual request to an equivalent HTTP request. + class Request + include Google::Apis::Core::Hashable + + # This message defines request authentication attributes. Terminology is + # based on the JSON Web Token (JWT) standard, but the terms also + # correlate to concepts in other standards. + # Corresponds to the JSON property `auth` + # @return [Google::Apis::ServicecontrolV2::Auth] + attr_accessor :auth + + # The HTTP request headers. If multiple headers share the same key, they + # must be merged according to the HTTP spec. All header keys must be + # lowercased, because HTTP header keys are case-insensitive. + # Corresponds to the JSON property `headers` + # @return [Hash] + attr_accessor :headers + + # The HTTP request `Host` header value. + # Corresponds to the JSON property `host` + # @return [String] + attr_accessor :host + + # The unique ID for a request, which can be propagated to downstream + # systems. The ID should have low probability of collision + # within a single day for a specific service. + # Corresponds to the JSON property `id` + # @return [String] + attr_accessor :id + + # The HTTP request method, such as `GET`, `POST`. + # Corresponds to the JSON property `method` + # @return [String] + attr_accessor :method_prop + + # The HTTP URL path. + # Corresponds to the JSON property `path` + # @return [String] + attr_accessor :path + + # The network protocol used with the request, such as "http/1.1", + # "spdy/3", "h2", "h2c", "webrtc", "tcp", "udp", "quic". See + # https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype- + # values.xhtml#alpn-protocol-ids + # for details. + # Corresponds to the JSON property `protocol` + # @return [String] + attr_accessor :protocol + + # The HTTP URL query in the format of `name1=value1&name2=value2`, as it + # appears in the first line of the HTTP request. No decoding is performed. + # Corresponds to the JSON property `query` + # @return [String] + attr_accessor :query + + # A special parameter for request reason. It is used by security systems + # to associate auditing information with a request. + # Corresponds to the JSON property `reason` + # @return [String] + attr_accessor :reason + + # The HTTP URL scheme, such as `http` and `https`. + # Corresponds to the JSON property `scheme` + # @return [String] + attr_accessor :scheme + + # The HTTP request size in bytes. If unknown, it must be -1. + # Corresponds to the JSON property `size` + # @return [Fixnum] + attr_accessor :size + + # The timestamp when the `destination` service receives the first byte of + # the request. + # Corresponds to the JSON property `time` + # @return [String] + attr_accessor :time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @auth = args[:auth] if args.key?(:auth) + @headers = args[:headers] if args.key?(:headers) + @host = args[:host] if args.key?(:host) + @id = args[:id] if args.key?(:id) + @method_prop = args[:method_prop] if args.key?(:method_prop) + @path = args[:path] if args.key?(:path) + @protocol = args[:protocol] if args.key?(:protocol) + @query = args[:query] if args.key?(:query) + @reason = args[:reason] if args.key?(:reason) + @scheme = args[:scheme] if args.key?(:scheme) + @size = args[:size] if args.key?(:size) + @time = args[:time] if args.key?(:time) + end + end + + # Metadata about the request. + class RequestMetadata + include Google::Apis::Core::Hashable + + # The IP address of the caller. + # For caller from internet, this will be public IPv4 or IPv6 address. + # For caller from a Compute Engine VM with external IP address, this + # will be the VM's external IP address. For caller from a Compute + # Engine VM without external IP address, if the VM is in the same + # organization (or project) as the accessed resource, `caller_ip` will + # be the VM's internal IPv4 address, otherwise the `caller_ip` will be + # redacted to "gce-internal-ip". + # See https://cloud.google.com/compute/docs/vpc/ for more information. + # Corresponds to the JSON property `callerIp` + # @return [String] + attr_accessor :caller_ip + + # The network of the caller. + # Set only if the network host project is part of the same GCP organization + # (or project) as the accessed resource. + # See https://cloud.google.com/compute/docs/vpc/ for more information. + # This is a scheme-less URI full resource name. For example: + # "//compute.googleapis.com/projects/PROJECT_ID/global/networks/NETWORK_ID" + # Corresponds to the JSON property `callerNetwork` + # @return [String] + attr_accessor :caller_network + + # The user agent of the caller. + # This information is not authenticated and should be treated accordingly. + # For example: + # + `google-api-python-client/1.4.0`: + # The request was made by the Google API client for Python. + # + `Cloud SDK Command Line Tool apitools-client/1.0 gcloud/0.9.62`: + # The request was made by the Google Cloud SDK CLI (gcloud). + # + `AppEngine-Google; (+http://code.google.com/appengine; appid: + # s~my-project`: + # The request was made from the `my-project` App Engine app. + # NOLINT + # Corresponds to the JSON property `callerSuppliedUserAgent` + # @return [String] + attr_accessor :caller_supplied_user_agent + + # This message defines attributes for a node that handles a network request. + # The node can be either a service or an application that sends, forwards, + # or receives the request. Service peers should fill in + # `principal` and `labels` as appropriate. + # Corresponds to the JSON property `destinationAttributes` + # @return [Google::Apis::ServicecontrolV2::Peer] + attr_accessor :destination_attributes + + # This message defines attributes for an HTTP request. If the actual + # request is not an HTTP request, the runtime system should try to map + # the actual request to an equivalent HTTP request. + # Corresponds to the JSON property `requestAttributes` + # @return [Google::Apis::ServicecontrolV2::Request] + attr_accessor :request_attributes + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @caller_ip = args[:caller_ip] if args.key?(:caller_ip) + @caller_network = args[:caller_network] if args.key?(:caller_network) + @caller_supplied_user_agent = args[:caller_supplied_user_agent] if args.key?(:caller_supplied_user_agent) + @destination_attributes = args[:destination_attributes] if args.key?(:destination_attributes) + @request_attributes = args[:request_attributes] if args.key?(:request_attributes) + end + end + + # This message defines core attributes for a resource. A resource is an + # addressable (named) entity provided by the destination service. For + # example, a file stored on a network storage service. + class Resource + include Google::Apis::Core::Hashable + + # The labels or tags on the resource, such as AWS resource tags and + # Kubernetes resource labels. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + + # The stable identifier (name) of a resource on the `service`. A resource + # can be logically identified as "//`resource.service`/`resource.name`". + # The differences between a resource name and a URI are: + # * Resource name is a logical identifier, independent of network + # protocol and API version. For example, + # `//pubsub.googleapis.com/projects/123/topics/news-feed`. + # * URI often includes protocol and version information, so it can + # be used directly by applications. For example, + # `https://pubsub.googleapis.com/v1/projects/123/topics/news-feed`. + # See https://cloud.google.com/apis/design/resource_names for details. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # The name of the service that this resource belongs to, such as + # `pubsub.googleapis.com`. The service may be different from the DNS + # hostname that actually serves the request. + # Corresponds to the JSON property `service` + # @return [String] + attr_accessor :service + + # The type of the resource. The syntax is platform-specific because + # different platforms define their resources differently. + # For Google APIs, the type format must be "`service`/`kind`". + # Corresponds to the JSON property `type` + # @return [String] + attr_accessor :type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @labels = args[:labels] if args.key?(:labels) + @name = args[:name] if args.key?(:name) + @service = args[:service] if args.key?(:service) + @type = args[:type] if args.key?(:type) + end + end + + # Describes a resource referenced in the request. + class ResourceInfo + include Google::Apis::Core::Hashable + + # The name of the resource referenced in the request. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # The resource permission needed for this request. + # The format must be "`service`/`plural`.`verb`". + # Corresponds to the JSON property `permission` + # @return [String] + attr_accessor :permission + + # The resource type in the format of "`service`/`kind`". + # Corresponds to the JSON property `type` + # @return [String] + attr_accessor :type + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @name = args[:name] if args.key?(:name) + @permission = args[:permission] if args.key?(:permission) + @type = args[:type] if args.key?(:type) + end + end + + # Location information about a resource. + class ResourceLocation + include Google::Apis::Core::Hashable + + # The locations of a resource after the execution of the operation. + # Requests to create or delete a location based resource must populate + # the 'current_locations' field and not the 'original_locations' field. + # For example: + # "europe-west1-a" + # "us-east1" + # "nam3" + # Corresponds to the JSON property `currentLocations` + # @return [Array] + attr_accessor :current_locations + + # The locations of a resource prior to the execution of the operation. + # Requests that mutate the resource's location must populate both the + # 'original_locations' as well as the 'current_locations' fields. + # For example: + # "europe-west1-a" + # "us-east1" + # "nam3" + # Corresponds to the JSON property `originalLocations` + # @return [Array] + attr_accessor :original_locations + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @current_locations = args[:current_locations] if args.key?(:current_locations) + @original_locations = args[:original_locations] if args.key?(:original_locations) + end + end + + # This message defines attributes for a typical network response. It + # generally models semantics of an HTTP response. + class Response + include Google::Apis::Core::Hashable + + # The HTTP response status code, such as `200` and `404`. + # Corresponds to the JSON property `code` + # @return [Fixnum] + attr_accessor :code + + # The HTTP response headers. If multiple headers share the same key, they + # must be merged according to HTTP spec. All header keys must be + # lowercased, because HTTP header keys are case-insensitive. + # Corresponds to the JSON property `headers` + # @return [Hash] + attr_accessor :headers + + # The HTTP response size in bytes. If unknown, it must be -1. + # Corresponds to the JSON property `size` + # @return [Fixnum] + attr_accessor :size + + # The timestamp when the `destination` service generates the first byte of + # the response. + # Corresponds to the JSON property `time` + # @return [String] + attr_accessor :time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @code = args[:code] if args.key?(:code) + @headers = args[:headers] if args.key?(:headers) + @size = args[:size] if args.key?(:size) + @time = args[:time] if args.key?(:time) + end + end + + # Identity delegation history of an authenticated service account. + class ServiceAccountDelegationInfo + include Google::Apis::Core::Hashable + + # First party identity principal. + # Corresponds to the JSON property `firstPartyPrincipal` + # @return [Google::Apis::ServicecontrolV2::FirstPartyPrincipal] + attr_accessor :first_party_principal + + # Third party identity principal. + # Corresponds to the JSON property `thirdPartyPrincipal` + # @return [Google::Apis::ServicecontrolV2::ThirdPartyPrincipal] + attr_accessor :third_party_principal + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @first_party_principal = args[:first_party_principal] if args.key?(:first_party_principal) + @third_party_principal = args[:third_party_principal] if args.key?(:third_party_principal) + end + end + + # The context of a span, attached to + # Exemplars + # in Distribution values during aggregation. + # It contains the name of a span with format: + # projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID] + class SpanContext + include Google::Apis::Core::Hashable + + # The resource name of the span. The format is: + # projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID] + # `[TRACE_ID]` is a unique identifier for a trace within a project; + # it is a 32-character hexadecimal encoding of a 16-byte array. + # `[SPAN_ID]` is a unique identifier for a span within a trace; it + # is a 16-character hexadecimal encoding of an 8-byte array. + # Corresponds to the JSON property `spanName` + # @return [String] + attr_accessor :span_name + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @span_name = args[:span_name] if args.key?(:span_name) + 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). + class Status + include Google::Apis::Core::Hashable + + # The status code, which should be an enum value of google.rpc.Code. + # Corresponds to the JSON property `code` + # @return [Fixnum] + attr_accessor :code + + # 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. + # Corresponds to the JSON property `message` + # @return [String] + attr_accessor :message + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @code = args[:code] if args.key?(:code) + @details = args[:details] if args.key?(:details) + @message = args[:message] if args.key?(:message) + end + end + + # Third party identity principal. + class ThirdPartyPrincipal + include Google::Apis::Core::Hashable + + # Metadata about third party identity. + # Corresponds to the JSON property `thirdPartyClaims` + # @return [Hash] + attr_accessor :third_party_claims + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @third_party_claims = args[:third_party_claims] if args.key?(:third_party_claims) + end + end + end + end +end diff --git a/generated/google/apis/servicecontrol_v2/representations.rb b/generated/google/apis/servicecontrol_v2/representations.rb new file mode 100644 index 000000000..e22367ef7 --- /dev/null +++ b/generated/google/apis/servicecontrol_v2/representations.rb @@ -0,0 +1,405 @@ +# 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 ServicecontrolV2 + + class Api + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class AttributeContext + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class AuditLog + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Auth + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class AuthenticationInfo + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class AuthorizationInfo + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class CheckRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class CheckResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class FirstPartyPrincipal + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Peer + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ReportRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ReportResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Request + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class RequestMetadata + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Resource + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ResourceInfo + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ResourceLocation + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Response + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ServiceAccountDelegationInfo + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class SpanContext + 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 ThirdPartyPrincipal + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class Api + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :operation, as: 'operation' + property :protocol, as: 'protocol' + property :service, as: 'service' + property :version, as: 'version' + end + end + + class AttributeContext + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :api, as: 'api', class: Google::Apis::ServicecontrolV2::Api, decorator: Google::Apis::ServicecontrolV2::Api::Representation + + property :destination, as: 'destination', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation + + collection :extensions, as: 'extensions' + property :origin, as: 'origin', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation + + property :request, as: 'request', class: Google::Apis::ServicecontrolV2::Request, decorator: Google::Apis::ServicecontrolV2::Request::Representation + + property :resource, as: 'resource', class: Google::Apis::ServicecontrolV2::Resource, decorator: Google::Apis::ServicecontrolV2::Resource::Representation + + property :response, as: 'response', class: Google::Apis::ServicecontrolV2::Response, decorator: Google::Apis::ServicecontrolV2::Response::Representation + + property :source, as: 'source', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation + + end + end + + class AuditLog + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :authentication_info, as: 'authenticationInfo', class: Google::Apis::ServicecontrolV2::AuthenticationInfo, decorator: Google::Apis::ServicecontrolV2::AuthenticationInfo::Representation + + collection :authorization_info, as: 'authorizationInfo', class: Google::Apis::ServicecontrolV2::AuthorizationInfo, decorator: Google::Apis::ServicecontrolV2::AuthorizationInfo::Representation + + hash :metadata, as: 'metadata' + property :method_name, as: 'methodName' + property :num_response_items, :numeric_string => true, as: 'numResponseItems' + hash :request, as: 'request' + property :request_metadata, as: 'requestMetadata', class: Google::Apis::ServicecontrolV2::RequestMetadata, decorator: Google::Apis::ServicecontrolV2::RequestMetadata::Representation + + property :resource_location, as: 'resourceLocation', class: Google::Apis::ServicecontrolV2::ResourceLocation, decorator: Google::Apis::ServicecontrolV2::ResourceLocation::Representation + + property :resource_name, as: 'resourceName' + hash :resource_original_state, as: 'resourceOriginalState' + hash :response, as: 'response' + hash :service_data, as: 'serviceData' + property :service_name, as: 'serviceName' + property :status, as: 'status', class: Google::Apis::ServicecontrolV2::Status, decorator: Google::Apis::ServicecontrolV2::Status::Representation + + end + end + + class Auth + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :access_levels, as: 'accessLevels' + collection :audiences, as: 'audiences' + hash :claims, as: 'claims' + property :presenter, as: 'presenter' + property :principal, as: 'principal' + end + end + + class AuthenticationInfo + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :authority_selector, as: 'authoritySelector' + property :principal_email, as: 'principalEmail' + property :principal_subject, as: 'principalSubject' + collection :service_account_delegation_info, as: 'serviceAccountDelegationInfo', class: Google::Apis::ServicecontrolV2::ServiceAccountDelegationInfo, decorator: Google::Apis::ServicecontrolV2::ServiceAccountDelegationInfo::Representation + + property :service_account_key_name, as: 'serviceAccountKeyName' + hash :third_party_principal, as: 'thirdPartyPrincipal' + end + end + + class AuthorizationInfo + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :granted, as: 'granted' + property :permission, as: 'permission' + property :resource, as: 'resource' + property :resource_attributes, as: 'resourceAttributes', class: Google::Apis::ServicecontrolV2::Resource, decorator: Google::Apis::ServicecontrolV2::Resource::Representation + + end + end + + class CheckRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :attributes, as: 'attributes', class: Google::Apis::ServicecontrolV2::AttributeContext, decorator: Google::Apis::ServicecontrolV2::AttributeContext::Representation + + collection :resources, as: 'resources', class: Google::Apis::ServicecontrolV2::ResourceInfo, decorator: Google::Apis::ServicecontrolV2::ResourceInfo::Representation + + property :service_config_id, as: 'serviceConfigId' + end + end + + class CheckResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + hash :headers, as: 'headers' + property :status, as: 'status', class: Google::Apis::ServicecontrolV2::Status, decorator: Google::Apis::ServicecontrolV2::Status::Representation + + end + end + + class FirstPartyPrincipal + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :principal_email, as: 'principalEmail' + hash :service_metadata, as: 'serviceMetadata' + end + end + + class Peer + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :ip, as: 'ip' + hash :labels, as: 'labels' + property :port, :numeric_string => true, as: 'port' + property :principal, as: 'principal' + property :region_code, as: 'regionCode' + end + end + + class ReportRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :operations, as: 'operations', class: Google::Apis::ServicecontrolV2::AttributeContext, decorator: Google::Apis::ServicecontrolV2::AttributeContext::Representation + + property :service_config_id, as: 'serviceConfigId' + end + end + + class ReportResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + end + end + + class Request + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :auth, as: 'auth', class: Google::Apis::ServicecontrolV2::Auth, decorator: Google::Apis::ServicecontrolV2::Auth::Representation + + hash :headers, as: 'headers' + property :host, as: 'host' + property :id, as: 'id' + property :method_prop, as: 'method' + property :path, as: 'path' + property :protocol, as: 'protocol' + property :query, as: 'query' + property :reason, as: 'reason' + property :scheme, as: 'scheme' + property :size, :numeric_string => true, as: 'size' + property :time, as: 'time' + end + end + + class RequestMetadata + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :caller_ip, as: 'callerIp' + property :caller_network, as: 'callerNetwork' + property :caller_supplied_user_agent, as: 'callerSuppliedUserAgent' + property :destination_attributes, as: 'destinationAttributes', class: Google::Apis::ServicecontrolV2::Peer, decorator: Google::Apis::ServicecontrolV2::Peer::Representation + + property :request_attributes, as: 'requestAttributes', class: Google::Apis::ServicecontrolV2::Request, decorator: Google::Apis::ServicecontrolV2::Request::Representation + + end + end + + class Resource + # @private + class Representation < Google::Apis::Core::JsonRepresentation + hash :labels, as: 'labels' + property :name, as: 'name' + property :service, as: 'service' + property :type, as: 'type' + end + end + + class ResourceInfo + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :name, as: 'name' + property :permission, as: 'permission' + property :type, as: 'type' + end + end + + class ResourceLocation + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :current_locations, as: 'currentLocations' + collection :original_locations, as: 'originalLocations' + end + end + + class Response + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :code, :numeric_string => true, as: 'code' + hash :headers, as: 'headers' + property :size, :numeric_string => true, as: 'size' + property :time, as: 'time' + end + end + + class ServiceAccountDelegationInfo + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :first_party_principal, as: 'firstPartyPrincipal', class: Google::Apis::ServicecontrolV2::FirstPartyPrincipal, decorator: Google::Apis::ServicecontrolV2::FirstPartyPrincipal::Representation + + property :third_party_principal, as: 'thirdPartyPrincipal', class: Google::Apis::ServicecontrolV2::ThirdPartyPrincipal, decorator: Google::Apis::ServicecontrolV2::ThirdPartyPrincipal::Representation + + end + end + + class SpanContext + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :span_name, as: 'spanName' + end + end + + class Status + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :code, as: 'code' + collection :details, as: 'details' + property :message, as: 'message' + end + end + + class ThirdPartyPrincipal + # @private + class Representation < Google::Apis::Core::JsonRepresentation + hash :third_party_claims, as: 'thirdPartyClaims' + end + end + end + end +end diff --git a/generated/google/apis/servicecontrol_v2/service.rb b/generated/google/apis/servicecontrol_v2/service.rb new file mode 100644 index 000000000..40615a6e0 --- /dev/null +++ b/generated/google/apis/servicecontrol_v2/service.rb @@ -0,0 +1,165 @@ +# 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 ServicecontrolV2 + # Service Control API + # + # Provides control plane functionality to managed services, such as logging, + # monitoring, and status checks. + # + # @example + # require 'google/apis/servicecontrol_v2' + # + # Servicecontrol = Google::Apis::ServicecontrolV2 # Alias the module + # service = Servicecontrol::ServiceControlService.new + # + # @see https://cloud.google.com/service-control/ + class ServiceControlService < 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://servicecontrol.googleapis.com/', '') + @batch_path = 'batch' + end + + # Private Preview. This feature is only available for approved services. + # This method provides admission control for services that are integrated + # with [Service Infrastructure](/service-infrastructure). It checks whether + # an operation should be allowed based on the service configuration and + # relevant policies. It must be called before the operation is executed. + # For more information, see + # [Admission Control](/service-infrastructure/docs/admission-control). + # NOTE: The admission control has an expected policy propagation delay of + # 60s. The caller **must** not depend on the most recent policy changes. + # NOTE: The admission control has a hard limit of 1 referenced resources + # per call. If an operation refers to more than 1 resources, the caller + # must call the Check method multiple times. + # This method requires the `servicemanagement.services.check` permission + # on the specified service. For more information, see + # [Service Control API Access + # Control](https://cloud.google.com/service-infrastructure/docs/service-control/ + # access-control). + # @param [String] service_name + # The service name as specified in its service configuration. For example, + # `"pubsub.googleapis.com"`. + # See + # [google.api.Service](https://cloud.google.com/service-management/reference/rpc/ + # google.api#google.api.Service) + # for the definition of a service name. + # @param [Google::Apis::ServicecontrolV2::CheckRequest] check_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::ServicecontrolV2::CheckResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::ServicecontrolV2::CheckResponse] + # + # @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 check_service(service_name, check_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/services/{serviceName}:check', options) + command.request_representation = Google::Apis::ServicecontrolV2::CheckRequest::Representation + command.request_object = check_request_object + command.response_representation = Google::Apis::ServicecontrolV2::CheckResponse::Representation + command.response_class = Google::Apis::ServicecontrolV2::CheckResponse + command.params['serviceName'] = service_name unless service_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 + + # Private Preview. This feature is only available for approved services. + # This method provides telemetry reporting for services that are integrated + # with [Service Infrastructure](/service-infrastructure). It reports a list + # of operations that have occurred on a service. It must be called after the + # operations have been executed. For more information, see + # [Telemetry Reporting](/service-infrastructure/docs/telemetry-reporting). + # NOTE: The telemetry reporting has a hard limit of 1000 operations and 1MB + # per Report call. It is recommended to have no more than 100 operations per + # call. + # This method requires the `servicemanagement.services.report` permission + # on the specified service. For more information, see + # [Service Control API Access + # Control](https://cloud.google.com/service-infrastructure/docs/service-control/ + # access-control). + # @param [String] service_name + # The service name as specified in its service configuration. For example, + # `"pubsub.googleapis.com"`. + # See + # [google.api.Service](https://cloud.google.com/service-management/reference/rpc/ + # google.api#google.api.Service) + # for the definition of a service name. + # @param [Google::Apis::ServicecontrolV2::ReportRequest] report_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::ServicecontrolV2::ReportResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::ServicecontrolV2::ReportResponse] + # + # @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 report_service(service_name, report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/services/{serviceName}:report', options) + command.request_representation = Google::Apis::ServicecontrolV2::ReportRequest::Representation + command.request_object = report_request_object + command.response_representation = Google::Apis::ServicecontrolV2::ReportResponse::Representation + command.response_class = Google::Apis::ServicecontrolV2::ReportResponse + command.params['serviceName'] = service_name unless service_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 + + 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