From 889330f35e45221df1f0ec6f974e28480b7471f0 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Sat, 8 Aug 2020 00:38:23 +0000 Subject: [PATCH] Autogenerated update (2020-08-08) Update: - bigqueryreservation_v1alpha2 - cloudprofiler_v2 - displayvideo_v1 - dlp_v2 - logging_v2 - oslogin_v1alpha - oslogin_v1beta - pubsub_v1 - pubsublite_v1 - texttospeech_v1beta1 --- api_names_out.yaml | 48 + .../apis/bigqueryreservation_v1alpha2.rb | 2 +- .../bigqueryreservation_v1alpha2/classes.rb | 188 +- .../bigqueryreservation_v1alpha2/service.rb | 177 +- generated/google/apis/cloudprofiler_v2.rb | 2 +- .../google/apis/cloudprofiler_v2/classes.rb | 61 +- .../google/apis/cloudprofiler_v2/service.rb | 36 +- generated/google/apis/displayvideo_v1.rb | 2 +- .../google/apis/displayvideo_v1/classes.rb | 16 +- .../google/apis/displayvideo_v1/service.rb | 20 +- generated/google/apis/dlp_v2.rb | 2 +- generated/google/apis/dlp_v2/classes.rb | 2378 ++++++++--------- generated/google/apis/dlp_v2/service.rb | 1577 +++++------ generated/google/apis/logging_v2.rb | 2 +- generated/google/apis/logging_v2/classes.rb | 388 ++- .../google/apis/logging_v2/representations.rb | 15 + generated/google/apis/logging_v2/service.rb | 1601 +++++++---- generated/google/apis/oslogin_v1alpha.rb | 2 +- .../google/apis/oslogin_v1alpha/classes.rb | 20 +- .../google/apis/oslogin_v1alpha/service.rb | 28 +- generated/google/apis/oslogin_v1beta.rb | 2 +- .../google/apis/oslogin_v1beta/classes.rb | 20 +- .../google/apis/oslogin_v1beta/service.rb | 28 +- generated/google/apis/pubsub_v1.rb | 2 +- generated/google/apis/pubsub_v1/classes.rb | 11 + .../google/apis/pubsub_v1/representations.rb | 1 + generated/google/apis/pubsublite_v1.rb | 2 +- .../google/apis/pubsublite_v1/classes.rb | 66 +- .../google/apis/pubsublite_v1/service.rb | 89 +- generated/google/apis/texttospeech_v1beta1.rb | 2 +- .../apis/texttospeech_v1beta1/classes.rb | 45 + .../texttospeech_v1beta1/representations.rb | 19 + 32 files changed, 3427 insertions(+), 3425 deletions(-) diff --git a/api_names_out.yaml b/api_names_out.yaml index 8f0f1a820..e98cb69ed 100644 --- a/api_names_out.yaml +++ b/api_names_out.yaml @@ -104749,6 +104749,7 @@ "/logging:v2/LogBucket/createTime": create_time "/logging:v2/LogBucket/description": description "/logging:v2/LogBucket/lifecycleState": lifecycle_state +"/logging:v2/LogBucket/locked": locked "/logging:v2/LogBucket/name": name "/logging:v2/LogBucket/retentionDays": retention_days "/logging:v2/LogBucket/updateTime": update_time @@ -104814,6 +104815,8 @@ "/logging:v2/LogSink/destination": destination "/logging:v2/LogSink/disabled": disabled "/logging:v2/LogSink/endTime": end_time +"/logging:v2/LogSink/exclusions": exclusions +"/logging:v2/LogSink/exclusions/exclusion": exclusion "/logging:v2/LogSink/filter": filter "/logging:v2/LogSink/includeChildren": include_children "/logging:v2/LogSink/name": name @@ -104899,6 +104902,7 @@ "/logging:v2/SourceReference": source_reference "/logging:v2/SourceReference/repository": repository "/logging:v2/SourceReference/revisionId": revision_id +"/logging:v2/UndeleteBucketRequest": undelete_bucket_request "/logging:v2/WriteLogEntriesRequest": write_log_entries_request "/logging:v2/WriteLogEntriesRequest/dryRun": dry_run "/logging:v2/WriteLogEntriesRequest/entries": entries @@ -104927,6 +104931,11 @@ "/logging:v2/logging.billingAccounts.exclusions.patch": patch_billing_account_exclusion "/logging:v2/logging.billingAccounts.exclusions.patch/name": name "/logging:v2/logging.billingAccounts.exclusions.patch/updateMask": update_mask +"/logging:v2/logging.billingAccounts.locations.buckets.create": create_billing_account_location_bucket +"/logging:v2/logging.billingAccounts.locations.buckets.create/bucketId": bucket_id +"/logging:v2/logging.billingAccounts.locations.buckets.create/parent": parent +"/logging:v2/logging.billingAccounts.locations.buckets.delete": delete_billing_account_location_bucket +"/logging:v2/logging.billingAccounts.locations.buckets.delete/name": name "/logging:v2/logging.billingAccounts.locations.buckets.list": list_billing_account_location_buckets "/logging:v2/logging.billingAccounts.locations.buckets.list/pageSize": page_size "/logging:v2/logging.billingAccounts.locations.buckets.list/pageToken": page_token @@ -104934,6 +104943,8 @@ "/logging:v2/logging.billingAccounts.locations.buckets.patch": patch_billing_account_location_bucket "/logging:v2/logging.billingAccounts.locations.buckets.patch/name": name "/logging:v2/logging.billingAccounts.locations.buckets.patch/updateMask": update_mask +"/logging:v2/logging.billingAccounts.locations.buckets.undelete": undelete_billing_account_location_bucket +"/logging:v2/logging.billingAccounts.locations.buckets.undelete/name": name "/logging:v2/logging.billingAccounts.logs.delete": delete_billing_account_log "/logging:v2/logging.billingAccounts.logs.delete/logName": log_name "/logging:v2/logging.billingAccounts.logs.list": list_billing_account_logs @@ -104987,6 +104998,11 @@ "/logging:v2/logging.folders.exclusions.patch": patch_folder_exclusion "/logging:v2/logging.folders.exclusions.patch/name": name "/logging:v2/logging.folders.exclusions.patch/updateMask": update_mask +"/logging:v2/logging.folders.locations.buckets.create": create_folder_location_bucket +"/logging:v2/logging.folders.locations.buckets.create/bucketId": bucket_id +"/logging:v2/logging.folders.locations.buckets.create/parent": parent +"/logging:v2/logging.folders.locations.buckets.delete": delete_folder_location_bucket +"/logging:v2/logging.folders.locations.buckets.delete/name": name "/logging:v2/logging.folders.locations.buckets.get": get_folder_location_bucket "/logging:v2/logging.folders.locations.buckets.get/name": name "/logging:v2/logging.folders.locations.buckets.list": list_folder_location_buckets @@ -104996,6 +105012,8 @@ "/logging:v2/logging.folders.locations.buckets.patch": patch_folder_location_bucket "/logging:v2/logging.folders.locations.buckets.patch/name": name "/logging:v2/logging.folders.locations.buckets.patch/updateMask": update_mask +"/logging:v2/logging.folders.locations.buckets.undelete": undelete_folder_location_bucket +"/logging:v2/logging.folders.locations.buckets.undelete/name": name "/logging:v2/logging.folders.logs.delete": delete_folder_log "/logging:v2/logging.folders.logs.delete/logName": log_name "/logging:v2/logging.folders.logs.list": list_folder_logs @@ -105022,6 +105040,11 @@ "/logging:v2/logging.folders.sinks.update/uniqueWriterIdentity": unique_writer_identity "/logging:v2/logging.folders.sinks.update/updateMask": update_mask "/logging:v2/logging.getCmekSettings/name": name +"/logging:v2/logging.locations.buckets.create": create_location_bucket +"/logging:v2/logging.locations.buckets.create/bucketId": bucket_id +"/logging:v2/logging.locations.buckets.create/parent": parent +"/logging:v2/logging.locations.buckets.delete": delete_location_bucket +"/logging:v2/logging.locations.buckets.delete/name": name "/logging:v2/logging.locations.buckets.get": get_location_bucket "/logging:v2/logging.locations.buckets.get/name": name "/logging:v2/logging.locations.buckets.list": list_location_buckets @@ -105031,6 +105054,8 @@ "/logging:v2/logging.locations.buckets.patch": patch_location_bucket "/logging:v2/logging.locations.buckets.patch/name": name "/logging:v2/logging.locations.buckets.patch/updateMask": update_mask +"/logging:v2/logging.locations.buckets.undelete": undelete_location_bucket +"/logging:v2/logging.locations.buckets.undelete/name": name "/logging:v2/logging.logs.delete": delete_log "/logging:v2/logging.logs.delete/logName": log_name "/logging:v2/logging.logs.list": list_logs @@ -105055,6 +105080,11 @@ "/logging:v2/logging.organizations.exclusions.patch/updateMask": update_mask "/logging:v2/logging.organizations.getCmekSettings": get_organization_cmek_settings "/logging:v2/logging.organizations.getCmekSettings/name": name +"/logging:v2/logging.organizations.locations.buckets.create": create_organization_location_bucket +"/logging:v2/logging.organizations.locations.buckets.create/bucketId": bucket_id +"/logging:v2/logging.organizations.locations.buckets.create/parent": parent +"/logging:v2/logging.organizations.locations.buckets.delete": delete_organization_location_bucket +"/logging:v2/logging.organizations.locations.buckets.delete/name": name "/logging:v2/logging.organizations.locations.buckets.get": get_organization_location_bucket "/logging:v2/logging.organizations.locations.buckets.get/name": name "/logging:v2/logging.organizations.locations.buckets.list": list_organization_location_buckets @@ -105064,6 +105094,8 @@ "/logging:v2/logging.organizations.locations.buckets.patch": patch_organization_location_bucket "/logging:v2/logging.organizations.locations.buckets.patch/name": name "/logging:v2/logging.organizations.locations.buckets.patch/updateMask": update_mask +"/logging:v2/logging.organizations.locations.buckets.undelete": undelete_organization_location_bucket +"/logging:v2/logging.organizations.locations.buckets.undelete/name": name "/logging:v2/logging.organizations.logs.delete": delete_organization_log "/logging:v2/logging.organizations.logs.delete/logName": log_name "/logging:v2/logging.organizations.logs.list": list_organization_logs @@ -105105,6 +105137,11 @@ "/logging:v2/logging.projects.exclusions.patch": patch_project_exclusion "/logging:v2/logging.projects.exclusions.patch/name": name "/logging:v2/logging.projects.exclusions.patch/updateMask": update_mask +"/logging:v2/logging.projects.locations.buckets.create": create_project_location_bucket +"/logging:v2/logging.projects.locations.buckets.create/bucketId": bucket_id +"/logging:v2/logging.projects.locations.buckets.create/parent": parent +"/logging:v2/logging.projects.locations.buckets.delete": delete_project_location_bucket +"/logging:v2/logging.projects.locations.buckets.delete/name": name "/logging:v2/logging.projects.locations.buckets.get": get_project_location_bucket "/logging:v2/logging.projects.locations.buckets.get/name": name "/logging:v2/logging.projects.locations.buckets.list": list_project_location_buckets @@ -105114,6 +105151,8 @@ "/logging:v2/logging.projects.locations.buckets.patch": patch_project_location_bucket "/logging:v2/logging.projects.locations.buckets.patch/name": name "/logging:v2/logging.projects.locations.buckets.patch/updateMask": update_mask +"/logging:v2/logging.projects.locations.buckets.undelete": undelete_project_location_bucket +"/logging:v2/logging.projects.locations.buckets.undelete/name": name "/logging:v2/logging.projects.logs.delete": delete_project_log "/logging:v2/logging.projects.logs.delete/logName": log_name "/logging:v2/logging.projects.logs.list": list_project_logs @@ -114178,6 +114217,7 @@ "/pubsub:v1/Subscription": subscription "/pubsub:v1/Subscription/ackDeadlineSeconds": ack_deadline_seconds "/pubsub:v1/Subscription/deadLetterPolicy": dead_letter_policy +"/pubsub:v1/Subscription/detached": detached "/pubsub:v1/Subscription/enableMessageOrdering": enable_message_ordering "/pubsub:v1/Subscription/expirationPolicy": expiration_policy "/pubsub:v1/Subscription/filter": filter @@ -134977,10 +135017,18 @@ "/texttospeech:v1beta1/SynthesisInput/text": text "/texttospeech:v1beta1/SynthesizeSpeechRequest": synthesize_speech_request "/texttospeech:v1beta1/SynthesizeSpeechRequest/audioConfig": audio_config +"/texttospeech:v1beta1/SynthesizeSpeechRequest/enableTimePointing": enable_time_pointing +"/texttospeech:v1beta1/SynthesizeSpeechRequest/enableTimePointing/enable_time_pointing": enable_time_pointing "/texttospeech:v1beta1/SynthesizeSpeechRequest/input": input "/texttospeech:v1beta1/SynthesizeSpeechRequest/voice": voice "/texttospeech:v1beta1/SynthesizeSpeechResponse": synthesize_speech_response +"/texttospeech:v1beta1/SynthesizeSpeechResponse/audioConfig": audio_config "/texttospeech:v1beta1/SynthesizeSpeechResponse/audioContent": audio_content +"/texttospeech:v1beta1/SynthesizeSpeechResponse/timepoints": timepoints +"/texttospeech:v1beta1/SynthesizeSpeechResponse/timepoints/timepoint": timepoint +"/texttospeech:v1beta1/Timepoint": timepoint +"/texttospeech:v1beta1/Timepoint/markName": mark_name +"/texttospeech:v1beta1/Timepoint/timeSeconds": time_seconds "/texttospeech:v1beta1/Voice": voice "/texttospeech:v1beta1/Voice/languageCodes": language_codes "/texttospeech:v1beta1/Voice/languageCodes/language_code": language_code diff --git a/generated/google/apis/bigqueryreservation_v1alpha2.rb b/generated/google/apis/bigqueryreservation_v1alpha2.rb index b0d879a49..6f91ebdba 100644 --- a/generated/google/apis/bigqueryreservation_v1alpha2.rb +++ b/generated/google/apis/bigqueryreservation_v1alpha2.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/bigquery/ module BigqueryreservationV1alpha2 VERSION = 'V1alpha2' - REVISION = '20200509' + REVISION = '20200801' # View and manage your data in Google BigQuery AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery' diff --git a/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb b/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb index 7e580e3d6..d3706200a 100644 --- a/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb +++ b/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb @@ -22,13 +22,12 @@ module Google module Apis module BigqueryreservationV1alpha2 - # The metadata for operation returned from - # ReservationService.CreateSlotPool. + # The metadata for operation returned from ReservationService.CreateSlotPool. class CreateSlotPoolMetadata include Google::Apis::Core::Hashable - # Resource name of the slot pool that is being created. E.g., - # projects/myproject/locations/us-central1/reservations/foo/slotPools/123 + # Resource name of the slot pool that is being created. E.g., projects/myproject/ + # locations/us-central1/reservations/foo/slotPools/123 # Corresponds to the JSON property `slotPool` # @return [String] attr_accessor :slot_pool @@ -43,13 +42,11 @@ module Google end end - # A generic empty message that you can re-use to avoid defining duplicated - # empty messages in your APIs. A typical example is to use it as the request - # or the response type of an API method. For instance: - # service Foo ` - # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -66,8 +63,8 @@ module Google class ListReservationGrantsResponse include Google::Apis::Core::Hashable - # Token to retrieve the next page of results, or empty if there are no - # more results in the list. + # 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 @@ -92,8 +89,8 @@ module Google class ListReservationsResponse include Google::Apis::Core::Hashable - # Token to retrieve the next page of results, or empty if there are no - # more results in the list. + # 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 @@ -118,8 +115,8 @@ module Google class ListSlotPoolsResponse include Google::Apis::Core::Hashable - # Token to retrieve the next page of results, or empty if there are no - # more results in the list. + # 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 @@ -145,47 +142,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # If the value is `false`, it means the operation is still in progress. - # If `true`, the operation is completed, and either `error` or `response` is - # available. + # If the value is `false`, it means the operation is still in progress. If `true` + # , the operation is completed, and either `error` or `response` is available. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::BigqueryreservationV1alpha2::Status] attr_accessor :error - # Service-specific metadata associated with the operation. It typically - # contains progress information and common metadata such as create time. - # Some services might not provide such metadata. Any method that returns a - # long-running operation should document the metadata type, if any. + # Service-specific metadata associated with the operation. It typically contains + # progress information and common metadata such as create time. Some services + # might not provide such metadata. Any method that returns a long-running + # operation should document the metadata type, if any. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # The server-assigned name, which is only unique within the same service that - # originally returns it. If you use the default HTTP mapping, the - # `name` should be a resource name ending with `operations/`unique_id``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. If the original - # method returns no data on success, such as `Delete`, the response is - # `google.protobuf.Empty`. If the original method is standard - # `Get`/`Create`/`Update`, the response should be the resource. For other - # methods, the response should have the type `XxxResponse`, where `Xxx` - # is the original method name. For example, if the original method name - # is `TakeSnapshot()`, the inferred response type is - # `TakeSnapshotResponse`. + # The normal response of the operation in case of success. If the original + # method returns no data on success, such as `Delete`, the response is `google. + # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, + # the response should be the resource. For other methods, the response should + # have the type `XxxResponse`, where `Xxx` is the original method name. For + # example, if the original method name is `TakeSnapshot()`, the inferred + # response type is `TakeSnapshotResponse`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -208,35 +203,31 @@ module Google class Reservation include Google::Apis::Core::Hashable - # The resource name of the reservation, e.g., - # "projects/*/locations/*/reservations/dev/team/product". Reservation names - # (e.g., "dev/team/product") exceeding a depth of six will fail with - # `google.rpc.Code.INVALID_ARGUMENT`. + # The resource name of the reservation, e.g., "projects/*/locations/*/ + # reservations/dev/team/product". Reservation names (e.g., "dev/team/product") + # exceeding a depth of six will fail with `google.rpc.Code.INVALID_ARGUMENT`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Maximum slots available to this reservation and its children. A slot is a - # unit of computational power in BigQuery, and serves as the unit of - # parallelism. In a scan of a multi-partitioned table, a single slot operates - # on a single partition of the table. - # If the new reservation's slot capacity exceed the parent's slot capacity or - # if total slot capacity of the new reservation and its siblings exceeds the - # parent's slot capacity, the request will fail with - # `google.rpc.Code.RESOURCE_EXHAUSTED`. + # Maximum slots available to this reservation and its children. A slot is a unit + # of computational power in BigQuery, and serves as the unit of parallelism. In + # a scan of a multi-partitioned table, a single slot operates on a single + # partition of the table. If the new reservation's slot capacity exceed the + # parent's slot capacity or if total slot capacity of the new reservation and + # its siblings exceeds the parent's slot capacity, the request will fail with ` + # google.rpc.Code.RESOURCE_EXHAUSTED`. # Corresponds to the JSON property `slotCapacity` # @return [Fixnum] attr_accessor :slot_capacity - # If true, any query using this reservation will also be submitted to the - # parent reservation. This allows the query to share the additional slot - # capacity of the parent with other queries in the parent reservation. If the - # parent also has this field set to true, then this process will continue - # until it encounters a reservation for which this is false. - # If false, a query using this reservation will - # execute with the maximum slot capacity as specified above. - # If not specified, default value is true. - # Ignored for top-level reservation. + # If true, any query using this reservation will also be submitted to the parent + # reservation. This allows the query to share the additional slot capacity of + # the parent with other queries in the parent reservation. If the parent also + # has this field set to true, then this process will continue until it + # encounters a reservation for which this is false. If false, a query using this + # reservation will execute with the maximum slot capacity as specified above. If + # not specified, default value is true. Ignored for top-level reservation. # Corresponds to the JSON property `useParentReservation` # @return [Boolean] attr_accessor :use_parent_reservation @@ -254,13 +245,13 @@ module Google end end - # A ReservationGrant allows a project to submit jobs - # of a certain type using slots from the specified reservation. + # A ReservationGrant allows a project to submit jobs of a certain type using + # slots from the specified reservation. class ReservationGrant include Google::Apis::Core::Hashable - # The resource which will use the reservation. E.g. - # projects/myproject, folders/123, organizations/456. + # The resource which will use the reservation. E.g. projects/myproject, folders/ + # 123, organizations/456. # Corresponds to the JSON property `grantee` # @return [String] attr_accessor :grantee @@ -270,16 +261,15 @@ module Google # @return [String] attr_accessor :job_type - # Output only. Name of the resource. E.g.: - # projects/myproject/locations/eu/reservationGrants/123. + # Output only. Name of the resource. E.g.: projects/myproject/locations/eu/ + # reservationGrants/123. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Resource name of the reservation. - # E.g., projects/myproject/locations/eu/reservations/my_reservation. - # This reservation must be in the same location as the grant. - # This reservation should belong to the same parent project. + # Resource name of the reservation. E.g., projects/myproject/locations/eu/ + # reservations/my_reservation. This reservation must be in the same location as + # the grant. This reservation should belong to the same parent project. # Corresponds to the JSON property `reservation` # @return [String] attr_accessor :reservation @@ -307,8 +297,8 @@ module Google class SearchReservationGrantsResponse include Google::Apis::Core::Hashable - # Token to retrieve the next page of results, or empty if there are no - # more results in the list. + # 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 @@ -333,34 +323,32 @@ module Google # usage. Slot pool is immutable and cannot be deleted until the end of the # commitment period. After the end of the commitment period, slots are still # available but can be freely removed any time. Annual commitments will - # automatically be downgraded to monthly after the commitment ends. - # A slot pool resource exists as a child resource of a top-level reservation. - # Sum of all the ACTIVE pools slot_count is always equal to the reservation - # slot_capacity. + # automatically be downgraded to monthly after the commitment ends. A slot pool + # resource exists as a child resource of a top-level reservation. Sum of all the + # ACTIVE pools slot_count is always equal to the reservation slot_capacity. class SlotPool include Google::Apis::Core::Hashable - # Output only. The end of the commitment period. Slot pool cannot be - # removed before commitment_end_time. It is applicable only for ACTIVE slot - # pools and is computed as a combination of the plan and the time when the - # slot pool became ACTIVE. + # Output only. The end of the commitment period. Slot pool cannot be removed + # before commitment_end_time. It is applicable only for ACTIVE slot pools and is + # computed as a combination of the plan and the time when the slot pool became + # ACTIVE. # Corresponds to the JSON property `commitmentEndTime` # @return [String] attr_accessor :commitment_end_time - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `failureStatus` # @return [Google::Apis::BigqueryreservationV1alpha2::Status] attr_accessor :failure_status - # Output only. The resource name of the slot pool, e.g., - # projects/myproject/locations/us-central1/reservations/myreservation/ - # slotPools/123 + # Output only. The resource name of the slot pool, e.g., projects/myproject/ + # locations/us-central1/reservations/myreservation/slotPools/123 # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -395,12 +383,12 @@ module Google end end - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable @@ -409,15 +397,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # A developer-facing error message, which should be in English. Any - # user-facing error message should be localized and sent in the - # google.rpc.Status.details field, or localized by the client. + # A developer-facing error message, which should be in English. Any user-facing + # error message should be localized and sent in the google.rpc.Status.details + # field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message diff --git a/generated/google/apis/bigqueryreservation_v1alpha2/service.rb b/generated/google/apis/bigqueryreservation_v1alpha2/service.rb index 09fc239c8..3d4eb8bf8 100644 --- a/generated/google/apis/bigqueryreservation_v1alpha2/service.rb +++ b/generated/google/apis/bigqueryreservation_v1alpha2/service.rb @@ -47,31 +47,26 @@ module Google @batch_path = 'batch' end - # Look up grants for a specified resource for a particular region. - # If the request is about a project: - # 1) Grants created on the project will be returned if they exist. - # 2) Otherwise grants created on the closest ancestor will be returned. - # 3) Grants for different JobTypes will all be returned. - # Same logic applies if the request is about a folder. - # If the request is about an organization, then grants created on the - # organization will be returned (organization doesn't have ancestors). - # Comparing to ListReservationGrants, there are two behavior - # differences: - # 1) permission on the grantee will be verified in this API. - # 2) Hierarchy lookup (project->folder->organization) happens in this API. + # Look up grants for a specified resource for a particular region. If the + # request is about a project: 1) Grants created on the project will be returned + # if they exist. 2) Otherwise grants created on the closest ancestor will be + # returned. 3) Grants for different JobTypes will all be returned. Same logic + # applies if the request is about a folder. If the request is about an + # organization, then grants created on the organization will be returned ( + # organization doesn't have ancestors). Comparing to ListReservationGrants, + # there are two behavior differences: 1) permission on the grantee will be + # verified in this API. 2) Hierarchy lookup (project->folder->organization) + # happens in this API. # @param [String] parent # The parent resource name (containing project and location), which owns the - # grants. e.g.: - # "projects/myproject/locations/us-central1". + # grants. e.g.: "projects/myproject/locations/us-central1". # @param [Fixnum] page_size # The maximum number of items to return. # @param [String] page_token # The next_page_token value returned from a previous List request, if any. # @param [String] query - # Please specify resource name as grantee in the query. - # e.g., "grantee=projects/myproject" - # "grantee=folders/123" - # "grantee=organizations/456" + # Please specify resource name as grantee in the query. e.g., "grantee=projects/ + # myproject" "grantee=folders/123" "grantee=organizations/456" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -102,15 +97,13 @@ module Google execute_or_queue_command(command, &block) end - # Starts asynchronous cancellation on a long-running operation. The server - # makes a best effort to cancel the operation, but success is not - # guaranteed. If the server doesn't support this method, it returns - # `google.rpc.Code.UNIMPLEMENTED`. Clients can use - # Operations.GetOperation or - # other methods to check whether the cancellation succeeded or whether the - # operation completed despite cancellation. On successful cancellation, - # the operation is not deleted; instead, it becomes an operation with - # an Operation.error value with a google.rpc.Status.code of 1, + # Starts asynchronous cancellation on a long-running operation. The server makes + # a best effort to cancel the operation, but success is not guaranteed. If the + # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. + # Clients can use Operations.GetOperation or other methods to check whether the + # cancellation succeeded or whether the operation completed despite cancellation. + # On successful cancellation, the operation is not deleted; instead, it becomes + # an operation with an Operation.error value with a google.rpc.Status.code of 1, # corresponding to `Code.CANCELLED`. # @param [String] name # The name of the operation resource to be cancelled. @@ -141,9 +134,8 @@ module Google execute_or_queue_command(command, &block) end - # Gets the latest state of a long-running operation. Clients can use this - # method to poll the operation result at intervals as recommended by the API - # service. + # Gets the latest state of a long-running operation. Clients can use this method + # to poll the operation result at intervals as recommended by the API service. # @param [String] name # The name of the operation resource. # @param [String] fields @@ -173,14 +165,13 @@ module Google execute_or_queue_command(command, &block) end - # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have - # 'bigquery.admin' permissions on the project using the reservation - # and the project that owns this reservation. - # Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the grant - # does not match location of the reservation. + # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have 'bigquery. + # admin' permissions on the project using the reservation and the project that + # owns this reservation. Returns `google.rpc.Code.INVALID_ARGUMENT` when + # location of the grant does not match location of the reservation. # @param [String] parent - # The parent resource name of the reservation grant - # E.g.: projects/myproject/location/eu. + # The parent resource name of the reservation grant E.g.: projects/myproject/ + # location/eu. # @param [Google::Apis::BigqueryreservationV1alpha2::ReservationGrant] reservation_grant_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -211,19 +202,15 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a reservation grant. No expansion will happen. - # E.g: - # organizationA contains project1 and project2. Reservation res1 exists. + # Deletes a reservation grant. No expansion will happen. E.g: organizationA + # contains project1 and project2. Reservation res1 exists. # CreateReservationGrant was invoked previously and following grants were - # created explicitly: - # - # - # Then deletion of won't affect . After - # deletion of , queries from project1 will still use - # res1, while queries from project2 will use on-demand mode. + # created explicitly: Then deletion of won't affect . After deletion of , + # queries from project1 will still use res1, while queries from project2 will + # use on-demand mode. # @param [String] name - # Name of the resource, e.g.: - # projects/myproject/locations/eu/reservationGrants/123 + # Name of the resource, e.g.: projects/myproject/locations/eu/reservationGrants/ + # 123 # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -251,15 +238,11 @@ module Google execute_or_queue_command(command, &block) end - # Lists reservation grants. - # Only explicitly created grants will be returned. E.g: + # Lists reservation grants. Only explicitly created grants will be returned. E.g: # organizationA contains project1 and project2. Reservation res1 exists. # CreateReservationGrant was invoked previously and following grants were - # created explicitly: - # - # - # Then this API will just return the above two grants for reservation res1, - # and no expansion/merge will happen. + # created explicitly: Then this API will just return the above two grants for + # reservation res1, and no expansion/merge will happen. # @param [String] parent # The parent resource name e.g.: projects/myproject/location/eu. # @param [Fixnum] page_size @@ -295,15 +278,15 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new reservation resource. Multiple reservations are created if - # the ancestor reservations do not exist. + # Creates a new reservation resource. Multiple reservations are created if the + # ancestor reservations do not exist. # @param [String] parent - # Project, location, and (optionally) reservation name. E.g., - # projects/myproject/locations/us-central1/reservations/parent + # Project, location, and (optionally) reservation name. E.g., projects/myproject/ + # locations/us-central1/reservations/parent # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object # @param [String] reservation_id - # The reservation ID relative to the parent, e.g., "dev". This field must - # only contain alphanumeric characters. + # The reservation ID relative to the parent, e.g., "dev". This field must only + # contain alphanumeric characters. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -334,15 +317,15 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new reservation resource. Multiple reservations are created if - # the ancestor reservations do not exist. + # Creates a new reservation resource. Multiple reservations are created if the + # ancestor reservations do not exist. # @param [String] parent - # Project, location, and (optionally) reservation name. E.g., - # projects/myproject/locations/us-central1/reservations/parent + # Project, location, and (optionally) reservation name. E.g., projects/myproject/ + # locations/us-central1/reservations/parent # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object # @param [String] reservation_id - # The reservation ID relative to the parent, e.g., "dev". This field must - # only contain alphanumeric characters. + # The reservation ID relative to the parent, e.g., "dev". This field must only + # contain alphanumeric characters. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -373,19 +356,17 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a reservation. - # Returns `google.rpc.Code.FAILED_PRECONDITION` in the following cases: - # 1. When reservation has child reservations. This check can be bypassed by - # setting DeleteReservationRequest.force flag to true. - # 2. When top-level reservation with slot pools is being deleted. + # Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` in the + # following cases: 1. When reservation has child reservations. This check can be + # bypassed by setting DeleteReservationRequest.force flag to true. 2. When top- + # level reservation with slot pools is being deleted. # @param [String] name - # Resource name of the reservation to retrieve. E.g., - # projects/myproject/locations/us-central1/reservations/my_reservation + # Resource name of the reservation to retrieve. E.g., projects/myproject/ + # locations/us-central1/reservations/my_reservation # @param [Boolean] force # If true, deletes all the child reservations of the given reservation. - # Otherwise, attempting to delete a reservation that has child - # reservations will fail with error code - # `google.rpc.Code.FAILED_PRECONDITION`. + # Otherwise, attempting to delete a reservation that has child reservations will + # fail with error code `google.rpc.Code.FAILED_PRECONDITION`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -416,8 +397,8 @@ module Google # Returns information about the reservation. # @param [String] name - # Resource name of the reservation to retrieve. E.g., - # projects/myproject/locations/us-central1/reservations/path/to/reserv + # Resource name of the reservation to retrieve. E.g., projects/myproject/ + # locations/us-central1/reservations/path/to/reserv # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -447,14 +428,13 @@ module Google # Lists all the reservations for the project in the specified location. # @param [String] parent - # The parent resource name containing project and location, e.g.: - # "projects/myproject/locations/us-central1" + # The parent resource name containing project and location, e.g.: "projects/ + # myproject/locations/us-central1" # @param [String] filter # Can be used to filter out reservations based on names, capacity, etc, e.g.: - # filter="reservation.slot_capacity > 200" - # filter="reservation.name = \"*dev/*\"" - # Advanced filtering syntax can be - # [here](https://cloud.google.com/logging/docs/view/advanced-filters). + # filter="reservation.slot_capacity > 200" filter="reservation.name = \"*dev/*\"" + # Advanced filtering syntax can be [here](https://cloud.google.com/logging/docs/ + # view/advanced-filters). # @param [Fixnum] page_size # The maximum number of items to return. # @param [String] page_token @@ -492,10 +472,9 @@ module Google # Updates an existing reservation resource. Applicable only for child # reservations. # @param [String] name - # The resource name of the reservation, e.g., - # "projects/*/locations/*/reservations/dev/team/product". Reservation names - # (e.g., "dev/team/product") exceeding a depth of six will fail with - # `google.rpc.Code.INVALID_ARGUMENT`. + # The resource name of the reservation, e.g., "projects/*/locations/*/ + # reservations/dev/team/product". Reservation names (e.g., "dev/team/product") + # exceeding a depth of six will fail with `google.rpc.Code.INVALID_ARGUMENT`. # @param [Google::Apis::BigqueryreservationV1alpha2::Reservation] reservation_object # @param [String] update_mask # Standard field mask for the set of fields to be updated. @@ -530,12 +509,11 @@ module Google end # Deletes a slot pool. Attempting to delete slot pool before its - # commitment_end_time will fail with the error code - # `google.rpc.Code.FAILED_PRECONDITION`. + # commitment_end_time will fail with the error code `google.rpc.Code. + # FAILED_PRECONDITION`. # @param [String] name - # Resource name of the slot pool to delete. E.g., - # projects/myproject/locations/us-central1/reservations/my_reservation/ - # slotPools/123 + # Resource name of the slot pool to delete. E.g., projects/myproject/locations/ + # us-central1/reservations/my_reservation/slotPools/123 # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -565,9 +543,8 @@ module Google # Returns information about the slot pool. # @param [String] name - # Resource name of the slot pool to retrieve. E.g., - # projects/myproject/locations/us-central1/reservations/my_reservation/ - # slotPools/123 + # Resource name of the slot pool to retrieve. E.g., projects/myproject/locations/ + # us-central1/reservations/my_reservation/slotPools/123 # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -597,9 +574,9 @@ module Google # Lists all the slot pools for the reservation. # @param [String] parent - # Resource name of the parent reservation. Only top-level reservations can - # have slot pools. E.g., - # projects/myproject/locations/us-central1/reservations/my_reservation + # Resource name of the parent reservation. Only top-level reservations can have + # slot pools. E.g., projects/myproject/locations/us-central1/reservations/ + # my_reservation # @param [Fixnum] page_size # The maximum number of items to return. # @param [String] page_token diff --git a/generated/google/apis/cloudprofiler_v2.rb b/generated/google/apis/cloudprofiler_v2.rb index 5979a9ad6..132bd117d 100644 --- a/generated/google/apis/cloudprofiler_v2.rb +++ b/generated/google/apis/cloudprofiler_v2.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/profiler/ module CloudprofilerV2 VERSION = 'V2' - REVISION = '20200210' + REVISION = '20200803' # 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/cloudprofiler_v2/classes.rb b/generated/google/apis/cloudprofiler_v2/classes.rb index f7b66be98..e4e900073 100644 --- a/generated/google/apis/cloudprofiler_v2/classes.rb +++ b/generated/google/apis/cloudprofiler_v2/classes.rb @@ -22,9 +22,9 @@ module Google module Apis module CloudprofilerV2 - # CreateProfileRequest describes a profile resource online creation request. - # The deployment field must be populated. The profile_type specifies the list - # of profile types supported by the agent. The creation call will hang until a + # CreateProfileRequest describes a profile resource online creation request. The + # deployment field must be populated. The profile_type specifies the list of + # profile types supported by the agent. The creation call will hang until a # profile of one of these types needs to be collected. class CreateProfileRequest include Google::Apis::Core::Hashable @@ -56,30 +56,27 @@ module Google # Labels identify the deployment within the user universe and same target. # Validation regex for label names: `^[a-z0-9]([a-z0-9-]`0,61`[a-z0-9])?$`. - # Value for an individual label must be <= 512 bytes, the total - # size of all label names and values must be <= 1024 bytes. - # Label named "language" can be used to record the programming language of - # the profiled deployment. The standard choices for the value include "java", - # "go", "python", "ruby", "nodejs", "php", "dotnet". - # For deployments running on Google Cloud Platform, "zone" or "region" label - # should be present describing the deployment location. An example of a zone - # is "us-central1-a", an example of a region is "us-central1" or - # "us-central". + # Value for an individual label must be <= 512 bytes, the total size of all + # label names and values must be <= 1024 bytes. Label named "language" can be + # used to record the programming language of the profiled deployment. The + # standard choices for the value include "java", "go", "python", "ruby", "nodejs" + # , "php", "dotnet". For deployments running on Google Cloud Platform, "zone" or + # "region" label should be present describing the deployment location. An + # example of a zone is "us-central1-a", an example of a region is "us-central1" + # or "us-central". # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # Project ID is the ID of a cloud project. - # Validation regex: `^a-z`4,61`[a-z0-9]$`. + # Project ID is the ID of a cloud project. Validation regex: `^a-z`4,61`[a-z0-9]$ + # `. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id - # Target is the service name used to group related deployments: - # * Service name for GAE Flex / Standard. - # * Cluster and container name for GKE. - # * User-specified string for direct GCE profiling (e.g. Java). - # * Job name for Dataflow. + # Target is the service name used to group related deployments: * Service name + # for GAE Flex / Standard. * Cluster and container name for GKE. * User- + # specified string for direct GCE profiling (e.g. Java). * Job name for Dataflow. # Validation regex: `^[a-z]([-a-z0-9_.]`0,253`[a-z0-9])?$`. # Corresponds to the JSON property `target` # @return [String] @@ -106,19 +103,18 @@ module Google # @return [Google::Apis::CloudprofilerV2::Deployment] attr_accessor :deployment - # Duration of the profiling session. - # Input (for the offline mode) or output (for the online mode). - # The field represents requested profiling duration. It may slightly differ - # from the effective profiling duration, which is recorded in the profile - # data, in case the profiling can't be stopped immediately (e.g. in case - # stopping the profiling is handled asynchronously). + # Duration of the profiling session. Input (for the offline mode) or output (for + # the online mode). The field represents requested profiling duration. It may + # slightly differ from the effective profiling duration, which is recorded in + # the profile data, in case the profiling can't be stopped immediately (e.g. in + # case stopping the profiling is handled asynchronously). # Corresponds to the JSON property `duration` # @return [String] attr_accessor :duration - # Input only. Labels associated to this specific profile. These labels will - # get merged with the deployment labels for the final data set. See - # documentation on deployment labels for validation rules and limits. + # Input only. Labels associated to this specific profile. These labels will get + # merged with the deployment labels for the final data set. See documentation on + # deployment labels for validation rules and limits. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels @@ -128,16 +124,15 @@ module Google # @return [String] attr_accessor :name - # Input only. Profile bytes, as a gzip compressed serialized proto, the - # format is https://github.com/google/pprof/blob/master/proto/profile.proto. + # Input only. Profile bytes, as a gzip compressed serialized proto, the format + # is https://github.com/google/pprof/blob/master/proto/profile.proto. # Corresponds to the JSON property `profileBytes` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :profile_bytes - # Type of profile. - # For offline mode, this must be specified when creating the profile. For - # online mode it is assigned and returned by the server. + # Type of profile. For offline mode, this must be specified when creating the + # profile. For online mode it is assigned and returned by the server. # Corresponds to the JSON property `profileType` # @return [String] attr_accessor :profile_type diff --git a/generated/google/apis/cloudprofiler_v2/service.rb b/generated/google/apis/cloudprofiler_v2/service.rb index eb6b44205..9902572f8 100644 --- a/generated/google/apis/cloudprofiler_v2/service.rb +++ b/generated/google/apis/cloudprofiler_v2/service.rb @@ -47,17 +47,15 @@ module Google @batch_path = 'batch' end - # CreateProfile creates a new profile resource in the online mode. - # The server ensures that the new profiles are created at a constant rate per - # deployment, so the creation request may hang for some time until the next - # profile session is available. - # The request may fail with ABORTED error if the creation is not available - # within ~1m, the response will indicate the duration of the backoff the - # client should take before attempting creating a profile again. The backoff - # duration is returned in google.rpc.RetryInfo extension on the response - # status. To a gRPC client, the extension will be return as a - # binary-serialized proto in the trailing metadata item named - # "google.rpc.retryinfo-bin". + # CreateProfile creates a new profile resource in the online mode. The server + # ensures that the new profiles are created at a constant rate per deployment, + # so the creation request may hang for some time until the next profile session + # is available. The request may fail with ABORTED error if the creation is not + # available within ~1m, the response will indicate the duration of the backoff + # the client should take before attempting creating a profile again. The backoff + # duration is returned in google.rpc.RetryInfo extension on the response status. + # To a gRPC client, the extension will be return as a binary-serialized proto in + # the trailing metadata item named "google.rpc.retryinfo-bin". # @param [String] parent # Parent project to create the profile in. # @param [Google::Apis::CloudprofilerV2::CreateProfileRequest] create_profile_request_object @@ -90,9 +88,9 @@ module Google execute_or_queue_command(command, &block) end - # CreateOfflineProfile creates a new profile resource in the offline mode. - # The client provides the profile to create along with the profile bytes, the - # server records it. + # CreateOfflineProfile creates a new profile resource in the offline mode. The + # client provides the profile to create along with the profile bytes, the server + # records it. # @param [String] parent # Parent project to create the profile in. # @param [Google::Apis::CloudprofilerV2::Profile] profile_object @@ -127,16 +125,16 @@ module Google # UpdateProfile updates the profile bytes and labels on the profile resource # created in the online mode. Updating the bytes for profiles created in the - # offline mode is currently not supported: the profile content must be - # provided at the time of the profile creation. + # offline mode is currently not supported: the profile content must be provided + # at the time of the profile creation. # @param [String] name # Output only. Opaque, server-assigned, unique ID for this profile. # @param [Google::Apis::CloudprofilerV2::Profile] profile_object # @param [String] update_mask # Field mask used to specify the fields to be overwritten. Currently only - # profile_bytes and labels fields are supported by UpdateProfile, so only - # those fields can be specified in the mask. When no mask is provided, all - # fields are overwritten. + # profile_bytes and labels fields are supported by UpdateProfile, so only those + # fields can be specified in the mask. When no mask is provided, all fields are + # overwritten. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user diff --git a/generated/google/apis/displayvideo_v1.rb b/generated/google/apis/displayvideo_v1.rb index 6a03b8602..cdb29de80 100644 --- a/generated/google/apis/displayvideo_v1.rb +++ b/generated/google/apis/displayvideo_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://developers.google.com/display-video/ module DisplayvideoV1 VERSION = 'V1' - REVISION = '20200804' + REVISION = '20200806' # Create, see, edit, and permanently delete your Display & Video 360 entities and reports AUTH_DISPLAY_VIDEO = 'https://www.googleapis.com/auth/display-video' diff --git a/generated/google/apis/displayvideo_v1/classes.rb b/generated/google/apis/displayvideo_v1/classes.rb index 81201b843..508bf9a98 100644 --- a/generated/google/apis/displayvideo_v1/classes.rb +++ b/generated/google/apis/displayvideo_v1/classes.rb @@ -1117,20 +1117,20 @@ module Google include Google::Apis::Core::Hashable # The number of ACTIVE and PAUSED campaigns under this advertiser. These - # campaigns count towards the limit of 9,999 campaigns per advertiser. + # campaigns count towards the limit of 9999 campaigns per advertiser. # Corresponds to the JSON property `usedCampaignsCount` # @return [Fixnum] attr_accessor :used_campaigns_count # The number of ACTIVE, PAUSED and DRAFT insertion orders under this advertiser. - # These insertion orders count towards the limit of 9,999 insertion orders per + # These insertion orders count towards the limit of 9999 insertion orders per # advertiser. # Corresponds to the JSON property `usedInsertionOrdersCount` # @return [Fixnum] attr_accessor :used_insertion_orders_count # The number of ACTIVE, PAUSED, and DRAFT line items under this advertiser. - # These line items count towards the limit of 9,999 line items per advertiser. + # These line items count towards the limit of 9999 line items per advertiser. # Corresponds to the JSON property `usedLineItemsCount` # @return [Fixnum] attr_accessor :used_line_items_count @@ -1469,7 +1469,7 @@ module Google end end - # Response message for BulkEditAssignedUserRoles. + # class BulkEditAssignedUserRolesResponse include Google::Apis::Core::Hashable @@ -5579,7 +5579,7 @@ module Google end end - # Response message for CustomBiddingAlgorithmService.ListCustomBiddingAlgorithms. + # class ListCustomBiddingAlgorithmsResponse include Google::Apis::Core::Hashable @@ -5906,7 +5906,7 @@ module Google end end - # Response message for ListPartnerAssignedTargetingOptions. + # class ListPartnerAssignedTargetingOptionsResponse include Google::Apis::Core::Hashable @@ -5934,7 +5934,7 @@ module Google end end - # Response message for ListPartners. + # class ListPartnersResponse include Google::Apis::Core::Hashable @@ -6015,7 +6015,7 @@ module Google end end - # Response message for ListUsers. + # class ListUsersResponse include Google::Apis::Core::Hashable diff --git a/generated/google/apis/displayvideo_v1/service.rb b/generated/google/apis/displayvideo_v1/service.rb index 543a77e44..d8eed4726 100644 --- a/generated/google/apis/displayvideo_v1/service.rb +++ b/generated/google/apis/displayvideo_v1/service.rb @@ -49,8 +49,8 @@ module Google end # Audits an advertiser. Returns the counts of used entities per resource type - # under the advertiser provided. Used entities count towards their [respective - # resource limit]: (https://support.google.com/displayvideo/answer/6071450?hl=en) + # under the advertiser provided. Used entities count towards their respective + # resource limit. See https://support.google.com/displayvideo/answer/6071450. # @param [Fixnum] advertiser_id # Required. The ID of the advertiser to audit. # @param [String] read_mask @@ -2845,9 +2845,9 @@ module Google # @param [Fixnum] custom_bidding_algorithm_id # Required. The ID of the custom bidding algorithm to fetch. # @param [Fixnum] advertiser_id - # The ID of the DV3 partner that has access to the custom bidding algorithm. + # The ID of the DV360 partner that has access to the custom bidding algorithm. # @param [Fixnum] partner_id - # The ID of the DV3 partner that has access to the custom bidding algorithm. + # The ID of the DV360 partner that has access to the custom bidding algorithm. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2881,7 +2881,7 @@ module Google # can be used in bidding stratgies. The order is defined by the order_by # parameter. # @param [Fixnum] advertiser_id - # The ID of the DV3 advertiser that has access to the custom bidding algorithm. + # The ID of the DV360 advertiser that has access to the custom bidding algorithm. # @param [String] filter # Allows filtering by custom bidding algorithm fields. Supported syntax: * # Filter expressions are made up of one or more restrictions. * Restrictions can @@ -2912,7 +2912,7 @@ module Google # ListCustomBiddingAlgorithms` method. If not specified, the first page of # results will be returned. # @param [Fixnum] partner_id - # The ID of the DV3 partner that has access to the custom bidding algorithm. + # The ID of the DV360 partner that has access to the custom bidding algorithm. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3856,9 +3856,9 @@ module Google # Bulk edits targeting options under a single partner. The operation will delete # the assigned targeting options provided in - # BulkEditPartnerAssignedTargetingOptionsRequest.delete_requests and then create + # BulkEditPartnerAssignedTargetingOptionsRequest.deleteRequests and then create # the assigned targeting options provided in - # BulkEditPartnerAssignedTargetingOptionsRequest.create_requests . + # BulkEditPartnerAssignedTargetingOptionsRequest.createRequests . # @param [Fixnum] partner_id # Required. The ID of the partner. # @param [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsRequest] bulk_edit_partner_assigned_targeting_options_request_object @@ -4657,9 +4657,9 @@ module Google end # Bulk edits user roles for a user. The operation will delete the assigned user - # roles provided in BulkEditAssignedUserRolesRequest.deleted_assigned_user_roles + # roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles # and then assign the user roles provided in BulkEditAssignedUserRolesRequest. - # created_assigned_user_roles. + # createdAssignedUserRoles. # @param [Fixnum] user_id # Required. The ID of the user to which the assigned user roles belong. # @param [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesRequest] bulk_edit_assigned_user_roles_request_object diff --git a/generated/google/apis/dlp_v2.rb b/generated/google/apis/dlp_v2.rb index 0f4a27e24..da28e3a46 100644 --- a/generated/google/apis/dlp_v2.rb +++ b/generated/google/apis/dlp_v2.rb @@ -27,7 +27,7 @@ module Google # @see https://cloud.google.com/dlp/docs/ module DlpV2 VERSION = 'V2' - REVISION = '20200726' + REVISION = '20200805' # 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/dlp_v2/classes.rb b/generated/google/apis/dlp_v2/classes.rb index f91cc2701..ba1b0ab9a 100644 --- a/generated/google/apis/dlp_v2/classes.rb +++ b/generated/google/apis/dlp_v2/classes.rb @@ -22,66 +22,59 @@ module Google module Apis module DlpV2 - # A task to execute on the completion of a job. - # See https://cloud.google.com/dlp/docs/concepts-actions to learn more. + # A task to execute on the completion of a job. See https://cloud.google.com/dlp/ + # docs/concepts-actions to learn more. class GooglePrivacyDlpV2Action include Google::Apis::Core::Hashable - # Enable email notification to project owners and editors on jobs's - # completion/failure. + # Enable email notification to project owners and editors on jobs's completion/ + # failure. # Corresponds to the JSON property `jobNotificationEmails` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2JobNotificationEmails] attr_accessor :job_notification_emails # Publish a message into given Pub/Sub topic when DlpJob has completed. The - # message contains a single field, `DlpJobName`, which is equal to the - # finished job's - # [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/projects. - # dlpJobs#DlpJob). - # Compatible with: Inspect, Risk + # message contains a single field, `DlpJobName`, which is equal to the finished + # job's [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/ + # projects.dlpJobs#DlpJob). Compatible with: Inspect, Risk # Corresponds to the JSON property `pubSub` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PublishToPubSub] attr_accessor :pub_sub # Publish findings of a DlpJob to Cloud Data Catalog. Labels summarizing the - # results of the DlpJob will be applied to the entry for the resource scanned - # in Cloud Data Catalog. Any labels previously written by another DlpJob will - # be deleted. InfoType naming patterns are strictly enforced when using this + # results of the DlpJob will be applied to the entry for the resource scanned in + # Cloud Data Catalog. Any labels previously written by another DlpJob will be + # deleted. InfoType naming patterns are strictly enforced when using this # feature. Note that the findings will be persisted in Cloud Data Catalog - # storage and are governed by Data Catalog service-specific policy, see - # https://cloud.google.com/terms/service-terms - # Only a single instance of this action can be specified and only allowed if - # all resources being scanned are BigQuery tables. - # Compatible with: Inspect + # storage and are governed by Data Catalog service-specific policy, see https:// + # cloud.google.com/terms/service-terms Only a single instance of this action can + # be specified and only allowed if all resources being scanned are BigQuery + # tables. Compatible with: Inspect # Corresponds to the JSON property `publishFindingsToCloudDataCatalog` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PublishFindingsToCloudDataCatalog] attr_accessor :publish_findings_to_cloud_data_catalog - # Publish the result summary of a DlpJob to the Cloud Security - # Command Center (CSCC Alpha). - # This action is only available for projects which are parts of - # an organization and whitelisted for the alpha Cloud Security Command - # Center. - # The action will publish count of finding instances and their info types. - # The summary of findings will be persisted in CSCC and are governed by CSCC - # service-specific policy, see https://cloud.google.com/terms/service-terms - # Only a single instance of this action can be specified. - # Compatible with: Inspect + # Publish the result summary of a DlpJob to the Cloud Security Command Center ( + # CSCC Alpha). This action is only available for projects which are parts of an + # organization and whitelisted for the alpha Cloud Security Command Center. The + # action will publish count of finding instances and their info types. The + # summary of findings will be persisted in CSCC and are governed by CSCC service- + # specific policy, see https://cloud.google.com/terms/service-terms Only a + # single instance of this action can be specified. Compatible with: Inspect # Corresponds to the JSON property `publishSummaryToCscc` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PublishSummaryToCscc] attr_accessor :publish_summary_to_cscc - # Enable Stackdriver metric dlp.googleapis.com/finding_count. This - # will publish a metric to stack driver on each infotype requested and - # how many findings were found for it. CustomDetectors will be bucketed - # as 'Custom' under the Stackdriver label 'info_type'. + # Enable Stackdriver metric dlp.googleapis.com/finding_count. This will publish + # a metric to stack driver on each infotype requested and how many findings were + # found for it. CustomDetectors will be bucketed as 'Custom' under the + # Stackdriver label 'info_type'. # Corresponds to the JSON property `publishToStackdriver` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PublishToStackdriver] attr_accessor :publish_to_stackdriver # If set, the detailed findings will be persisted to the specified - # OutputStorageConfig. Only a single instance of this action can be - # specified. + # OutputStorageConfig. Only a single instance of this action can be specified. # Compatible with: Inspect, Risk # Corresponds to the JSON property `saveFindings` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2SaveFindings] @@ -157,10 +150,8 @@ module Google attr_accessor :requested_privacy_metric # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `requestedSourceTable` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :requested_source_table @@ -182,13 +173,12 @@ module Google end end - # An auxiliary table contains statistical information on the relative - # frequency of different quasi-identifiers values. It has one or several - # quasi-identifiers columns, and one column that indicates the relative - # frequency of each quasi-identifier tuple. - # If a tuple is present in the data but not in the auxiliary table, the - # corresponding relative frequency is assumed to be zero (and thus, the - # tuple is highly reidentifiable). + # An auxiliary table contains statistical information on the relative frequency + # of different quasi-identifiers values. It has one or several quasi-identifiers + # columns, and one column that indicates the relative frequency of each quasi- + # identifier tuple. If a tuple is present in the data but not in the auxiliary + # table, the corresponding relative frequency is assumed to be zero (and thus, + # the tuple is highly reidentifiable). class GooglePrivacyDlpV2AuxiliaryTable include Google::Apis::Core::Hashable @@ -203,10 +193,8 @@ module Google attr_accessor :relative_frequency # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `table` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table @@ -233,10 +221,8 @@ module Google attr_accessor :field # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `table` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table @@ -257,19 +243,16 @@ module Google include Google::Apis::Core::Hashable # Row number inferred at the time the table was scanned. This value is - # nondeterministic, cannot be queried, and may be null for inspection - # jobs. To locate findings within a table, specify - # `inspect_job.storage_config.big_query_options.identifying_fields` in - # `CreateDlpJobRequest`. + # nondeterministic, cannot be queried, and may be null for inspection jobs. To + # locate findings within a table, specify `inspect_job.storage_config. + # big_query_options.identifying_fields` in `CreateDlpJobRequest`. # Corresponds to the JSON property `rowNumber` # @return [Fixnum] attr_accessor :row_number # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `tableReference` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table_reference @@ -295,11 +278,11 @@ module Google # @return [Array] attr_accessor :excluded_fields - # Table fields that may uniquely identify a row within the table. When - # `actions.saveFindings.outputConfig.table` is specified, the values of - # columns specified here are available in the output table under - # `location.content_locations.record_location.record_key.id_values`. Nested - # fields such as `person.birthdate.year` are allowed. + # Table fields that may uniquely identify a row within the table. When `actions. + # saveFindings.outputConfig.table` is specified, the values of columns specified + # here are available in the output table under `location.content_locations. + # record_location.record_key.id_values`. Nested fields such as `person.birthdate. + # year` are allowed. # Corresponds to the JSON property `identifyingFields` # @return [Array] attr_accessor :identifying_fields @@ -327,10 +310,8 @@ module Google attr_accessor :sample_method # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `tableReference` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table_reference @@ -351,10 +332,8 @@ module Google end # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. class GooglePrivacyDlpV2BigQueryTable include Google::Apis::Core::Hashable @@ -363,8 +342,8 @@ module Google # @return [String] attr_accessor :dataset_id - # The Google Cloud Platform project ID of the project containing the table. - # If omitted, project ID is inferred from the API call. + # The Google Cloud Platform project ID of the project containing the table. If + # omitted, project ID is inferred from the API call. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id @@ -427,32 +406,29 @@ module Google class GooglePrivacyDlpV2Bucket include Google::Apis::Core::Hashable - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `max` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :max - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `min` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :min - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `replacementValue` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :replacement_value @@ -471,12 +447,10 @@ module Google # Generalization function that buckets values based on ranges. The ranges and # replacement values are dynamically provided by the user for custom behavior, - # such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH - # This can be used on - # data of type: number, long, string, timestamp. - # If the bound `Value` type differs from the type of data being transformed, we - # will first attempt converting the type of the data to be transformed to match - # the type of the bound before comparing. + # such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH This can be used on data of + # type: number, long, string, timestamp. If the bound `Value` type differs from + # the type of data being transformed, we will first attempt converting the type + # of the data to be transformed to match the type of the bound before comparing. # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more. class GooglePrivacyDlpV2BucketingConfig include Google::Apis::Core::Hashable @@ -535,8 +509,8 @@ module Google end end - # Compute numerical stats over an individual column, including - # number of distinct values and value count distribution. + # Compute numerical stats over an individual column, including number of + # distinct values and value count distribution. class GooglePrivacyDlpV2CategoricalStatsConfig include Google::Apis::Core::Hashable @@ -569,8 +543,8 @@ module Google # @return [Fixnum] attr_accessor :bucket_value_count - # Sample of value frequencies in this bucket. The total number of - # values returned per bucket is capped at 20. + # Sample of value frequencies in this bucket. The total number of values + # returned per bucket is capped at 20. # Corresponds to the JSON property `bucketValues` # @return [Array] attr_accessor :bucket_values @@ -618,12 +592,11 @@ module Google end end - # Partially mask a string by replacing a given number of characters with a - # fixed character. Masking can start from the beginning or end of the string. - # This can be used on data of any type (numbers, longs, and so on) and when - # de-identifying structured data we'll attempt to preserve the original data's - # type. (This allows you to take a long like 123 and modify it to a string like - # **3. + # Partially mask a string by replacing a given number of characters with a fixed + # character. Masking can start from the beginning or end of the string. This can + # be used on data of any type (numbers, longs, and so on) and when de- + # identifying structured data we'll attempt to preserve the original data's type. + # (This allows you to take a long like 123 and modify it to a string like **3. class GooglePrivacyDlpV2CharacterMaskConfig include Google::Apis::Core::Hashable @@ -635,25 +608,25 @@ module Google # @return [Array] attr_accessor :characters_to_ignore - # Character to use to mask the sensitive values—for example, `*` for an - # alphabetic string such as a name, or `0` for a numeric string such as ZIP - # code or credit card number. This string must have a length of 1. If not - # supplied, this value defaults to `*` for strings, and `0` for digits. + # Character to use to mask the sensitive values—for example, `*` for an + # alphabetic string such as a name, or `0` for a numeric string such as ZIP code + # or credit card number. This string must have a length of 1. If not supplied, + # this value defaults to `*` for strings, and `0` for digits. # Corresponds to the JSON property `maskingCharacter` # @return [String] attr_accessor :masking_character - # Number of characters to mask. If not set, all matching chars will be - # masked. Skipped characters do not count towards this tally. + # Number of characters to mask. If not set, all matching chars will be masked. + # Skipped characters do not count towards this tally. # Corresponds to the JSON property `numberToMask` # @return [Fixnum] attr_accessor :number_to_mask - # Mask characters in reverse order. For example, if `masking_character` is - # `0`, `number_to_mask` is `14`, and `reverse_order` is `false`, then the - # input string `1234-5678-9012-3456` is masked as `00000000000000-3456`. - # If `masking_character` is `*`, `number_to_mask` is `3`, and `reverse_order` - # is `true`, then the string `12345` is masked as `12***`. + # Mask characters in reverse order. For example, if `masking_character` is `0`, ` + # number_to_mask` is `14`, and `reverse_order` is `false`, then the input string + # `1234-5678-9012-3456` is masked as `00000000000000-3456`. If ` + # masking_character` is `*`, `number_to_mask` is `3`, and `reverse_order` is ` + # true`, then the string `12345` is masked as `12***`. # Corresponds to the JSON property `reverseOrder` # @return [Boolean] attr_accessor :reverse_order @@ -703,8 +676,7 @@ module Google class GooglePrivacyDlpV2CloudStorageFileSet include Google::Apis::Core::Hashable - # The url, in the format `gs:///`. Trailing wildcard in the - # path is allowed. + # The url, in the format `gs:///`. Trailing wildcard in the path is allowed. # Corresponds to the JSON property `url` # @return [String] attr_accessor :url @@ -719,22 +691,21 @@ module Google end end - # Options defining a file or a set of files within a Google Cloud Storage - # bucket. + # Options defining a file or a set of files within a Google Cloud Storage bucket. class GooglePrivacyDlpV2CloudStorageOptions include Google::Apis::Core::Hashable # Max number of bytes to scan from a file. If a scanned file's size is bigger - # than this value then the rest of the bytes are omitted. Only one - # of bytes_limit_per_file and bytes_limit_per_file_percent can be specified. + # than this value then the rest of the bytes are omitted. Only one of + # bytes_limit_per_file and bytes_limit_per_file_percent can be specified. # Corresponds to the JSON property `bytesLimitPerFile` # @return [Fixnum] attr_accessor :bytes_limit_per_file - # Max percentage of bytes to scan from a file. The rest are omitted. The - # number of bytes scanned is rounded down. Must be between 0 and 100, - # inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one - # of bytes_limit_per_file and bytes_limit_per_file_percent can be specified. + # Max percentage of bytes to scan from a file. The rest are omitted. The number + # of bytes scanned is rounded down. Must be between 0 and 100, inclusively. Both + # 0 and 100 means no limit. Defaults to 0. Only one of bytes_limit_per_file and + # bytes_limit_per_file_percent can be specified. # Corresponds to the JSON property `bytesLimitPerFilePercent` # @return [Fixnum] attr_accessor :bytes_limit_per_file_percent @@ -744,13 +715,12 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FileSet] attr_accessor :file_set - # List of file type groups to include in the scan. - # If empty, all files are scanned and available data format processors - # are applied. In addition, the binary content of the selected files - # is always scanned as well. - # Images are scanned only as binary if the specified region - # does not support image inspection and no file_types were specified. - # Image inspection is restricted to 'global', 'us', 'asia', and 'europe'. + # List of file type groups to include in the scan. If empty, all files are + # scanned and available data format processors are applied. In addition, the + # binary content of the selected files is always scanned as well. Images are + # scanned only as binary if the specified region does not support image + # inspection and no file_types were specified. Image inspection is restricted to + # 'global', 'us', 'asia', and 'europe'. # Corresponds to the JSON property `fileTypes` # @return [Array] attr_accessor :file_types @@ -786,8 +756,8 @@ module Google class GooglePrivacyDlpV2CloudStoragePath include Google::Apis::Core::Hashable - # A url representing a file or path (no wildcards) in Cloud Storage. - # Example: gs://[BUCKET_NAME]/dictionary.txt + # A url representing a file or path (no wildcards) in Cloud Storage. Example: gs: + # //[BUCKET_NAME]/dictionary.txt # Corresponds to the JSON property `path` # @return [String] attr_accessor :path @@ -804,30 +774,23 @@ module Google # Message representing a set of files in a Cloud Storage bucket. Regular # expressions are used to allow fine-grained control over which files in the - # bucket to include. - # Included files are those that match at least one item in `include_regex` and - # do not match any items in `exclude_regex`. Note that a file that matches - # items from both lists will _not_ be included. For a match to occur, the - # entire file path (i.e., everything in the url after the bucket name) must - # match the regular expression. - # For example, given the input ``bucket_name: "mybucket", include_regex: - # ["directory1/.*"], exclude_regex: - # ["directory1/excluded.*"]``: - # * `gs://mybucket/directory1/myfile` will be included - # * `gs://mybucket/directory1/directory2/myfile` will be included (`.*` matches - # across `/`) - # * `gs://mybucket/directory0/directory1/myfile` will _not_ be included (the - # full path doesn't match any items in `include_regex`) - # * `gs://mybucket/directory1/excludedfile` will _not_ be included (the path - # matches an item in `exclude_regex`) - # If `include_regex` is left empty, it will match all files by default - # (this is equivalent to setting `include_regex: [".*"]`). - # Some other common use cases: - # * ``bucket_name: "mybucket", exclude_regex: [".*\.pdf"]`` will include all - # files in `mybucket` except for .pdf files - # * ``bucket_name: "mybucket", include_regex: ["directory/[^/]+"]`` will - # include all files directly under `gs://mybucket/directory/`, without matching - # across `/` + # bucket to include. Included files are those that match at least one item in ` + # include_regex` and do not match any items in `exclude_regex`. Note that a file + # that matches items from both lists will _not_ be included. For a match to + # occur, the entire file path (i.e., everything in the url after the bucket name) + # must match the regular expression. For example, given the input ``bucket_name: + # "mybucket", include_regex: ["directory1/.*"], exclude_regex: ["directory1/ + # excluded.*"]``: * `gs://mybucket/directory1/myfile` will be included * `gs:// + # mybucket/directory1/directory2/myfile` will be included (`.*` matches across `/ + # `) * `gs://mybucket/directory0/directory1/myfile` will _not_ be included (the + # full path doesn't match any items in `include_regex`) * `gs://mybucket/ + # directory1/excludedfile` will _not_ be included (the path matches an item in ` + # exclude_regex`) If `include_regex` is left empty, it will match all files by + # default (this is equivalent to setting `include_regex: [".*"]`). Some other + # common use cases: * ``bucket_name: "mybucket", exclude_regex: [".*\.pdf"]`` + # will include all files in `mybucket` except for .pdf files * ``bucket_name: " + # mybucket", include_regex: ["directory/[^/]+"]`` will include all files + # directly under `gs://mybucket/directory/`, without matching across `/` class GooglePrivacyDlpV2CloudStorageRegexFileSet include Google::Apis::Core::Hashable @@ -836,24 +799,22 @@ module Google # @return [String] attr_accessor :bucket_name - # A list of regular expressions matching file paths to exclude. All files in - # the bucket that match at least one of these regular expressions will be - # excluded from the scan. - # Regular expressions use RE2 - # [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found - # under the google/re2 repository on GitHub. + # A list of regular expressions matching file paths to exclude. All files in the + # bucket that match at least one of these regular expressions will be excluded + # from the scan. Regular expressions use RE2 [syntax](https://github.com/google/ + # re2/wiki/Syntax); a guide can be found under the google/re2 repository on + # GitHub. # Corresponds to the JSON property `excludeRegex` # @return [Array] attr_accessor :exclude_regex - # A list of regular expressions matching file paths to include. All files in - # the bucket that match at least one of these regular expressions will be - # included in the set of files, except for those that also match an item in - # `exclude_regex`. Leaving this field empty will match all files by default - # (this is equivalent to including `.*` in the list). - # Regular expressions use RE2 - # [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found - # under the google/re2 repository on GitHub. + # A list of regular expressions matching file paths to include. All files in the + # bucket that match at least one of these regular expressions will be included + # in the set of files, except for those that also match an item in ` + # exclude_regex`. Leaving this field empty will match all files by default (this + # is equivalent to including `.*` in the list). Regular expressions use RE2 [ + # syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found under + # the google/re2 repository on GitHub. # Corresponds to the JSON property `includeRegex` # @return [Array] attr_accessor :include_regex @@ -901,23 +862,18 @@ module Google end end - # The field type of `value` and `field` do not need to match to be - # considered equal, but not all comparisons are possible. - # EQUAL_TO and NOT_EQUAL_TO attempt to compare even with incompatible types, - # but all other comparisons are invalid with incompatible types. - # A `value` of type: - # - `string` can be compared against all other types - # - `boolean` can only be compared against other booleans - # - `integer` can be compared against doubles or a string if the string value - # can be parsed as an integer. - # - `double` can be compared against integers or a string if the string can - # be parsed as a double. - # - `Timestamp` can be compared against strings in RFC 3339 date string - # format. - # - `TimeOfDay` can be compared against timestamps and strings in the format - # of 'HH:mm:ss'. - # If we fail to compare do to type mismatch, a warning will be given and - # the condition will evaluate to false. + # The field type of `value` and `field` do not need to match to be considered + # equal, but not all comparisons are possible. EQUAL_TO and NOT_EQUAL_TO attempt + # to compare even with incompatible types, but all other comparisons are invalid + # with incompatible types. A `value` of type: - `string` can be compared against + # all other types - `boolean` can only be compared against other booleans - ` + # integer` can be compared against doubles or a string if the string value can + # be parsed as an integer. - `double` can be compared against integers or a + # string if the string can be parsed as a double. - `Timestamp` can be compared + # against strings in RFC 3339 date string format. - `TimeOfDay` can be compared + # against timestamps and strings in the format of 'HH:mm:ss'. If we fail to + # compare do to type mismatch, a warning will be given and the condition will + # evaluate to false. class GooglePrivacyDlpV2Condition include Google::Apis::Core::Hashable @@ -931,12 +887,11 @@ module Google # @return [String] attr_accessor :operator - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `value` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :value @@ -972,41 +927,35 @@ module Google end end - # Represents a container that may contain DLP findings. - # Examples of a container include a file, table, or database record. + # Represents a container that may contain DLP findings. Examples of a container + # include a file, table, or database record. class GooglePrivacyDlpV2Container include Google::Apis::Core::Hashable - # A string representation of the full container name. - # Examples: - # - BigQuery: 'Project:DataSetId.TableId' - # - Google Cloud Storage: 'gs://Bucket/folders/filename.txt' + # A string representation of the full container name. Examples: - BigQuery: ' + # Project:DataSetId.TableId' - Google Cloud Storage: 'gs://Bucket/folders/ + # filename.txt' # Corresponds to the JSON property `fullPath` # @return [String] attr_accessor :full_path - # Project where the finding was found. - # Can be different from the project that owns the finding. + # Project where the finding was found. Can be different from the project that + # owns the finding. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id - # The rest of the path after the root. - # Examples: - # - For BigQuery table `project_id:dataset_id.table_id`, the relative path is - # `table_id` - # - Google Cloud Storage file `gs://bucket/folder/filename.txt`, the relative - # path is `folder/filename.txt` + # The rest of the path after the root. Examples: - For BigQuery table ` + # project_id:dataset_id.table_id`, the relative path is `table_id` - Google + # Cloud Storage file `gs://bucket/folder/filename.txt`, the relative path is ` + # folder/filename.txt` # Corresponds to the JSON property `relativePath` # @return [String] attr_accessor :relative_path - # The root of the container. - # Examples: - # - For BigQuery table `project_id:dataset_id.table_id`, the root is - # `dataset_id` - # - For Google Cloud Storage file `gs://bucket/folder/filename.txt`, the root - # is `gs://bucket` + # The root of the container. Examples: - For BigQuery table `project_id: + # dataset_id.table_id`, the root is `dataset_id` - For Google Cloud Storage file + # `gs://bucket/folder/filename.txt`, the root is `gs://bucket` # Corresponds to the JSON property `rootPath` # @return [String] attr_accessor :root_path @@ -1016,16 +965,15 @@ module Google # @return [String] attr_accessor :type - # Findings container modification timestamp, if applicable. - # For Google Cloud Storage contains last file modification timestamp. - # For BigQuery table contains last_modified_time property. - # For Datastore - not populated. + # Findings container modification timestamp, if applicable. For Google Cloud + # Storage contains last file modification timestamp. For BigQuery table contains + # last_modified_time property. For Datastore - not populated. # Corresponds to the JSON property `updateTime` # @return [String] attr_accessor :update_time - # Findings container version, if available - # ("generation" for Google Cloud Storage). + # Findings container version, if available ("generation" for Google Cloud + # Storage). # Corresponds to the JSON property `version` # @return [String] attr_accessor :version @@ -1055,9 +1003,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2ByteContentItem] attr_accessor :byte_item - # Structured content to inspect. Up to 50,000 `Value`s per request allowed. - # See https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to - # learn more. + # Structured content to inspect. Up to 50,000 `Value`s per request allowed. See + # https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to learn + # more. # Corresponds to the JSON property `table` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Table] attr_accessor :table @@ -1084,28 +1032,25 @@ module Google class GooglePrivacyDlpV2ContentLocation include Google::Apis::Core::Hashable - # Name of the container where the finding is located. - # The top level name is the source file name or table name. Names of some - # common storage containers are formatted as follows: - # * BigQuery tables: ``project_id`:`dataset_id`.`table_id`` - # * Cloud Storage files: `gs://`bucket`/`path`` - # * Datastore namespace: `namespace` - # Nested names could be absent if the embedded object has no string + # Name of the container where the finding is located. The top level name is the + # source file name or table name. Names of some common storage containers are + # formatted as follows: * BigQuery tables: ``project_id`:`dataset_id`.`table_id`` + # * Cloud Storage files: `gs://`bucket`/`path`` * Datastore namespace: ` + # namespace` Nested names could be absent if the embedded object has no string # identifier (for an example an image contained within a document). # Corresponds to the JSON property `containerName` # @return [String] attr_accessor :container_name - # Findings container modification timestamp, if applicable. - # For Google Cloud Storage contains last file modification timestamp. - # For BigQuery table contains last_modified_time property. - # For Datastore - not populated. + # Findings container modification timestamp, if applicable. For Google Cloud + # Storage contains last file modification timestamp. For BigQuery table contains + # last_modified_time property. For Datastore - not populated. # Corresponds to the JSON property `containerTimestamp` # @return [String] attr_accessor :container_timestamp - # Findings container version, if available - # ("generation" for Google Cloud Storage). + # Findings container version, if available ("generation" for Google Cloud + # Storage). # Corresponds to the JSON property `containerVersion` # @return [String] attr_accessor :container_version @@ -1150,8 +1095,8 @@ module Google class GooglePrivacyDlpV2CreateDeidentifyTemplateRequest include Google::Apis::Core::Hashable - # DeidentifyTemplates contains instructions on how to de-identify content. - # See https://cloud.google.com/dlp/docs/concepts-templates to learn more. + # DeidentifyTemplates contains instructions on how to de-identify content. See + # https://cloud.google.com/dlp/docs/concepts-templates to learn more. # Corresponds to the JSON property `deidentifyTemplate` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate] attr_accessor :deidentify_template @@ -1161,10 +1106,10 @@ module Google # @return [String] attr_accessor :location_id - # The template id can contain uppercase and lowercase letters, - # numbers, and hyphens; that is, it must match the regular - # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100 - # characters. Can be empty to allow the system to generate one. + # The template id can contain uppercase and lowercase letters, numbers, and + # hyphens; that is, it must match the regular expression: `[a-zA-Z\\d-_]+`. The + # maximum length is 100 characters. Can be empty to allow the system to generate + # one. # Corresponds to the JSON property `templateId` # @return [String] attr_accessor :template_id @@ -1181,9 +1126,8 @@ module Google end end - # Request message for CreateDlpJobRequest. Used to initiate long running - # jobs such as calculating risk metrics or inspecting Google Cloud - # Storage. + # Request message for CreateDlpJobRequest. Used to initiate long running jobs + # such as calculating risk metrics or inspecting Google Cloud Storage. class GooglePrivacyDlpV2CreateDlpJobRequest include Google::Apis::Core::Hashable @@ -1192,10 +1136,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectJobConfig] attr_accessor :inspect_job - # The job id can contain uppercase and lowercase letters, - # numbers, and hyphens; that is, it must match the regular - # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100 - # characters. Can be empty to allow the system to generate one. + # The job id can contain uppercase and lowercase letters, numbers, and hyphens; + # that is, it must match the regular expression: `[a-zA-Z\\d-_]+`. The maximum + # length is 100 characters. Can be empty to allow the system to generate one. # Corresponds to the JSON property `jobId` # @return [String] attr_accessor :job_id @@ -1205,8 +1148,8 @@ module Google # @return [String] attr_accessor :location_id - # Configuration for a risk analysis job. See - # https://cloud.google.com/dlp/docs/concepts-risk-analysis to learn more. + # Configuration for a risk analysis job. See https://cloud.google.com/dlp/docs/ + # concepts-risk-analysis to learn more. # Corresponds to the JSON property `riskJob` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2RiskAnalysisJobConfig] attr_accessor :risk_job @@ -1230,8 +1173,8 @@ module Google # The inspectTemplate contains a configuration (set of types of sensitive data # to be detected) to be used anywhere you otherwise would normally specify - # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates - # to learn more. + # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to + # learn more. # Corresponds to the JSON property `inspectTemplate` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate] attr_accessor :inspect_template @@ -1241,10 +1184,10 @@ module Google # @return [String] attr_accessor :location_id - # The template id can contain uppercase and lowercase letters, - # numbers, and hyphens; that is, it must match the regular - # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100 - # characters. Can be empty to allow the system to generate one. + # The template id can contain uppercase and lowercase letters, numbers, and + # hyphens; that is, it must match the regular expression: `[a-zA-Z\\d-_]+`. The + # maximum length is 100 characters. Can be empty to allow the system to generate + # one. # Corresponds to the JSON property `templateId` # @return [String] attr_accessor :template_id @@ -1265,8 +1208,8 @@ module Google class GooglePrivacyDlpV2CreateJobTriggerRequest include Google::Apis::Core::Hashable - # Contains a configuration to make dlp api calls on a repeating basis. - # See https://cloud.google.com/dlp/docs/concepts-job-triggers to learn more. + # Contains a configuration to make dlp api calls on a repeating basis. See https: + # //cloud.google.com/dlp/docs/concepts-job-triggers to learn more. # Corresponds to the JSON property `jobTrigger` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2JobTrigger] attr_accessor :job_trigger @@ -1276,10 +1219,10 @@ module Google # @return [String] attr_accessor :location_id - # The trigger id can contain uppercase and lowercase letters, - # numbers, and hyphens; that is, it must match the regular - # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100 - # characters. Can be empty to allow the system to generate one. + # The trigger id can contain uppercase and lowercase letters, numbers, and + # hyphens; that is, it must match the regular expression: `[a-zA-Z\\d-_]+`. The + # maximum length is 100 characters. Can be empty to allow the system to generate + # one. # Corresponds to the JSON property `triggerId` # @return [String] attr_accessor :trigger_id @@ -1300,9 +1243,9 @@ module Google class GooglePrivacyDlpV2CreateStoredInfoTypeRequest include Google::Apis::Core::Hashable - # Configuration for stored infoTypes. All fields and subfield are provided - # by the user. For more information, see - # https://cloud.google.com/dlp/docs/creating-custom-infotypes. + # Configuration for stored infoTypes. All fields and subfield are provided by + # the user. For more information, see https://cloud.google.com/dlp/docs/creating- + # custom-infotypes. # Corresponds to the JSON property `config` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoTypeConfig] attr_accessor :config @@ -1312,10 +1255,10 @@ module Google # @return [String] attr_accessor :location_id - # The storedInfoType ID can contain uppercase and lowercase letters, - # numbers, and hyphens; that is, it must match the regular - # expression: `[a-zA-Z\\d-_]+`. The maximum length is 100 - # characters. Can be empty to allow the system to generate one. + # The storedInfoType ID can contain uppercase and lowercase letters, numbers, + # and hyphens; that is, it must match the regular expression: `[a-zA-Z\\d-_]+`. + # The maximum length is 100 characters. Can be empty to allow the system to + # generate one. # Corresponds to the JSON property `storedInfoTypeId` # @return [String] attr_accessor :stored_info_type_id @@ -1333,8 +1276,8 @@ module Google end # Pseudonymization method that generates deterministic encryption for the given - # input. Outputs a base64 encoded representation of the encrypted output. - # Uses AES-SIV based on the RFC https://tools.ietf.org/html/rfc5297. + # input. Outputs a base64 encoded representation of the encrypted output. Uses + # AES-SIV based on the RFC https://tools.ietf.org/html/rfc5297. class GooglePrivacyDlpV2CryptoDeterministicConfig include Google::Apis::Core::Hashable @@ -1343,10 +1286,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :context - # This is a data encryption key (DEK) (as opposed to - # a key encryption key (KEK) stored by KMS). - # When using KMS to wrap/unwrap DEKs, be sure to set an appropriate - # IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot + # This is a data encryption key (DEK) (as opposed to a key encryption key (KEK) + # stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set an + # appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot # unwrap the data crypto key. # Corresponds to the JSON property `cryptoKey` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoKey] @@ -1370,19 +1312,17 @@ module Google end # Pseudonymization method that generates surrogates via cryptographic hashing. - # Uses SHA-256. - # The key size must be either 32 or 64 bytes. - # Outputs a base64 encoded representation of the hashed output - # (for example, L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=). - # Currently, only string and integer values can be hashed. - # See https://cloud.google.com/dlp/docs/pseudonymization to learn more. + # Uses SHA-256. The key size must be either 32 or 64 bytes. Outputs a base64 + # encoded representation of the hashed output (for example, + # L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=). Currently, only string and + # integer values can be hashed. See https://cloud.google.com/dlp/docs/ + # pseudonymization to learn more. class GooglePrivacyDlpV2CryptoHashConfig include Google::Apis::Core::Hashable - # This is a data encryption key (DEK) (as opposed to - # a key encryption key (KEK) stored by KMS). - # When using KMS to wrap/unwrap DEKs, be sure to set an appropriate - # IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot + # This is a data encryption key (DEK) (as opposed to a key encryption key (KEK) + # stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set an + # appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot # unwrap the data crypto key. # Corresponds to the JSON property `cryptoKey` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoKey] @@ -1398,31 +1338,29 @@ module Google end end - # This is a data encryption key (DEK) (as opposed to - # a key encryption key (KEK) stored by KMS). - # When using KMS to wrap/unwrap DEKs, be sure to set an appropriate - # IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot + # This is a data encryption key (DEK) (as opposed to a key encryption key (KEK) + # stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set an + # appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot # unwrap the data crypto key. class GooglePrivacyDlpV2CryptoKey include Google::Apis::Core::Hashable - # Include to use an existing data crypto key wrapped by KMS. - # The wrapped key must be a 128/192/256 bit key. - # Authorization requires the following IAM permissions when sending a request - # to perform a crypto transformation using a kms-wrapped crypto key: - # dlp.kms.encrypt + # Include to use an existing data crypto key wrapped by KMS. The wrapped key + # must be a 128/192/256 bit key. Authorization requires the following IAM + # permissions when sending a request to perform a crypto transformation using a + # kms-wrapped crypto key: dlp.kms.encrypt # Corresponds to the JSON property `kmsWrapped` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2KmsWrappedCryptoKey] attr_accessor :kms_wrapped - # Use this to have a random data crypto key generated. - # It will be discarded after the request finishes. + # Use this to have a random data crypto key generated. It will be discarded + # after the request finishes. # Corresponds to the JSON property `transient` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2TransientCryptoKey] attr_accessor :transient - # Using raw keys is prone to security risks due to accidentally - # leaking the key. Choose another type of key if possible. + # Using raw keys is prone to security risks due to accidentally leaking the key. + # Choose another type of key if possible. # Corresponds to the JSON property `unwrapped` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2UnwrappedCryptoKey] attr_accessor :unwrapped @@ -1439,18 +1377,17 @@ module Google end end - # Replaces an identifier with a surrogate using Format Preserving Encryption - # (FPE) with the FFX mode of operation; however when used in the - # `ReidentifyContent` API method, it serves the opposite function by reversing + # Replaces an identifier with a surrogate using Format Preserving Encryption ( + # FPE) with the FFX mode of operation; however when used in the ` + # ReidentifyContent` API method, it serves the opposite function by reversing # the surrogate back into the original identifier. The identifier must be - # encoded as ASCII. For a given crypto key and context, the same identifier - # will be replaced with the same surrogate. Identifiers must be at least two + # encoded as ASCII. For a given crypto key and context, the same identifier will + # be replaced with the same surrogate. Identifiers must be at least two # characters long. In the case that the identifier is the empty string, it will # be skipped. See https://cloud.google.com/dlp/docs/pseudonymization to learn - # more. - # Note: We recommend using CryptoDeterministicConfig for all use cases which - # do not require preserving the input alphabet space and size, plus warrant - # referential integrity. + # more. Note: We recommend using CryptoDeterministicConfig for all use cases + # which do not require preserving the input alphabet space and size, plus + # warrant referential integrity. class GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig include Google::Apis::Core::Hashable @@ -1464,25 +1401,21 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :context - # This is a data encryption key (DEK) (as opposed to - # a key encryption key (KEK) stored by KMS). - # When using KMS to wrap/unwrap DEKs, be sure to set an appropriate - # IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot + # This is a data encryption key (DEK) (as opposed to a key encryption key (KEK) + # stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set an + # appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot # unwrap the data crypto key. # Corresponds to the JSON property `cryptoKey` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoKey] attr_accessor :crypto_key - # This is supported by mapping these to the alphanumeric characters - # that the FFX mode natively supports. This happens before/after - # encryption/decryption. - # Each character listed must appear only once. - # Number of characters must be in the range [2, 95]. - # This must be encoded as ASCII. - # The order of characters does not matter. - # The full list of allowed characters is: - # 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz - # ~`!@#$%^&*()_-+=`[`]|\:;"'<,>.?/ + # This is supported by mapping these to the alphanumeric characters that the FFX + # mode natively supports. This happens before/after encryption/decryption. Each + # character listed must appear only once. Number of characters must be in the + # range [2, 95]. This must be encoded as ASCII. The order of characters does not + # matter. The full list of allowed characters is: + # 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz ~`!@#$%^&*()_-+= + # `[`]|\:;"'<,>.?/ # Corresponds to the JSON property `customAlphabet` # @return [String] attr_accessor :custom_alphabet @@ -1517,41 +1450,37 @@ module Google class GooglePrivacyDlpV2CustomInfoType include Google::Apis::Core::Hashable - # Set of detection rules to apply to all findings of this CustomInfoType. - # Rules are applied in order that they are specified. Not supported for the - # `surrogate_type` CustomInfoType. + # Set of detection rules to apply to all findings of this CustomInfoType. Rules + # are applied in order that they are specified. Not supported for the ` + # surrogate_type` CustomInfoType. # Corresponds to the JSON property `detectionRules` # @return [Array] attr_accessor :detection_rules - # Custom information type based on a dictionary of words or phrases. This can - # be used to match sensitive information specific to the data, such as a list - # of employee IDs or job titles. - # Dictionary words are case-insensitive and all characters other than letters - # and digits in the unicode [Basic Multilingual + # Custom information type based on a dictionary of words or phrases. This can be + # used to match sensitive information specific to the data, such as a list of + # employee IDs or job titles. Dictionary words are case-insensitive and all + # characters other than letters and digits in the unicode [Basic Multilingual # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29# - # Basic_Multilingual_Plane) - # will be replaced with whitespace when scanning for matches, so the - # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", - # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters - # surrounding any match must be of a different type than the adjacent - # characters within the word, so letters must be next to non-letters and - # digits next to non-digits. For example, the dictionary word "jen" will - # match the first three letters of the text "jen123" but will return no - # matches for "jennifer". - # Dictionary words containing a large number of characters that are not - # letters or digits may result in unexpected findings because such characters - # are treated as whitespace. The - # [limits](https://cloud.google.com/dlp/limits) page contains details about - # the size limits of dictionaries. For dictionaries that do not fit within - # these constraints, consider using `LargeCustomDictionaryConfig` in the - # `StoredInfoType` API. + # Basic_Multilingual_Plane) will be replaced with whitespace when scanning for + # matches, so the dictionary phrase "Sam Johnson" will match all three phrases " + # sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the + # characters surrounding any match must be of a different type than the adjacent + # characters within the word, so letters must be next to non-letters and digits + # next to non-digits. For example, the dictionary word "jen" will match the + # first three letters of the text "jen123" but will return no matches for " + # jennifer". Dictionary words containing a large number of characters that are + # not letters or digits may result in unexpected findings because such + # characters are treated as whitespace. The [limits](https://cloud.google.com/ + # dlp/limits) page contains details about the size limits of dictionaries. For + # dictionaries that do not fit within these constraints, consider using ` + # LargeCustomDictionaryConfig` in the `StoredInfoType` API. # Corresponds to the JSON property `dictionary` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Dictionary] attr_accessor :dictionary - # If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding - # to be returned. It still can be used for rules matching. + # If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding to be + # returned. It still can be used for rules matching. # Corresponds to the JSON property `exclusionType` # @return [String] attr_accessor :exclusion_type @@ -1561,9 +1490,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InfoType] attr_accessor :info_type - # Likelihood to return for this CustomInfoType. This base value can be - # altered by a detection rule if the finding meets the criteria specified by - # the rule. Defaults to `VERY_LIKELY` if not specified. + # Likelihood to return for this CustomInfoType. This base value can be altered + # by a detection rule if the finding meets the criteria specified by the rule. + # Defaults to `VERY_LIKELY` if not specified. # Corresponds to the JSON property `likelihood` # @return [String] attr_accessor :likelihood @@ -1578,15 +1507,13 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2StoredType] attr_accessor :stored_type - # Message for detecting output from deidentification transformations - # such as - # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ - # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). - # These types of transformations are - # those that perform pseudonymization, thereby producing a "surrogate" as - # output. This should be used in conjunction with a field on the - # transformation such as `surrogate_info_type`. This CustomInfoType does - # not support the use of `detection_rules`. + # Message for detecting output from deidentification transformations such as [` + # CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ + # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). These types + # of transformations are those that perform pseudonymization, thereby producing + # a "surrogate" as output. This should be used in conjunction with a field on + # the transformation such as `surrogate_info_type`. This CustomInfoType does not + # support the use of `detection_rules`. # Corresponds to the JSON property `surrogateType` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2SurrogateType] attr_accessor :surrogate_type @@ -1612,9 +1539,8 @@ module Google class GooglePrivacyDlpV2DatastoreKey include Google::Apis::Core::Hashable - # A unique identifier for a Datastore entity. - # If a key's partition ID or any of its path kinds or names are - # reserved/read-only, the key is reserved/read-only. + # A unique identifier for a Datastore entity. If a key's partition ID or any of + # its path kinds or names are reserved/read-only, the key is reserved/read-only. # A reserved/read-only key is forbidden in certain documented contexts. # Corresponds to the JSON property `entityKey` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Key] @@ -1639,11 +1565,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2KindExpression] attr_accessor :kind - # Datastore partition ID. - # A partition ID identifies a grouping of entities. The grouping is always - # by project and namespace, however the namespace ID may be empty. - # A partition ID contains several dimensions: - # project ID and namespace ID. + # Datastore partition ID. A partition ID identifies a grouping of entities. The + # grouping is always by project and namespace, however the namespace ID may be + # empty. A partition ID contains several dimensions: project ID and namespace ID. # Corresponds to the JSON property `partitionId` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PartitionId] attr_accessor :partition_id @@ -1660,8 +1584,8 @@ module Google end # Shifts dates by random number of days, with option to be consistent for the - # same context. See https://cloud.google.com/dlp/docs/concepts-date-shifting - # to learn more. + # same context. See https://cloud.google.com/dlp/docs/concepts-date-shifting to + # learn more. class GooglePrivacyDlpV2DateShiftConfig include Google::Apis::Core::Hashable @@ -1670,10 +1594,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :context - # This is a data encryption key (DEK) (as opposed to - # a key encryption key (KEK) stored by KMS). - # When using KMS to wrap/unwrap DEKs, be sure to set an appropriate - # IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot + # This is a data encryption key (DEK) (as opposed to a key encryption key (KEK) + # stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set an + # appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot # unwrap the data crypto key. # Corresponds to the JSON property `cryptoKey` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoKey] @@ -1685,10 +1608,9 @@ module Google attr_accessor :lower_bound_days # Required. Range of shift in days. Actual shift will be selected at random - # within this - # range (inclusive ends). Negative means shift to earlier in time. Must not - # be more than 365250 days (1000 years) each direction. - # For example, 3 means shift date to at most 3 days into the future. + # within this range (inclusive ends). Negative means shift to earlier in time. + # Must not be more than 365250 days (1000 years) each direction. For example, 3 + # means shift date to at most 3 days into the future. # Corresponds to the JSON property `upperBoundDays` # @return [Fixnum] attr_accessor :upper_bound_days @@ -1706,19 +1628,18 @@ module Google end end - # Message for a date time object. - # e.g. 2018-01-01, 5th August. + # Message for a date time object. e.g. 2018-01-01, 5th August. class GooglePrivacyDlpV2DateTime include Google::Apis::Core::Hashable # Represents a whole or partial calendar date, e.g. a birthday. The time of day # and time zone are either specified elsewhere or are not significant. The date - # is relative to the Proleptic Gregorian Calendar. This can represent: - # * A full date, with non-zero year, month and day values - # * A month and day value, with a zero year, e.g. an anniversary - # * A year on its own, with zero month and day values - # * A year and month value, with a zero day, e.g. a credit card expiration date - # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`. + # is relative to the Proleptic Gregorian Calendar. This can represent: * A full + # date, with non-zero year, month and day values * A month and day value, with a + # zero year, e.g. an anniversary * A year on its own, with zero month and day + # values * A year and month value, with a zero day, e.g. a credit card + # expiration date Related types are google.type.TimeOfDay and `google.protobuf. + # Timestamp`. # Corresponds to the JSON property `date` # @return [Google::Apis::DlpV2::GoogleTypeDate] attr_accessor :date @@ -1728,8 +1649,8 @@ module Google # @return [String] attr_accessor :day_of_week - # Represents a time of day. The date and time zone are either not significant - # or are specified elsewhere. An API may choose to allow leap seconds. Related + # Represents a time of day. The date and time zone are either not significant or + # are specified elsewhere. An API may choose to allow leap seconds. Related # types are google.type.Date and `google.protobuf.Timestamp`. # Corresponds to the JSON property `time` # @return [Google::Apis::DlpV2::GoogleTypeTimeOfDay] @@ -1757,28 +1678,25 @@ module Google class GooglePrivacyDlpV2DeidentifyConfig include Google::Apis::Core::Hashable - # A type of transformation that will scan unstructured text and - # apply various `PrimitiveTransformation`s to each finding, where the - # transformation is applied to only values that were identified as a specific - # info_type. + # A type of transformation that will scan unstructured text and apply various ` + # PrimitiveTransformation`s to each finding, where the transformation is applied + # to only values that were identified as a specific info_type. # Corresponds to the JSON property `infoTypeTransformations` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InfoTypeTransformations] attr_accessor :info_type_transformations - # A type of transformation that is applied over structured data such as a - # table. + # A type of transformation that is applied over structured data such as a table. # Corresponds to the JSON property `recordTransformations` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2RecordTransformations] attr_accessor :record_transformations - # How to handle transformation errors during de-identification. A - # transformation error occurs when the requested transformation is incompatible - # with the data. For example, trying to de-identify an IP address using a - # `DateShift` transformation would result in a transformation error, since date - # info cannot be extracted from an IP address. - # Information about any incompatible transformations, and how they were - # handled, is returned in the response as part of the - # `TransformationOverviews`. + # How to handle transformation errors during de-identification. A transformation + # error occurs when the requested transformation is incompatible with the data. + # For example, trying to de-identify an IP address using a `DateShift` + # transformation would result in a transformation error, since date info cannot + # be extracted from an IP address. Information about any incompatible + # transformations, and how they were handled, is returned in the response as + # part of the `TransformationOverviews`. # Corresponds to the JSON property `transformationErrorHandling` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2TransformationErrorHandling] attr_accessor :transformation_error_handling @@ -1804,27 +1722,24 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyConfig] attr_accessor :deidentify_config - # Template to use. Any configuration directly specified in - # deidentify_config will override those set in the template. Singular fields - # that are set in this request will replace their corresponding fields in the - # template. Repeated fields are appended. Singular sub-messages and groups - # are recursively merged. + # Template to use. Any configuration directly specified in deidentify_config + # will override those set in the template. Singular fields that are set in this + # request will replace their corresponding fields in the template. Repeated + # fields are appended. Singular sub-messages and groups are recursively merged. # Corresponds to the JSON property `deidentifyTemplateName` # @return [String] attr_accessor :deidentify_template_name - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config - # Template to use. Any configuration directly specified in - # inspect_config will override those set in the template. Singular fields - # that are set in this request will replace their corresponding fields in the - # template. Repeated fields are appended. Singular sub-messages and groups - # are recursively merged. + # Template to use. Any configuration directly specified in inspect_config will + # override those set in the template. Singular fields that are set in this + # request will replace their corresponding fields in the template. Repeated + # fields are appended. Singular sub-messages and groups are recursively merged. # Corresponds to the JSON property `inspectTemplateName` # @return [String] attr_accessor :inspect_template_name @@ -1879,8 +1794,8 @@ module Google end end - # DeidentifyTemplates contains instructions on how to de-identify content. - # See https://cloud.google.com/dlp/docs/concepts-templates to learn more. + # DeidentifyTemplates contains instructions on how to de-identify content. See + # https://cloud.google.com/dlp/docs/concepts-templates to learn more. class GooglePrivacyDlpV2DeidentifyTemplate include Google::Apis::Core::Hashable @@ -1904,10 +1819,9 @@ module Google # @return [String] attr_accessor :display_name - # Output only. The template name. - # The template will have one of the following formats: - # `projects/PROJECT_ID/deidentifyTemplates/TEMPLATE_ID` OR - # `organizations/ORGANIZATION_ID/deidentifyTemplates/TEMPLATE_ID` + # Output only. The template name. The template will have one of the following + # formats: `projects/PROJECT_ID/deidentifyTemplates/TEMPLATE_ID` OR ` + # organizations/ORGANIZATION_ID/deidentifyTemplates/TEMPLATE_ID` # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -1932,30 +1846,29 @@ module Google end end - # δ-presence metric, used to estimate how likely it is for an attacker to - # figure out that one given individual appears in a de-identified dataset. - # Similarly to the k-map metric, we cannot compute δ-presence exactly without - # knowing the attack dataset, so we use a statistical model instead. + # δ-presence metric, used to estimate how likely it is for an attacker to figure + # out that one given individual appears in a de-identified dataset. Similarly to + # the k-map metric, we cannot compute δ-presence exactly without knowing the + # attack dataset, so we use a statistical model instead. class GooglePrivacyDlpV2DeltaPresenceEstimationConfig include Google::Apis::Core::Hashable - # Several auxiliary tables can be used in the analysis. Each custom_tag - # used to tag a quasi-identifiers field must appear in exactly one - # field of one auxiliary table. + # Several auxiliary tables can be used in the analysis. Each custom_tag used to + # tag a quasi-identifiers field must appear in exactly one field of one + # auxiliary table. # Corresponds to the JSON property `auxiliaryTables` # @return [Array] attr_accessor :auxiliary_tables # Required. Fields considered to be quasi-identifiers. No two fields can have - # the - # same tag. + # the same tag. # Corresponds to the JSON property `quasiIds` # @return [Array] attr_accessor :quasi_ids - # ISO 3166-1 alpha-2 region code to use in the statistical modeling. - # Set if no column is tagged with a region-specific InfoType (like - # US_ZIP_5) or a region code. + # ISO 3166-1 alpha-2 region code to use in the statistical modeling. Set if no + # column is tagged with a region-specific InfoType (like US_ZIP_5) or a region + # code. # Corresponds to the JSON property `regionCode` # @return [String] attr_accessor :region_code @@ -1972,15 +1885,11 @@ module Google end end - # A DeltaPresenceEstimationHistogramBucket message with the following - # values: - # min_probability: 0.1 - # max_probability: 0.2 - # frequency: 42 - # means that there are 42 records for which δ is in [0.1, 0.2). An - # important particular case is when min_probability = max_probability = 1: - # then, every individual who shares this quasi-identifier combination is in - # the dataset. + # A DeltaPresenceEstimationHistogramBucket message with the following values: + # min_probability: 0.1 max_probability: 0.2 frequency: 42 means that there are + # 42 records for which δ is in [0.1, 0.2). An important particular case is when + # min_probability = max_probability = 1: then, every individual who shares this + # quasi-identifier combination is in the dataset. class GooglePrivacyDlpV2DeltaPresenceEstimationHistogramBucket include Google::Apis::Core::Hashable @@ -1994,8 +1903,8 @@ module Google # @return [Fixnum] attr_accessor :bucket_value_count - # Sample of quasi-identifier tuple values in this bucket. The total - # number of classes returned per bucket is capped at 20. + # Sample of quasi-identifier tuple values in this bucket. The total number of + # classes returned per bucket is capped at 20. # Corresponds to the JSON property `bucketValues` # @return [Array] attr_accessor :bucket_values @@ -2028,14 +1937,13 @@ module Google class GooglePrivacyDlpV2DeltaPresenceEstimationQuasiIdValues include Google::Apis::Core::Hashable - # The estimated probability that a given individual sharing these - # quasi-identifier values is in the dataset. This value, typically called - # δ, is the ratio between the number of records in the dataset with these - # quasi-identifier values, and the total number of individuals (inside - # *and* outside the dataset) with these quasi-identifier values. - # For example, if there are 15 individuals in the dataset who share the - # same quasi-identifier values, and an estimated 100 people in the entire - # population with these values, then δ is 0.15. + # The estimated probability that a given individual sharing these quasi- + # identifier values is in the dataset. This value, typically called δ, is the + # ratio between the number of records in the dataset with these quasi-identifier + # values, and the total number of individuals (inside *and* outside the dataset) + # with these quasi-identifier values. For example, if there are 15 individuals + # in the dataset who share the same quasi-identifier values, and an estimated + # 100 people in the entire population with these values, then δ is 0.15. # Corresponds to the JSON property `estimatedProbability` # @return [Float] attr_accessor :estimated_probability @@ -2061,14 +1969,13 @@ module Google class GooglePrivacyDlpV2DeltaPresenceEstimationResult include Google::Apis::Core::Hashable - # The intervals [min_probability, max_probability) do not overlap. If a - # value doesn't correspond to any such interval, the associated frequency - # is zero. For example, the following records: - # `min_probability: 0, max_probability: 0.1, frequency: 17` - # `min_probability: 0.2, max_probability: 0.3, frequency: 42` - # `min_probability: 0.3, max_probability: 0.4, frequency: 99` - # mean that there are no record with an estimated probability in [0.1, 0.2) - # nor larger or equal to 0.4. + # The intervals [min_probability, max_probability) do not overlap. If a value + # doesn't correspond to any such interval, the associated frequency is zero. For + # example, the following records: `min_probability: 0, max_probability: 0.1, + # frequency: 17` `min_probability: 0.2, max_probability: 0.3, frequency: 42` ` + # min_probability: 0.3, max_probability: 0.4, frequency: 99` mean that there are + # no record with an estimated probability in [0.1, 0.2) nor larger or equal to 0. + # 4. # Corresponds to the JSON property `deltaPresenceEstimationHistogram` # @return [Array] attr_accessor :delta_presence_estimation_histogram @@ -2083,15 +1990,15 @@ module Google end end - # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a - # `CustomInfoType` to alter behavior under certain circumstances, depending - # on the specific details of the rule. Not supported for the `surrogate_type` + # Deprecated; use `InspectionRuleSet` instead. Rule for modifying a ` + # CustomInfoType` to alter behavior under certain circumstances, depending on + # the specific details of the rule. Not supported for the `surrogate_type` # custom infoType. class GooglePrivacyDlpV2DetectionRule include Google::Apis::Core::Hashable - # The rule that adjusts the likelihood of findings within a certain - # proximity of hotwords. + # The rule that adjusts the likelihood of findings within a certain proximity of + # hotwords. # Corresponds to the JSON property `hotwordRule` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2HotwordRule] attr_accessor :hotword_rule @@ -2106,28 +2013,24 @@ module Google end end - # Custom information type based on a dictionary of words or phrases. This can - # be used to match sensitive information specific to the data, such as a list - # of employee IDs or job titles. - # Dictionary words are case-insensitive and all characters other than letters - # and digits in the unicode [Basic Multilingual + # Custom information type based on a dictionary of words or phrases. This can be + # used to match sensitive information specific to the data, such as a list of + # employee IDs or job titles. Dictionary words are case-insensitive and all + # characters other than letters and digits in the unicode [Basic Multilingual # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29# - # Basic_Multilingual_Plane) - # will be replaced with whitespace when scanning for matches, so the - # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", - # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters - # surrounding any match must be of a different type than the adjacent - # characters within the word, so letters must be next to non-letters and - # digits next to non-digits. For example, the dictionary word "jen" will - # match the first three letters of the text "jen123" but will return no - # matches for "jennifer". - # Dictionary words containing a large number of characters that are not - # letters or digits may result in unexpected findings because such characters - # are treated as whitespace. The - # [limits](https://cloud.google.com/dlp/limits) page contains details about - # the size limits of dictionaries. For dictionaries that do not fit within - # these constraints, consider using `LargeCustomDictionaryConfig` in the - # `StoredInfoType` API. + # Basic_Multilingual_Plane) will be replaced with whitespace when scanning for + # matches, so the dictionary phrase "Sam Johnson" will match all three phrases " + # sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the + # characters surrounding any match must be of a different type than the adjacent + # characters within the word, so letters must be next to non-letters and digits + # next to non-digits. For example, the dictionary word "jen" will match the + # first three letters of the text "jen123" but will return no matches for " + # jennifer". Dictionary words containing a large number of characters that are + # not letters or digits may result in unexpected findings because such + # characters are treated as whitespace. The [limits](https://cloud.google.com/ + # dlp/limits) page contains details about the size limits of dictionaries. For + # dictionaries that do not fit within these constraints, consider using ` + # LargeCustomDictionaryConfig` in the `StoredInfoType` API. class GooglePrivacyDlpV2Dictionary include Google::Apis::Core::Hashable @@ -2230,8 +2133,8 @@ module Google class GooglePrivacyDlpV2DocumentLocation include Google::Apis::Core::Hashable - # Offset of the line, from the beginning of the file, where the finding - # is located. + # Offset of the line, from the beginning of the file, where the finding is + # located. # Corresponds to the JSON property `fileOffset` # @return [Fixnum] attr_accessor :file_offset @@ -2246,11 +2149,11 @@ module Google end end - # An entity in a dataset is a field or set of fields that correspond to a - # single person. For example, in medical records the `EntityId` might be a - # patient identifier, or for financial records it might be an account - # identifier. This message is used when generalizations or analysis must take - # into account that multiple rows correspond to the same entity. + # An entity in a dataset is a field or set of fields that correspond to a single + # person. For example, in medical records the `EntityId` might be a patient + # identifier, or for financial records it might be an account identifier. This + # message is used when generalizations or analysis must take into account that + # multiple rows correspond to the same entity. class GooglePrivacyDlpV2EntityId include Google::Apis::Core::Hashable @@ -2269,17 +2172,17 @@ module Google end end - # Details information about an error encountered during job execution or - # the results of an unsuccessful activation of the JobTrigger. + # Details information about an error encountered during job execution or the + # results of an unsuccessful activation of the JobTrigger. class GooglePrivacyDlpV2Error include Google::Apis::Core::Hashable - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `details` # @return [Google::Apis::DlpV2::GoogleRpcStatus] attr_accessor :details @@ -2305,12 +2208,11 @@ module Google include Google::Apis::Core::Hashable # InfoType list in ExclusionRule rule drops a finding when it overlaps or - # contained within with a finding of an infoType from this list. For - # example, for `InspectionRuleSet.info_types` containing "PHONE_NUMBER"` and - # `exclusion_rule` containing `exclude_info_types.info_types` with - # "EMAIL_ADDRESS" the phone number findings are dropped if they overlap - # with EMAIL_ADDRESS finding. - # That leads to "555-222-2222@example.org" to generate only a single + # contained within with a finding of an infoType from this list. For example, + # for `InspectionRuleSet.info_types` containing "PHONE_NUMBER"` and ` + # exclusion_rule` containing `exclude_info_types.info_types` with "EMAIL_ADDRESS" + # the phone number findings are dropped if they overlap with EMAIL_ADDRESS + # finding. That leads to "555-222-2222@example.org" to generate only a single # finding, namely email address. # Corresponds to the JSON property `infoTypes` # @return [Array] @@ -2326,33 +2228,29 @@ module Google end end - # The rule that specifies conditions when findings of infoTypes specified in - # `InspectionRuleSet` are removed from results. + # The rule that specifies conditions when findings of infoTypes specified in ` + # InspectionRuleSet` are removed from results. class GooglePrivacyDlpV2ExclusionRule include Google::Apis::Core::Hashable - # Custom information type based on a dictionary of words or phrases. This can - # be used to match sensitive information specific to the data, such as a list - # of employee IDs or job titles. - # Dictionary words are case-insensitive and all characters other than letters - # and digits in the unicode [Basic Multilingual + # Custom information type based on a dictionary of words or phrases. This can be + # used to match sensitive information specific to the data, such as a list of + # employee IDs or job titles. Dictionary words are case-insensitive and all + # characters other than letters and digits in the unicode [Basic Multilingual # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29# - # Basic_Multilingual_Plane) - # will be replaced with whitespace when scanning for matches, so the - # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", - # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters - # surrounding any match must be of a different type than the adjacent - # characters within the word, so letters must be next to non-letters and - # digits next to non-digits. For example, the dictionary word "jen" will - # match the first three letters of the text "jen123" but will return no - # matches for "jennifer". - # Dictionary words containing a large number of characters that are not - # letters or digits may result in unexpected findings because such characters - # are treated as whitespace. The - # [limits](https://cloud.google.com/dlp/limits) page contains details about - # the size limits of dictionaries. For dictionaries that do not fit within - # these constraints, consider using `LargeCustomDictionaryConfig` in the - # `StoredInfoType` API. + # Basic_Multilingual_Plane) will be replaced with whitespace when scanning for + # matches, so the dictionary phrase "Sam Johnson" will match all three phrases " + # sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the + # characters surrounding any match must be of a different type than the adjacent + # characters within the word, so letters must be next to non-letters and digits + # next to non-digits. For example, the dictionary word "jen" will match the + # first three letters of the text "jen123" but will return no matches for " + # jennifer". Dictionary words containing a large number of characters that are + # not letters or digits may result in unexpected findings because such + # characters are treated as whitespace. The [limits](https://cloud.google.com/ + # dlp/limits) page contains details about the size limits of dictionaries. For + # dictionaries that do not fit within these constraints, consider using ` + # LargeCustomDictionaryConfig` in the `StoredInfoType` API. # Corresponds to the JSON property `dictionary` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Dictionary] attr_accessor :dictionary @@ -2394,8 +2292,8 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Conditions] attr_accessor :conditions - # The operator to apply to the result of conditions. Default and currently - # only supported value is `AND`. + # The operator to apply to the result of conditions. Default and currently only + # supported value is `AND`. # Corresponds to the JSON property `logicalOperator` # @return [String] attr_accessor :logical_operator @@ -2434,8 +2332,8 @@ module Google class GooglePrivacyDlpV2FieldTransformation include Google::Apis::Core::Hashable - # A condition for determining whether a transformation should be applied to - # a field. + # A condition for determining whether a transformation should be applied to a + # field. # Corresponds to the JSON property `condition` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2RecordCondition] attr_accessor :condition @@ -2445,10 +2343,9 @@ module Google # @return [Array] attr_accessor :fields - # A type of transformation that will scan unstructured text and - # apply various `PrimitiveTransformation`s to each finding, where the - # transformation is applied to only values that were identified as a specific - # info_type. + # A type of transformation that will scan unstructured text and apply various ` + # PrimitiveTransformation`s to each finding, where the transformation is applied + # to only values that were identified as a specific info_type. # Corresponds to the JSON property `infoTypeTransformations` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InfoTypeTransformations] attr_accessor :info_type_transformations @@ -2477,42 +2374,34 @@ module Google # Message representing a set of files in a Cloud Storage bucket. Regular # expressions are used to allow fine-grained control over which files in the - # bucket to include. - # Included files are those that match at least one item in `include_regex` and - # do not match any items in `exclude_regex`. Note that a file that matches - # items from both lists will _not_ be included. For a match to occur, the - # entire file path (i.e., everything in the url after the bucket name) must - # match the regular expression. - # For example, given the input ``bucket_name: "mybucket", include_regex: - # ["directory1/.*"], exclude_regex: - # ["directory1/excluded.*"]``: - # * `gs://mybucket/directory1/myfile` will be included - # * `gs://mybucket/directory1/directory2/myfile` will be included (`.*` matches - # across `/`) - # * `gs://mybucket/directory0/directory1/myfile` will _not_ be included (the - # full path doesn't match any items in `include_regex`) - # * `gs://mybucket/directory1/excludedfile` will _not_ be included (the path - # matches an item in `exclude_regex`) - # If `include_regex` is left empty, it will match all files by default - # (this is equivalent to setting `include_regex: [".*"]`). - # Some other common use cases: - # * ``bucket_name: "mybucket", exclude_regex: [".*\.pdf"]`` will include all - # files in `mybucket` except for .pdf files - # * ``bucket_name: "mybucket", include_regex: ["directory/[^/]+"]`` will - # include all files directly under `gs://mybucket/directory/`, without matching - # across `/` + # bucket to include. Included files are those that match at least one item in ` + # include_regex` and do not match any items in `exclude_regex`. Note that a file + # that matches items from both lists will _not_ be included. For a match to + # occur, the entire file path (i.e., everything in the url after the bucket name) + # must match the regular expression. For example, given the input ``bucket_name: + # "mybucket", include_regex: ["directory1/.*"], exclude_regex: ["directory1/ + # excluded.*"]``: * `gs://mybucket/directory1/myfile` will be included * `gs:// + # mybucket/directory1/directory2/myfile` will be included (`.*` matches across `/ + # `) * `gs://mybucket/directory0/directory1/myfile` will _not_ be included (the + # full path doesn't match any items in `include_regex`) * `gs://mybucket/ + # directory1/excludedfile` will _not_ be included (the path matches an item in ` + # exclude_regex`) If `include_regex` is left empty, it will match all files by + # default (this is equivalent to setting `include_regex: [".*"]`). Some other + # common use cases: * ``bucket_name: "mybucket", exclude_regex: [".*\.pdf"]`` + # will include all files in `mybucket` except for .pdf files * ``bucket_name: " + # mybucket", include_regex: ["directory/[^/]+"]`` will include all files + # directly under `gs://mybucket/directory/`, without matching across `/` # Corresponds to the JSON property `regexFileSet` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CloudStorageRegexFileSet] attr_accessor :regex_file_set - # The Cloud Storage url of the file(s) to scan, in the format - # `gs:///`. Trailing wildcard in the path is allowed. - # If the url ends in a trailing slash, the bucket or directory represented - # by the url will be scanned non-recursively (content in sub-directories - # will not be scanned). This means that `gs://mybucket/` is equivalent to - # `gs://mybucket/*`, and `gs://mybucket/directory/` is equivalent to - # `gs://mybucket/directory/*`. - # Exactly one of `url` or `regex_file_set` must be set. + # The Cloud Storage url of the file(s) to scan, in the format `gs:///`. Trailing + # wildcard in the path is allowed. If the url ends in a trailing slash, the + # bucket or directory represented by the url will be scanned non-recursively ( + # content in sub-directories will not be scanned). This means that `gs:// + # mybucket/` is equivalent to `gs://mybucket/*`, and `gs://mybucket/directory/` + # is equivalent to `gs://mybucket/directory/*`. Exactly one of `url` or ` + # regex_file_set` must be set. # Corresponds to the JSON property `url` # @return [String] attr_accessor :url @@ -2552,15 +2441,12 @@ module Google # @return [String] attr_accessor :job_name - # The labels associated with this `Finding`. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. - # Label values must be between 0 and 63 characters long and must conform - # to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. - # No more than 10 labels can be associated with a given finding. - # Examples: - # * `"environment" : "production"` - # * `"pipeline" : "etl"` + # The labels associated with this `Finding`. Label keys must be between 1 and 63 + # characters long and must conform to the following regular expression: `[a-z]([- + # a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 characters long and + # must conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. No + # more than 10 labels can be associated with a given finding. Examples: * `" + # environment" : "production"` * `"pipeline" : "etl"` # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels @@ -2575,18 +2461,16 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Location] attr_accessor :location - # Resource name in format - # projects/`project`/locations/`location`/findings/`finding` Populated only - # when viewing persisted findings. + # Resource name in format projects/`project`/locations/`location`/findings/` + # finding` Populated only when viewing persisted findings. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The content that was found. Even if the content is not textual, it - # may be converted to a textual representation here. - # Provided if `include_quote` is true and the finding is - # less than or equal to 4096 bytes long. If the finding exceeds 4096 bytes - # in length, the quote may be omitted. + # The content that was found. Even if the content is not textual, it may be + # converted to a textual representation here. Provided if `include_quote` is + # true and the finding is less than or equal to 4096 bytes long. If the finding + # exceeds 4096 bytes in length, the quote may be omitted. # Corresponds to the JSON property `quote` # @return [String] attr_accessor :quote @@ -2636,17 +2520,16 @@ module Google # @return [Array] attr_accessor :max_findings_per_info_type - # Max number of findings that will be returned for each item scanned. - # When set within `InspectJobConfig`, - # the maximum returned is 2000 regardless if this is set higher. - # When set within `InspectContentRequest`, this field is ignored. + # Max number of findings that will be returned for each item scanned. When set + # within `InspectJobConfig`, the maximum returned is 2000 regardless if this is + # set higher. When set within `InspectContentRequest`, this field is ignored. # Corresponds to the JSON property `maxFindingsPerItem` # @return [Fixnum] attr_accessor :max_findings_per_item - # Max number of findings that will be returned per request/job. - # When set within `InspectContentRequest`, the maximum returned is 2000 - # regardless if this is set higher. + # Max number of findings that will be returned per request/job. When set within ` + # InspectContentRequest`, the maximum returned is 2000 regardless if this is set + # higher. # Corresponds to the JSON property `maxFindingsPerRequest` # @return [Fixnum] attr_accessor :max_findings_per_request @@ -2676,45 +2559,41 @@ module Google end end - # Buckets values based on fixed size ranges. The - # Bucketing transformation can provide all of this functionality, - # but requires more configuration. This message is provided as a convenience to - # the user for simple bucketing strategies. - # The transformed value will be a hyphenated string of - # `lower_bound`-`upper_bound`, i.e if lower_bound = 10 and upper_bound = 20 - # all values that are within this bucket will be replaced with "10-20". - # This can be used on data of type: double, long. - # If the bound Value type differs from the type of data - # being transformed, we will first attempt converting the type of the data to - # be transformed to match the type of the bound before comparing. - # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more. + # Buckets values based on fixed size ranges. The Bucketing transformation can + # provide all of this functionality, but requires more configuration. This + # message is provided as a convenience to the user for simple bucketing + # strategies. The transformed value will be a hyphenated string of `lower_bound`- + # `upper_bound`, i.e if lower_bound = 10 and upper_bound = 20 all values that + # are within this bucket will be replaced with "10-20". This can be used on data + # of type: double, long. If the bound Value type differs from the type of data + # being transformed, we will first attempt converting the type of the data to be + # transformed to match the type of the bound before comparing. See https://cloud. + # google.com/dlp/docs/concepts-bucketing to learn more. class GooglePrivacyDlpV2FixedSizeBucketingConfig include Google::Apis::Core::Hashable - # Required. Size of each bucket (except for minimum and maximum buckets). So if - # `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the - # following buckets would be used: -10, 10-20, 20-30, 30-40, 40-50, 50-60, - # 60-70, 70-80, 80-89, 89+. Precision up to 2 decimals works. + # Required. Size of each bucket (except for minimum and maximum buckets). So if ` + # lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the + # following buckets would be used: -10, 10-20, 20-30, 30-40, 40-50, 50-60, 60-70, + # 70-80, 80-89, 89+. Precision up to 2 decimals works. # Corresponds to the JSON property `bucketSize` # @return [Float] attr_accessor :bucket_size - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `lowerBound` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :lower_bound - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `upperBound` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :upper_bound @@ -2731,8 +2610,8 @@ module Google end end - # The rule that adjusts the likelihood of findings within a certain - # proximity of hotwords. + # The rule that adjusts the likelihood of findings within a certain proximity of + # hotwords. class GooglePrivacyDlpV2HotwordRule include Google::Apis::Core::Hashable @@ -2741,14 +2620,13 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Regex] attr_accessor :hotword_regex - # Message for specifying an adjustment to the likelihood of a finding as - # part of a detection rule. + # Message for specifying an adjustment to the likelihood of a finding as part of + # a detection rule. # Corresponds to the JSON property `likelihoodAdjustment` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2LikelihoodAdjustment] attr_accessor :likelihood_adjustment - # Message for specifying a window around a finding to apply a detection - # rule. + # Message for specifying a window around a finding to apply a detection rule. # Corresponds to the JSON property `proximity` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Proximity] attr_accessor :proximity @@ -2795,39 +2673,34 @@ module Google class GooglePrivacyDlpV2HybridFindingDetails include Google::Apis::Core::Hashable - # Represents a container that may contain DLP findings. - # Examples of a container include a file, table, or database record. + # Represents a container that may contain DLP findings. Examples of a container + # include a file, table, or database record. # Corresponds to the JSON property `containerDetails` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Container] attr_accessor :container_details - # Offset in bytes of the line, from the beginning of the file, where the - # finding is located. Populate if the item being scanned is only part of a - # bigger item, such as a shard of a file and you want to track the absolute - # position of the finding. + # Offset in bytes of the line, from the beginning of the file, where the finding + # is located. Populate if the item being scanned is only part of a bigger item, + # such as a shard of a file and you want to track the absolute position of the + # finding. # Corresponds to the JSON property `fileOffset` # @return [Fixnum] attr_accessor :file_offset - # Labels to represent user provided metadata about the data being inspected. - # If configured by the job, some key values may be required. - # The labels associated with `Finding`'s produced by hybrid - # inspection. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. - # Label values must be between 0 and 63 characters long and must conform - # to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. - # No more than 10 labels can be associated with a given finding. - # Examples: - # * `"environment" : "production"` - # * `"pipeline" : "etl"` + # Labels to represent user provided metadata about the data being inspected. If + # configured by the job, some key values may be required. The labels associated + # with `Finding`'s produced by hybrid inspection. Label keys must be between 1 + # and 63 characters long and must conform to the following regular expression: `[ + # a-z]([-a-z0-9]*[a-z0-9])?`. Label values must be between 0 and 63 characters + # long and must conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?` + # . No more than 10 labels can be associated with a given finding. Examples: * `" + # environment" : "production"` * `"pipeline" : "etl"` # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # Offset of the row for tables. Populate if the row(s) being scanned are - # part of a bigger dataset and you want to keep track of their absolute - # position. + # Offset of the row for tables. Populate if the row(s) being scanned are part of + # a bigger dataset and you want to keep track of their absolute position. # Corresponds to the JSON property `rowOffset` # @return [Fixnum] attr_accessor :row_offset @@ -2908,17 +2781,16 @@ module Google class GooglePrivacyDlpV2HybridInspectStatistics include Google::Apis::Core::Hashable - # The number of hybrid inspection requests aborted because the job ran - # out of quota or was ended before they could be processed. + # The number of hybrid inspection requests aborted because the job ran out of + # quota or was ended before they could be processed. # Corresponds to the JSON property `abortedCount` # @return [Fixnum] attr_accessor :aborted_count - # The number of hybrid requests currently being processed. Only populated - # when called via method `getDlpJob`. - # A burst of traffic may cause hybrid inspect requests to be enqueued. - # Processing will take place as quickly as possible, but resource limitations - # may impact how long a request is enqueued for. + # The number of hybrid requests currently being processed. Only populated when + # called via method `getDlpJob`. A burst of traffic may cause hybrid inspect + # requests to be enqueued. Processing will take place as quickly as possible, + # but resource limitations may impact how long a request is enqueued for. # Corresponds to the JSON property `pendingCount` # @return [Fixnum] attr_accessor :pending_count @@ -2940,36 +2812,32 @@ module Google end end - # Configuration to control jobs where the content being inspected is outside - # of Google Cloud Platform. + # Configuration to control jobs where the content being inspected is outside of + # Google Cloud Platform. class GooglePrivacyDlpV2HybridOptions include Google::Apis::Core::Hashable - # A short description of where the data is coming from. Will be stored once - # in the job. 256 max length. + # A short description of where the data is coming from. Will be stored once in + # the job. 256 max length. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # To organize findings, these labels will be added to each finding. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. - # Label values must be between 0 and 63 characters long and must conform - # to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. - # No more than 10 labels can be associated with a given finding. - # Examples: - # * `"environment" : "production"` - # * `"pipeline" : "etl"` + # To organize findings, these labels will be added to each finding. Label keys + # must be between 1 and 63 characters long and must conform to the following + # regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. Label values must be between + # 0 and 63 characters long and must conform to the regular expression `([a-z]([- + # a-z0-9]*[a-z0-9])?)?`. No more than 10 labels can be associated with a given + # finding. Examples: * `"environment" : "production"` * `"pipeline" : "etl"` # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # These are labels that each inspection request must include within their - # 'finding_labels' map. Request may contain others, but any missing one of - # these will be rejected. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. - # No more than 10 keys can be required. + # These are labels that each inspection request must include within their ' + # finding_labels' map. Request may contain others, but any missing one of these + # will be rejected. Label keys must be between 1 and 63 characters long and must + # conform to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`. No + # more than 10 keys can be required. # Corresponds to the JSON property `requiredFindingLabelKeys` # @return [Array] attr_accessor :required_finding_label_keys @@ -3048,11 +2916,11 @@ module Google class GooglePrivacyDlpV2InfoType include Google::Apis::Core::Hashable - # Name of the information type. Either a name of your choosing when - # creating a CustomInfoType, or one of the names listed - # at https://cloud.google.com/dlp/docs/infotypes-reference when specifying - # a built-in type. When sending Cloud DLP results to Data Catalog, infoType - # names should conform to the pattern `[A-Za-z0-9$-_]`1,64``. + # Name of the information type. Either a name of your choosing when creating a + # CustomInfoType, or one of the names listed at https://cloud.google.com/dlp/ + # docs/infotypes-reference when specifying a built-in type. When sending Cloud + # DLP results to Data Catalog, infoType names should conform to the pattern `[A- + # Za-z0-9$-_]`1,64``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -3105,8 +2973,8 @@ module Google end end - # Max findings configuration per infoType, per content item or long - # running DlpJob. + # Max findings configuration per infoType, per content item or long running + # DlpJob. class GooglePrivacyDlpV2InfoTypeLimit include Google::Apis::Core::Hashable @@ -3156,14 +3024,13 @@ module Google end end - # A transformation to apply to text that is identified as a specific - # info_type. + # A transformation to apply to text that is identified as a specific info_type. class GooglePrivacyDlpV2InfoTypeTransformation include Google::Apis::Core::Hashable - # InfoTypes to apply the transformation to. An empty list will cause - # this transformation to apply to all findings that correspond to - # infoTypes that were requested in `InspectConfig`. + # InfoTypes to apply the transformation to. An empty list will cause this + # transformation to apply to all findings that correspond to infoTypes that were + # requested in `InspectConfig`. # Corresponds to the JSON property `infoTypes` # @return [Array] attr_accessor :info_types @@ -3184,15 +3051,14 @@ module Google end end - # A type of transformation that will scan unstructured text and - # apply various `PrimitiveTransformation`s to each finding, where the - # transformation is applied to only values that were identified as a specific - # info_type. + # A type of transformation that will scan unstructured text and apply various ` + # PrimitiveTransformation`s to each finding, where the transformation is applied + # to only values that were identified as a specific info_type. class GooglePrivacyDlpV2InfoTypeTransformations include Google::Apis::Core::Hashable - # Required. Transformation for each infoType. Cannot specify more than one - # for a given infoType. + # Required. Transformation for each infoType. Cannot specify more than one for a + # given infoType. # Corresponds to the JSON property `transformations` # @return [Array] attr_accessor :transformations @@ -3207,20 +3073,19 @@ module Google end end - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. class GooglePrivacyDlpV2InspectConfig include Google::Apis::Core::Hashable - # List of options defining data content to scan. - # If empty, text, images, and other content will be included. + # List of options defining data content to scan. If empty, text, images, and + # other content will be included. # Corresponds to the JSON property `contentOptions` # @return [Array] attr_accessor :content_options - # CustomInfoTypes provided by the user. See - # https://cloud.google.com/dlp/docs/creating-custom-infotypes to learn more. + # CustomInfoTypes provided by the user. See https://cloud.google.com/dlp/docs/ + # creating-custom-infotypes to learn more. # Corresponds to the JSON property `customInfoTypes` # @return [Array] attr_accessor :custom_info_types @@ -3238,14 +3103,13 @@ module Google attr_accessor :include_quote alias_method :include_quote?, :include_quote - # Restricts what info_types to look for. The values must correspond to - # InfoType values returned by ListInfoTypes or listed at - # https://cloud.google.com/dlp/docs/infotypes-reference. - # When no InfoTypes or CustomInfoTypes are specified in a request, the - # system may automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. - # If you need precise control and predictability as to what detectors are - # run you should specify specific InfoTypes listed in the reference, + # Restricts what info_types to look for. The values must correspond to InfoType + # values returned by ListInfoTypes or listed at https://cloud.google.com/dlp/ + # docs/infotypes-reference. When no InfoTypes or CustomInfoTypes are specified + # in a request, the system may automatically choose what detectors to run. By + # default this may be all types, but may change over time as detectors are + # updated. If you need precise control and predictability as to what detectors + # are run you should specify specific InfoTypes listed in the reference, # otherwise a default list will be used, which may change over time. # Corresponds to the JSON property `infoTypes` # @return [Array] @@ -3256,16 +3120,15 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FindingLimits] attr_accessor :limits - # Only returns findings equal or above this threshold. The default is - # POSSIBLE. + # Only returns findings equal or above this threshold. The default is POSSIBLE. # See https://cloud.google.com/dlp/docs/likelihood to learn more. # Corresponds to the JSON property `minLikelihood` # @return [String] attr_accessor :min_likelihood - # Set of rules to apply to the findings for this InspectConfig. - # Exclusion rules, contained in the set are executed in the end, other - # rules are executed in the order they are specified for each info type. + # Set of rules to apply to the findings for this InspectConfig. Exclusion rules, + # contained in the set are executed in the end, other rules are executed in the + # order they are specified for each info type. # Corresponds to the JSON property `ruleSet` # @return [Array] attr_accessor :rule_set @@ -3291,18 +3154,16 @@ module Google class GooglePrivacyDlpV2InspectContentRequest include Google::Apis::Core::Hashable - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config - # Template to use. Any configuration directly specified in - # inspect_config will override those set in the template. Singular fields - # that are set in this request will replace their corresponding fields in the - # template. Repeated fields are appended. Singular sub-messages and groups - # are recursively merged. + # Template to use. Any configuration directly specified in inspect_config will + # override those set in the template. Singular fields that are set in this + # request will replace their corresponding fields in the template. Repeated + # fields are appended. Singular sub-messages and groups are recursively merged. # Corresponds to the JSON property `inspectTemplateName` # @return [String] attr_accessor :inspect_template_name @@ -3383,15 +3244,14 @@ module Google # @return [Array] attr_accessor :actions - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config - # If provided, will be used as the default for all values in InspectConfig. - # `inspect_config` will be merged into the values persisted as part of the + # If provided, will be used as the default for all values in InspectConfig. ` + # inspect_config` will be merged into the values persisted as part of the # template. # Corresponds to the JSON property `inspectTemplateName` # @return [String] @@ -3424,12 +3284,11 @@ module Google # @return [Array] attr_accessor :findings - # If true, then this item might have more findings than were returned, - # and the findings returned are an arbitrary subset of all findings. - # The findings list might be truncated because the input items were too - # large, or because the server reached the maximum amount of resources - # allowed for a single API call. For best results, divide the input into - # smaller batches. + # If true, then this item might have more findings than were returned, and the + # findings returned are an arbitrary subset of all findings. The findings list + # might be truncated because the input items were too large, or because the + # server reached the maximum amount of resources allowed for a single API call. + # For best results, divide the input into smaller batches. # Corresponds to the JSON property `findingsTruncated` # @return [Boolean] attr_accessor :findings_truncated @@ -3448,8 +3307,8 @@ module Google # The inspectTemplate contains a configuration (set of types of sensitive data # to be detected) to be used anywhere you otherwise would normally specify - # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates - # to learn more. + # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to + # learn more. class GooglePrivacyDlpV2InspectTemplate include Google::Apis::Core::Hashable @@ -3468,17 +3327,15 @@ module Google # @return [String] attr_accessor :display_name - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config - # Output only. The template name. - # The template will have one of the following formats: - # `projects/PROJECT_ID/inspectTemplates/TEMPLATE_ID` OR - # `organizations/ORGANIZATION_ID/inspectTemplates/TEMPLATE_ID`; + # Output only. The template name. The template will have one of the following + # formats: `projects/PROJECT_ID/inspectTemplates/TEMPLATE_ID` OR `organizations/ + # ORGANIZATION_ID/inspectTemplates/TEMPLATE_ID`; # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -3503,19 +3360,19 @@ module Google end end - # A single inspection rule to be applied to infoTypes, specified in - # `InspectionRuleSet`. + # A single inspection rule to be applied to infoTypes, specified in ` + # InspectionRuleSet`. class GooglePrivacyDlpV2InspectionRule include Google::Apis::Core::Hashable - # The rule that specifies conditions when findings of infoTypes specified in - # `InspectionRuleSet` are removed from results. + # The rule that specifies conditions when findings of infoTypes specified in ` + # InspectionRuleSet` are removed from results. # Corresponds to the JSON property `exclusionRule` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2ExclusionRule] attr_accessor :exclusion_rule - # The rule that adjusts the likelihood of findings within a certain - # proximity of hotwords. + # The rule that adjusts the likelihood of findings within a certain proximity of + # hotwords. # Corresponds to the JSON property `hotwordRule` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2HotwordRule] attr_accessor :hotword_rule @@ -3557,8 +3414,8 @@ module Google end end - # Enable email notification to project owners and editors on jobs's - # completion/failure. + # Enable email notification to project owners and editors on jobs's completion/ + # failure. class GooglePrivacyDlpV2JobNotificationEmails include Google::Apis::Core::Hashable @@ -3571,8 +3428,8 @@ module Google end end - # Contains a configuration to make dlp api calls on a repeating basis. - # See https://cloud.google.com/dlp/docs/concepts-job-triggers to learn more. + # Contains a configuration to make dlp api calls on a repeating basis. See https: + # //cloud.google.com/dlp/docs/concepts-job-triggers to learn more. class GooglePrivacyDlpV2JobTrigger include Google::Apis::Core::Hashable @@ -3592,10 +3449,9 @@ module Google attr_accessor :display_name # Output only. A stream of errors encountered when the trigger was activated. - # Repeated - # errors may result in the JobTrigger automatically being paused. - # Will return the last 100 errors. Whenever the JobTrigger is modified - # this list will be cleared. + # Repeated errors may result in the JobTrigger automatically being paused. Will + # return the last 100 errors. Whenever the JobTrigger is modified this list will + # be cleared. # Corresponds to the JSON property `errors` # @return [Array] attr_accessor :errors @@ -3611,8 +3467,8 @@ module Google attr_accessor :last_run_time # Unique resource name for the triggeredJob, assigned by the service when the - # triggeredJob is created, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # triggeredJob is created, for example `projects/dlp-test-project/jobTriggers/ + # 53234423`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -3622,9 +3478,9 @@ module Google # @return [String] attr_accessor :status - # A list of triggers which will be OR'ed together. Only one in the list - # needs to trigger for a job to be started. The list may contain only - # a single Schedule trigger and must have at least one object. + # A list of triggers which will be OR'ed together. Only one in the list needs to + # trigger for a job to be started. The list may contain only a single Schedule + # trigger and must have at least one object. # Corresponds to the JSON property `triggers` # @return [Array] attr_accessor :triggers @@ -3657,20 +3513,19 @@ module Google class GooglePrivacyDlpV2KAnonymityConfig include Google::Apis::Core::Hashable - # An entity in a dataset is a field or set of fields that correspond to a - # single person. For example, in medical records the `EntityId` might be a - # patient identifier, or for financial records it might be an account - # identifier. This message is used when generalizations or analysis must take - # into account that multiple rows correspond to the same entity. + # An entity in a dataset is a field or set of fields that correspond to a single + # person. For example, in medical records the `EntityId` might be a patient + # identifier, or for financial records it might be an account identifier. This + # message is used when generalizations or analysis must take into account that + # multiple rows correspond to the same entity. # Corresponds to the JSON property `entityId` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2EntityId] attr_accessor :entity_id - # Set of fields to compute k-anonymity over. When multiple fields are - # specified, they are considered a single composite key. Structs and - # repeated data types are not supported; however, nested fields are - # supported so long as they are not structs themselves or nested within - # a repeated field. + # Set of fields to compute k-anonymity over. When multiple fields are specified, + # they are considered a single composite key. Structs and repeated data types + # are not supported; however, nested fields are supported so long as they are + # not structs themselves or nested within a repeated field. # Corresponds to the JSON property `quasiIds` # @return [Array] attr_accessor :quasi_ids @@ -3690,15 +3545,15 @@ module Google class GooglePrivacyDlpV2KAnonymityEquivalenceClass include Google::Apis::Core::Hashable - # Size of the equivalence class, for example number of rows with the - # above set of values. + # Size of the equivalence class, for example number of rows with the above set + # of values. # Corresponds to the JSON property `equivalenceClassSize` # @return [Fixnum] attr_accessor :equivalence_class_size - # Set of values defining the equivalence class. One value per - # quasi-identifier column in the original KAnonymity metric message. - # The order is always the same as the original request. + # Set of values defining the equivalence class. One value per quasi-identifier + # column in the original KAnonymity metric message. The order is always the same + # as the original request. # Corresponds to the JSON property `quasiIdsValues` # @return [Array] attr_accessor :quasi_ids_values @@ -3728,8 +3583,8 @@ module Google # @return [Fixnum] attr_accessor :bucket_value_count - # Sample of equivalence classes in this bucket. The total number of - # classes returned per bucket is capped at 20. + # Sample of equivalence classes in this bucket. The total number of classes + # returned per bucket is capped at 20. # Corresponds to the JSON property `bucketValues` # @return [Array] attr_accessor :bucket_values @@ -3777,32 +3632,31 @@ module Google end end - # Reidentifiability metric. This corresponds to a risk model similar to what - # is called "journalist risk" in the literature, except the attack dataset is - # statistically modeled instead of being perfectly known. This can be done - # using publicly available data (like the US Census), or using a custom - # statistical model (indicated as one or several BigQuery tables), or by - # extrapolating from the distribution of values in the input dataset. + # Reidentifiability metric. This corresponds to a risk model similar to what is + # called "journalist risk" in the literature, except the attack dataset is + # statistically modeled instead of being perfectly known. This can be done using + # publicly available data (like the US Census), or using a custom statistical + # model (indicated as one or several BigQuery tables), or by extrapolating from + # the distribution of values in the input dataset. class GooglePrivacyDlpV2KMapEstimationConfig include Google::Apis::Core::Hashable - # Several auxiliary tables can be used in the analysis. Each custom_tag - # used to tag a quasi-identifiers column must appear in exactly one column - # of one auxiliary table. + # Several auxiliary tables can be used in the analysis. Each custom_tag used to + # tag a quasi-identifiers column must appear in exactly one column of one + # auxiliary table. # Corresponds to the JSON property `auxiliaryTables` # @return [Array] attr_accessor :auxiliary_tables # Required. Fields considered to be quasi-identifiers. No two columns can have - # the - # same tag. + # the same tag. # Corresponds to the JSON property `quasiIds` # @return [Array] attr_accessor :quasi_ids - # ISO 3166-1 alpha-2 region code to use in the statistical modeling. - # Set if no column is tagged with a region-specific InfoType (like - # US_ZIP_5) or a region code. + # ISO 3166-1 alpha-2 region code to use in the statistical modeling. Set if no + # column is tagged with a region-specific InfoType (like US_ZIP_5) or a region + # code. # Corresponds to the JSON property `regionCode` # @return [String] attr_accessor :region_code @@ -3820,13 +3674,11 @@ module Google end # A KMapEstimationHistogramBucket message with the following values: - # min_anonymity: 3 - # max_anonymity: 5 - # frequency: 42 - # means that there are 42 records whose quasi-identifier values correspond - # to 3, 4 or 5 people in the overlying population. An important particular - # case is when min_anonymity = max_anonymity = 1: the frequency field then - # corresponds to the number of uniquely identifiable records. + # min_anonymity: 3 max_anonymity: 5 frequency: 42 means that there are 42 + # records whose quasi-identifier values correspond to 3, 4 or 5 people in the + # overlying population. An important particular case is when min_anonymity = + # max_anonymity = 1: the frequency field then corresponds to the number of + # uniquely identifiable records. class GooglePrivacyDlpV2KMapEstimationHistogramBucket include Google::Apis::Core::Hashable @@ -3840,8 +3692,8 @@ module Google # @return [Fixnum] attr_accessor :bucket_value_count - # Sample of quasi-identifier tuple values in this bucket. The total - # number of classes returned per bucket is capped at 20. + # Sample of quasi-identifier tuple values in this bucket. The total number of + # classes returned per bucket is capped at 20. # Corresponds to the JSON property `bucketValues` # @return [Array] attr_accessor :bucket_values @@ -3900,14 +3752,12 @@ module Google class GooglePrivacyDlpV2KMapEstimationResult include Google::Apis::Core::Hashable - # The intervals [min_anonymity, max_anonymity] do not overlap. If a value - # doesn't correspond to any such interval, the associated frequency is - # zero. For example, the following records: - # `min_anonymity: 1, max_anonymity: 1, frequency: 17` - # `min_anonymity: 2, max_anonymity: 3, frequency: 42` - # `min_anonymity: 5, max_anonymity: 10, frequency: 99` - # mean that there are no record with an estimated anonymity of 4, 5, or - # larger than 10. + # The intervals [min_anonymity, max_anonymity] do not overlap. If a value doesn' + # t correspond to any such interval, the associated frequency is zero. For + # example, the following records: `min_anonymity: 1, max_anonymity: 1, frequency: + # 17` `min_anonymity: 2, max_anonymity: 3, frequency: 42` `min_anonymity: 5, + # max_anonymity: 10, frequency: 99` mean that there are no record with an + # estimated anonymity of 4, 5, or larger than 10. # Corresponds to the JSON property `kMapEstimationHistogram` # @return [Array] attr_accessor :k_map_estimation_histogram @@ -3922,30 +3772,26 @@ module Google end end - # A unique identifier for a Datastore entity. - # If a key's partition ID or any of its path kinds or names are - # reserved/read-only, the key is reserved/read-only. + # A unique identifier for a Datastore entity. If a key's partition ID or any of + # its path kinds or names are reserved/read-only, the key is reserved/read-only. # A reserved/read-only key is forbidden in certain documented contexts. class GooglePrivacyDlpV2Key include Google::Apis::Core::Hashable - # Datastore partition ID. - # A partition ID identifies a grouping of entities. The grouping is always - # by project and namespace, however the namespace ID may be empty. - # A partition ID contains several dimensions: - # project ID and namespace ID. + # Datastore partition ID. A partition ID identifies a grouping of entities. The + # grouping is always by project and namespace, however the namespace ID may be + # empty. A partition ID contains several dimensions: project ID and namespace ID. # Corresponds to the JSON property `partitionId` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2PartitionId] attr_accessor :partition_id - # The entity path. - # An entity path consists of one or more elements composed of a kind and a - # string or numerical identifier, which identify entities. The first - # element identifies a _root entity_, the second element identifies - # a _child_ of the root entity, the third element identifies a child of the - # second entity, and so forth. The entities identified by all prefixes of - # the path are called the element's _ancestors_. - # A path can never be empty, and a path can have at most 100 elements. + # The entity path. An entity path consists of one or more elements composed of a + # kind and a string or numerical identifier, which identify entities. The first + # element identifies a _root entity_, the second element identifies a _child_ of + # the root entity, the third element identifies a child of the second entity, + # and so forth. The entities identified by all prefixes of the path are called + # the element's _ancestors_. A path can never be empty, and a path can have at + # most 100 elements. # Corresponds to the JSON property `path` # @return [Array] attr_accessor :path @@ -3980,11 +3826,10 @@ module Google end end - # Include to use an existing data crypto key wrapped by KMS. - # The wrapped key must be a 128/192/256 bit key. - # Authorization requires the following IAM permissions when sending a request - # to perform a crypto transformation using a kms-wrapped crypto key: - # dlp.kms.encrypt + # Include to use an existing data crypto key wrapped by KMS. The wrapped key + # must be a 128/192/256 bit key. Authorization requires the following IAM + # permissions when sending a request to perform a crypto transformation using a + # kms-wrapped crypto key: dlp.kms.encrypt class GooglePrivacyDlpV2KmsWrappedCryptoKey include Google::Apis::Core::Hashable @@ -4014,9 +3859,9 @@ module Google class GooglePrivacyDlpV2LDiversityConfig include Google::Apis::Core::Hashable - # Set of quasi-identifiers indicating how equivalence classes are - # defined for the l-diversity computation. When multiple fields are - # specified, they are considered a single composite key. + # Set of quasi-identifiers indicating how equivalence classes are defined for + # the l-diversity computation. When multiple fields are specified, they are + # considered a single composite key. # Corresponds to the JSON property `quasiIds` # @return [Array] attr_accessor :quasi_ids @@ -4051,8 +3896,8 @@ module Google # @return [Fixnum] attr_accessor :num_distinct_sensitive_values - # Quasi-identifier values defining the k-anonymity equivalence - # class. The order is always the same as the original request. + # Quasi-identifier values defining the k-anonymity equivalence class. The order + # is always the same as the original request. # Corresponds to the JSON property `quasiIdsValues` # @return [Array] attr_accessor :quasi_ids_values @@ -4089,20 +3934,20 @@ module Google # @return [Fixnum] attr_accessor :bucket_value_count - # Sample of equivalence classes in this bucket. The total number of - # classes returned per bucket is capped at 20. + # Sample of equivalence classes in this bucket. The total number of classes + # returned per bucket is capped at 20. # Corresponds to the JSON property `bucketValues` # @return [Array] attr_accessor :bucket_values - # Lower bound on the sensitive value frequencies of the equivalence - # classes in this bucket. + # Lower bound on the sensitive value frequencies of the equivalence classes in + # this bucket. # Corresponds to the JSON property `sensitiveValueFrequencyLowerBound` # @return [Fixnum] attr_accessor :sensitive_value_frequency_lower_bound - # Upper bound on the sensitive value frequencies of the equivalence - # classes in this bucket. + # Upper bound on the sensitive value frequencies of the equivalence classes in + # this bucket. # Corresponds to the JSON property `sensitiveValueFrequencyUpperBound` # @return [Fixnum] attr_accessor :sensitive_value_frequency_upper_bound @@ -4141,11 +3986,10 @@ module Google end # Configuration for a custom dictionary created from a data source of any size - # up to the maximum size defined in the - # [limits](https://cloud.google.com/dlp/limits) page. The artifacts of - # dictionary creation are stored in the specified Google Cloud Storage - # location. Consider using `CustomInfoType.Dictionary` for smaller dictionaries - # that satisfy the size requirements. + # up to the maximum size defined in the [limits](https://cloud.google.com/dlp/ + # limits) page. The artifacts of dictionary creation are stored in the specified + # Google Cloud Storage location. Consider using `CustomInfoType.Dictionary` for + # smaller dictionaries that satisfy the size requirements. class GooglePrivacyDlpV2LargeCustomDictionaryConfig include Google::Apis::Core::Hashable @@ -4196,9 +4040,8 @@ module Google end # Skips the data without modifying it if the requested transformation would - # cause an error. For example, if a `DateShift` transformation were applied - # an an IP address, this mode would leave the IP address unchanged in the - # response. + # cause an error. For example, if a `DateShift` transformation were applied an + # an IP address, this mode would leave the IP address unchanged in the response. class GooglePrivacyDlpV2LeaveUntransformed include Google::Apis::Core::Hashable @@ -4211,8 +4054,8 @@ module Google end end - # Message for specifying an adjustment to the likelihood of a finding as - # part of a detection rule. + # Message for specifying an adjustment to the likelihood of a finding as part of + # a detection rule. class GooglePrivacyDlpV2LikelihoodAdjustment include Google::Apis::Core::Hashable @@ -4221,14 +4064,13 @@ module Google # @return [String] attr_accessor :fixed_likelihood - # Increase or decrease the likelihood by the specified number of - # levels. For example, if a finding would be `POSSIBLE` without the - # detection rule and `relative_likelihood` is 1, then it is upgraded to - # `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`. - # Likelihood may never drop below `VERY_UNLIKELY` or exceed - # `VERY_LIKELY`, so applying an adjustment of 1 followed by an - # adjustment of -1 when base likelihood is `VERY_LIKELY` will result in - # a final likelihood of `LIKELY`. + # Increase or decrease the likelihood by the specified number of levels. For + # example, if a finding would be `POSSIBLE` without the detection rule and ` + # relative_likelihood` is 1, then it is upgraded to `LIKELY`, while a value of - + # 1 would downgrade it to `UNLIKELY`. Likelihood may never drop below ` + # VERY_UNLIKELY` or exceed `VERY_LIKELY`, so applying an adjustment of 1 + # followed by an adjustment of -1 when base likelihood is `VERY_LIKELY` will + # result in a final likelihood of `LIKELY`. # Corresponds to the JSON property `relativeLikelihood` # @return [Fixnum] attr_accessor :relative_likelihood @@ -4254,8 +4096,8 @@ module Google # @return [Array] attr_accessor :deidentify_templates - # If the next page is available then the next page token to be used - # in following ListDeidentifyTemplates request. + # If the next page is available then the next page token to be used in following + # ListDeidentifyTemplates request. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -4324,8 +4166,8 @@ module Google # @return [Array] attr_accessor :inspect_templates - # If the next page is available then the next page token to be used - # in following ListInspectTemplates request. + # If the next page is available then the next page token to be used in following + # ListInspectTemplates request. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -4350,8 +4192,8 @@ module Google # @return [Array] attr_accessor :job_triggers - # If the next page is available then the next page token to be used - # in following ListJobTriggers request. + # If the next page is available then the next page token to be used in following + # ListJobTriggers request. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -4371,8 +4213,8 @@ module Google class GooglePrivacyDlpV2ListStoredInfoTypesResponse include Google::Apis::Core::Hashable - # If the next page is available then the next page token to be used - # in following ListStoredInfoTypes request. + # If the next page is available then the next page token to be used in following + # ListStoredInfoTypes request. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -4407,14 +4249,14 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Range] attr_accessor :codepoint_range - # Represents a container that may contain DLP findings. - # Examples of a container include a file, table, or database record. + # Represents a container that may contain DLP findings. Examples of a container + # include a file, table, or database record. # Corresponds to the JSON property `container` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Container] attr_accessor :container - # List of nested objects pointing to the precise location of the finding - # within the file or record. + # List of nested objects pointing to the precise location of the finding within + # the file or record. # Corresponds to the JSON property `contentLocations` # @return [Array] attr_accessor :content_locations @@ -4432,8 +4274,7 @@ module Google end end - # Job trigger option for hybrid jobs. Jobs must be manually created - # and finished. + # Job trigger option for hybrid jobs. Jobs must be manually created and finished. class GooglePrivacyDlpV2Manual include Google::Apis::Core::Hashable @@ -4471,8 +4312,8 @@ module Google end end - # Compute numerical stats over an individual column, including - # min, max, and quantiles. + # Compute numerical stats over an individual column, including min, max, and + # quantiles. class GooglePrivacyDlpV2NumericalStatsConfig include Google::Apis::Core::Hashable @@ -4495,28 +4336,26 @@ module Google class GooglePrivacyDlpV2NumericalStatsResult include Google::Apis::Core::Hashable - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `maxValue` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :max_value - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `minValue` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :min_value - # List of 99 values that partition the set of field values into 100 equal - # sized buckets. + # List of 99 values that partition the set of field values into 100 equal sized + # buckets. # Corresponds to the JSON property `quantileValues` # @return [Array] attr_accessor :quantile_values @@ -4537,24 +4376,21 @@ module Google class GooglePrivacyDlpV2OutputStorageConfig include Google::Apis::Core::Hashable - # Schema used for writing the findings for Inspect jobs. This field is only - # used for Inspect and must be unspecified for Risk jobs. Columns are derived - # from the `Finding` object. If appending to an existing table, any columns - # from the predefined schema that are missing will be added. No columns in - # the existing table will be deleted. - # If unspecified, then all available columns will be used for a new table or - # an (existing) table with no schema, and no changes will be made to an - # existing table that has a schema. - # Only for use with external storage. + # Schema used for writing the findings for Inspect jobs. This field is only used + # for Inspect and must be unspecified for Risk jobs. Columns are derived from + # the `Finding` object. If appending to an existing table, any columns from the + # predefined schema that are missing will be added. No columns in the existing + # table will be deleted. If unspecified, then all available columns will be used + # for a new table or an (existing) table with no schema, and no changes will be + # made to an existing table that has a schema. Only for use with external + # storage. # Corresponds to the JSON property `outputSchema` # @return [String] attr_accessor :output_schema # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `table` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table @@ -4570,11 +4406,9 @@ module Google end end - # Datastore partition ID. - # A partition ID identifies a grouping of entities. The grouping is always - # by project and namespace, however the namespace ID may be empty. - # A partition ID contains several dimensions: - # project ID and namespace ID. + # Datastore partition ID. A partition ID identifies a grouping of entities. The + # grouping is always by project and namespace, however the namespace ID may be + # empty. A partition ID contains several dimensions: project ID and namespace ID. class GooglePrivacyDlpV2PartitionId include Google::Apis::Core::Hashable @@ -4599,31 +4433,26 @@ module Google end end - # A (kind, ID/name) pair used to construct a key path. - # If either name or ID is set, the element is complete. - # If neither is set, the element is incomplete. + # A (kind, ID/name) pair used to construct a key path. If either name or ID is + # set, the element is complete. If neither is set, the element is incomplete. class GooglePrivacyDlpV2PathElement include Google::Apis::Core::Hashable - # The auto-allocated ID of the entity. - # Never equal to zero. Values less than zero are discouraged and may not - # be supported in the future. + # The auto-allocated ID of the entity. Never equal to zero. Values less than + # zero are discouraged and may not be supported in the future. # Corresponds to the JSON property `id` # @return [Fixnum] attr_accessor :id - # The kind of the entity. - # A kind matching regex `__.*__` is reserved/read-only. - # A kind must not contain more than 1500 bytes when UTF-8 encoded. - # Cannot be `""`. + # The kind of the entity. A kind matching regex `__.*__` is reserved/read-only. + # A kind must not contain more than 1500 bytes when UTF-8 encoded. Cannot be `""` + # . # Corresponds to the JSON property `kind` # @return [String] attr_accessor :kind - # The name of the entity. - # A name matching regex `__.*__` is reserved/read-only. - # A name must not be more than 1500 bytes when UTF-8 encoded. - # Cannot be `""`. + # The name of the entity. A name matching regex `__.*__` is reserved/read-only. + # A name must not be more than 1500 bytes when UTF-8 encoded. Cannot be `""`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -4646,80 +4475,73 @@ module Google # Generalization function that buckets values based on ranges. The ranges and # replacement values are dynamically provided by the user for custom behavior, - # such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH - # This can be used on - # data of type: number, long, string, timestamp. - # If the bound `Value` type differs from the type of data being transformed, we - # will first attempt converting the type of the data to be transformed to match - # the type of the bound before comparing. + # such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH This can be used on data of + # type: number, long, string, timestamp. If the bound `Value` type differs from + # the type of data being transformed, we will first attempt converting the type + # of the data to be transformed to match the type of the bound before comparing. # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more. # Corresponds to the JSON property `bucketingConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BucketingConfig] attr_accessor :bucketing_config - # Partially mask a string by replacing a given number of characters with a - # fixed character. Masking can start from the beginning or end of the string. - # This can be used on data of any type (numbers, longs, and so on) and when - # de-identifying structured data we'll attempt to preserve the original data's - # type. (This allows you to take a long like 123 and modify it to a string like - # **3. + # Partially mask a string by replacing a given number of characters with a fixed + # character. Masking can start from the beginning or end of the string. This can + # be used on data of any type (numbers, longs, and so on) and when de- + # identifying structured data we'll attempt to preserve the original data's type. + # (This allows you to take a long like 123 and modify it to a string like **3. # Corresponds to the JSON property `characterMaskConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CharacterMaskConfig] attr_accessor :character_mask_config # Pseudonymization method that generates deterministic encryption for the given - # input. Outputs a base64 encoded representation of the encrypted output. - # Uses AES-SIV based on the RFC https://tools.ietf.org/html/rfc5297. + # input. Outputs a base64 encoded representation of the encrypted output. Uses + # AES-SIV based on the RFC https://tools.ietf.org/html/rfc5297. # Corresponds to the JSON property `cryptoDeterministicConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoDeterministicConfig] attr_accessor :crypto_deterministic_config # Pseudonymization method that generates surrogates via cryptographic hashing. - # Uses SHA-256. - # The key size must be either 32 or 64 bytes. - # Outputs a base64 encoded representation of the hashed output - # (for example, L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=). - # Currently, only string and integer values can be hashed. - # See https://cloud.google.com/dlp/docs/pseudonymization to learn more. + # Uses SHA-256. The key size must be either 32 or 64 bytes. Outputs a base64 + # encoded representation of the hashed output (for example, + # L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=). Currently, only string and + # integer values can be hashed. See https://cloud.google.com/dlp/docs/ + # pseudonymization to learn more. # Corresponds to the JSON property `cryptoHashConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoHashConfig] attr_accessor :crypto_hash_config - # Replaces an identifier with a surrogate using Format Preserving Encryption - # (FPE) with the FFX mode of operation; however when used in the - # `ReidentifyContent` API method, it serves the opposite function by reversing + # Replaces an identifier with a surrogate using Format Preserving Encryption ( + # FPE) with the FFX mode of operation; however when used in the ` + # ReidentifyContent` API method, it serves the opposite function by reversing # the surrogate back into the original identifier. The identifier must be - # encoded as ASCII. For a given crypto key and context, the same identifier - # will be replaced with the same surrogate. Identifiers must be at least two + # encoded as ASCII. For a given crypto key and context, the same identifier will + # be replaced with the same surrogate. Identifiers must be at least two # characters long. In the case that the identifier is the empty string, it will # be skipped. See https://cloud.google.com/dlp/docs/pseudonymization to learn - # more. - # Note: We recommend using CryptoDeterministicConfig for all use cases which - # do not require preserving the input alphabet space and size, plus warrant - # referential integrity. + # more. Note: We recommend using CryptoDeterministicConfig for all use cases + # which do not require preserving the input alphabet space and size, plus + # warrant referential integrity. # Corresponds to the JSON property `cryptoReplaceFfxFpeConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CryptoReplaceFfxFpeConfig] attr_accessor :crypto_replace_ffx_fpe_config # Shifts dates by random number of days, with option to be consistent for the - # same context. See https://cloud.google.com/dlp/docs/concepts-date-shifting - # to learn more. + # same context. See https://cloud.google.com/dlp/docs/concepts-date-shifting to + # learn more. # Corresponds to the JSON property `dateShiftConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DateShiftConfig] attr_accessor :date_shift_config - # Buckets values based on fixed size ranges. The - # Bucketing transformation can provide all of this functionality, - # but requires more configuration. This message is provided as a convenience to - # the user for simple bucketing strategies. - # The transformed value will be a hyphenated string of - # `lower_bound`-`upper_bound`, i.e if lower_bound = 10 and upper_bound = 20 - # all values that are within this bucket will be replaced with "10-20". - # This can be used on data of type: double, long. - # If the bound Value type differs from the type of data - # being transformed, we will first attempt converting the type of the data to - # be transformed to match the type of the bound before comparing. - # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more. + # Buckets values based on fixed size ranges. The Bucketing transformation can + # provide all of this functionality, but requires more configuration. This + # message is provided as a convenience to the user for simple bucketing + # strategies. The transformed value will be a hyphenated string of `lower_bound`- + # `upper_bound`, i.e if lower_bound = 10 and upper_bound = 20 all values that + # are within this bucket will be replaced with "10-20". This can be used on data + # of type: double, long. If the bound Value type differs from the type of data + # being transformed, we will first attempt converting the type of the data to be + # transformed to match the type of the bound before comparing. See https://cloud. + # google.com/dlp/docs/concepts-bucketing to learn more. # Corresponds to the JSON property `fixedSizeBucketingConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FixedSizeBucketingConfig] attr_accessor :fixed_size_bucketing_config @@ -4771,16 +4593,16 @@ module Google class GooglePrivacyDlpV2PrivacyMetric include Google::Apis::Core::Hashable - # Compute numerical stats over an individual column, including - # number of distinct values and value count distribution. + # Compute numerical stats over an individual column, including number of + # distinct values and value count distribution. # Corresponds to the JSON property `categoricalStatsConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CategoricalStatsConfig] attr_accessor :categorical_stats_config - # δ-presence metric, used to estimate how likely it is for an attacker to - # figure out that one given individual appears in a de-identified dataset. - # Similarly to the k-map metric, we cannot compute δ-presence exactly without - # knowing the attack dataset, so we use a statistical model instead. + # δ-presence metric, used to estimate how likely it is for an attacker to figure + # out that one given individual appears in a de-identified dataset. Similarly to + # the k-map metric, we cannot compute δ-presence exactly without knowing the + # attack dataset, so we use a statistical model instead. # Corresponds to the JSON property `deltaPresenceEstimationConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeltaPresenceEstimationConfig] attr_accessor :delta_presence_estimation_config @@ -4790,12 +4612,12 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2KAnonymityConfig] attr_accessor :k_anonymity_config - # Reidentifiability metric. This corresponds to a risk model similar to what - # is called "journalist risk" in the literature, except the attack dataset is - # statistically modeled instead of being perfectly known. This can be done - # using publicly available data (like the US Census), or using a custom - # statistical model (indicated as one or several BigQuery tables), or by - # extrapolating from the distribution of values in the input dataset. + # Reidentifiability metric. This corresponds to a risk model similar to what is + # called "journalist risk" in the literature, except the attack dataset is + # statistically modeled instead of being perfectly known. This can be done using + # publicly available data (like the US Census), or using a custom statistical + # model (indicated as one or several BigQuery tables), or by extrapolating from + # the distribution of values in the input dataset. # Corresponds to the JSON property `kMapEstimationConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2KMapEstimationConfig] attr_accessor :k_map_estimation_config @@ -4805,8 +4627,8 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2LDiversityConfig] attr_accessor :l_diversity_config - # Compute numerical stats over an individual column, including - # min, max, and quantiles. + # Compute numerical stats over an individual column, including min, max, and + # quantiles. # Corresponds to the JSON property `numericalStatsConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2NumericalStatsConfig] attr_accessor :numerical_stats_config @@ -4826,8 +4648,7 @@ module Google end end - # Message for specifying a window around a finding to apply a detection - # rule. + # Message for specifying a window around a finding to apply a detection rule. class GooglePrivacyDlpV2Proximity include Google::Apis::Core::Hashable @@ -4853,15 +4674,14 @@ module Google end # Publish findings of a DlpJob to Cloud Data Catalog. Labels summarizing the - # results of the DlpJob will be applied to the entry for the resource scanned - # in Cloud Data Catalog. Any labels previously written by another DlpJob will - # be deleted. InfoType naming patterns are strictly enforced when using this + # results of the DlpJob will be applied to the entry for the resource scanned in + # Cloud Data Catalog. Any labels previously written by another DlpJob will be + # deleted. InfoType naming patterns are strictly enforced when using this # feature. Note that the findings will be persisted in Cloud Data Catalog - # storage and are governed by Data Catalog service-specific policy, see - # https://cloud.google.com/terms/service-terms - # Only a single instance of this action can be specified and only allowed if - # all resources being scanned are BigQuery tables. - # Compatible with: Inspect + # storage and are governed by Data Catalog service-specific policy, see https:// + # cloud.google.com/terms/service-terms Only a single instance of this action can + # be specified and only allowed if all resources being scanned are BigQuery + # tables. Compatible with: Inspect class GooglePrivacyDlpV2PublishFindingsToCloudDataCatalog include Google::Apis::Core::Hashable @@ -4874,16 +4694,13 @@ module Google end end - # Publish the result summary of a DlpJob to the Cloud Security - # Command Center (CSCC Alpha). - # This action is only available for projects which are parts of - # an organization and whitelisted for the alpha Cloud Security Command - # Center. - # The action will publish count of finding instances and their info types. - # The summary of findings will be persisted in CSCC and are governed by CSCC - # service-specific policy, see https://cloud.google.com/terms/service-terms - # Only a single instance of this action can be specified. - # Compatible with: Inspect + # Publish the result summary of a DlpJob to the Cloud Security Command Center ( + # CSCC Alpha). This action is only available for projects which are parts of an + # organization and whitelisted for the alpha Cloud Security Command Center. The + # action will publish count of finding instances and their info types. The + # summary of findings will be persisted in CSCC and are governed by CSCC service- + # specific policy, see https://cloud.google.com/terms/service-terms Only a + # single instance of this action can be specified. Compatible with: Inspect class GooglePrivacyDlpV2PublishSummaryToCscc include Google::Apis::Core::Hashable @@ -4897,18 +4714,16 @@ module Google end # Publish a message into given Pub/Sub topic when DlpJob has completed. The - # message contains a single field, `DlpJobName`, which is equal to the - # finished job's - # [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/projects. - # dlpJobs#DlpJob). - # Compatible with: Inspect, Risk + # message contains a single field, `DlpJobName`, which is equal to the finished + # job's [`DlpJob.name`](https://cloud.google.com/dlp/docs/reference/rest/v2/ + # projects.dlpJobs#DlpJob). Compatible with: Inspect, Risk class GooglePrivacyDlpV2PublishToPubSub include Google::Apis::Core::Hashable # Cloud Pub/Sub topic to send notifications to. The topic must have given - # publishing access rights to the DLP API service account executing - # the long running DlpJob sending the notifications. - # Format is projects/`project`/topics/`topic`. + # publishing access rights to the DLP API service account executing the long + # running DlpJob sending the notifications. Format is projects/`project`/topics/` + # topic`. # Corresponds to the JSON property `topic` # @return [String] attr_accessor :topic @@ -4923,10 +4738,10 @@ module Google end end - # Enable Stackdriver metric dlp.googleapis.com/finding_count. This - # will publish a metric to stack driver on each infotype requested and - # how many findings were found for it. CustomDetectors will be bucketed - # as 'Custom' under the Stackdriver label 'info_type'. + # Enable Stackdriver metric dlp.googleapis.com/finding_count. This will publish + # a metric to stack driver on each infotype requested and how many findings were + # found for it. CustomDetectors will be bucketed as 'Custom' under the + # Stackdriver label 'info_type'. class GooglePrivacyDlpV2PublishToStackdriver include Google::Apis::Core::Hashable @@ -4943,9 +4758,9 @@ module Google class GooglePrivacyDlpV2QuasiId include Google::Apis::Core::Hashable - # A column can be tagged with a custom tag. In this case, the user must - # indicate an auxiliary table that contains statistical information on - # the possible values of this column (below). + # A column can be tagged with a custom tag. In this case, the user must indicate + # an auxiliary table that contains statistical information on the possible + # values of this column (below). # Corresponds to the JSON property `customTag` # @return [String] attr_accessor :custom_tag @@ -4955,13 +4770,11 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :field - # 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 ````. # Corresponds to the JSON property `inferred` # @return [Google::Apis::DlpV2::GoogleProtobufEmpty] attr_accessor :inferred @@ -4984,8 +4797,8 @@ module Google end end - # A quasi-identifier column has a custom_tag, used to know which column - # in the data corresponds to which column in the statistical model. + # A quasi-identifier column has a custom_tag, used to know which column in the + # data corresponds to which column in the statistical model. class GooglePrivacyDlpV2QuasiIdField include Google::Apis::Core::Hashable @@ -5010,14 +4823,14 @@ module Google end end - # A quasi-identifier column has a custom_tag, used to know which column - # in the data corresponds to which column in the statistical model. + # A quasi-identifier column has a custom_tag, used to know which column in the + # data corresponds to which column in the statistical model. class GooglePrivacyDlpV2QuasiIdentifierField include Google::Apis::Core::Hashable - # A column can be tagged with a custom tag. In this case, the user must - # indicate an auxiliary table that contains statistical information on - # the possible values of this column (below). + # A column can be tagged with a custom tag. In this case, the user must indicate + # an auxiliary table that contains statistical information on the possible + # values of this column (below). # Corresponds to the JSON property `customTag` # @return [String] attr_accessor :custom_tag @@ -5042,8 +4855,7 @@ module Google class GooglePrivacyDlpV2QuoteInfo include Google::Apis::Core::Hashable - # Message for a date time object. - # e.g. 2018-01-01, 5th August. + # Message for a date time object. e.g. 2018-01-01, 5th August. # Corresponds to the JSON property `dateTime` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DateTime] attr_accessor :date_time @@ -5083,8 +4895,8 @@ module Google end end - # A condition for determining whether a transformation should be applied to - # a field. + # A condition for determining whether a transformation should be applied to a + # field. class GooglePrivacyDlpV2RecordCondition include Google::Apis::Core::Hashable @@ -5117,8 +4929,8 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DatastoreKey] attr_accessor :datastore_key - # Values of identifying columns in the given row. Order of values matches - # the order of `identifying_fields` specified in the scanning request. + # Values of identifying columns in the given row. Order of values matches the + # order of `identifying_fields` specified in the scanning request. # Corresponds to the JSON property `idValues` # @return [Array] attr_accessor :id_values @@ -5171,8 +4983,8 @@ module Google class GooglePrivacyDlpV2RecordSuppression include Google::Apis::Core::Hashable - # A condition for determining whether a transformation should be applied to - # a field. + # A condition for determining whether a transformation should be applied to a + # field. # Corresponds to the JSON property `condition` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2RecordCondition] attr_accessor :condition @@ -5187,8 +4999,7 @@ module Google end end - # A type of transformation that is applied over structured data such as a - # table. + # A type of transformation that is applied over structured data such as a table. class GooglePrivacyDlpV2RecordTransformations include Google::Apis::Core::Hashable @@ -5229,8 +5040,8 @@ module Google end end - # Request to search for potentially sensitive info in an image and redact it - # by covering it with a colored rectangle. + # Request to search for potentially sensitive info in an image and redact it by + # covering it with a colored rectangle. class GooglePrivacyDlpV2RedactImageRequest include Google::Apis::Core::Hashable @@ -5244,16 +5055,14 @@ module Google # @return [Array] attr_accessor :image_redaction_configs - # Whether the response should include findings along with the redacted - # image. + # Whether the response should include findings along with the redacted image. # Corresponds to the JSON property `includeFindings` # @return [Boolean] attr_accessor :include_findings alias_method :include_findings?, :include_findings - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config @@ -5281,9 +5090,9 @@ module Google class GooglePrivacyDlpV2RedactImageResponse include Google::Apis::Core::Hashable - # If an image was being inspected and the InspectConfig's include_quote was - # set to true, then this field will include all text, if any, that was found - # in the image. + # If an image was being inspected and the InspectConfig's include_quote was set + # to true, then this field will include all text, if any, that was found in the + # image. # Corresponds to the JSON property `extractedText` # @return [String] attr_accessor :extracted_text @@ -5315,15 +5124,14 @@ module Google class GooglePrivacyDlpV2Regex include Google::Apis::Core::Hashable - # The index of the submatch to extract as findings. When not - # specified, the entire match is returned. No more than 3 may be included. + # The index of the submatch to extract as findings. When not specified, the + # entire match is returned. No more than 3 may be included. # Corresponds to the JSON property `groupIndexes` # @return [Array] attr_accessor :group_indexes - # Pattern defining the regular expression. Its syntax - # (https://github.com/google/re2/wiki/Syntax) can be found under the - # google/re2 repository on GitHub. + # Pattern defining the regular expression. Its syntax (https://github.com/google/ + # re2/wiki/Syntax) can be found under the google/re2 repository on GitHub. # Corresponds to the JSON property `pattern` # @return [String] attr_accessor :pattern @@ -5343,18 +5151,16 @@ module Google class GooglePrivacyDlpV2ReidentifyContentRequest include Google::Apis::Core::Hashable - # Configuration description of the scanning process. - # When used with redactContent only info_types and min_likelihood are currently - # used. + # Configuration description of the scanning process. When used with + # redactContent only info_types and min_likelihood are currently used. # Corresponds to the JSON property `inspectConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectConfig] attr_accessor :inspect_config - # Template to use. Any configuration directly specified in - # `inspect_config` will override those set in the template. Singular fields - # that are set in this request will replace their corresponding fields in the - # template. Repeated fields are appended. Singular sub-messages and groups - # are recursively merged. + # Template to use. Any configuration directly specified in `inspect_config` will + # override those set in the template. Singular fields that are set in this + # request will replace their corresponding fields in the template. Repeated + # fields are appended. Singular sub-messages and groups are recursively merged. # Corresponds to the JSON property `inspectTemplateName` # @return [String] attr_accessor :inspect_template_name @@ -5374,13 +5180,12 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyConfig] attr_accessor :reidentify_config - # Template to use. References an instance of `DeidentifyTemplate`. - # Any configuration directly specified in `reidentify_config` or - # `inspect_config` will override those set in the template. The - # `DeidentifyTemplate` used must include only reversible transformations. - # Singular fields that are set in this request will replace their - # corresponding fields in the template. Repeated fields are appended. - # Singular sub-messages and groups are recursively merged. + # Template to use. References an instance of `DeidentifyTemplate`. Any + # configuration directly specified in `reidentify_config` or `inspect_config` + # will override those set in the template. The `DeidentifyTemplate` used must + # include only reversible transformations. Singular fields that are set in this + # request will replace their corresponding fields in the template. Repeated + # fields are appended. Singular sub-messages and groups are recursively merged. # Corresponds to the JSON property `reidentifyTemplateName` # @return [String] attr_accessor :reidentify_template_name @@ -5429,12 +5234,11 @@ module Google class GooglePrivacyDlpV2ReplaceValueConfig include Google::Apis::Core::Hashable - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `newValue` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :new_value @@ -5473,8 +5277,8 @@ module Google # The inspectTemplate contains a configuration (set of types of sensitive data # to be detected) to be used anywhere you otherwise would normally specify - # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates - # to learn more. + # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to + # learn more. # Corresponds to the JSON property `snapshotInspectTemplate` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate] attr_accessor :snapshot_inspect_template @@ -5499,8 +5303,8 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2HybridInspectStatistics] attr_accessor :hybrid_stats - # Statistics of how many instances of each info type were found during - # inspect job. + # Statistics of how many instances of each info type were found during inspect + # job. # Corresponds to the JSON property `infoTypeStats` # @return [Array] attr_accessor :info_type_stats @@ -5528,8 +5332,8 @@ module Google end end - # Configuration for a risk analysis job. See - # https://cloud.google.com/dlp/docs/concepts-risk-analysis to learn more. + # Configuration for a risk analysis job. See https://cloud.google.com/dlp/docs/ + # concepts-risk-analysis to learn more. class GooglePrivacyDlpV2RiskAnalysisJobConfig include Google::Apis::Core::Hashable @@ -5545,10 +5349,8 @@ module Google attr_accessor :privacy_metric # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `sourceTable` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :source_table @@ -5585,8 +5387,7 @@ module Google end # If set, the detailed findings will be persisted to the specified - # OutputStorageConfig. Only a single instance of this action can be - # specified. + # OutputStorageConfig. Only a single instance of this action can be specified. # Compatible with: Inspect, Risk class GooglePrivacyDlpV2SaveFindings include Google::Apis::Core::Hashable @@ -5610,12 +5411,11 @@ module Google class GooglePrivacyDlpV2Schedule include Google::Apis::Core::Hashable - # With this option a job is started a regular periodic basis. For - # example: every day (86400 seconds). - # A scheduled start time will be skipped if the previous - # execution has not ended when its scheduled time occurs. - # This value must be set to a time duration greater than or equal - # to 1 day and can be no longer than 60 days. + # With this option a job is started a regular periodic basis. For example: every + # day (86400 seconds). A scheduled start time will be skipped if the previous + # execution has not ended when its scheduled time occurs. This value must be set + # to a time duration greater than or equal to 1 day and can be no longer than 60 + # days. # Corresponds to the JSON property `recurrencePeriodDuration` # @return [String] attr_accessor :recurrence_period_duration @@ -5631,12 +5431,11 @@ module Google end # An auxiliary table containing statistical information on the relative - # frequency of different quasi-identifiers values. It has one or several - # quasi-identifiers columns, and one column that indicates the relative - # frequency of each quasi-identifier tuple. - # If a tuple is present in the data but not in the auxiliary table, the - # corresponding relative frequency is assumed to be zero (and thus, the - # tuple is highly reidentifiable). + # frequency of different quasi-identifiers values. It has one or several quasi- + # identifiers columns, and one column that indicates the relative frequency of + # each quasi-identifier tuple. If a tuple is present in the data but not in the + # auxiliary table, the corresponding relative frequency is assumed to be zero ( + # and thus, the tuple is highly reidentifiable). class GooglePrivacyDlpV2StatisticalTable include Google::Apis::Core::Hashable @@ -5651,10 +5450,8 @@ module Google attr_accessor :relative_frequency # Message defining the location of a BigQuery table. A table is uniquely - # identified by its project_id, dataset_id, and table_name. Within a query - # a table is often referenced with a string in the format of: - # `:.` or - # `..`. + # identified by its project_id, dataset_id, and table_name. Within a query a + # table is often referenced with a string in the format of: `:.` or `..`. # Corresponds to the JSON property `table` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryTable] attr_accessor :table @@ -5680,8 +5477,7 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2BigQueryOptions] attr_accessor :big_query_options - # Options defining a file or a set of files within a Google Cloud Storage - # bucket. + # Options defining a file or a set of files within a Google Cloud Storage bucket. # Corresponds to the JSON property `cloudStorageOptions` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2CloudStorageOptions] attr_accessor :cloud_storage_options @@ -5691,14 +5487,14 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DatastoreOptions] attr_accessor :datastore_options - # Configuration to control jobs where the content being inspected is outside - # of Google Cloud Platform. + # Configuration to control jobs where the content being inspected is outside of + # Google Cloud Platform. # Corresponds to the JSON property `hybridOptions` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2HybridOptions] attr_accessor :hybrid_options - # Configuration of the timespan of the items to include in scanning. - # Currently only supported when inspecting Google Cloud Storage and BigQuery. + # Configuration of the timespan of the items to include in scanning. Currently + # only supported when inspecting Google Cloud Storage and BigQuery. # Corresponds to the JSON property `timespanConfig` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2TimespanConfig] attr_accessor :timespan_config @@ -5752,8 +5548,7 @@ module Google # @return [String] attr_accessor :name - # Pending versions of the stored info type. Empty if no versions are - # pending. + # Pending versions of the stored info type. Empty if no versions are pending. # Corresponds to the JSON property `pendingVersions` # @return [Array] attr_accessor :pending_versions @@ -5770,9 +5565,9 @@ module Google end end - # Configuration for stored infoTypes. All fields and subfield are provided - # by the user. For more information, see - # https://cloud.google.com/dlp/docs/creating-custom-infotypes. + # Configuration for stored infoTypes. All fields and subfield are provided by + # the user. For more information, see https://cloud.google.com/dlp/docs/creating- + # custom-infotypes. class GooglePrivacyDlpV2StoredInfoTypeConfig include Google::Apis::Core::Hashable @@ -5781,28 +5576,24 @@ module Google # @return [String] attr_accessor :description - # Custom information type based on a dictionary of words or phrases. This can - # be used to match sensitive information specific to the data, such as a list - # of employee IDs or job titles. - # Dictionary words are case-insensitive and all characters other than letters - # and digits in the unicode [Basic Multilingual + # Custom information type based on a dictionary of words or phrases. This can be + # used to match sensitive information specific to the data, such as a list of + # employee IDs or job titles. Dictionary words are case-insensitive and all + # characters other than letters and digits in the unicode [Basic Multilingual # Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29# - # Basic_Multilingual_Plane) - # will be replaced with whitespace when scanning for matches, so the - # dictionary phrase "Sam Johnson" will match all three phrases "sam johnson", - # "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters - # surrounding any match must be of a different type than the adjacent - # characters within the word, so letters must be next to non-letters and - # digits next to non-digits. For example, the dictionary word "jen" will - # match the first three letters of the text "jen123" but will return no - # matches for "jennifer". - # Dictionary words containing a large number of characters that are not - # letters or digits may result in unexpected findings because such characters - # are treated as whitespace. The - # [limits](https://cloud.google.com/dlp/limits) page contains details about - # the size limits of dictionaries. For dictionaries that do not fit within - # these constraints, consider using `LargeCustomDictionaryConfig` in the - # `StoredInfoType` API. + # Basic_Multilingual_Plane) will be replaced with whitespace when scanning for + # matches, so the dictionary phrase "Sam Johnson" will match all three phrases " + # sam johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the + # characters surrounding any match must be of a different type than the adjacent + # characters within the word, so letters must be next to non-letters and digits + # next to non-digits. For example, the dictionary word "jen" will match the + # first three letters of the text "jen123" but will return no matches for " + # jennifer". Dictionary words containing a large number of characters that are + # not letters or digits may result in unexpected findings because such + # characters are treated as whitespace. The [limits](https://cloud.google.com/ + # dlp/limits) page contains details about the size limits of dictionaries. For + # dictionaries that do not fit within these constraints, consider using ` + # LargeCustomDictionaryConfig` in the `StoredInfoType` API. # Corresponds to the JSON property `dictionary` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Dictionary] attr_accessor :dictionary @@ -5813,11 +5604,10 @@ module Google attr_accessor :display_name # Configuration for a custom dictionary created from a data source of any size - # up to the maximum size defined in the - # [limits](https://cloud.google.com/dlp/limits) page. The artifacts of - # dictionary creation are stored in the specified Google Cloud Storage - # location. Consider using `CustomInfoType.Dictionary` for smaller dictionaries - # that satisfy the size requirements. + # up to the maximum size defined in the [limits](https://cloud.google.com/dlp/ + # limits) page. The artifacts of dictionary creation are stored in the specified + # Google Cloud Storage location. Consider using `CustomInfoType.Dictionary` for + # smaller dictionaries that satisfy the size requirements. # Corresponds to the JSON property `largeCustomDictionary` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2LargeCustomDictionaryConfig] attr_accessor :large_custom_dictionary @@ -5865,36 +5655,35 @@ module Google class GooglePrivacyDlpV2StoredInfoTypeVersion include Google::Apis::Core::Hashable - # Configuration for stored infoTypes. All fields and subfield are provided - # by the user. For more information, see - # https://cloud.google.com/dlp/docs/creating-custom-infotypes. + # Configuration for stored infoTypes. All fields and subfield are provided by + # the user. For more information, see https://cloud.google.com/dlp/docs/creating- + # custom-infotypes. # Corresponds to the JSON property `config` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoTypeConfig] attr_accessor :config - # Create timestamp of the version. Read-only, determined by the system - # when the version is created. + # Create timestamp of the version. Read-only, determined by the system when the + # version is created. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time - # Errors that occurred when creating this storedInfoType version, or - # anomalies detected in the storedInfoType data that render it unusable. Only - # the five most recent errors will be displayed, with the most recent error - # appearing first. - # For example, some of the data for stored custom dictionaries is put in + # Errors that occurred when creating this storedInfoType version, or anomalies + # detected in the storedInfoType data that render it unusable. Only the five + # most recent errors will be displayed, with the most recent error appearing + # first. For example, some of the data for stored custom dictionaries is put in # the user's Google Cloud Storage bucket, and if this data is modified or - # deleted by the user or another system, the dictionary becomes invalid. - # If any errors occur, fix the problem indicated by the error message and - # use the UpdateStoredInfoType API method to create another version of the - # storedInfoType to continue using it, reusing the same `config` if it was - # not the source of the error. + # deleted by the user or another system, the dictionary becomes invalid. If any + # errors occur, fix the problem indicated by the error message and use the + # UpdateStoredInfoType API method to create another version of the + # storedInfoType to continue using it, reusing the same `config` if it was not + # the source of the error. # Corresponds to the JSON property `errors` # @return [Array] attr_accessor :errors - # Stored info type version state. Read-only, updated by the system - # during dictionary creation. + # Stored info type version state. Read-only, updated by the system during + # dictionary creation. # Corresponds to the JSON property `state` # @return [String] attr_accessor :state @@ -5928,9 +5717,9 @@ module Google # @return [String] attr_accessor :create_time - # Resource name of the requested `StoredInfoType`, for example - # `organizations/433245324/storedInfoTypes/432452342` or - # `projects/project-id/storedInfoTypes/432452342`. + # Resource name of the requested `StoredInfoType`, for example `organizations/ + # 433245324/storedInfoTypes/432452342` or `projects/project-id/storedInfoTypes/ + # 432452342`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -5946,8 +5735,8 @@ module Google end end - # A collection that informs the user the number of times a particular - # `TransformationResultCode` and error details occurred. + # A collection that informs the user the number of times a particular ` + # TransformationResultCode` and error details occurred. class GooglePrivacyDlpV2SummaryResult include Google::Apis::Core::Hashable @@ -5961,8 +5750,8 @@ module Google # @return [Fixnum] attr_accessor :count - # A place for warnings or errors to show up if a transformation didn't - # work as expected. + # A place for warnings or errors to show up if a transformation didn't work as + # expected. # Corresponds to the JSON property `details` # @return [String] attr_accessor :details @@ -5979,15 +5768,13 @@ module Google end end - # Message for detecting output from deidentification transformations - # such as - # [`CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ - # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). - # These types of transformations are - # those that perform pseudonymization, thereby producing a "surrogate" as - # output. This should be used in conjunction with a field on the - # transformation such as `surrogate_info_type`. This CustomInfoType does - # not support the use of `detection_rules`. + # Message for detecting output from deidentification transformations such as [` + # CryptoReplaceFfxFpeConfig`](https://cloud.google.com/dlp/docs/reference/rest/ + # v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig). These types + # of transformations are those that perform pseudonymization, thereby producing + # a "surrogate" as output. This should be used in conjunction with a field on + # the transformation such as `surrogate_info_type`. This CustomInfoType does not + # support the use of `detection_rules`. class GooglePrivacyDlpV2SurrogateType include Google::Apis::Core::Hashable @@ -6000,9 +5787,9 @@ module Google end end - # Structured content to inspect. Up to 50,000 `Value`s per request allowed. - # See https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to - # learn more. + # Structured content to inspect. Up to 50,000 `Value`s per request allowed. See + # https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to learn + # more. class GooglePrivacyDlpV2Table include Google::Apis::Core::Hashable @@ -6031,12 +5818,11 @@ module Google class GooglePrivacyDlpV2TableLocation include Google::Apis::Core::Hashable - # The zero-based index of the row where the finding is located. Only - # populated for resources that have a natural ordering, not BigQuery. In - # BigQuery, to identify the row a finding came from, populate - # BigQueryOptions.identifying_fields with your primary key column names and - # when you store the findings the value of those columns will be stored - # inside of Finding. + # The zero-based index of the row where the finding is located. Only populated + # for resources that have a natural ordering, not BigQuery. In BigQuery, to + # identify the row a finding came from, populate BigQueryOptions. + # identifying_fields with your primary key column names and when you store the + # findings the value of those columns will be stored inside of Finding. # Corresponds to the JSON property `rowIndex` # @return [Fixnum] attr_accessor :row_index @@ -6056,9 +5842,9 @@ module Google include Google::Apis::Core::Hashable # The columns that are the primary keys for table objects included in - # ContentItem. A copy of this cell's value will stored alongside alongside - # each finding so that the finding can be traced to the specific row it came - # from. No more than 3 may be provided. + # ContentItem. A copy of this cell's value will stored alongside alongside each + # finding so that the finding can be traced to the specific row it came from. No + # more than 3 may be provided. # Corresponds to the JSON property `identifyingFields` # @return [Array] attr_accessor :identifying_fields @@ -6077,9 +5863,9 @@ module Google class GooglePrivacyDlpV2TaggedField include Google::Apis::Core::Hashable - # A column can be tagged with a custom tag. In this case, the user must - # indicate an auxiliary table that contains statistical information on - # the possible values of this column (below). + # A column can be tagged with a custom tag. In this case, the user must indicate + # an auxiliary table that contains statistical information on the possible + # values of this column (below). # Corresponds to the JSON property `customTag` # @return [String] attr_accessor :custom_tag @@ -6089,13 +5875,11 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :field - # 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 ````. # Corresponds to the JSON property `inferred` # @return [Google::Apis::DlpV2::GoogleProtobufEmpty] attr_accessor :inferred @@ -6155,8 +5939,8 @@ module Google class GooglePrivacyDlpV2TimeZone include Google::Apis::Core::Hashable - # Set only if the offset can be determined. Positive for time ahead of UTC. - # E.g. For "UTC-9", this value is -540. + # Set only if the offset can be determined. Positive for time ahead of UTC. E.g. + # For "UTC-9", this value is -540. # Corresponds to the JSON property `offsetMinutes` # @return [Fixnum] attr_accessor :offset_minutes @@ -6171,22 +5955,22 @@ module Google end end - # Configuration of the timespan of the items to include in scanning. - # Currently only supported when inspecting Google Cloud Storage and BigQuery. + # Configuration of the timespan of the items to include in scanning. Currently + # only supported when inspecting Google Cloud Storage and BigQuery. class GooglePrivacyDlpV2TimespanConfig include Google::Apis::Core::Hashable - # When the job is started by a JobTrigger we will automatically figure out - # a valid start_time to avoid scanning files that have not been modified - # since the last time the JobTrigger executed. This will be based on the - # time of the execution of the last run of the JobTrigger. + # When the job is started by a JobTrigger we will automatically figure out a + # valid start_time to avoid scanning files that have not been modified since the + # last time the JobTrigger executed. This will be based on the time of the + # execution of the last run of the JobTrigger. # Corresponds to the JSON property `enableAutoPopulationOfTimespanConfig` # @return [Boolean] attr_accessor :enable_auto_population_of_timespan_config alias_method :enable_auto_population_of_timespan_config?, :enable_auto_population_of_timespan_config - # Exclude files or rows newer than this value. - # If set to zero, no upper time limit is applied. + # Exclude files or rows newer than this value. If set to zero, no upper time + # limit is applied. # Corresponds to the JSON property `endTime` # @return [String] attr_accessor :end_time @@ -6214,21 +5998,19 @@ module Google end end - # How to handle transformation errors during de-identification. A - # transformation error occurs when the requested transformation is incompatible - # with the data. For example, trying to de-identify an IP address using a - # `DateShift` transformation would result in a transformation error, since date - # info cannot be extracted from an IP address. - # Information about any incompatible transformations, and how they were - # handled, is returned in the response as part of the - # `TransformationOverviews`. + # How to handle transformation errors during de-identification. A transformation + # error occurs when the requested transformation is incompatible with the data. + # For example, trying to de-identify an IP address using a `DateShift` + # transformation would result in a transformation error, since date info cannot + # be extracted from an IP address. Information about any incompatible + # transformations, and how they were handled, is returned in the response as + # part of the `TransformationOverviews`. class GooglePrivacyDlpV2TransformationErrorHandling include Google::Apis::Core::Hashable # Skips the data without modifying it if the requested transformation would - # cause an error. For example, if a `DateShift` transformation were applied - # an an IP address, this mode would leave the IP address unchanged in the - # response. + # cause an error. For example, if a `DateShift` transformation were applied an + # an IP address, this mode would leave the IP address unchanged in the response. # Corresponds to the JSON property `leaveUntransformed` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2LeaveUntransformed] attr_accessor :leave_untransformed @@ -6274,9 +6056,8 @@ module Google end end - # Summary of a single transformation. - # Only one of 'transformation', 'field_transformation', or 'record_suppress' - # will be set. + # Summary of a single transformation. Only one of 'transformation', ' + # field_transformation', or 'record_suppress' will be set. class GooglePrivacyDlpV2TransformationSummary include Google::Apis::Core::Hashable @@ -6285,9 +6066,9 @@ module Google # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2FieldId] attr_accessor :field - # The field transformation that was applied. - # If multiple field transformations are requested for a single field, - # this list will contain all of them; otherwise, only one is supplied. + # The field transformation that was applied. If multiple field transformations + # are requested for a single field, this list will contain all of them; + # otherwise, only one is supplied. # Corresponds to the JSON property `fieldTransformations` # @return [Array] attr_accessor :field_transformations @@ -6334,17 +6115,16 @@ module Google end end - # Use this to have a random data crypto key generated. - # It will be discarded after the request finishes. + # Use this to have a random data crypto key generated. It will be discarded + # after the request finishes. class GooglePrivacyDlpV2TransientCryptoKey include Google::Apis::Core::Hashable - # Required. Name of the key. - # This is an arbitrary string used to differentiate different keys. - # A unique key is generated per name: two separate `TransientCryptoKey` - # protos share the same generated key if their names are the same. - # When the data crypto key is generated, this name is not used in any way - # (repeating the api call will result in a different key being generated). + # Required. Name of the key. This is an arbitrary string used to differentiate + # different keys. A unique key is generated per name: two separate ` + # TransientCryptoKey` protos share the same generated key if their names are the + # same. When the data crypto key is generated, this name is not used in any way ( + # repeating the api call will result in a different key being generated). # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -6363,8 +6143,7 @@ module Google class GooglePrivacyDlpV2Trigger include Google::Apis::Core::Hashable - # Job trigger option for hybrid jobs. Jobs must be manually created - # and finished. + # Job trigger option for hybrid jobs. Jobs must be manually created and finished. # Corresponds to the JSON property `manual` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Manual] attr_accessor :manual @@ -6385,8 +6164,8 @@ module Google end end - # Using raw keys is prone to security risks due to accidentally - # leaking the key. Choose another type of key if possible. + # Using raw keys is prone to security risks due to accidentally leaking the key. + # Choose another type of key if possible. class GooglePrivacyDlpV2UnwrappedCryptoKey include Google::Apis::Core::Hashable @@ -6410,8 +6189,8 @@ module Google class GooglePrivacyDlpV2UpdateDeidentifyTemplateRequest include Google::Apis::Core::Hashable - # DeidentifyTemplates contains instructions on how to de-identify content. - # See https://cloud.google.com/dlp/docs/concepts-templates to learn more. + # DeidentifyTemplates contains instructions on how to de-identify content. See + # https://cloud.google.com/dlp/docs/concepts-templates to learn more. # Corresponds to the JSON property `deidentifyTemplate` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyTemplate] attr_accessor :deidentify_template @@ -6438,8 +6217,8 @@ module Google # The inspectTemplate contains a configuration (set of types of sensitive data # to be detected) to be used anywhere you otherwise would normally specify - # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates - # to learn more. + # InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates to + # learn more. # Corresponds to the JSON property `inspectTemplate` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectTemplate] attr_accessor :inspect_template @@ -6464,8 +6243,8 @@ module Google class GooglePrivacyDlpV2UpdateJobTriggerRequest include Google::Apis::Core::Hashable - # Contains a configuration to make dlp api calls on a repeating basis. - # See https://cloud.google.com/dlp/docs/concepts-job-triggers to learn more. + # Contains a configuration to make dlp api calls on a repeating basis. See https: + # //cloud.google.com/dlp/docs/concepts-job-triggers to learn more. # Corresponds to the JSON property `jobTrigger` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2JobTrigger] attr_accessor :job_trigger @@ -6490,9 +6269,9 @@ module Google class GooglePrivacyDlpV2UpdateStoredInfoTypeRequest include Google::Apis::Core::Hashable - # Configuration for stored infoTypes. All fields and subfield are provided - # by the user. For more information, see - # https://cloud.google.com/dlp/docs/creating-custom-infotypes. + # Configuration for stored infoTypes. All fields and subfield are provided by + # the user. For more information, see https://cloud.google.com/dlp/docs/creating- + # custom-infotypes. # Corresponds to the JSON property `config` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2StoredInfoTypeConfig] attr_accessor :config @@ -6513,12 +6292,11 @@ module Google end end - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. class GooglePrivacyDlpV2Value include Google::Apis::Core::Hashable @@ -6530,12 +6308,12 @@ module Google # Represents a whole or partial calendar date, e.g. a birthday. The time of day # and time zone are either specified elsewhere or are not significant. The date - # is relative to the Proleptic Gregorian Calendar. This can represent: - # * A full date, with non-zero year, month and day values - # * A month and day value, with a zero year, e.g. an anniversary - # * A year on its own, with zero month and day values - # * A year and month value, with a zero day, e.g. a credit card expiration date - # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`. + # is relative to the Proleptic Gregorian Calendar. This can represent: * A full + # date, with non-zero year, month and day values * A month and day value, with a + # zero year, e.g. an anniversary * A year on its own, with zero month and day + # values * A year and month value, with a zero day, e.g. a credit card + # expiration date Related types are google.type.TimeOfDay and `google.protobuf. + # Timestamp`. # Corresponds to the JSON property `dateValue` # @return [Google::Apis::DlpV2::GoogleTypeDate] attr_accessor :date_value @@ -6560,8 +6338,8 @@ module Google # @return [String] attr_accessor :string_value - # Represents a time of day. The date and time zone are either not significant - # or are specified elsewhere. An API may choose to allow leap seconds. Related + # Represents a time of day. The date and time zone are either not significant or + # are specified elsewhere. An API may choose to allow leap seconds. Related # types are google.type.Date and `google.protobuf.Timestamp`. # Corresponds to the JSON property `timeValue` # @return [Google::Apis::DlpV2::GoogleTypeTimeOfDay] @@ -6598,12 +6376,11 @@ module Google # @return [Fixnum] attr_accessor :count - # Set of primitive values supported by the system. - # Note that for the purposes of inspection or transformation, the number - # of bytes considered to comprise a 'Value' is based on its representation - # as a UTF-8 encoded string. For example, if 'integer_value' is set to - # 123456789, the number of bytes would be counted as 9, even though an - # int64 only holds up to 8 bytes of data. + # Set of primitive values supported by the system. Note that for the purposes of + # inspection or transformation, the number of bytes considered to comprise a ' + # Value' is based on its representation as a UTF-8 encoded string. For example, + # if 'integer_value' is set to 123456789, the number of bytes would be counted + # as 9, even though an int64 only holds up to 8 bytes of data. # Corresponds to the JSON property `value` # @return [Google::Apis::DlpV2::GooglePrivacyDlpV2Value] attr_accessor :value @@ -6623,9 +6400,9 @@ module Google class GooglePrivacyDlpV2WordList include Google::Apis::Core::Hashable - # Words or phrases defining the dictionary. The dictionary must contain - # at least one phrase and every phrase must contain at least 2 characters - # that are letters or digits. [required] + # Words or phrases defining the dictionary. The dictionary must contain at least + # one phrase and every phrase must contain at least 2 characters that are + # letters or digits. [required] # Corresponds to the JSON property `words` # @return [Array] attr_accessor :words @@ -6640,13 +6417,11 @@ module Google end end - # A generic empty message that you can re-use to avoid defining duplicated - # empty messages in your APIs. A typical example is to use it as the request - # or the response type of an API method. For instance: - # service Foo ` - # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. class GoogleProtobufEmpty include Google::Apis::Core::Hashable @@ -6659,12 +6434,12 @@ module Google end end - # The `Status` type defines a logical error model that is suitable for - # different programming environments, including REST APIs and RPC APIs. It is - # used by [gRPC](https://github.com/grpc). Each `Status` message contains - # three pieces of data: error code, error message, and error details. - # You can find out more about this error model and how to work with it in the - # [API Design Guide](https://cloud.google.com/apis/design/errors). + # The `Status` type defines a logical error model that is suitable for different + # programming environments, including REST APIs and RPC APIs. It is used by [ + # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of + # data: error code, error message, and error details. You can find out more + # about this error model and how to work with it in the [API Design Guide](https: + # //cloud.google.com/apis/design/errors). class GoogleRpcStatus include Google::Apis::Core::Hashable @@ -6673,15 +6448,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # A developer-facing error message, which should be in English. Any - # user-facing error message should be localized and sent in the - # google.rpc.Status.details field, or localized by the client. + # A developer-facing error message, which should be in English. Any user-facing + # error message should be localized and sent in the google.rpc.Status.details + # field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message @@ -6700,30 +6475,29 @@ module Google # Represents a whole or partial calendar date, e.g. a birthday. The time of day # and time zone are either specified elsewhere or are not significant. The date - # is relative to the Proleptic Gregorian Calendar. This can represent: - # * A full date, with non-zero year, month and day values - # * A month and day value, with a zero year, e.g. an anniversary - # * A year on its own, with zero month and day values - # * A year and month value, with a zero day, e.g. a credit card expiration date - # Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`. + # is relative to the Proleptic Gregorian Calendar. This can represent: * A full + # date, with non-zero year, month and day values * A month and day value, with a + # zero year, e.g. an anniversary * A year on its own, with zero month and day + # values * A year and month value, with a zero day, e.g. a credit card + # expiration date Related types are google.type.TimeOfDay and `google.protobuf. + # Timestamp`. class GoogleTypeDate include Google::Apis::Core::Hashable - # Day of month. Must be from 1 to 31 and valid for the year and month, or 0 - # if specifying a year by itself or a year and month where the day is not + # Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if + # specifying a year by itself or a year and month where the day is not # significant. # Corresponds to the JSON property `day` # @return [Fixnum] attr_accessor :day - # Month of year. Must be from 1 to 12, or 0 if specifying a year without a - # month and day. + # Month of year. Must be from 1 to 12, or 0 if specifying a year without a month + # and day. # Corresponds to the JSON property `month` # @return [Fixnum] attr_accessor :month - # Year of date. Must be from 1 to 9999, or 0 if specifying a date without - # a year. + # Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year. # Corresponds to the JSON property `year` # @return [Fixnum] attr_accessor :year @@ -6740,14 +6514,14 @@ module Google end end - # Represents a time of day. The date and time zone are either not significant - # or are specified elsewhere. An API may choose to allow leap seconds. Related + # Represents a time of day. The date and time zone are either not significant or + # are specified elsewhere. An API may choose to allow leap seconds. Related # types are google.type.Date and `google.protobuf.Timestamp`. class GoogleTypeTimeOfDay include Google::Apis::Core::Hashable - # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose - # to allow the value "24:00:00" for scenarios like business closing time. + # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to + # allow the value "24:00:00" for scenarios like business closing time. # Corresponds to the JSON property `hours` # @return [Fixnum] attr_accessor :hours diff --git a/generated/google/apis/dlp_v2/service.rb b/generated/google/apis/dlp_v2/service.rb index 1020d029c..27a4333de 100644 --- a/generated/google/apis/dlp_v2/service.rb +++ b/generated/google/apis/dlp_v2/service.rb @@ -49,21 +49,18 @@ module Google @batch_path = 'batch' end - # Returns a list of the sensitive information types that the DLP API - # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to - # learn more. + # Returns a list of the sensitive information types that the DLP API supports. + # See https://cloud.google.com/dlp/docs/infotypes-reference to learn more. # @param [String] filter - # filter to only return infoTypes supported by certain parts of the - # API. Defaults to supported_by=INSPECT. + # filter to only return infoTypes supported by certain parts of the API. + # Defaults to supported_by=INSPECT. # @param [String] language_code - # BCP-47 language code for localized infoType friendly - # names. If omitted, or if localized strings are not available, - # en-US strings will be returned. + # BCP-47 language code for localized infoType friendly names. If omitted, or if + # localized strings are not available, en-US strings will be returned. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] parent - # The parent resource name. - # - Format:locations/[LOCATION-ID] + # The parent resource name. - Format:locations/[LOCATION-ID] # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -94,19 +91,16 @@ module Google execute_or_queue_command(command, &block) end - # Returns a list of the sensitive information types that the DLP API - # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to - # learn more. + # Returns a list of the sensitive information types that the DLP API supports. + # See https://cloud.google.com/dlp/docs/infotypes-reference to learn more. # @param [String] parent - # The parent resource name. - # - Format:locations/[LOCATION-ID] + # The parent resource name. - Format:locations/[LOCATION-ID] # @param [String] filter - # filter to only return infoTypes supported by certain parts of the - # API. Defaults to supported_by=INSPECT. + # filter to only return infoTypes supported by certain parts of the API. + # Defaults to supported_by=INSPECT. # @param [String] language_code - # BCP-47 language code for localized infoType friendly - # names. If omitted, or if localized strings are not available, - # en-US strings will be returned. + # BCP-47 language code for localized infoType friendly names. If omitted, or if + # localized strings are not available, en-US strings will be returned. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] fields @@ -139,16 +133,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates a DeidentifyTemplate for re-using frequently used configuration - # for de-identifying content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Creates a DeidentifyTemplate for re-using frequently used configuration for de- + # identifying content, images, and storage. See https://cloud.google.com/dlp/ + # docs/creating-templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -179,14 +170,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Deletes a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be - # deleted, - # for example `organizations/433245324/deidentifyTemplates/432452342` or - # projects/project-id/deidentifyTemplates/432452342. + # deleted, for example `organizations/433245324/deidentifyTemplates/432452342` + # or projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -214,13 +203,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Gets a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be read, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -249,34 +236,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists DeidentifyTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Lists DeidentifyTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListDeidentifyTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListDeidentifyTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -308,13 +289,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Updates the DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of organization and deidentify template to be updated, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateDeidentifyTemplateRequest] google_privacy_dlp_v2_update_deidentify_template_request_object # @param [String] fields @@ -346,15 +325,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates an InspectTemplate for re-using frequently used configuration - # for inspecting content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Creates an InspectTemplate for re-using frequently used configuration for + # inspecting content, images, and storage. See https://cloud.google.com/dlp/docs/ + # creating-templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -385,13 +362,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Deletes an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be deleted, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -419,13 +395,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Gets an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be read, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -453,33 +428,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists InspectTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Lists InspectTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListInspectTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListInspectTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -511,12 +481,12 @@ module Google execute_or_queue_command(command, &block) end - # Updates the InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Updates the InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of organization and inspectTemplate to be updated, for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateInspectTemplateRequest] google_privacy_dlp_v2_update_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -547,16 +517,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates a DeidentifyTemplate for re-using frequently used configuration - # for de-identifying content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Creates a DeidentifyTemplate for re-using frequently used configuration for de- + # identifying content, images, and storage. See https://cloud.google.com/dlp/ + # docs/creating-templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -587,14 +554,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Deletes a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be - # deleted, - # for example `organizations/433245324/deidentifyTemplates/432452342` or - # projects/project-id/deidentifyTemplates/432452342. + # deleted, for example `organizations/433245324/deidentifyTemplates/432452342` + # or projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -622,13 +587,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Gets a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be read, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -657,34 +620,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists DeidentifyTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Lists DeidentifyTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListDeidentifyTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListDeidentifyTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -716,13 +673,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Updates the DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of organization and deidentify template to be updated, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateDeidentifyTemplateRequest] google_privacy_dlp_v2_update_deidentify_template_request_object # @param [String] fields @@ -754,15 +709,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates an InspectTemplate for re-using frequently used configuration - # for inspecting content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Creates an InspectTemplate for re-using frequently used configuration for + # inspecting content, images, and storage. See https://cloud.google.com/dlp/docs/ + # creating-templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -793,13 +746,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Deletes an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be deleted, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -827,13 +779,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Gets an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be read, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -861,33 +812,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists InspectTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Lists InspectTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListInspectTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListInspectTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -919,12 +865,12 @@ module Google execute_or_queue_command(command, &block) end - # Updates the InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Updates the InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of organization and inspectTemplate to be updated, for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateInspectTemplateRequest] google_privacy_dlp_v2_update_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -955,15 +901,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a pre-built stored infoType to be used for inspection. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Creates a pre-built stored infoType to be used for inspection. See https:// + # cloud.google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -994,14 +937,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Deletes a stored infoType. See https://cloud.google.com/dlp/docs/creating- + # stored-infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be deleted, - # for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # for example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1029,13 +970,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Gets a stored infoType. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be read, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1063,35 +1003,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists stored infoTypes. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Lists stored infoTypes. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, display_name, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the most recent version of the - # resource was created. - # - `state`: corresponds to the state of the resource. - # - `name`: corresponds to resource name. - # - `display_name`: corresponds to info type's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, display_name, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the most recent version of the resource was created. - `state`: corresponds to + # the state of the resource. - `name`: corresponds to resource name. - ` + # display_name`: corresponds to info type's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListStoredInfoTypes`. + # Page token to continue retrieval. Comes from previous call to ` + # ListStoredInfoTypes`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1124,13 +1057,12 @@ module Google end # Updates the stored infoType by creating a new version. The existing version - # will continue to be used until the new version is ready. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # will continue to be used until the new version is ready. See https://cloud. + # google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] name # Required. Resource name of organization and storedInfoType to be updated, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateStoredInfoTypeRequest] google_privacy_dlp_v2_update_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1161,15 +1093,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a pre-built stored infoType to be used for inspection. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Creates a pre-built stored infoType to be used for inspection. See https:// + # cloud.google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1200,14 +1129,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Deletes a stored infoType. See https://cloud.google.com/dlp/docs/creating- + # stored-infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be deleted, - # for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # for example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1235,13 +1162,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Gets a stored infoType. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be read, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1269,35 +1195,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists stored infoTypes. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Lists stored infoTypes. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, display_name, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the most recent version of the - # resource was created. - # - `state`: corresponds to the state of the resource. - # - `name`: corresponds to resource name. - # - `display_name`: corresponds to info type's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, display_name, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the most recent version of the resource was created. - `state`: corresponds to + # the state of the resource. - `name`: corresponds to resource name. - ` + # display_name`: corresponds to info type's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListStoredInfoTypes`. + # Page token to continue retrieval. Comes from previous call to ` + # ListStoredInfoTypes`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1330,13 +1249,12 @@ module Google end # Updates the stored infoType by creating a new version. The existing version - # will continue to be used until the new version is ready. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # will continue to be used until the new version is ready. See https://cloud. + # google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] name # Required. Resource name of organization and storedInfoType to be updated, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateStoredInfoTypeRequest] google_privacy_dlp_v2_update_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1367,17 +1285,15 @@ module Google execute_or_queue_command(command, &block) end - # De-identifies potentially sensitive info from a ContentItem. - # This method has limits on input size and output size. - # See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to - # learn more. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # De-identifies potentially sensitive info from a ContentItem. This method has + # limits on input size and output size. See https://cloud.google.com/dlp/docs/ + # deidentify-sensitive-data to learn more. When no InfoTypes or CustomInfoTypes + # are specified in this request, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. # @param [String] parent - # Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest] google_privacy_dlp_v2_deidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1408,17 +1324,15 @@ module Google execute_or_queue_command(command, &block) end - # Finds potentially sensitive info in content. - # This method has limits on input size, processing time, and output size. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. - # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images - # and https://cloud.google.com/dlp/docs/inspecting-text, + # Finds potentially sensitive info in content. This method has limits on input + # size, processing time, and output size. When no InfoTypes or CustomInfoTypes + # are specified in this request, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. For how to guides, see https://cloud.google.com/dlp/ + # docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, # @param [String] parent - # Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest] google_privacy_dlp_v2_inspect_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1449,15 +1363,12 @@ module Google execute_or_queue_command(command, &block) end - # Re-identifies content that has been de-identified. - # See - # https://cloud.google.com/dlp/docs/pseudonymization#re- - # identification_in_free_text_code_example - # to learn more. + # Re-identifies content that has been de-identified. See https://cloud.google. + # com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example to + # learn more. # @param [String] parent - # Required. The parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. The parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest] google_privacy_dlp_v2_reidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1488,16 +1399,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates a DeidentifyTemplate for re-using frequently used configuration - # for de-identifying content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Creates a DeidentifyTemplate for re-using frequently used configuration for de- + # identifying content, images, and storage. See https://cloud.google.com/dlp/ + # docs/creating-templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1528,14 +1436,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Deletes a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be - # deleted, - # for example `organizations/433245324/deidentifyTemplates/432452342` or - # projects/project-id/deidentifyTemplates/432452342. + # deleted, for example `organizations/433245324/deidentifyTemplates/432452342` + # or projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1563,13 +1469,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Gets a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be read, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1598,34 +1502,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists DeidentifyTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Lists DeidentifyTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListDeidentifyTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListDeidentifyTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1657,13 +1555,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Updates the DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of organization and deidentify template to be updated, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateDeidentifyTemplateRequest] google_privacy_dlp_v2_update_deidentify_template_request_object # @param [String] fields @@ -1695,11 +1591,10 @@ module Google execute_or_queue_command(command, &block) end - # Starts asynchronous cancellation on a long-running DlpJob. The server - # makes a best effort to cancel the DlpJob, but success is not - # guaranteed. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Starts asynchronous cancellation on a long-running DlpJob. The server makes a + # best effort to cancel the DlpJob, but success is not guaranteed. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource to be cancelled. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CancelDlpJobRequest] google_privacy_dlp_v2_cancel_dlp_job_request_object @@ -1732,16 +1627,15 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new job to inspect storage or calculate risk metrics. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. - # When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # Creates a new job to inspect storage or calculate risk metrics. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. When no InfoTypes or CustomInfoTypes + # are specified in inspect jobs, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest] google_privacy_dlp_v2_create_dlp_job_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1772,11 +1666,10 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a long-running DlpJob. This method indicates that the client is - # no longer interested in the DlpJob result. The job will be cancelled if - # possible. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Deletes a long-running DlpJob. This method indicates that the client is no + # longer interested in the DlpJob result. The job will be cancelled if possible. + # See https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud. + # google.com/dlp/docs/compute-risk-analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource to be deleted. # @param [String] fields @@ -1806,9 +1699,9 @@ module Google execute_or_queue_command(command, &block) end - # Gets the latest state of a long-running DlpJob. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Gets the latest state of a long-running DlpJob. See https://cloud.google.com/ + # dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk- + # analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource. # @param [String] fields @@ -1838,50 +1731,38 @@ module Google execute_or_queue_command(command, &block) end - # Lists DlpJobs that match the specified filter in the request. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Lists DlpJobs that match the specified filter in the request. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter - # Allows filtering. - # Supported syntax: - # * Filter expressions are made up of one or more restrictions. - # * Restrictions can be combined by `AND` or `OR` logical operators. A - # sequence of restrictions implicitly uses `AND`. - # * A restriction has the form of ``field` `operator` `value``. - # * Supported fields/values for inspect jobs: - # - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - # - `trigger_name` - The resource name of the trigger that created job. - # - 'end_time` - Corresponds to time the job finished. - # - 'start_time` - Corresponds to time the job finished. - # * Supported fields for risk analysis jobs: - # - `state` - RUNNING|CANCELED|FINISHED|FAILED - # - 'end_time` - Corresponds to time the job finished. - # - 'start_time` - Corresponds to time the job finished. - # * The operator must be `=` or `!=`. - # Examples: - # * inspected_storage = cloud_storage AND state = done - # * inspected_storage = cloud_storage OR inspected_storage = bigquery - # * inspected_storage = cloud_storage AND (state = done OR state = canceled) - # * end_time > \"2017-12-12T00:00:00+00:00\" - # The length of this field should be no more than 500 characters. + # Allows filtering. Supported syntax: * Filter expressions are made up of one or + # more restrictions. * Restrictions can be combined by `AND` or `OR` logical + # operators. A sequence of restrictions implicitly uses `AND`. * A restriction + # has the form of ``field` `operator` `value``. * Supported fields/values for + # inspect jobs: - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - ` + # inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - `trigger_name` - The + # resource name of the trigger that created job. - 'end_time` - Corresponds to + # time the job finished. - 'start_time` - Corresponds to time the job finished. * + # Supported fields for risk analysis jobs: - `state` - RUNNING|CANCELED| + # FINISHED|FAILED - 'end_time` - Corresponds to time the job finished. - ' + # start_time` - Corresponds to time the job finished. * The operator must be `=` + # or `!=`. Examples: * inspected_storage = cloud_storage AND state = done * + # inspected_storage = cloud_storage OR inspected_storage = bigquery * + # inspected_storage = cloud_storage AND (state = done OR state = canceled) * + # end_time > \"2017-12-12T00:00:00+00:00\" The length of this field should be no + # more than 500 characters. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, end_time asc, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the job was created. - # - `end_time`: corresponds to time the job ended. - # - `name`: corresponds to job's name. - # - `state`: corresponds to `state` + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, end_time asc, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the job was created. - `end_time`: corresponds to time the job ended. - `name`: + # corresponds to job's name. - `state`: corresponds to `state` # @param [Fixnum] page_size # The standard list page size. # @param [String] page_token @@ -1921,17 +1802,15 @@ module Google execute_or_queue_command(command, &block) end - # Redacts potentially sensitive info from an image. - # This method has limits on input size, processing time, and output size. - # See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to - # learn more. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # Redacts potentially sensitive info from an image. This method has limits on + # input size, processing time, and output size. See https://cloud.google.com/dlp/ + # docs/redacting-sensitive-data-images to learn more. When no InfoTypes or + # CustomInfoTypes are specified in this request, the system will automatically + # choose what detectors to run. By default this may be all types, but may change + # over time as detectors are updated. # @param [String] parent - # The parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # The parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest] google_privacy_dlp_v2_redact_image_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1962,15 +1841,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates an InspectTemplate for re-using frequently used configuration - # for inspecting content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Creates an InspectTemplate for re-using frequently used configuration for + # inspecting content, images, and storage. See https://cloud.google.com/dlp/docs/ + # creating-templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2001,13 +1878,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Deletes an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be deleted, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2035,13 +1911,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Gets an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be read, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2069,33 +1944,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists InspectTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Lists InspectTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListInspectTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListInspectTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2127,12 +1997,12 @@ module Google execute_or_queue_command(command, &block) end - # Updates the InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Updates the InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of organization and inspectTemplate to be updated, for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateInspectTemplateRequest] google_privacy_dlp_v2_update_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2163,11 +2033,11 @@ module Google execute_or_queue_command(command, &block) end - # Activate a job trigger. Causes the immediate execute of a trigger - # instead of waiting on the trigger event to occur. + # Activate a job trigger. Causes the immediate execute of a trigger instead of + # waiting on the trigger event to occur. # @param [String] name - # Required. Resource name of the trigger to activate, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the trigger to activate, for example `projects/dlp- + # test-project/jobTriggers/53234423`. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ActivateJobTriggerRequest] google_privacy_dlp_v2_activate_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2199,12 +2069,11 @@ module Google end # Creates a job trigger to run DLP actions such as scanning storage for - # sensitive information on a set schedule. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # sensitive information on a set schedule. See https://cloud.google.com/dlp/docs/ + # creating-job-triggers to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest] google_privacy_dlp_v2_create_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2235,11 +2104,11 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Deletes a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2267,11 +2136,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Gets a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2299,53 +2168,43 @@ module Google execute_or_queue_command(command, &block) end - # Lists job triggers. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Lists job triggers. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter - # Allows filtering. - # Supported syntax: - # * Filter expressions are made up of one or more restrictions. - # * Restrictions can be combined by `AND` or `OR` logical operators. A - # sequence of restrictions implicitly uses `AND`. - # * A restriction has the form of ``field` `operator` `value``. - # * Supported fields/values for inspect jobs: - # - `status` - HEALTHY|PAUSED|CANCELLED - # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - # - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by - # quotation marks. Nanoseconds are ignored. - # - 'error_count' - Number of errors that have occurred while running. - # * The operator must be `=` or `!=` for status and inspected_storage. - # Examples: - # * inspected_storage = cloud_storage AND status = HEALTHY - # * inspected_storage = cloud_storage OR inspected_storage = bigquery - # * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY) - # * last_run_time > \"2017-12-12T00:00:00+00:00\" - # The length of this field should be no more than 500 characters. + # Allows filtering. Supported syntax: * Filter expressions are made up of one or + # more restrictions. * Restrictions can be combined by `AND` or `OR` logical + # operators. A sequence of restrictions implicitly uses `AND`. * A restriction + # has the form of ``field` `operator` `value``. * Supported fields/values for + # inspect jobs: - `status` - HEALTHY|PAUSED|CANCELLED - `inspected_storage` - + # DATASTORE|CLOUD_STORAGE|BIGQUERY - 'last_run_time` - RFC 3339 formatted + # timestamp, surrounded by quotation marks. Nanoseconds are ignored. - ' + # error_count' - Number of errors that have occurred while running. * The + # operator must be `=` or `!=` for status and inspected_storage. Examples: * + # inspected_storage = cloud_storage AND status = HEALTHY * inspected_storage = + # cloud_storage OR inspected_storage = bigquery * inspected_storage = + # cloud_storage AND (state = PAUSED OR state = HEALTHY) * last_run_time > \"2017- + # 12-12T00:00:00+00:00\" The length of this field should be no more than 500 + # characters. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of triggeredJob fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the JobTrigger was created. - # - `update_time`: corresponds to time the JobTrigger was last updated. - # - `last_run_time`: corresponds to the last time the JobTrigger ran. - # - `name`: corresponds to JobTrigger's name. - # - `display_name`: corresponds to JobTrigger's display name. - # - `status`: corresponds to JobTrigger's status. + # Comma separated list of triggeredJob fields to order by, followed by `asc` or ` + # desc` postfix. This list is case-insensitive, default sorting order is + # ascending, redundant space characters are insignificant. Example: `name asc, + # update_time, create_time desc` Supported fields are: - `create_time`: + # corresponds to time the JobTrigger was created. - `update_time`: corresponds + # to time the JobTrigger was last updated. - `last_run_time`: corresponds to the + # last time the JobTrigger ran. - `name`: corresponds to JobTrigger's name. - ` + # display_name`: corresponds to JobTrigger's display name. - `status`: + # corresponds to JobTrigger's status. # @param [Fixnum] page_size # Size of the page, can be limited by a server. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to ListJobTriggers. `order_by` field must not - # change for subsequent calls. + # Page token to continue retrieval. Comes from previous call to ListJobTriggers. + # `order_by` field must not change for subsequent calls. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2378,11 +2237,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Updates a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateJobTriggerRequest] google_privacy_dlp_v2_update_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2413,17 +2272,15 @@ module Google execute_or_queue_command(command, &block) end - # De-identifies potentially sensitive info from a ContentItem. - # This method has limits on input size and output size. - # See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to - # learn more. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # De-identifies potentially sensitive info from a ContentItem. This method has + # limits on input size and output size. See https://cloud.google.com/dlp/docs/ + # deidentify-sensitive-data to learn more. When no InfoTypes or CustomInfoTypes + # are specified in this request, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. # @param [String] parent - # Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2DeidentifyContentRequest] google_privacy_dlp_v2_deidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2454,17 +2311,15 @@ module Google execute_or_queue_command(command, &block) end - # Finds potentially sensitive info in content. - # This method has limits on input size, processing time, and output size. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. - # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images - # and https://cloud.google.com/dlp/docs/inspecting-text, + # Finds potentially sensitive info in content. This method has limits on input + # size, processing time, and output size. When no InfoTypes or CustomInfoTypes + # are specified in this request, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. For how to guides, see https://cloud.google.com/dlp/ + # docs/inspecting-images and https://cloud.google.com/dlp/docs/inspecting-text, # @param [String] parent - # Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2InspectContentRequest] google_privacy_dlp_v2_inspect_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2495,15 +2350,12 @@ module Google execute_or_queue_command(command, &block) end - # Re-identifies content that has been de-identified. - # See - # https://cloud.google.com/dlp/docs/pseudonymization#re- - # identification_in_free_text_code_example - # to learn more. + # Re-identifies content that has been de-identified. See https://cloud.google. + # com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example to + # learn more. # @param [String] parent - # Required. The parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. The parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ReidentifyContentRequest] google_privacy_dlp_v2_reidentify_content_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2534,16 +2386,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates a DeidentifyTemplate for re-using frequently used configuration - # for de-identifying content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Creates a DeidentifyTemplate for re-using frequently used configuration for de- + # identifying content, images, and storage. See https://cloud.google.com/dlp/ + # docs/creating-templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDeidentifyTemplateRequest] google_privacy_dlp_v2_create_deidentify_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2574,14 +2423,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Deletes a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be - # deleted, - # for example `organizations/433245324/deidentifyTemplates/432452342` or - # projects/project-id/deidentifyTemplates/432452342. + # deleted, for example `organizations/433245324/deidentifyTemplates/432452342` + # or projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2609,13 +2456,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Gets a DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of the organization and deidentify template to be read, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2644,34 +2489,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists DeidentifyTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Lists DeidentifyTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListDeidentifyTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListDeidentifyTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2703,13 +2542,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the DeidentifyTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn - # more. + # Updates the DeidentifyTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates-deid to learn more. # @param [String] name # Required. Resource name of organization and deidentify template to be updated, - # for - # example `organizations/433245324/deidentifyTemplates/432452342` or + # for example `organizations/433245324/deidentifyTemplates/432452342` or # projects/project-id/deidentifyTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateDeidentifyTemplateRequest] google_privacy_dlp_v2_update_deidentify_template_request_object # @param [String] fields @@ -2741,11 +2578,10 @@ module Google execute_or_queue_command(command, &block) end - # Starts asynchronous cancellation on a long-running DlpJob. The server - # makes a best effort to cancel the DlpJob, but success is not - # guaranteed. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Starts asynchronous cancellation on a long-running DlpJob. The server makes a + # best effort to cancel the DlpJob, but success is not guaranteed. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource to be cancelled. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CancelDlpJobRequest] google_privacy_dlp_v2_cancel_dlp_job_request_object @@ -2778,16 +2614,15 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new job to inspect storage or calculate risk metrics. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. - # When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # Creates a new job to inspect storage or calculate risk metrics. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. When no InfoTypes or CustomInfoTypes + # are specified in inspect jobs, the system will automatically choose what + # detectors to run. By default this may be all types, but may change over time + # as detectors are updated. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateDlpJobRequest] google_privacy_dlp_v2_create_dlp_job_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2818,11 +2653,10 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a long-running DlpJob. This method indicates that the client is - # no longer interested in the DlpJob result. The job will be cancelled if - # possible. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Deletes a long-running DlpJob. This method indicates that the client is no + # longer interested in the DlpJob result. The job will be cancelled if possible. + # See https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud. + # google.com/dlp/docs/compute-risk-analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource to be deleted. # @param [String] fields @@ -2852,11 +2686,10 @@ module Google execute_or_queue_command(command, &block) end - # Finish a running hybrid DlpJob. Triggers the finalization steps and running - # of any enabled actions that have not yet run. - # Early access feature is in a pre-release state and might change or have - # limited support. For more information, see - # https://cloud.google.com/products#product-launch-stages. + # Finish a running hybrid DlpJob. Triggers the finalization steps and running of + # any enabled actions that have not yet run. Early access feature is in a pre- + # release state and might change or have limited support. For more information, + # see https://cloud.google.com/products#product-launch-stages. # @param [String] name # Required. The name of the DlpJob resource to be cancelled. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2FinishDlpJobRequest] google_privacy_dlp_v2_finish_dlp_job_request_object @@ -2889,9 +2722,9 @@ module Google execute_or_queue_command(command, &block) end - # Gets the latest state of a long-running DlpJob. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Gets the latest state of a long-running DlpJob. See https://cloud.google.com/ + # dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk- + # analysis to learn more. # @param [String] name # Required. The name of the DlpJob resource. # @param [String] fields @@ -2921,12 +2754,10 @@ module Google execute_or_queue_command(command, &block) end - # Inspect hybrid content and store findings to a job. - # To review the findings inspect the job. Inspection will occur - # asynchronously. - # Early access feature is in a pre-release state and might change or have - # limited support. For more information, see - # https://cloud.google.com/products#product-launch-stages. + # Inspect hybrid content and store findings to a job. To review the findings + # inspect the job. Inspection will occur asynchronously. Early access feature is + # in a pre-release state and might change or have limited support. For more + # information, see https://cloud.google.com/products#product-launch-stages. # @param [String] name # Required. Resource name of the job to execute a hybrid inspect on, for example # `projects/dlp-test-project/dlpJob/53234423`. @@ -2960,50 +2791,38 @@ module Google execute_or_queue_command(command, &block) end - # Lists DlpJobs that match the specified filter in the request. - # See https://cloud.google.com/dlp/docs/inspecting-storage and - # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more. + # Lists DlpJobs that match the specified filter in the request. See https:// + # cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/ + # docs/compute-risk-analysis to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter - # Allows filtering. - # Supported syntax: - # * Filter expressions are made up of one or more restrictions. - # * Restrictions can be combined by `AND` or `OR` logical operators. A - # sequence of restrictions implicitly uses `AND`. - # * A restriction has the form of ``field` `operator` `value``. - # * Supported fields/values for inspect jobs: - # - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - # - `trigger_name` - The resource name of the trigger that created job. - # - 'end_time` - Corresponds to time the job finished. - # - 'start_time` - Corresponds to time the job finished. - # * Supported fields for risk analysis jobs: - # - `state` - RUNNING|CANCELED|FINISHED|FAILED - # - 'end_time` - Corresponds to time the job finished. - # - 'start_time` - Corresponds to time the job finished. - # * The operator must be `=` or `!=`. - # Examples: - # * inspected_storage = cloud_storage AND state = done - # * inspected_storage = cloud_storage OR inspected_storage = bigquery - # * inspected_storage = cloud_storage AND (state = done OR state = canceled) - # * end_time > \"2017-12-12T00:00:00+00:00\" - # The length of this field should be no more than 500 characters. + # Allows filtering. Supported syntax: * Filter expressions are made up of one or + # more restrictions. * Restrictions can be combined by `AND` or `OR` logical + # operators. A sequence of restrictions implicitly uses `AND`. * A restriction + # has the form of ``field` `operator` `value``. * Supported fields/values for + # inspect jobs: - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED - ` + # inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - `trigger_name` - The + # resource name of the trigger that created job. - 'end_time` - Corresponds to + # time the job finished. - 'start_time` - Corresponds to time the job finished. * + # Supported fields for risk analysis jobs: - `state` - RUNNING|CANCELED| + # FINISHED|FAILED - 'end_time` - Corresponds to time the job finished. - ' + # start_time` - Corresponds to time the job finished. * The operator must be `=` + # or `!=`. Examples: * inspected_storage = cloud_storage AND state = done * + # inspected_storage = cloud_storage OR inspected_storage = bigquery * + # inspected_storage = cloud_storage AND (state = done OR state = canceled) * + # end_time > \"2017-12-12T00:00:00+00:00\" The length of this field should be no + # more than 500 characters. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, end_time asc, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the job was created. - # - `end_time`: corresponds to time the job ended. - # - `name`: corresponds to job's name. - # - `state`: corresponds to `state` + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, end_time asc, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the job was created. - `end_time`: corresponds to time the job ended. - `name`: + # corresponds to job's name. - `state`: corresponds to `state` # @param [Fixnum] page_size # The standard list page size. # @param [String] page_token @@ -3043,17 +2862,15 @@ module Google execute_or_queue_command(command, &block) end - # Redacts potentially sensitive info from an image. - # This method has limits on input size, processing time, and output size. - # See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to - # learn more. - # When no InfoTypes or CustomInfoTypes are specified in this request, the - # system will automatically choose what detectors to run. By default this may - # be all types, but may change over time as detectors are updated. + # Redacts potentially sensitive info from an image. This method has limits on + # input size, processing time, and output size. See https://cloud.google.com/dlp/ + # docs/redacting-sensitive-data-images to learn more. When no InfoTypes or + # CustomInfoTypes are specified in this request, the system will automatically + # choose what detectors to run. By default this may be all types, but may change + # over time as detectors are updated. # @param [String] parent - # The parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # The parent resource name. - Format:projects/[PROJECT-ID] - Format:projects/[ + # PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2RedactImageRequest] google_privacy_dlp_v2_redact_image_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3084,15 +2901,13 @@ module Google execute_or_queue_command(command, &block) end - # Creates an InspectTemplate for re-using frequently used configuration - # for inspecting content, images, and storage. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Creates an InspectTemplate for re-using frequently used configuration for + # inspecting content, images, and storage. See https://cloud.google.com/dlp/docs/ + # creating-templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateInspectTemplateRequest] google_privacy_dlp_v2_create_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3123,13 +2938,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Deletes an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be deleted, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3157,13 +2971,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets an InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Gets an InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of the organization and inspectTemplate to be read, - # for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # for example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3191,33 +3004,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists InspectTemplates. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Lists InspectTemplates. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the template was created. - # - `update_time`: corresponds to time the template was last updated. - # - `name`: corresponds to template's name. - # - `display_name`: corresponds to template's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc,update_time, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the template was created. - `update_time`: corresponds to time the template + # was last updated. - `name`: corresponds to template's name. - `display_name`: + # corresponds to template's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListInspectTemplates`. + # Page token to continue retrieval. Comes from previous call to ` + # ListInspectTemplates`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3249,12 +3057,12 @@ module Google execute_or_queue_command(command, &block) end - # Updates the InspectTemplate. - # See https://cloud.google.com/dlp/docs/creating-templates to learn more. + # Updates the InspectTemplate. See https://cloud.google.com/dlp/docs/creating- + # templates to learn more. # @param [String] name # Required. Resource name of organization and inspectTemplate to be updated, for - # example `organizations/433245324/inspectTemplates/432452342` or - # projects/project-id/inspectTemplates/432452342. + # example `organizations/433245324/inspectTemplates/432452342` or projects/ + # project-id/inspectTemplates/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateInspectTemplateRequest] google_privacy_dlp_v2_update_inspect_template_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3285,11 +3093,11 @@ module Google execute_or_queue_command(command, &block) end - # Activate a job trigger. Causes the immediate execute of a trigger - # instead of waiting on the trigger event to occur. + # Activate a job trigger. Causes the immediate execute of a trigger instead of + # waiting on the trigger event to occur. # @param [String] name - # Required. Resource name of the trigger to activate, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the trigger to activate, for example `projects/dlp- + # test-project/jobTriggers/53234423`. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2ActivateJobTriggerRequest] google_privacy_dlp_v2_activate_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3321,12 +3129,11 @@ module Google end # Creates a job trigger to run DLP actions such as scanning storage for - # sensitive information on a set schedule. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # sensitive information on a set schedule. See https://cloud.google.com/dlp/docs/ + # creating-job-triggers to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateJobTriggerRequest] google_privacy_dlp_v2_create_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3357,11 +3164,11 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Deletes a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3389,11 +3196,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Gets a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3421,16 +3228,14 @@ module Google execute_or_queue_command(command, &block) end - # Inspect hybrid content and store findings to a trigger. The inspection - # will be processed asynchronously. To review the findings monitor the - # jobs within the trigger. - # Early access feature is in a pre-release state and might change or have - # limited support. For more information, see - # https://cloud.google.com/products#product-launch-stages. + # Inspect hybrid content and store findings to a trigger. The inspection will be + # processed asynchronously. To review the findings monitor the jobs within the + # trigger. Early access feature is in a pre-release state and might change or + # have limited support. For more information, see https://cloud.google.com/ + # products#product-launch-stages. # @param [String] name # Required. Resource name of the trigger to execute a hybrid inspect on, for - # example - # `projects/dlp-test-project/jobTriggers/53234423`. + # example `projects/dlp-test-project/jobTriggers/53234423`. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2HybridInspectJobTriggerRequest] google_privacy_dlp_v2_hybrid_inspect_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3461,53 +3266,43 @@ module Google execute_or_queue_command(command, &block) end - # Lists job triggers. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Lists job triggers. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # projects/[PROJECT-ID]/locations/[LOCATION-ID] # @param [String] filter - # Allows filtering. - # Supported syntax: - # * Filter expressions are made up of one or more restrictions. - # * Restrictions can be combined by `AND` or `OR` logical operators. A - # sequence of restrictions implicitly uses `AND`. - # * A restriction has the form of ``field` `operator` `value``. - # * Supported fields/values for inspect jobs: - # - `status` - HEALTHY|PAUSED|CANCELLED - # - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY - # - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by - # quotation marks. Nanoseconds are ignored. - # - 'error_count' - Number of errors that have occurred while running. - # * The operator must be `=` or `!=` for status and inspected_storage. - # Examples: - # * inspected_storage = cloud_storage AND status = HEALTHY - # * inspected_storage = cloud_storage OR inspected_storage = bigquery - # * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY) - # * last_run_time > \"2017-12-12T00:00:00+00:00\" - # The length of this field should be no more than 500 characters. + # Allows filtering. Supported syntax: * Filter expressions are made up of one or + # more restrictions. * Restrictions can be combined by `AND` or `OR` logical + # operators. A sequence of restrictions implicitly uses `AND`. * A restriction + # has the form of ``field` `operator` `value``. * Supported fields/values for + # inspect jobs: - `status` - HEALTHY|PAUSED|CANCELLED - `inspected_storage` - + # DATASTORE|CLOUD_STORAGE|BIGQUERY - 'last_run_time` - RFC 3339 formatted + # timestamp, surrounded by quotation marks. Nanoseconds are ignored. - ' + # error_count' - Number of errors that have occurred while running. * The + # operator must be `=` or `!=` for status and inspected_storage. Examples: * + # inspected_storage = cloud_storage AND status = HEALTHY * inspected_storage = + # cloud_storage OR inspected_storage = bigquery * inspected_storage = + # cloud_storage AND (state = PAUSED OR state = HEALTHY) * last_run_time > \"2017- + # 12-12T00:00:00+00:00\" The length of this field should be no more than 500 + # characters. # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of triggeredJob fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc,update_time, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the JobTrigger was created. - # - `update_time`: corresponds to time the JobTrigger was last updated. - # - `last_run_time`: corresponds to the last time the JobTrigger ran. - # - `name`: corresponds to JobTrigger's name. - # - `display_name`: corresponds to JobTrigger's display name. - # - `status`: corresponds to JobTrigger's status. + # Comma separated list of triggeredJob fields to order by, followed by `asc` or ` + # desc` postfix. This list is case-insensitive, default sorting order is + # ascending, redundant space characters are insignificant. Example: `name asc, + # update_time, create_time desc` Supported fields are: - `create_time`: + # corresponds to time the JobTrigger was created. - `update_time`: corresponds + # to time the JobTrigger was last updated. - `last_run_time`: corresponds to the + # last time the JobTrigger ran. - `name`: corresponds to JobTrigger's name. - ` + # display_name`: corresponds to JobTrigger's display name. - `status`: + # corresponds to JobTrigger's status. # @param [Fixnum] page_size # Size of the page, can be limited by a server. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to ListJobTriggers. `order_by` field must not - # change for subsequent calls. + # Page token to continue retrieval. Comes from previous call to ListJobTriggers. + # `order_by` field must not change for subsequent calls. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3540,11 +3335,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates a job trigger. - # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more. + # Updates a job trigger. See https://cloud.google.com/dlp/docs/creating-job- + # triggers to learn more. # @param [String] name - # Required. Resource name of the project and the triggeredJob, for example - # `projects/dlp-test-project/jobTriggers/53234423`. + # Required. Resource name of the project and the triggeredJob, for example ` + # projects/dlp-test-project/jobTriggers/53234423`. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateJobTriggerRequest] google_privacy_dlp_v2_update_job_trigger_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3575,15 +3370,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a pre-built stored infoType to be used for inspection. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Creates a pre-built stored infoType to be used for inspection. See https:// + # cloud.google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3614,14 +3406,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Deletes a stored infoType. See https://cloud.google.com/dlp/docs/creating- + # stored-infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be deleted, - # for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # for example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3649,13 +3439,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Gets a stored infoType. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be read, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3683,35 +3472,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists stored infoTypes. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Lists stored infoTypes. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, display_name, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the most recent version of the - # resource was created. - # - `state`: corresponds to the state of the resource. - # - `name`: corresponds to resource name. - # - `display_name`: corresponds to info type's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, display_name, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the most recent version of the resource was created. - `state`: corresponds to + # the state of the resource. - `name`: corresponds to resource name. - ` + # display_name`: corresponds to info type's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListStoredInfoTypes`. + # Page token to continue retrieval. Comes from previous call to ` + # ListStoredInfoTypes`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3744,13 +3526,12 @@ module Google end # Updates the stored infoType by creating a new version. The existing version - # will continue to be used until the new version is ready. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # will continue to be used until the new version is ready. See https://cloud. + # google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] name # Required. Resource name of organization and storedInfoType to be updated, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateStoredInfoTypeRequest] google_privacy_dlp_v2_update_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3781,15 +3562,12 @@ module Google execute_or_queue_command(command, &block) end - # Creates a pre-built stored infoType to be used for inspection. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Creates a pre-built stored infoType to be used for inspection. See https:// + # cloud.google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2CreateStoredInfoTypeRequest] google_privacy_dlp_v2_create_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3820,14 +3598,12 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Deletes a stored infoType. See https://cloud.google.com/dlp/docs/creating- + # stored-infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be deleted, - # for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # for example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3855,13 +3631,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets a stored infoType. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Gets a stored infoType. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] name # Required. Resource name of the organization and storedInfoType to be read, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3889,35 +3664,28 @@ module Google execute_or_queue_command(command, &block) end - # Lists stored infoTypes. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # Lists stored infoTypes. See https://cloud.google.com/dlp/docs/creating-stored- + # infotypes to learn more. # @param [String] parent - # Required. Parent resource name. - # - Format:projects/[PROJECT-ID] - # - Format:organizations/[ORGANIZATION-ID] - # - Format:projects/[PROJECT-ID]/locations/[LOCATION-ID] - # - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] + # Required. Parent resource name. - Format:projects/[PROJECT-ID] - Format: + # organizations/[ORGANIZATION-ID] - Format:projects/[PROJECT-ID]/locations/[ + # LOCATION-ID] - Format:organizations/[ORGANIZATION-ID]/locations/[LOCATION-ID] # @param [String] location_id # Deprecated. This field has no effect. # @param [String] order_by - # Comma separated list of fields to order by, - # followed by `asc` or `desc` postfix. This list is case-insensitive, - # default sorting order is ascending, redundant space characters are - # insignificant. - # Example: `name asc, display_name, create_time desc` - # Supported fields are: - # - `create_time`: corresponds to time the most recent version of the - # resource was created. - # - `state`: corresponds to the state of the resource. - # - `name`: corresponds to resource name. - # - `display_name`: corresponds to info type's display name. + # Comma separated list of fields to order by, followed by `asc` or `desc` + # postfix. This list is case-insensitive, default sorting order is ascending, + # redundant space characters are insignificant. Example: `name asc, display_name, + # create_time desc` Supported fields are: - `create_time`: corresponds to time + # the most recent version of the resource was created. - `state`: corresponds to + # the state of the resource. - `name`: corresponds to resource name. - ` + # display_name`: corresponds to info type's display name. # @param [Fixnum] page_size - # Size of the page, can be limited by server. If zero server returns - # a page of max size 100. + # Size of the page, can be limited by server. If zero server returns a page of + # max size 100. # @param [String] page_token - # Page token to continue retrieval. Comes from previous call - # to `ListStoredInfoTypes`. + # Page token to continue retrieval. Comes from previous call to ` + # ListStoredInfoTypes`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3950,13 +3718,12 @@ module Google end # Updates the stored infoType by creating a new version. The existing version - # will continue to be used until the new version is ready. - # See https://cloud.google.com/dlp/docs/creating-stored-infotypes to - # learn more. + # will continue to be used until the new version is ready. See https://cloud. + # google.com/dlp/docs/creating-stored-infotypes to learn more. # @param [String] name # Required. Resource name of organization and storedInfoType to be updated, for - # example `organizations/433245324/storedInfoTypes/432452342` or - # projects/project-id/storedInfoTypes/432452342. + # example `organizations/433245324/storedInfoTypes/432452342` or projects/ + # project-id/storedInfoTypes/432452342. # @param [Google::Apis::DlpV2::GooglePrivacyDlpV2UpdateStoredInfoTypeRequest] google_privacy_dlp_v2_update_stored_info_type_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. diff --git a/generated/google/apis/logging_v2.rb b/generated/google/apis/logging_v2.rb index 0e8859efd..1762e475e 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 = '20200724' + REVISION = '20200801' # 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 015cf37e2..15fae9baa 100644 --- a/generated/google/apis/logging_v2/classes.rb +++ b/generated/google/apis/logging_v2/classes.rb @@ -76,7 +76,7 @@ module Google # Specifies a set of buckets with arbitrary widths.There are size(bounds) + 1 (= # N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N-1): - # boundsi Lower bound (1 <= i < N); boundsi - 1The bounds field must contain at + # boundsi Lower bound (1 <= i < N); boundsi - 1The bounds field must contain at # least one element. If bounds has only one element, then there are no finite # buckets, and that single element is the common boundary of the overflow and # underflow buckets. @@ -88,7 +88,7 @@ module Google # proportional to the value of the lower bound. Each bucket represents a # constant relative uncertainty on a specific value in the bucket.There are # num_finite_buckets + 2 (= N) buckets. Bucket i has the following boundaries: - # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < + # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < # N): scale * (growth_factor ^ (i - 1)). # Corresponds to the JSON property `exponentialBuckets` # @return [Google::Apis::LoggingV2::Exponential] @@ -98,8 +98,7 @@ module Google # overflow and underflow). Each bucket represents a constant absolute # uncertainty on the specific value in the bucket.There are num_finite_buckets + # 2 (= N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N- - # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)) - # . + # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)). # Corresponds to the JSON property `linearBuckets` # @return [Google::Apis::LoggingV2::Linear] attr_accessor :linear_buckets @@ -125,9 +124,9 @@ module Google class CmekSettings include Google::Apis::Core::Hashable - # The resource name for the configured Cloud KMS key.KMS key name format: " + # The resource name for the configured Cloud KMS key.KMS key name format: " # projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY"For - # example: "projects/my-project-id/locations/my-region/keyRings/key-ring-name/ + # example: "projects/my-project-id/locations/my-region/keyRings/key-ring-name/ # cryptoKeys/key-name"To enable CMEK for the Logs Router, set this field to a # valid kms_key_name for which the associated service account has the required # roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud @@ -173,11 +172,9 @@ module Google # 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 ``. + # 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 @@ -192,7 +189,7 @@ module Google # Specifies a set of buckets with arbitrary widths.There are size(bounds) + 1 (= # N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N-1): - # boundsi Lower bound (1 <= i < N); boundsi - 1The bounds field must contain at + # boundsi Lower bound (1 <= i < N); boundsi - 1The bounds field must contain at # least one element. If bounds has only one element, then there are no finite # buckets, and that single element is the common boundary of the overflow and # underflow buckets. @@ -218,7 +215,7 @@ module Google # proportional to the value of the lower bound. Each bucket represents a # constant relative uncertainty on a specific value in the bucket.There are # num_finite_buckets + 2 (= N) buckets. Bucket i has the following boundaries: - # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < + # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower bound (1 <= i < # N): scale * (growth_factor ^ (i - 1)). class Exponential include Google::Apis::Core::Hashable @@ -339,8 +336,7 @@ module Google attr_accessor :status # The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE 6.0; - # Windows 98; Q312461; .NET - # CLR 1.0.3705)". + # Windows 98; Q312461; .NET CLR 1.0.3705)". # Corresponds to the JSON property `userAgent` # @return [String] attr_accessor :user_agent @@ -404,8 +400,7 @@ module Google # overflow and underflow). Each bucket represents a constant absolute # uncertainty on the specific value in the bucket.There are num_finite_buckets + # 2 (= N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i < N- - # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)) - # . + # 1): offset + (width * i). Lower bound (1 <= i < N): offset + (width * (i - 1)). class Linear include Google::Apis::Core::Hashable @@ -538,12 +533,9 @@ module Google attr_accessor :project_ids # Required. Names of one or more parent resources from which to retrieve log - # entries: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Projects listed in the project_ids field are added to this list. + # entries: "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" " + # billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Projects listed in + # the project_ids field are added to this list. # Corresponds to the JSON property `resourceNames` # @return [Array] attr_accessor :resource_names @@ -727,11 +719,17 @@ module Google # @return [String] attr_accessor :lifecycle_state + # Whether the bucket has been locked. The retention period on a locked bucket + # may not be changed. Locked buckets may only be deleted if they are empty. + # Corresponds to the JSON property `locked` + # @return [Boolean] + attr_accessor :locked + alias_method :locked?, :locked + # The resource name of the bucket. For example: "projects/my-project-id/ - # locations/my-location/buckets/my-bucket-id The supported locations are: " - # global" "us-central1"For the location of global it is unspecified where logs - # are actually stored. Once a bucket has been created, the location can not be - # changed. + # locations/my-location/buckets/my-bucket-id The supported locations are: " + # global"For the location of global it is unspecified where logs are actually + # stored. Once a bucket has been created, the location can not be changed. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -758,6 +756,7 @@ module Google @create_time = args[:create_time] if args.key?(:create_time) @description = args[:description] if args.key?(:description) @lifecycle_state = args[:lifecycle_state] if args.key?(:lifecycle_state) + @locked = args[:locked] if args.key?(:locked) @name = args[:name] if args.key?(:name) @retention_days = args[:retention_days] if args.key?(:retention_days) @update_time = args[:update_time] if args.key?(:update_time) @@ -780,7 +779,7 @@ module Google # timestamp, and with the same insert_id to be duplicates which are removed in a # single query result. However, there are no guarantees of de-duplication in the # export of logs.If the insert_id is omitted when writing a log entry, the - # Logging API assigns its own unique identifier in this field.In queries, the + # Logging API assigns its own unique identifier in this field.In queries, the # insert_id is also used to order log entries that have the same log_name and # timestamp values. # Corresponds to the JSON property `insertId` @@ -799,22 +798,20 @@ module Google # @return [Hash] attr_accessor :labels - # Required. The resource name of the log to which this log entry belongs: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # A project number may be used in place of PROJECT_ID. The project number is - # translated to its corresponding PROJECT_ID internally and the log_name field - # will contain PROJECT_ID in queries and exports.[LOG_ID] must be URL-encoded - # within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager. - # googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and - # can only include the following characters: upper and lower case alphanumeric - # characters, forward-slash, underscore, hyphen, and period.For backward - # compatibility, if log_name begins with a forward-slash, such as /projects/..., - # then the log entry is ingested as usual but the forward-slash is removed. - # Listing the log entry will not show the leading slash and filtering for a log - # name with a leading slash will never return any results. + # Required. The resource name of the log to which this log entry belongs: " + # projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[ + # LOG_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[ + # FOLDER_ID]/logs/[LOG_ID]" A project number may be used in place of PROJECT_ID. + # The project number is translated to its corresponding PROJECT_ID internally + # and the log_name field will contain PROJECT_ID in queries and exports.[LOG_ID] + # must be URL-encoded within log_name. Example: "organizations/1234567890/logs/ + # cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than + # 512 characters long and can only include the following characters: upper and + # lower case alphanumeric characters, forward-slash, underscore, hyphen, and + # period.For backward compatibility, if log_name begins with a forward-slash, + # such as /projects/..., then the log entry is ingested as usual but the forward- + # slash is removed. Listing the log entry will not show the leading slash and + # filtering for a log name with a leading slash will never return any results. # Corresponds to the JSON property `logName` # @return [String] attr_accessor :log_name @@ -837,7 +834,7 @@ module Google # The log entry payload, represented as a protocol buffer. Some Google Cloud # Platform services use this field for their log entry payloads.The following # protocol buffer types are supported; user-defined types are not supported:" - # type.googleapis.com/google.cloud.audit.AuditLog" "type.googleapis.com/google. + # type.googleapis.com/google.cloud.audit.AuditLog" "type.googleapis.com/google. # appengine.logging.v1.RequestLog" # Corresponds to the JSON property `protoPayload` # @return [Hash] @@ -856,10 +853,8 @@ module Google # attributes according to the schema. For example, a particular Compute Engine # VM instance could be represented by the following object, because the # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and " - # zone": - # ` "type": "gce_instance", - # "labels": ` "instance_id": "12345678901234", - # "zone": "us-central1-a" `` + # zone": ` "type": "gce_instance", "labels": ` "instance_id": "12345678901234", " + # zone": "us-central1-a" `` # Corresponds to the JSON property `resource` # @return [Google::Apis::LoggingV2::MonitoredResource] attr_accessor :resource @@ -1170,9 +1165,9 @@ module Google attr_accessor :description # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/ - # advanced_filters) which is used to match log entries. Example: - # "resource.type=gae_app AND severity>=ERROR" - # The maximum length of the filter is 20000 characters. + # advanced_filters) which is used to match log entries. Example: "resource.type= + # gae_app AND severity>=ERROR" The maximum length of the filter is 20000 + # characters. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter @@ -1194,14 +1189,12 @@ module Google # Defines a metric type and its schema. Once a metric descriptor is created, # 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 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/ - # monitoring/quotas + # Monitoring metric descriptors: 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/monitoring/quotas # Corresponds to the JSON property `metricDescriptor` # @return [Google::Apis::LoggingV2::MetricDescriptor] attr_accessor :metric_descriptor @@ -1228,15 +1221,15 @@ module Google # Optional. A value_extractor is required when using a distribution logs-based # metric to extract the values to record from a log entry. Two functions are # supported for value extraction: EXTRACT(field) or REGEXP_EXTRACT(field, regex). - # The argument are: 1. field: The name of the log entry field from which the - # value is to be extracted. 2. regex: A regular expression using the Google - # RE2 syntax (https://github.com/google/re2/wiki/Syntax) with a single capture - # group to extract data from the specified log entry field. The value of the - # field is converted to a string before applying the regex. It is an error to - # specify a regex that does not include exactly one capture group.The result of - # the extraction must be convertible to a double type, as the distribution - # always records double values. If either the extraction or the conversion to - # double fails, then those values are not recorded in the distribution.Example: + # The argument are: 1. field: The name of the log entry field from which the + # value is to be extracted. 2. regex: A regular expression using the Google RE2 + # syntax (https://github.com/google/re2/wiki/Syntax) with a single capture group + # to extract data from the specified log entry field. The value of the field is + # converted to a string before applying the regex. It is an error to specify a + # regex that does not include exactly one capture group.The result of the + # extraction must be convertible to a double type, as the distribution always + # records double values. If either the extraction or the conversion to double + # fails, then those values are not recorded in the distribution.Example: # REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*") # Corresponds to the JSON property `valueExtractor` # @return [String] @@ -1292,12 +1285,11 @@ module Google # @return [String] attr_accessor :description - # Required. The export destination: - # "storage.googleapis.com/[GCS_BUCKET]" - # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]" - # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]" - # The sink's writer_identity, set when the sink is created, must have permission - # to write to the destination or else the log entries are not exported. For more + # Required. The export destination: "storage.googleapis.com/[GCS_BUCKET]" " + # bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]" "pubsub. + # googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]" The sink's + # writer_identity, set when the sink is created, must have permission to write + # to the destination or else the log entries are not exported. For more # information, see Exporting Logs with Sinks (https://cloud.google.com/logging/ # docs/api/tasks/exporting-logs). # Corresponds to the JSON property `destination` @@ -1311,10 +1303,17 @@ module Google attr_accessor :disabled alias_method :disabled?, :disabled + # Optional. Log entries that match any of the exclusion filters will not be + # exported. If a log entry is matched by both filter and one of + # exclusion_filters it will not be exported. + # Corresponds to the JSON property `exclusions` + # @return [Array] + attr_accessor :exclusions + # Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/ # advanced-queries). The only exported log entries are those that are in the - # resource owning the sink and that match the filter. For example: - # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR + # resource owning the sink and that match the filter. For example: logName=" + # projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter @@ -1328,9 +1327,8 @@ module Google # if this field is true, then the filter resource.type=gce_instance would export # all Compute Engine VM instance log entries from all projects in the sink's # parent. To only export entries from certain child projects, filter on the - # project part of the log name: - # logName:("projects/test-project1/" OR "projects/test-project2/") AND - # resource.type=gce_instance + # project part of the log name: logName:("projects/test-project1/" OR "projects/ + # test-project2/") AND resource.type=gce_instance # Corresponds to the JSON property `includeChildren` # @return [Boolean] attr_accessor :include_children @@ -1356,16 +1354,15 @@ module Google # @return [String] attr_accessor :update_time - # Output only. An IAM identity—a service account or group—under - # which Logging writes the exported log entries to the sink's destination. This - # field is set by sinks.create and sinks.update based on the value of - # unique_writer_identity in those methods.Until you grant this identity write- - # access to the destination, log entry exports from this sink will fail. For - # more information, see Granting Access for a Resource (https://cloud.google.com/ - # iam/docs/granting-roles-to-service-accounts# - # granting_access_to_a_service_account_for_a_resource). Consult the destination - # service's documentation to determine the appropriate IAM roles to assign to - # the identity. + # Output only. An IAM identity—a service account or group—under which Logging + # writes the exported log entries to the sink's destination. This field is set + # by sinks.create and sinks.update based on the value of unique_writer_identity + # in those methods.Until you grant this identity write-access to the destination, + # log entry exports from this sink will fail. For more information, see + # Granting Access for a Resource (https://cloud.google.com/iam/docs/granting- + # roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource). + # Consult the destination service's documentation to determine the appropriate + # IAM roles to assign to the identity. # Corresponds to the JSON property `writerIdentity` # @return [String] attr_accessor :writer_identity @@ -1381,6 +1378,7 @@ module Google @description = args[:description] if args.key?(:description) @destination = args[:destination] if args.key?(:destination) @disabled = args[:disabled] if args.key?(:disabled) + @exclusions = args[:exclusions] if args.key?(:exclusions) @filter = args[:filter] if args.key?(:filter) @include_children = args[:include_children] if args.key?(:include_children) @name = args[:name] if args.key?(:name) @@ -1393,14 +1391,12 @@ module Google # Defines a metric type and its schema. Once a metric descriptor is created, # 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 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/ - # monitoring/quotas + # Monitoring metric descriptors: 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/monitoring/quotas class MetricDescriptor include Google::Apis::Core::Hashable @@ -1418,10 +1414,9 @@ module Google attr_accessor :display_name # The set of labels that can be used to describe a specific instance of this - # metric type.The label key name must follow: - # Only upper and lower-case letters, digits and underscores (_) are allowed. - # Label name must start with a letter or digit. - # The maximum length of a label name is 100 characters.For example, the + # metric type.The label key name must follow: Only upper and lower-case letters, + # digits and underscores (_) are allowed. Label name must start with a letter or + # digit. The maximum length of a label name is 100 characters.For example, the # appengine.googleapis.com/http/server/response_latencies metric type has a # label for the HTTP response code, response_code, so you can look at latencies # for successful responses or just for responses that failed. @@ -1461,16 +1456,14 @@ module Google # The metric type, including its DNS name prefix. The type is not URL-encoded. # All service defined metrics must be prefixed with the service name, in the # format of `service name`/`relative metric name`, such as cloudsql.googleapis. - # com/database/cpu/utilization. The relative metric name must follow: - # Only upper and lower-case letters, digits, '/' and underscores '_' are - # allowed. - # The maximum number of characters allowed for the relative_metric_name is 100. - # All user-defined metric types have the DNS name custom.googleapis.com, - # external.googleapis.com, or logging.googleapis.com/user/.Metric types should - # use a natural hierarchical grouping. For example: - # "custom.googleapis.com/invoice/paid/amount" - # "external.googleapis.com/prometheus/up" - # "appengine.googleapis.com/http/server/response_latencies" + # com/database/cpu/utilization. The relative metric name must follow: Only upper + # and lower-case letters, digits, '/' and underscores '_' are allowed. The + # maximum number of characters allowed for the relative_metric_name is 100.All + # user-defined metric types have the DNS name custom.googleapis.com, external. + # googleapis.com, or logging.googleapis.com/user/.Metric types should use a + # natural hierarchical grouping. For example: "custom.googleapis.com/invoice/ + # paid/amount" "external.googleapis.com/prometheus/up" "appengine.googleapis.com/ + # http/server/response_latencies" # Corresponds to the JSON property `type` # @return [String] attr_accessor :type @@ -1489,65 +1482,34 @@ module Google # a DOUBLE CUMULATIVE metric whose unit is ks`CPU`, and then write the value 12. # 005 (which is 12005/1000), or use Kis`CPU` and write 11.723 (which is 12005/ # 1024).The supported units are a subset of The Unified Code for Units of - # Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT) - # bit bit - # By byte - # s second - # min minute - # h hour - # d day - # 1 dimensionlessPrefixes (PREFIX) - # k kilo (10^3) - # M mega (10^6) - # G giga (10^9) - # T tera (10^12) - # P peta (10^15) - # E exa (10^18) - # Z zetta (10^21) - # Y yotta (10^24) - # m milli (10^-3) - # u micro (10^-6) - # n nano (10^-9) - # p pico (10^-12) - # f femto (10^-15) - # a atto (10^-18) - # z zepto (10^-21) - # y yocto (10^-24) - # Ki kibi (2^10) - # Mi mebi (2^20) - # Gi gibi (2^30) - # Ti tebi (2^40) - # Pi pebi (2^50)GrammarThe grammar also includes these connectors: - # / division or ratio (as an infix operator). For examples, kBy/`email` or MiBy/ - # 10ms (although you should almost never have /s in a metric unit; rates should - # always be computed at query time from the underlying cumulative or delta - # value). - # . multiplication or composition (as an infix operator). For examples, GBy.d - # or k`watt`.h.The grammar for a unit is as follows: - # Expression = Component ` "." Component ` ` "/" Component ` ; - # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] - # | Annotation - # | "1" - # ; - # Annotation = "`" NAME "`" ; - # Notes: - # Annotation is just a comment if it follows a UNIT. If the annotation is used - # alone, then the unit is equivalent to 1. For examples, `request`/s == 1/s, By` - # transmitted`/s == By/s. - # NAME is a sequence of non-blank printable ASCII characters not containing ` - # or `. - # 1 represents a unitary dimensionless unit (https://en.wikipedia.org/wiki/ - # Dimensionless_quantity) of 1, such as in 1/s. It is typically used when none - # of the basic units are appropriate. For example, "new users per day" can be - # represented as 1/d or `new-users`/d (and a metric value 5 would mean "5 new - # users). Alternatively, "thousands of page views per day" would be represented - # as 1000/d or k1/d or k`page_views`/d (and a metric value of 5.3 would mean " - # 5300 page views per day"). - # % represents dimensionless value of 1/100, and annotates values giving a - # percentage (so the metric values are typically in the range of 0..100, and a - # metric value 3 means "3 percent"). - # 10^2.% indicates a metric contains a ratio, typically in the range 0..1, that - # will be multiplied by 100 and displayed as a percentage (so a metric value 0. + # Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT) bit + # bit By byte s second min minute h hour d day 1 dimensionlessPrefixes (PREFIX) + # k kilo (10^3) M mega (10^6) G giga (10^9) T tera (10^12) P peta (10^15) E exa ( + # 10^18) Z zetta (10^21) Y yotta (10^24) m milli (10^-3) u micro (10^-6) n nano ( + # 10^-9) p pico (10^-12) f femto (10^-15) a atto (10^-18) z zepto (10^-21) y + # yocto (10^-24) Ki kibi (2^10) Mi mebi (2^20) Gi gibi (2^30) Ti tebi (2^40) Pi + # pebi (2^50)GrammarThe grammar also includes these connectors: / division or + # ratio (as an infix operator). For examples, kBy/`email` or MiBy/10ms (although + # you should almost never have /s in a metric unit; rates should always be + # computed at query time from the underlying cumulative or delta value). . + # multiplication or composition (as an infix operator). For examples, GBy.d or k` + # watt`.h.The grammar for a unit is as follows: Expression = Component ` "." + # Component ` ` "/" Component ` ; Component = ( [ PREFIX ] UNIT | "%" ) [ + # Annotation ] | Annotation | "1" ; Annotation = "`" NAME "`" ; Notes: + # Annotation is just a comment if it follows a UNIT. If the annotation is used + # alone, then the unit is equivalent to 1. For examples, `request`/s == 1/s, By` + # transmitted`/s == By/s. NAME is a sequence of non-blank printable ASCII + # characters not containing ` or `. 1 represents a unitary dimensionless unit ( + # https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such as in 1/s. It + # is typically used when none of the basic units are appropriate. For example, " + # new users per day" can be represented as 1/d or `new-users`/d (and a metric + # value 5 would mean "5 new users). Alternatively, "thousands of page views per + # day" would be represented as 1000/d or k1/d or k`page_views`/d (and a metric + # value of 5.3 would mean "5300 page views per day"). % represents dimensionless + # value of 1/100, and annotates values giving a percentage (so the metric values + # are typically in the range of 0..100, and a metric value 3 means "3 percent"). + # 10^2.% indicates a metric contains a ratio, typically in the range 0..1, that + # will be multiplied by 100 and displayed as a percentage (so a metric value 0. # 03 means "3 percent"). # Corresponds to the JSON property `unit` # @return [String] @@ -1623,10 +1585,8 @@ module Google # attributes according to the schema. For example, a particular Compute Engine # VM instance could be represented by the following object, because the # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and " - # zone": - # ` "type": "gce_instance", - # "labels": ` "instance_id": "12345678901234", - # "zone": "us-central1-a" `` + # zone": ` "type": "gce_instance", "labels": ` "instance_id": "12345678901234", " + # zone": "us-central1-a" `` class MonitoredResource include Google::Apis::Core::Hashable @@ -1661,18 +1621,14 @@ module Google # the use of the labels "instance_id" and "zone" to identify particular VM # instances.Different services can support different monitored resource types. # The following are specific rules to service defined monitored resources for - # Monitoring and Logging: - # The type, display_name, description, labels and launch_stage fields are all - # required. - # The first label of the monitored resource descriptor must be - # resource_container. There are legacy monitored resource descritptors start - # with project_id. - # It must include a location label. - # Maximum of default 5 service defined monitored resource descriptors is - # allowed per service. - # Maximum of default 10 labels per monitored resource is allowed.The default - # maximum limit can be overridden. Please follow https://cloud.google.com/ - # monitoring/quotas + # Monitoring and Logging: The type, display_name, description, labels and + # launch_stage fields are all required. The first label of the monitored + # resource descriptor must be resource_container. There are legacy monitored + # resource descritptors start with project_id. It must include a location label. + # Maximum of default 5 service defined monitored resource descriptors is allowed + # per service. Maximum of default 10 labels per monitored resource is allowed. + # The default maximum limit can be overridden. Please follow https://cloud. + # google.com/monitoring/quotas class MonitoredResourceDescriptor include Google::Apis::Core::Hashable @@ -1690,12 +1646,11 @@ module Google attr_accessor :display_name # Required. A set of labels used to describe instances of this monitored - # resource type. The label key name must follow: - # Only upper and lower-case letters, digits and underscores (_) are allowed. - # Label name must start with a letter or digit. - # The maximum length of a label name is 100 characters.For example, an - # individual Google Cloud SQL database is identified by values for the labels - # database_id and location. + # resource type. The label key name must follow: Only upper and lower-case + # letters, digits and underscores (_) are allowed. Label name must start with a + # letter or digit. The maximum length of a label name is 100 characters.For + # example, an individual Google Cloud SQL database is identified by values for + # the labels database_id and location. # Corresponds to the JSON property `labels` # @return [Array] attr_accessor :labels @@ -1719,11 +1674,10 @@ module Google # represents databases in Google Cloud SQL.All service defined monitored # resource types must be prefixed with the service name, in the format of ` # service name`/`relative resource name`. The relative resource name must follow: - # Only upper and lower-case letters and digits are allowed. - # It must start with upper case character and is recommended to use Upper Camel - # Case style. - # The maximum number of characters allowed for the relative_resource_name is - # 100.Note there are legacy service monitored resources not following this rule. + # Only upper and lower-case letters and digits are allowed. It must start with + # upper case character and is recommended to use Upper Camel Case style. The + # maximum number of characters allowed for the relative_resource_name is 100. + # Note there are legacy service monitored resources not following this rule. # Corresponds to the JSON property `type` # @return [String] attr_accessor :type @@ -1754,10 +1708,8 @@ module Google # Output only. Values for predefined system metadata labels. System labels are a # kind of metadata extracted by Google, including "machine_image", "vpc", " # subnet_id", "security_group", "name", etc. System label values can be only - # strings, Boolean values, or a list of strings. For example: - # ` "name": "my-test-instance", - # "security_group": ["a", "b", "c"], - # "spot_instance": false ` + # strings, Boolean values, or a list of strings. For example: ` "name": "my-test- + # instance", "security_group": ["a", "b", "c"], "spot_instance": false ` # Corresponds to the JSON property `systemLabels` # @return [Hash] attr_accessor :system_labels @@ -2073,6 +2025,19 @@ module Google end end + # The parameters to UndeleteBucket. + class UndeleteBucketRequest + include Google::Apis::Core::Hashable + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + end + end + # The parameters to WriteLogEntries. class WriteLogEntriesRequest include Google::Apis::Core::Hashable @@ -2114,14 +2079,11 @@ module Google attr_accessor :labels # Optional. A default log resource name that is assigned to all log entries in - # entries that do not specify a value for log_name: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example: - # "projects/my-project-id/logs/syslog" - # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" + # entries that do not specify a value for log_name: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example: "projects/my-project-id/logs/syslog" " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" # The permission logging.logEntries.create is needed on each project, # organization, billing account, or folder that is receiving new log entries, # whether the resource is specified in logName or in an individual log entry. @@ -2147,10 +2109,8 @@ module Google # attributes according to the schema. For example, a particular Compute Engine # VM instance could be represented by the following object, because the # MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and " - # zone": - # ` "type": "gce_instance", - # "labels": ` "instance_id": "12345678901234", - # "zone": "us-central1-a" `` + # zone": ` "type": "gce_instance", "labels": ` "instance_id": "12345678901234", " + # zone": "us-central1-a" `` # Corresponds to the JSON property `resource` # @return [Google::Apis::LoggingV2::MonitoredResource] attr_accessor :resource diff --git a/generated/google/apis/logging_v2/representations.rb b/generated/google/apis/logging_v2/representations.rb index bfe7fc608..56bc6f498 100644 --- a/generated/google/apis/logging_v2/representations.rb +++ b/generated/google/apis/logging_v2/representations.rb @@ -220,6 +220,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class UndeleteBucketRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class WriteLogEntriesRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -402,6 +408,7 @@ module Google property :create_time, as: 'createTime' property :description, as: 'description' property :lifecycle_state, as: 'lifecycleState' + property :locked, as: 'locked' property :name, as: 'name' property :retention_days, as: 'retentionDays' property :update_time, as: 'updateTime' @@ -505,6 +512,8 @@ module Google property :description, as: 'description' property :destination, as: 'destination' property :disabled, as: 'disabled' + collection :exclusions, as: 'exclusions', class: Google::Apis::LoggingV2::LogExclusion, decorator: Google::Apis::LoggingV2::LogExclusion::Representation + property :filter, as: 'filter' property :include_children, as: 'includeChildren' property :name, as: 'name' @@ -629,6 +638,12 @@ module Google end end + class UndeleteBucketRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + end + end + class WriteLogEntriesRequest # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/logging_v2/service.rb b/generated/google/apis/logging_v2/service.rb index 62eb19ab4..de7af15c8 100644 --- a/generated/google/apis/logging_v2/service.rb +++ b/generated/google/apis/logging_v2/service.rb @@ -52,13 +52,12 @@ module Google # Gets a bucket (Beta). # @param [String] name - # Required. The resource name of the bucket: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". + # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/ + # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/ + # my-location/buckets/my-bucket-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -90,12 +89,10 @@ module Google # belonging to that resource can be excluded. You can have up to 10 exclusions # in a resource. # @param [String] parent - # Required. The parent resource in which to create the exclusion: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The parent resource in which to create the exclusion: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging- + # project", "organizations/123456789". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -128,12 +125,11 @@ module Google # Deletes an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion to delete: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion to delete: "projects/[ + # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/ + # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[ + # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: " + # projects/my-project-id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -163,12 +159,11 @@ module Google # Gets the description of an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -198,11 +193,9 @@ module Google # Lists all the exclusions in a parent resource. # @param [String] parent - # Required. The parent resource whose exclusions are to be listed. - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose exclusions are to be listed. "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -243,12 +236,11 @@ module Google # Changes one or more properties of an existing exclusion. # @param [String] name - # Required. The resource name of the exclusion to update: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] update_mask # Required. A non-empty list of fields to change in the existing exclusion. New @@ -287,15 +279,92 @@ module Google execute_or_queue_command(command, &block) end + # Creates a bucket that can be used to store log entries. Once a bucket has been + # created, the region cannot be changed. + # @param [String] parent + # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/ + # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/ + # global" + # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object + # @param [String] bucket_id + # Required. A client-assigned identifier such as "my-bucket". Identifiers are + # limited to 100 characters and can include only letters, digits, underscores, + # hyphens, and periods. + # @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::LoggingV2::LogBucket] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::LogBucket] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_billing_account_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+parent}/buckets', options) + command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.request_object = log_bucket_object + command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.response_class = Google::Apis::LoggingV2::LogBucket + command.params['parent'] = parent unless parent.nil? + command.query['bucketId'] = bucket_id unless bucket_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days, + # the bucket will be purged and all logs in the bucket will be permanently + # deleted. + # @param [String] name + # Required. The full resource name of the bucket to delete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_billing_account_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v2/{+name}', options) + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 buckets (Beta). # @param [String] parent - # Required. The parent resource whose buckets are to be listed: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]" - # Note: The locations portion of the resource must be specified, but supplying - # the character - in place of LOCATION_ID will return all buckets. + # Required. The parent resource whose buckets are to be listed: "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/ + # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[ + # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The + # locations portion of the resource must be specified, but supplying the + # character - in place of LOCATION_ID will return all buckets. # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -341,15 +410,13 @@ module Google # FAILED_PRECONDITION will be returned.A buckets region may not be modified # after it is created. This method is in Beta. # @param [String] name - # Required. The full resource name of the bucket to update. - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". - # Also requires permission "resourcemanager.projects.updateLiens" to set the - # locked property + # Required. The full resource name of the bucket to update. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". Also requires + # permission "resourcemanager.projects.updateLiens" to set the locked property # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object # @param [String] update_mask # Required. Field mask that specifies the fields in bucket that need an update. @@ -387,19 +454,56 @@ module Google execute_or_queue_command(command, &block) end + # Undeletes a bucket. A bucket that has been deleted may be undeleted within the + # grace period of 7 days. + # @param [String] name + # Required. The full resource name of the bucket to undelete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @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 undelete_billing_account_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+name}:undelete', options) + command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation + command.request_object = undelete_bucket_request_object + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 + # Deletes all the log entries in a log. The log reappears if it receives new # entries. Log entries written shortly before the delete operation might not be # deleted. Entries received after the delete operation with a timestamp before # the operation will be deleted. # @param [String] log_name - # Required. The resource name of the log to delete: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" - # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com% - # 2Factivity". For more information about log names, see LogEntry. + # Required. The resource name of the log to delete: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example, "projects/my-project-id/logs/syslog", " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". + # For more information about log names, see LogEntry. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -430,11 +534,9 @@ module Google # Lists the logs in projects, organizations, folders, or billing accounts. Only # logs that have entries are listed. # @param [String] parent - # Required. The resource name that owns the logs: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The resource name that owns the logs: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -478,12 +580,10 @@ module Google # writer_identity is not permitted to write to the destination. A sink can # export log entries only from the resource owning the sink. # @param [String] parent - # Required. The resource in which to create the sink: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/ + # 123456789". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. Determines the kind of IAM identity returned as writer_identity in @@ -529,11 +629,9 @@ module Google # account is also deleted. # @param [String] sink_name # Required. The full resource name of the sink to delete, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -564,11 +662,9 @@ module Google # Gets a sink. # @param [String] sink_name - # Required. The resource name of the sink: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID] + # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -599,11 +695,9 @@ module Google # Lists sinks. # @param [String] parent - # Required. The parent resource whose sinks are to be listed: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose sinks are to be listed: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -647,23 +741,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -709,23 +800,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -836,12 +924,10 @@ module Google # belonging to that resource can be excluded. You can have up to 10 exclusions # in a resource. # @param [String] parent - # Required. The parent resource in which to create the exclusion: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The parent resource in which to create the exclusion: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging- + # project", "organizations/123456789". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -874,12 +960,11 @@ module Google # Deletes an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion to delete: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion to delete: "projects/[ + # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/ + # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[ + # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: " + # projects/my-project-id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -909,12 +994,11 @@ module Google # Gets the description of an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -944,11 +1028,9 @@ module Google # Lists all the exclusions in a parent resource. # @param [String] parent - # Required. The parent resource whose exclusions are to be listed. - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose exclusions are to be listed. "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -989,12 +1071,11 @@ module Google # Changes one or more properties of an existing exclusion. # @param [String] name - # Required. The resource name of the exclusion to update: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] update_mask # Required. A non-empty list of fields to change in the existing exclusion. New @@ -1037,12 +1118,10 @@ module Google # belonging to that resource can be excluded. You can have up to 10 exclusions # in a resource. # @param [String] parent - # Required. The parent resource in which to create the exclusion: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The parent resource in which to create the exclusion: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging- + # project", "organizations/123456789". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1075,12 +1154,11 @@ module Google # Deletes an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion to delete: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion to delete: "projects/[ + # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/ + # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[ + # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: " + # projects/my-project-id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1110,12 +1188,11 @@ module Google # Gets the description of an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1145,11 +1222,9 @@ module Google # Lists all the exclusions in a parent resource. # @param [String] parent - # Required. The parent resource whose exclusions are to be listed. - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose exclusions are to be listed. "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -1190,12 +1265,11 @@ module Google # Changes one or more properties of an existing exclusion. # @param [String] name - # Required. The resource name of the exclusion to update: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] update_mask # Required. A non-empty list of fields to change in the existing exclusion. New @@ -1234,15 +1308,92 @@ module Google execute_or_queue_command(command, &block) end + # Creates a bucket that can be used to store log entries. Once a bucket has been + # created, the region cannot be changed. + # @param [String] parent + # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/ + # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/ + # global" + # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object + # @param [String] bucket_id + # Required. A client-assigned identifier such as "my-bucket". Identifiers are + # limited to 100 characters and can include only letters, digits, underscores, + # hyphens, and periods. + # @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::LoggingV2::LogBucket] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::LogBucket] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_folder_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+parent}/buckets', options) + command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.request_object = log_bucket_object + command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.response_class = Google::Apis::LoggingV2::LogBucket + command.params['parent'] = parent unless parent.nil? + command.query['bucketId'] = bucket_id unless bucket_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days, + # the bucket will be purged and all logs in the bucket will be permanently + # deleted. + # @param [String] name + # Required. The full resource name of the bucket to delete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_folder_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v2/{+name}', options) + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + command.params['name'] = name unless name.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Gets a bucket (Beta). # @param [String] name - # Required. The resource name of the bucket: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". + # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/ + # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/ + # my-location/buckets/my-bucket-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1272,13 +1423,12 @@ module Google # Lists buckets (Beta). # @param [String] parent - # Required. The parent resource whose buckets are to be listed: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]" - # Note: The locations portion of the resource must be specified, but supplying - # the character - in place of LOCATION_ID will return all buckets. + # Required. The parent resource whose buckets are to be listed: "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/ + # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[ + # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The + # locations portion of the resource must be specified, but supplying the + # character - in place of LOCATION_ID will return all buckets. # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -1324,15 +1474,13 @@ module Google # FAILED_PRECONDITION will be returned.A buckets region may not be modified # after it is created. This method is in Beta. # @param [String] name - # Required. The full resource name of the bucket to update. - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". - # Also requires permission "resourcemanager.projects.updateLiens" to set the - # locked property + # Required. The full resource name of the bucket to update. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". Also requires + # permission "resourcemanager.projects.updateLiens" to set the locked property # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object # @param [String] update_mask # Required. Field mask that specifies the fields in bucket that need an update. @@ -1370,19 +1518,56 @@ module Google execute_or_queue_command(command, &block) end + # Undeletes a bucket. A bucket that has been deleted may be undeleted within the + # grace period of 7 days. + # @param [String] name + # Required. The full resource name of the bucket to undelete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @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 undelete_folder_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+name}:undelete', options) + command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation + command.request_object = undelete_bucket_request_object + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 + # Deletes all the log entries in a log. The log reappears if it receives new # entries. Log entries written shortly before the delete operation might not be # deleted. Entries received after the delete operation with a timestamp before # the operation will be deleted. # @param [String] log_name - # Required. The resource name of the log to delete: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" - # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com% - # 2Factivity". For more information about log names, see LogEntry. + # Required. The resource name of the log to delete: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example, "projects/my-project-id/logs/syslog", " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". + # For more information about log names, see LogEntry. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1413,11 +1598,9 @@ module Google # Lists the logs in projects, organizations, folders, or billing accounts. Only # logs that have entries are listed. # @param [String] parent - # Required. The resource name that owns the logs: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The resource name that owns the logs: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -1461,12 +1644,10 @@ module Google # writer_identity is not permitted to write to the destination. A sink can # export log entries only from the resource owning the sink. # @param [String] parent - # Required. The resource in which to create the sink: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/ + # 123456789". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. Determines the kind of IAM identity returned as writer_identity in @@ -1512,11 +1693,9 @@ module Google # account is also deleted. # @param [String] sink_name # Required. The full resource name of the sink to delete, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1547,11 +1726,9 @@ module Google # Gets a sink. # @param [String] sink_name - # Required. The resource name of the sink: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID] + # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1582,11 +1759,9 @@ module Google # Lists sinks. # @param [String] parent - # Required. The parent resource whose sinks are to be listed: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose sinks are to be listed: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -1630,23 +1805,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -1692,23 +1864,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -1749,15 +1918,92 @@ module Google execute_or_queue_command(command, &block) end + # Creates a bucket that can be used to store log entries. Once a bucket has been + # created, the region cannot be changed. + # @param [String] parent + # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/ + # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/ + # global" + # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object + # @param [String] bucket_id + # Required. A client-assigned identifier such as "my-bucket". Identifiers are + # limited to 100 characters and can include only letters, digits, underscores, + # hyphens, and periods. + # @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::LoggingV2::LogBucket] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::LogBucket] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+parent}/buckets', options) + command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.request_object = log_bucket_object + command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.response_class = Google::Apis::LoggingV2::LogBucket + command.params['parent'] = parent unless parent.nil? + command.query['bucketId'] = bucket_id unless bucket_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days, + # the bucket will be purged and all logs in the bucket will be permanently + # deleted. + # @param [String] name + # Required. The full resource name of the bucket to delete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v2/{+name}', options) + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + command.params['name'] = name unless name.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Gets a bucket (Beta). # @param [String] name - # Required. The resource name of the bucket: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". + # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/ + # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/ + # my-location/buckets/my-bucket-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1787,13 +2033,12 @@ module Google # Lists buckets (Beta). # @param [String] parent - # Required. The parent resource whose buckets are to be listed: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]" - # Note: The locations portion of the resource must be specified, but supplying - # the character - in place of LOCATION_ID will return all buckets. + # Required. The parent resource whose buckets are to be listed: "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/ + # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[ + # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The + # locations portion of the resource must be specified, but supplying the + # character - in place of LOCATION_ID will return all buckets. # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -1839,15 +2084,13 @@ module Google # FAILED_PRECONDITION will be returned.A buckets region may not be modified # after it is created. This method is in Beta. # @param [String] name - # Required. The full resource name of the bucket to update. - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". - # Also requires permission "resourcemanager.projects.updateLiens" to set the - # locked property + # Required. The full resource name of the bucket to update. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". Also requires + # permission "resourcemanager.projects.updateLiens" to set the locked property # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object # @param [String] update_mask # Required. Field mask that specifies the fields in bucket that need an update. @@ -1885,19 +2128,56 @@ module Google execute_or_queue_command(command, &block) end + # Undeletes a bucket. A bucket that has been deleted may be undeleted within the + # grace period of 7 days. + # @param [String] name + # Required. The full resource name of the bucket to undelete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @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 undelete_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+name}:undelete', options) + command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation + command.request_object = undelete_bucket_request_object + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 + # Deletes all the log entries in a log. The log reappears if it receives new # entries. Log entries written shortly before the delete operation might not be # deleted. Entries received after the delete operation with a timestamp before # the operation will be deleted. # @param [String] log_name - # Required. The resource name of the log to delete: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" - # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com% - # 2Factivity". For more information about log names, see LogEntry. + # Required. The resource name of the log to delete: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example, "projects/my-project-id/logs/syslog", " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". + # For more information about log names, see LogEntry. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1928,11 +2208,9 @@ module Google # Lists the logs in projects, organizations, folders, or billing accounts. Only # logs that have entries are listed. # @param [String] parent - # Required. The resource name that owns the logs: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The resource name that owns the logs: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2015,14 +2293,12 @@ module Google # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/ # managed-encryption) for more information. # @param [String] name - # Required. The resource for which to retrieve CMEK settings. - # "projects/[PROJECT_ID]/cmekSettings" - # "organizations/[ORGANIZATION_ID]/cmekSettings" - # "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" - # "folders/[FOLDER_ID]/cmekSettings" - # Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can - # currently only be configured for GCP organizations. Once configured, it - # applies to all projects and folders in the GCP organization. + # Required. The resource for which to retrieve CMEK settings. "projects/[ + # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" " + # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/ + # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the + # Logs Router can currently only be configured for GCP organizations. Once + # configured, it applies to all projects and folders in the GCP organization. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2059,14 +2335,12 @@ module Google # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/ # logging/docs/routing/managed-encryption) for more information. # @param [String] name - # Required. The resource name for the CMEK settings to update. - # "projects/[PROJECT_ID]/cmekSettings" - # "organizations/[ORGANIZATION_ID]/cmekSettings" - # "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" - # "folders/[FOLDER_ID]/cmekSettings" - # Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can - # currently only be configured for GCP organizations. Once configured, it - # applies to all projects and folders in the GCP organization. + # Required. The resource name for the CMEK settings to update. "projects/[ + # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" " + # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/ + # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the + # Logs Router can currently only be configured for GCP organizations. Once + # configured, it applies to all projects and folders in the GCP organization. # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object # @param [String] update_mask # Optional. Field mask identifying which fields from cmek_settings should be @@ -2107,12 +2381,10 @@ module Google # belonging to that resource can be excluded. You can have up to 10 exclusions # in a resource. # @param [String] parent - # Required. The parent resource in which to create the exclusion: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The parent resource in which to create the exclusion: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging- + # project", "organizations/123456789". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2145,12 +2417,11 @@ module Google # Deletes an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion to delete: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion to delete: "projects/[ + # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/ + # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[ + # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: " + # projects/my-project-id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2180,12 +2451,11 @@ module Google # Gets the description of an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2215,11 +2485,9 @@ module Google # Lists all the exclusions in a parent resource. # @param [String] parent - # Required. The parent resource whose exclusions are to be listed. - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose exclusions are to be listed. "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2260,12 +2528,11 @@ module Google # Changes one or more properties of an existing exclusion. # @param [String] name - # Required. The resource name of the exclusion to update: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] update_mask # Required. A non-empty list of fields to change in the existing exclusion. New @@ -2304,15 +2571,92 @@ module Google execute_or_queue_command(command, &block) end + # Creates a bucket that can be used to store log entries. Once a bucket has been + # created, the region cannot be changed. + # @param [String] parent + # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/ + # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/ + # global" + # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object + # @param [String] bucket_id + # Required. A client-assigned identifier such as "my-bucket". Identifiers are + # limited to 100 characters and can include only letters, digits, underscores, + # hyphens, and periods. + # @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::LoggingV2::LogBucket] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::LogBucket] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_organization_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+parent}/buckets', options) + command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.request_object = log_bucket_object + command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.response_class = Google::Apis::LoggingV2::LogBucket + command.params['parent'] = parent unless parent.nil? + command.query['bucketId'] = bucket_id unless bucket_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days, + # the bucket will be purged and all logs in the bucket will be permanently + # deleted. + # @param [String] name + # Required. The full resource name of the bucket to delete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_organization_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v2/{+name}', options) + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + command.params['name'] = name unless name.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Gets a bucket (Beta). # @param [String] name - # Required. The resource name of the bucket: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". + # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/ + # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/ + # my-location/buckets/my-bucket-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2342,13 +2686,12 @@ module Google # Lists buckets (Beta). # @param [String] parent - # Required. The parent resource whose buckets are to be listed: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]" - # Note: The locations portion of the resource must be specified, but supplying - # the character - in place of LOCATION_ID will return all buckets. + # Required. The parent resource whose buckets are to be listed: "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/ + # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[ + # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The + # locations portion of the resource must be specified, but supplying the + # character - in place of LOCATION_ID will return all buckets. # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2394,15 +2737,13 @@ module Google # FAILED_PRECONDITION will be returned.A buckets region may not be modified # after it is created. This method is in Beta. # @param [String] name - # Required. The full resource name of the bucket to update. - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". - # Also requires permission "resourcemanager.projects.updateLiens" to set the - # locked property + # Required. The full resource name of the bucket to update. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". Also requires + # permission "resourcemanager.projects.updateLiens" to set the locked property # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object # @param [String] update_mask # Required. Field mask that specifies the fields in bucket that need an update. @@ -2440,19 +2781,56 @@ module Google execute_or_queue_command(command, &block) end + # Undeletes a bucket. A bucket that has been deleted may be undeleted within the + # grace period of 7 days. + # @param [String] name + # Required. The full resource name of the bucket to undelete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @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 undelete_organization_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+name}:undelete', options) + command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation + command.request_object = undelete_bucket_request_object + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 + # Deletes all the log entries in a log. The log reappears if it receives new # entries. Log entries written shortly before the delete operation might not be # deleted. Entries received after the delete operation with a timestamp before # the operation will be deleted. # @param [String] log_name - # Required. The resource name of the log to delete: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" - # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com% - # 2Factivity". For more information about log names, see LogEntry. + # Required. The resource name of the log to delete: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example, "projects/my-project-id/logs/syslog", " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". + # For more information about log names, see LogEntry. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2483,11 +2861,9 @@ module Google # Lists the logs in projects, organizations, folders, or billing accounts. Only # logs that have entries are listed. # @param [String] parent - # Required. The resource name that owns the logs: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The resource name that owns the logs: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2531,12 +2907,10 @@ module Google # writer_identity is not permitted to write to the destination. A sink can # export log entries only from the resource owning the sink. # @param [String] parent - # Required. The resource in which to create the sink: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/ + # 123456789". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. Determines the kind of IAM identity returned as writer_identity in @@ -2582,11 +2956,9 @@ module Google # account is also deleted. # @param [String] sink_name # Required. The full resource name of the sink to delete, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2617,11 +2989,9 @@ module Google # Gets a sink. # @param [String] sink_name - # Required. The resource name of the sink: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID] + # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2652,11 +3022,9 @@ module Google # Lists sinks. # @param [String] parent - # Required. The parent resource whose sinks are to be listed: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose sinks are to be listed: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2700,23 +3068,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -2762,23 +3127,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -2823,12 +3185,10 @@ module Google # belonging to that resource can be excluded. You can have up to 10 exclusions # in a resource. # @param [String] parent - # Required. The parent resource in which to create the exclusion: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The parent resource in which to create the exclusion: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging- + # project", "organizations/123456789". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -2861,12 +3221,11 @@ module Google # Deletes an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion to delete: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion to delete: "projects/[ + # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/ + # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[ + # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: " + # projects/my-project-id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2896,12 +3255,11 @@ module Google # Gets the description of an exclusion. # @param [String] name - # Required. The resource name of an existing exclusion: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -2931,11 +3289,9 @@ module Google # Lists all the exclusions in a parent resource. # @param [String] parent - # Required. The parent resource whose exclusions are to be listed. - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose exclusions are to be listed. "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -2976,12 +3332,11 @@ module Google # Changes one or more properties of an existing exclusion. # @param [String] name - # Required. The resource name of the exclusion to update: - # "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" - # "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" - # Example: "projects/my-project-id/exclusions/my-exclusion-id". + # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/ + # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[ + # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" + # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project- + # id/exclusions/my-exclusion-id". # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object # @param [String] update_mask # Required. A non-empty list of fields to change in the existing exclusion. New @@ -3020,15 +3375,92 @@ module Google execute_or_queue_command(command, &block) end + # Creates a bucket that can be used to store log entries. Once a bucket has been + # created, the region cannot be changed. + # @param [String] parent + # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/ + # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/ + # global" + # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object + # @param [String] bucket_id + # Required. A client-assigned identifier such as "my-bucket". Identifiers are + # limited to 100 characters and can include only letters, digits, underscores, + # hyphens, and periods. + # @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::LoggingV2::LogBucket] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::LogBucket] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_project_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+parent}/buckets', options) + command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.request_object = log_bucket_object + command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation + command.response_class = Google::Apis::LoggingV2::LogBucket + command.params['parent'] = parent unless parent.nil? + command.query['bucketId'] = bucket_id unless bucket_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days, + # the bucket will be purged and all logs in the bucket will be permanently + # deleted. + # @param [String] name + # Required. The full resource name of the bucket to delete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_project_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v2/{+name}', options) + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + command.params['name'] = name unless name.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Gets a bucket (Beta). # @param [String] name - # Required. The resource name of the bucket: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". + # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/ + # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[ + # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/ + # my-location/buckets/my-bucket-id". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3058,13 +3490,12 @@ module Google # Lists buckets (Beta). # @param [String] parent - # Required. The parent resource whose buckets are to be listed: - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]" - # Note: The locations portion of the resource must be specified, but supplying - # the character - in place of LOCATION_ID will return all buckets. + # Required. The parent resource whose buckets are to be listed: "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/ + # locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[ + # LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The + # locations portion of the resource must be specified, but supplying the + # character - in place of LOCATION_ID will return all buckets. # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -3110,15 +3541,13 @@ module Google # FAILED_PRECONDITION will be returned.A buckets region may not be modified # after it is created. This method is in Beta. # @param [String] name - # Required. The full resource name of the bucket to update. - # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[ - # BUCKET_ID]" - # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" - # Example: "projects/my-project-id/locations/my-location/buckets/my-bucket-id". - # Also requires permission "resourcemanager.projects.updateLiens" to set the - # locked property + # Required. The full resource name of the bucket to update. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". Also requires + # permission "resourcemanager.projects.updateLiens" to set the locked property # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object # @param [String] update_mask # Required. Field mask that specifies the fields in bucket that need an update. @@ -3156,19 +3585,56 @@ module Google execute_or_queue_command(command, &block) end + # Undeletes a bucket. A bucket that has been deleted may be undeleted within the + # grace period of 7 days. + # @param [String] name + # Required. The full resource name of the bucket to undelete. "projects/[ + # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ + # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/ + # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[ + # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my- + # project-id/locations/my-location/buckets/my-bucket-id". + # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::LoggingV2::Empty] + # + # @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 undelete_project_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v2/{+name}:undelete', options) + command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation + command.request_object = undelete_bucket_request_object + command.response_representation = Google::Apis::LoggingV2::Empty::Representation + command.response_class = Google::Apis::LoggingV2::Empty + 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 + # Deletes all the log entries in a log. The log reappears if it receives new # entries. Log entries written shortly before the delete operation might not be # deleted. Entries received after the delete operation with a timestamp before # the operation will be deleted. # @param [String] log_name - # Required. The resource name of the log to delete: - # "projects/[PROJECT_ID]/logs/[LOG_ID]" - # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" - # "folders/[FOLDER_ID]/logs/[LOG_ID]" - # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog" - # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com% - # 2Factivity". For more information about log names, see LogEntry. + # Required. The resource name of the log to delete: "projects/[PROJECT_ID]/logs/[ + # LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" [LOG_ID] + # must be URL-encoded. For example, "projects/my-project-id/logs/syslog", " + # organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity". + # For more information about log names, see LogEntry. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3199,11 +3665,9 @@ module Google # Lists the logs in projects, organizations, folders, or billing accounts. Only # logs that have entries are listed. # @param [String] parent - # Required. The resource name that owns the logs: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The resource name that owns the logs: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -3244,9 +3708,8 @@ module Google # Creates a logs-based metric. # @param [String] parent - # Required. The resource name of the project in which to create the metric: - # "projects/[PROJECT_ID]" - # The new metric must be provided in the request. + # Required. The resource name of the project in which to create the metric: " + # projects/[PROJECT_ID]" The new metric must be provided in the request. # @param [Google::Apis::LoggingV2::LogMetric] log_metric_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3279,8 +3742,8 @@ module Google # Deletes a logs-based metric. # @param [String] metric_name - # Required. The resource name of the metric to delete: - # "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + # Required. The resource name of the metric to delete: "projects/[PROJECT_ID]/ + # metrics/[METRIC_ID]" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3310,8 +3773,8 @@ module Google # Gets a logs-based metric. # @param [String] metric_name - # Required. The resource name of the desired metric: - # "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + # Required. The resource name of the desired metric: "projects/[PROJECT_ID]/ + # metrics/[METRIC_ID]" # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3341,8 +3804,8 @@ module Google # Lists logs-based metrics. # @param [String] parent - # Required. The name of the project containing the metrics: - # "projects/[PROJECT_ID]" + # Required. The name of the project containing the metrics: "projects/[ + # PROJECT_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -3383,11 +3846,10 @@ module Google # Creates or updates a logs-based metric. # @param [String] metric_name - # Required. The resource name of the metric to update: - # "projects/[PROJECT_ID]/metrics/[METRIC_ID]" - # The updated metric must be provided in the request and it's name field must be - # the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a - # new metric is created. + # Required. The resource name of the metric to update: "projects/[PROJECT_ID]/ + # metrics/[METRIC_ID]" The updated metric must be provided in the request and it' + # s name field must be the same as [METRIC_ID] If the metric does not exist in [ + # PROJECT_ID], then a new metric is created. # @param [Google::Apis::LoggingV2::LogMetric] log_metric_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3423,12 +3885,10 @@ module Google # writer_identity is not permitted to write to the destination. A sink can # export log entries only from the resource owning the sink. # @param [String] parent - # Required. The resource in which to create the sink: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/ + # 123456789". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. Determines the kind of IAM identity returned as writer_identity in @@ -3474,11 +3934,9 @@ module Google # account is also deleted. # @param [String] sink_name # Required. The full resource name of the sink to delete, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3509,11 +3967,9 @@ module Google # Gets a sink. # @param [String] sink_name - # Required. The resource name of the sink: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID] + # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3544,11 +4000,9 @@ module Google # Lists sinks. # @param [String] parent - # Required. The parent resource whose sinks are to be listed: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose sinks are to be listed: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -3592,23 +4046,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -3654,23 +4105,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -3716,12 +4164,10 @@ module Google # writer_identity is not permitted to write to the destination. A sink can # export log entries only from the resource owning the sink. # @param [String] parent - # Required. The resource in which to create the sink: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" - # Examples: "projects/my-logging-project", "organizations/123456789". + # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" " + # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" " + # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/ + # 123456789". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. Determines the kind of IAM identity returned as writer_identity in @@ -3767,11 +4213,9 @@ module Google # account is also deleted. # @param [String] sink_name # Required. The full resource name of the sink to delete, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3802,11 +4246,9 @@ module Google # Gets a sink. # @param [String] sink_name - # Required. The resource name of the sink: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID] + # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3837,11 +4279,9 @@ module Google # Lists sinks. # @param [String] parent - # Required. The parent resource whose sinks are to be listed: - # "projects/[PROJECT_ID]" - # "organizations/[ORGANIZATION_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]" - # "folders/[FOLDER_ID]" + # Required. The parent resource whose sinks are to be listed: "projects/[ + # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" # @param [Fixnum] page_size # Optional. The maximum number of results to return from this request. Non- # positive values are ignored. The presence of nextPageToken in the response @@ -3885,23 +4325,20 @@ module Google # also have a new writer_identity; see the unique_writer_identity field. # @param [String] sink_name # Required. The full resource name of the sink to update, including the parent - # resource and the sink identifier: - # "projects/[PROJECT_ID]/sinks/[SINK_ID]" - # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" - # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - # "folders/[FOLDER_ID]/sinks/[SINK_ID]" + # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" " + # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[ + # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" # Example: "projects/my-project-id/sinks/my-sink-id". # @param [Google::Apis::LoggingV2::LogSink] log_sink_object # @param [Boolean] unique_writer_identity # Optional. See sinks.create for a description of this field. When updating a # sink, the effect of this field on the value of writer_identity in the updated - # sink depends on both the old and new values of this field: - # If the old and new values of this field are both false or both true, then - # there is no change to the sink's writer_identity. - # If the old value is false and the new value is true, then writer_identity is - # changed to a unique service account. - # It is an error if the old value is true and the new value is set to false or - # defaulted to false. + # sink depends on both the old and new values of this field: If the old and new + # values of this field are both false or both true, then there is no change to + # the sink's writer_identity. If the old value is false and the new value is + # true, then writer_identity is changed to a unique service account. It is an + # error if the old value is true and the new value is set to false or defaulted + # to false. # @param [String] update_mask # Optional. Field mask that specifies the fields in sink that need an update. A # sink field will be overwritten if, and only if, it is in the update mask. name @@ -3948,14 +4385,12 @@ module Google # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/ # managed-encryption) for more information. # @param [String] name - # Required. The resource for which to retrieve CMEK settings. - # "projects/[PROJECT_ID]/cmekSettings" - # "organizations/[ORGANIZATION_ID]/cmekSettings" - # "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" - # "folders/[FOLDER_ID]/cmekSettings" - # Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can - # currently only be configured for GCP organizations. Once configured, it - # applies to all projects and folders in the GCP organization. + # Required. The resource for which to retrieve CMEK settings. "projects/[ + # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" " + # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/ + # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the + # Logs Router can currently only be configured for GCP organizations. Once + # configured, it applies to all projects and folders in the GCP organization. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -3992,14 +4427,12 @@ module Google # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/ # logging/docs/routing/managed-encryption) for more information. # @param [String] name - # Required. The resource name for the CMEK settings to update. - # "projects/[PROJECT_ID]/cmekSettings" - # "organizations/[ORGANIZATION_ID]/cmekSettings" - # "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" - # "folders/[FOLDER_ID]/cmekSettings" - # Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can - # currently only be configured for GCP organizations. Once configured, it - # applies to all projects and folders in the GCP organization. + # Required. The resource name for the CMEK settings to update. "projects/[ + # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" " + # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/ + # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the + # Logs Router can currently only be configured for GCP organizations. Once + # configured, it applies to all projects and folders in the GCP organization. # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object # @param [String] update_mask # Optional. Field mask identifying which fields from cmek_settings should be diff --git a/generated/google/apis/oslogin_v1alpha.rb b/generated/google/apis/oslogin_v1alpha.rb index 856f47b9f..a607d674f 100644 --- a/generated/google/apis/oslogin_v1alpha.rb +++ b/generated/google/apis/oslogin_v1alpha.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/compute/docs/oslogin/ module OsloginV1alpha VERSION = 'V1alpha' - REVISION = '20200215' + REVISION = '20200801' # 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/oslogin_v1alpha/classes.rb b/generated/google/apis/oslogin_v1alpha/classes.rb index 3a3cc6515..b2c9ab5e0 100644 --- a/generated/google/apis/oslogin_v1alpha/classes.rb +++ b/generated/google/apis/oslogin_v1alpha/classes.rb @@ -22,13 +22,11 @@ module Google module Apis module OsloginV1alpha - # 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 @@ -138,8 +136,8 @@ module Google # @return [String] attr_accessor :shell - # System identifier for which account the username or uid applies to. - # By default, the empty value is used. + # System identifier for which account the username or uid applies to. By default, + # the empty value is used. # Corresponds to the JSON property `systemId` # @return [String] attr_accessor :system_id @@ -188,9 +186,7 @@ module Google # @return [String] attr_accessor :fingerprint - # Public key text in SSH format, defined by - # RFC4253 - # section 6.6. + # Public key text in SSH format, defined by RFC4253 section 6.6. # Corresponds to the JSON property `key` # @return [String] attr_accessor :key diff --git a/generated/google/apis/oslogin_v1alpha/service.rb b/generated/google/apis/oslogin_v1alpha/service.rb index 84942831e..859f3ae3b 100644 --- a/generated/google/apis/oslogin_v1alpha/service.rb +++ b/generated/google/apis/oslogin_v1alpha/service.rb @@ -47,8 +47,8 @@ module Google @batch_path = 'batch' end - # Retrieves the profile information used for logging in to a virtual machine - # on Google Compute Engine. + # Retrieves the profile information used for logging in to a virtual machine on + # Google Compute Engine. # @param [String] name # The unique ID for the user in format `users/`user``. # @param [String] operating_system_type @@ -88,8 +88,8 @@ module Google end # Adds an SSH public key and returns the profile information. Default POSIX - # account information is set when no username and UID exist as part of the - # login profile. + # account information is set when no username and UID exist as part of the login + # profile. # @param [String] parent # The unique ID for the user in format `users/`user``. # @param [Google::Apis::OsloginV1alpha::SshPublicKey] ssh_public_key_object @@ -127,9 +127,9 @@ module Google # Deletes a POSIX account. # @param [String] name - # A reference to the POSIX account to update. POSIX accounts are identified - # by the project ID they are associated with. A reference to the POSIX - # account is in format `users/`user`/projects/`project``. + # A reference to the POSIX account to update. POSIX accounts are identified by + # the project ID they are associated with. A reference to the POSIX account is + # in format `users/`user`/projects/`project``. # @param [String] operating_system_type # The type of operating system associated with the account. # @param [String] fields @@ -163,8 +163,8 @@ module Google # Deletes an SSH public key. # @param [String] name # The fingerprint of the public key to update. Public keys are identified by - # their SHA-256 fingerprint. The fingerprint of the public key is in format - # `users/`user`/sshPublicKeys/`fingerprint``. + # their SHA-256 fingerprint. The fingerprint of the public key is in format ` + # users/`user`/sshPublicKeys/`fingerprint``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -194,9 +194,9 @@ module Google # Retrieves an SSH public key. # @param [String] name - # The fingerprint of the public key to retrieve. Public keys are identified - # by their SHA-256 fingerprint. The fingerprint of the public key is in - # format `users/`user`/sshPublicKeys/`fingerprint``. + # The fingerprint of the public key to retrieve. Public keys are identified by + # their SHA-256 fingerprint. The fingerprint of the public key is in format ` + # users/`user`/sshPublicKeys/`fingerprint``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -228,8 +228,8 @@ module Google # supports patch semantics. # @param [String] name # The fingerprint of the public key to update. Public keys are identified by - # their SHA-256 fingerprint. The fingerprint of the public key is in format - # `users/`user`/sshPublicKeys/`fingerprint``. + # their SHA-256 fingerprint. The fingerprint of the public key is in format ` + # users/`user`/sshPublicKeys/`fingerprint``. # @param [Google::Apis::OsloginV1alpha::SshPublicKey] ssh_public_key_object # @param [String] update_mask # Mask to control which fields get updated. Updates all if not present. diff --git a/generated/google/apis/oslogin_v1beta.rb b/generated/google/apis/oslogin_v1beta.rb index 27afac4a3..22b8932ba 100644 --- a/generated/google/apis/oslogin_v1beta.rb +++ b/generated/google/apis/oslogin_v1beta.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/compute/docs/oslogin/ module OsloginV1beta VERSION = 'V1beta' - REVISION = '20200215' + REVISION = '20200801' # 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/oslogin_v1beta/classes.rb b/generated/google/apis/oslogin_v1beta/classes.rb index 5cbe68833..ddc54d02f 100644 --- a/generated/google/apis/oslogin_v1beta/classes.rb +++ b/generated/google/apis/oslogin_v1beta/classes.rb @@ -22,13 +22,11 @@ module Google module Apis module OsloginV1beta - # 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 @@ -138,8 +136,8 @@ module Google # @return [String] attr_accessor :shell - # System identifier for which account the username or uid applies to. - # By default, the empty value is used. + # System identifier for which account the username or uid applies to. By default, + # the empty value is used. # Corresponds to the JSON property `systemId` # @return [String] attr_accessor :system_id @@ -188,9 +186,7 @@ module Google # @return [String] attr_accessor :fingerprint - # Public key text in SSH format, defined by - # RFC4253 - # section 6.6. + # Public key text in SSH format, defined by RFC4253 section 6.6. # Corresponds to the JSON property `key` # @return [String] attr_accessor :key diff --git a/generated/google/apis/oslogin_v1beta/service.rb b/generated/google/apis/oslogin_v1beta/service.rb index c44885757..741d0d30f 100644 --- a/generated/google/apis/oslogin_v1beta/service.rb +++ b/generated/google/apis/oslogin_v1beta/service.rb @@ -47,8 +47,8 @@ module Google @batch_path = 'batch' end - # Retrieves the profile information used for logging in to a virtual machine - # on Google Compute Engine. + # Retrieves the profile information used for logging in to a virtual machine on + # Google Compute Engine. # @param [String] name # Required. The unique ID for the user in format `users/`user``. # @param [String] project_id @@ -85,8 +85,8 @@ module Google end # Adds an SSH public key and returns the profile information. Default POSIX - # account information is set when no username and UID exist as part of the - # login profile. + # account information is set when no username and UID exist as part of the login + # profile. # @param [String] parent # The unique ID for the user in format `users/`user``. # @param [Google::Apis::OsloginV1beta::SshPublicKey] ssh_public_key_object @@ -125,9 +125,8 @@ module Google # Deletes a POSIX account. # @param [String] name # Required. A reference to the POSIX account to update. POSIX accounts are - # identified - # by the project ID they are associated with. A reference to the POSIX - # account is in format `users/`user`/projects/`project``. + # identified by the project ID they are associated with. A reference to the + # POSIX account is in format `users/`user`/projects/`project``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -158,9 +157,8 @@ module Google # Deletes an SSH public key. # @param [String] name # Required. The fingerprint of the public key to update. Public keys are - # identified by - # their SHA-256 fingerprint. The fingerprint of the public key is in format - # `users/`user`/sshPublicKeys/`fingerprint``. + # identified by their SHA-256 fingerprint. The fingerprint of the public key is + # in format `users/`user`/sshPublicKeys/`fingerprint``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -191,9 +189,8 @@ module Google # Retrieves an SSH public key. # @param [String] name # Required. The fingerprint of the public key to retrieve. Public keys are - # identified - # by their SHA-256 fingerprint. The fingerprint of the public key is in - # format `users/`user`/sshPublicKeys/`fingerprint``. + # identified by their SHA-256 fingerprint. The fingerprint of the public key is + # in format `users/`user`/sshPublicKeys/`fingerprint``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -225,9 +222,8 @@ module Google # supports patch semantics. # @param [String] name # Required. The fingerprint of the public key to update. Public keys are - # identified by - # their SHA-256 fingerprint. The fingerprint of the public key is in format - # `users/`user`/sshPublicKeys/`fingerprint``. + # identified by their SHA-256 fingerprint. The fingerprint of the public key is + # in format `users/`user`/sshPublicKeys/`fingerprint``. # @param [Google::Apis::OsloginV1beta::SshPublicKey] ssh_public_key_object # @param [String] update_mask # Mask to control which fields get updated. Updates all if not present. diff --git a/generated/google/apis/pubsub_v1.rb b/generated/google/apis/pubsub_v1.rb index 303eead80..559dd647f 100644 --- a/generated/google/apis/pubsub_v1.rb +++ b/generated/google/apis/pubsub_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/pubsub/docs module PubsubV1 VERSION = 'V1' - REVISION = '20200713' + REVISION = '20200731' # 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/pubsub_v1/classes.rb b/generated/google/apis/pubsub_v1/classes.rb index 595e69988..4d83b6d92 100644 --- a/generated/google/apis/pubsub_v1/classes.rb +++ b/generated/google/apis/pubsub_v1/classes.rb @@ -1196,6 +1196,16 @@ module Google # @return [Google::Apis::PubsubV1::DeadLetterPolicy] attr_accessor :dead_letter_policy + # Indicates whether the subscription is detached from its topic. Detached + # subscriptions don't receive messages from their topic and don't retain any + # backlog. `Pull` and `StreamingPull` requests will return + # FAILED_PRECONDITION. If the subscription is a push subscription, pushes to + # the endpoint will not be made. + # Corresponds to the JSON property `detached` + # @return [Boolean] + attr_accessor :detached + alias_method :detached?, :detached + # If true, messages published with the same `ordering_key` in `PubsubMessage` # will be delivered to the subscribers in the order in which they # are received by the Pub/Sub system. Otherwise, they may be delivered in @@ -1290,6 +1300,7 @@ module Google def update!(**args) @ack_deadline_seconds = args[:ack_deadline_seconds] if args.key?(:ack_deadline_seconds) @dead_letter_policy = args[:dead_letter_policy] if args.key?(:dead_letter_policy) + @detached = args[:detached] if args.key?(:detached) @enable_message_ordering = args[:enable_message_ordering] if args.key?(:enable_message_ordering) @expiration_policy = args[:expiration_policy] if args.key?(:expiration_policy) @filter = args[:filter] if args.key?(:filter) diff --git a/generated/google/apis/pubsub_v1/representations.rb b/generated/google/apis/pubsub_v1/representations.rb index c9db959f8..44c2fe54d 100644 --- a/generated/google/apis/pubsub_v1/representations.rb +++ b/generated/google/apis/pubsub_v1/representations.rb @@ -498,6 +498,7 @@ module Google property :ack_deadline_seconds, as: 'ackDeadlineSeconds' property :dead_letter_policy, as: 'deadLetterPolicy', class: Google::Apis::PubsubV1::DeadLetterPolicy, decorator: Google::Apis::PubsubV1::DeadLetterPolicy::Representation + property :detached, as: 'detached' property :enable_message_ordering, as: 'enableMessageOrdering' property :expiration_policy, as: 'expirationPolicy', class: Google::Apis::PubsubV1::ExpirationPolicy, decorator: Google::Apis::PubsubV1::ExpirationPolicy::Representation diff --git a/generated/google/apis/pubsublite_v1.rb b/generated/google/apis/pubsublite_v1.rb index a8bbebec2..a68272710 100644 --- a/generated/google/apis/pubsublite_v1.rb +++ b/generated/google/apis/pubsublite_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/pubsub/lite/docs module PubsubliteV1 VERSION = 'V1' - REVISION = '20200728' + REVISION = '20200803' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/pubsublite_v1/classes.rb b/generated/google/apis/pubsublite_v1/classes.rb index df7cc5df5..d0d152fd8 100644 --- a/generated/google/apis/pubsublite_v1/classes.rb +++ b/generated/google/apis/pubsublite_v1/classes.rb @@ -26,14 +26,12 @@ module Google class Capacity include Google::Apis::Core::Hashable - # Publish throughput capacity per partition in MiB/s. - # Must be >= 4 and <= 16. + # Publish throughput capacity per partition in MiB/s. Must be >= 4 and <= 16. # Corresponds to the JSON property `publishMibPerSec` # @return [Fixnum] attr_accessor :publish_mib_per_sec - # Subscribe throughput capacity per partition in MiB/s. - # Must be >= 4 and <= 32. + # Subscribe throughput capacity per partition in MiB/s. Must be >= 4 and <= 32. # Corresponds to the JSON property `subscribeMibPerSec` # @return [Fixnum] attr_accessor :subscribe_mib_per_sec @@ -88,13 +86,11 @@ module Google end end - # A generic empty message that you can re-use to avoid defining duplicated - # empty messages in your APIs. A typical example is to use it as the request - # or the response type of an API method. For instance: - # service Foo ` - # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # A generic empty message that you can re-use to avoid defining duplicated empty + # messages in your APIs. A typical example is to use it as the request or the + # response type of an API method. For instance: service Foo ` rpc Bar(google. + # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -111,8 +107,8 @@ module Google class ListPartitionCursorsResponse include Google::Apis::Core::Hashable - # A token, which can be sent as `page_token` to retrieve the next page. - # If this field is omitted, there are no subsequent pages. + # A token, which can be sent as `page_token` to retrieve the next page. If this + # field is omitted, there are no subsequent pages. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -137,8 +133,8 @@ module Google class ListSubscriptionsResponse include Google::Apis::Core::Hashable - # A token that can be sent as `page_token` to retrieve the next page of - # results. If this field is omitted, there are no more results. + # A token that can be sent as `page_token` to retrieve the next page of results. + # If this field is omitted, there are no more results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -164,8 +160,8 @@ module Google class ListTopicSubscriptionsResponse include Google::Apis::Core::Hashable - # A token that can be sent as `page_token` to retrieve the next page of - # results. If this field is omitted, there are no more results. + # A token that can be sent as `page_token` to retrieve the next page of results. + # If this field is omitted, there are no more results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -191,8 +187,8 @@ module Google class ListTopicsResponse include Google::Apis::Core::Hashable - # A token that can be sent as `page_token` to retrieve the next page of - # results. If this field is omitted, there are no more results. + # A token that can be sent as `page_token` to retrieve the next page of results. + # If this field is omitted, there are no more results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -228,11 +224,10 @@ module Google # @return [Fixnum] attr_accessor :count - # Every partition in the topic is allocated throughput equivalent to - # `scale` times the standard partition throughput (4 MiB/s). This is also - # reflected in the cost of this topic; a topic with `scale` of 2 and - # count of 10 is charged for 20 partitions. This value must be in the - # range [1,4]. + # Every partition in the topic is allocated throughput equivalent to `scale` + # times the standard partition throughput (4 MiB/s). This is also reflected in + # the cost of this topic; a topic with `scale` of 2 and count of 10 is charged + # for 20 partitions. This value must be in the range [1,4]. # Corresponds to the JSON property `scale` # @return [Fixnum] attr_accessor :scale @@ -280,15 +275,15 @@ module Google # The provisioned storage, in bytes, per partition. If the number of bytes # stored in any of the topic's partitions grows beyond this value, older - # messages will be dropped to make room for newer ones, regardless of the - # value of `period`. + # messages will be dropped to make room for newer ones, regardless of the value + # of `period`. # Corresponds to the JSON property `perPartitionBytes` # @return [Fixnum] attr_accessor :per_partition_bytes - # How long a published message is retained. If unset, messages will be - # retained as long as the bytes retained for each partition is below - # `per_partition_bytes`. + # How long a published message is retained. If unset, messages will be retained + # as long as the bytes retained for each partition is below `per_partition_bytes` + # . # Corresponds to the JSON property `period` # @return [String] attr_accessor :period @@ -313,15 +308,13 @@ module Google # @return [Google::Apis::PubsubliteV1::DeliveryConfig] attr_accessor :delivery_config - # The name of the subscription. - # Structured like: - # projects/`project_number`/locations/`location`/subscriptions/`subscription_id` + # The name of the subscription. Structured like: projects/`project_number`/ + # locations/`location`/subscriptions/`subscription_id` # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The name of the topic this subscription is attached to. - # Structured like: + # The name of the topic this subscription is attached to. Structured like: # projects/`project_number`/locations/`location`/topics/`topic_id` # Corresponds to the JSON property `topic` # @return [String] @@ -343,9 +336,8 @@ module Google class Topic include Google::Apis::Core::Hashable - # The name of the topic. - # Structured like: - # projects/`project_number`/locations/`location`/topics/`topic_id` + # The name of the topic. Structured like: projects/`project_number`/locations/` + # location`/topics/`topic_id` # Corresponds to the JSON property `name` # @return [String] attr_accessor :name diff --git a/generated/google/apis/pubsublite_v1/service.rb b/generated/google/apis/pubsublite_v1/service.rb index e55504c4e..8a2e95180 100644 --- a/generated/google/apis/pubsublite_v1/service.rb +++ b/generated/google/apis/pubsublite_v1/service.rb @@ -49,14 +49,13 @@ module Google # Creates a new subscription. # @param [String] parent - # Required. The parent location in which to create the subscription. - # Structured like `projects/`project_number`/locations/`location``. + # Required. The parent location in which to create the subscription. Structured + # like `projects/`project_number`/locations/`location``. # @param [Google::Apis::PubsubliteV1::Subscription] subscription_object # @param [String] subscription_id # Required. The ID to use for the subscription, which will become the final - # component - # of the subscription's name. - # This value is structured like: `my-sub-name`. + # component of the subscription's name. This value is structured like: `my-sub- + # name`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -149,17 +148,17 @@ module Google # Returns the list of subscriptions for the given project. # @param [String] parent - # Required. The parent whose subscriptions are to be listed. - # Structured like `projects/`project_number`/locations/`location``. + # Required. The parent whose subscriptions are to be listed. Structured like ` + # projects/`project_number`/locations/`location``. # @param [Fixnum] page_size # The maximum number of subscriptions to return. The service may return fewer - # than this value. - # If unset or zero, all subscriptions for the parent will be returned. + # than this value. If unset or zero, all subscriptions for the parent will be + # returned. # @param [String] page_token - # A page token, received from a previous `ListSubscriptions` call. - # Provide this to retrieve the subsequent page. - # When paginating, all other parameters provided to `ListSubscriptions` must - # match the call that provided the page token. + # A page token, received from a previous `ListSubscriptions` call. Provide this + # to retrieve the subsequent page. When paginating, all other parameters + # provided to `ListSubscriptions` must match the call that provided the page + # token. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -191,9 +190,8 @@ module Google # Updates properties of the specified subscription. # @param [String] name - # The name of the subscription. - # Structured like: - # projects/`project_number`/locations/`location`/subscriptions/`subscription_id` + # The name of the subscription. Structured like: projects/`project_number`/ + # locations/`location`/subscriptions/`subscription_id` # @param [Google::Apis::PubsubliteV1::Subscription] subscription_object # @param [String] update_mask # Required. A mask specifying the subscription fields to change. @@ -229,14 +227,12 @@ module Google # Creates a new topic. # @param [String] parent - # Required. The parent location in which to create the topic. - # Structured like `projects/`project_number`/locations/`location``. + # Required. The parent location in which to create the topic. Structured like ` + # projects/`project_number`/locations/`location``. # @param [Google::Apis::PubsubliteV1::Topic] topic_object # @param [String] topic_id # Required. The ID to use for the topic, which will become the final component - # of - # the topic's name. - # This value is structured like: `my-topic-name`. + # of the topic's name. This value is structured like: `my-topic-name`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -359,17 +355,15 @@ module Google # Returns the list of topics for the given project. # @param [String] parent - # Required. The parent whose topics are to be listed. - # Structured like `projects/`project_number`/locations/`location``. + # Required. The parent whose topics are to be listed. Structured like `projects/` + # project_number`/locations/`location``. # @param [Fixnum] page_size - # The maximum number of topics to return. The service may return fewer than - # this value. - # If unset or zero, all topics for the parent will be returned. + # The maximum number of topics to return. The service may return fewer than this + # value. If unset or zero, all topics for the parent will be returned. # @param [String] page_token - # A page token, received from a previous `ListTopics` call. - # Provide this to retrieve the subsequent page. - # When paginating, all other parameters provided to `ListTopics` must match - # the call that provided the page token. + # A page token, received from a previous `ListTopics` call. Provide this to + # retrieve the subsequent page. When paginating, all other parameters provided + # to `ListTopics` must match the call that provided the page token. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -401,9 +395,8 @@ module Google # Updates properties of the specified topic. # @param [String] name - # The name of the topic. - # Structured like: - # projects/`project_number`/locations/`location`/topics/`topic_id` + # The name of the topic. Structured like: projects/`project_number`/locations/` + # location`/topics/`topic_id` # @param [Google::Apis::PubsubliteV1::Topic] topic_object # @param [String] update_mask # Required. A mask specifying the topic fields to change. @@ -442,13 +435,13 @@ module Google # Required. The name of the topic whose subscriptions to list. # @param [Fixnum] page_size # The maximum number of subscriptions to return. The service may return fewer - # than this value. - # If unset or zero, all subscriptions for the given topic will be returned. + # than this value. If unset or zero, all subscriptions for the given topic will + # be returned. # @param [String] page_token - # A page token, received from a previous `ListTopicSubscriptions` call. - # Provide this to retrieve the subsequent page. - # When paginating, all other parameters provided to `ListTopicSubscriptions` - # must match the call that provided the page token. + # A page token, received from a previous `ListTopicSubscriptions` call. Provide + # this to retrieve the subsequent page. When paginating, all other parameters + # provided to `ListTopicSubscriptions` must match the call that provided the + # page token. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -480,19 +473,17 @@ module Google # Returns all committed cursor information for a subscription. # @param [String] parent - # Required. The subscription for which to retrieve cursors. - # Structured like - # `projects/`project_number`/locations/`location`/subscriptions/`subscription_id` - # `. + # Required. The subscription for which to retrieve cursors. Structured like ` + # projects/`project_number`/locations/`location`/subscriptions/`subscription_id`` + # . # @param [Fixnum] page_size # The maximum number of cursors to return. The service may return fewer than - # this value. - # If unset or zero, all cursors for the parent will be returned. + # this value. If unset or zero, all cursors for the parent will be returned. # @param [String] page_token - # A page token, received from a previous `ListPartitionCursors` call. - # Provide this to retrieve the subsequent page. - # When paginating, all other parameters provided to `ListPartitionCursors` - # must match the call that provided the page token. + # A page token, received from a previous `ListPartitionCursors` call. Provide + # this to retrieve the subsequent page. When paginating, all other parameters + # provided to `ListPartitionCursors` must match the call that provided the page + # token. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user diff --git a/generated/google/apis/texttospeech_v1beta1.rb b/generated/google/apis/texttospeech_v1beta1.rb index 50e4a4389..9dea57832 100644 --- a/generated/google/apis/texttospeech_v1beta1.rb +++ b/generated/google/apis/texttospeech_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/text-to-speech/ module TexttospeechV1beta1 VERSION = 'V1beta1' - REVISION = '20200619' + REVISION = '20200731' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/texttospeech_v1beta1/classes.rb b/generated/google/apis/texttospeech_v1beta1/classes.rb index afb85b3b0..63a366768 100644 --- a/generated/google/apis/texttospeech_v1beta1/classes.rb +++ b/generated/google/apis/texttospeech_v1beta1/classes.rb @@ -153,6 +153,11 @@ module Google # @return [Google::Apis::TexttospeechV1beta1::AudioConfig] attr_accessor :audio_config + # Whether and what timepoints are returned in the response. + # Corresponds to the JSON property `enableTimePointing` + # @return [Array] + attr_accessor :enable_time_pointing + # Contains text input to be synthesized. Either `text` or `ssml` must be # supplied. Supplying both or neither returns # google.rpc.Code.INVALID_ARGUMENT. The input size is limited to 5000 @@ -173,6 +178,7 @@ module Google # Update properties of this object def update!(**args) @audio_config = args[:audio_config] if args.key?(:audio_config) + @enable_time_pointing = args[:enable_time_pointing] if args.key?(:enable_time_pointing) @input = args[:input] if args.key?(:input) @voice = args[:voice] if args.key?(:voice) end @@ -182,6 +188,11 @@ module Google class SynthesizeSpeechResponse include Google::Apis::Core::Hashable + # Description of audio data to be synthesized. + # Corresponds to the JSON property `audioConfig` + # @return [Google::Apis::TexttospeechV1beta1::AudioConfig] + attr_accessor :audio_config + # The audio data bytes encoded as specified in the request, including the # header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS). # For LINEAR16 audio, we include the WAV header. Note: as @@ -192,13 +203,47 @@ module Google # @return [String] attr_accessor :audio_content + # A link between a position in the original request input and a corresponding + # time in the output audio. It's only supported via of SSML input. + # Corresponds to the JSON property `timepoints` + # @return [Array] + attr_accessor :timepoints + def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) + @audio_config = args[:audio_config] if args.key?(:audio_config) @audio_content = args[:audio_content] if args.key?(:audio_content) + @timepoints = args[:timepoints] if args.key?(:timepoints) + end + end + + # This contains a mapping between a certain point in the input text and a + # corresponding time in the output audio. + class Timepoint + include Google::Apis::Core::Hashable + + # Timepoint name as received from the client within tag. + # Corresponds to the JSON property `markName` + # @return [String] + attr_accessor :mark_name + + # Time offset in seconds from the start of the synthesized audio. + # Corresponds to the JSON property `timeSeconds` + # @return [Float] + attr_accessor :time_seconds + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @mark_name = args[:mark_name] if args.key?(:mark_name) + @time_seconds = args[:time_seconds] if args.key?(:time_seconds) end end diff --git a/generated/google/apis/texttospeech_v1beta1/representations.rb b/generated/google/apis/texttospeech_v1beta1/representations.rb index d8d9874d5..3b08cd433 100644 --- a/generated/google/apis/texttospeech_v1beta1/representations.rb +++ b/generated/google/apis/texttospeech_v1beta1/representations.rb @@ -52,6 +52,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class Timepoint + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class Voice class Representation < Google::Apis::Core::JsonRepresentation; end @@ -97,6 +103,7 @@ module Google class Representation < Google::Apis::Core::JsonRepresentation property :audio_config, as: 'audioConfig', class: Google::Apis::TexttospeechV1beta1::AudioConfig, decorator: Google::Apis::TexttospeechV1beta1::AudioConfig::Representation + collection :enable_time_pointing, as: 'enableTimePointing' property :input, as: 'input', class: Google::Apis::TexttospeechV1beta1::SynthesisInput, decorator: Google::Apis::TexttospeechV1beta1::SynthesisInput::Representation property :voice, as: 'voice', class: Google::Apis::TexttospeechV1beta1::VoiceSelectionParams, decorator: Google::Apis::TexttospeechV1beta1::VoiceSelectionParams::Representation @@ -107,7 +114,19 @@ module Google class SynthesizeSpeechResponse # @private class Representation < Google::Apis::Core::JsonRepresentation + property :audio_config, as: 'audioConfig', class: Google::Apis::TexttospeechV1beta1::AudioConfig, decorator: Google::Apis::TexttospeechV1beta1::AudioConfig::Representation + property :audio_content, :base64 => true, as: 'audioContent' + collection :timepoints, as: 'timepoints', class: Google::Apis::TexttospeechV1beta1::Timepoint, decorator: Google::Apis::TexttospeechV1beta1::Timepoint::Representation + + end + end + + class Timepoint + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :mark_name, as: 'markName' + property :time_seconds, as: 'timeSeconds' end end