google-cloud-data_catalog-v1 0.6.0 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/data_catalog/v1.rb +2 -0
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +182 -64
  4. data/lib/google/cloud/data_catalog/v1/data_catalog/paths.rb +23 -0
  5. data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +54 -0
  6. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +1320 -0
  7. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/credentials.rb +51 -0
  8. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/paths.rb +90 -0
  9. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +51 -0
  10. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +474 -0
  11. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/credentials.rb +51 -0
  12. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/paths.rb +69 -0
  13. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  14. data/lib/google/cloud/datacatalog/v1/common_pb.rb +1 -0
  15. data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +30 -0
  16. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +25 -0
  17. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +6 -3
  18. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +107 -0
  19. data/lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb +85 -0
  20. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +70 -0
  21. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb +62 -0
  22. data/lib/google/cloud/datacatalog/v1/search_pb.rb +2 -0
  23. data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +1 -0
  24. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +1 -0
  25. data/proto_docs/google/cloud/datacatalog/v1/common.rb +3 -0
  26. data/proto_docs/google/cloud/datacatalog/v1/data_source.rb +51 -0
  27. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +212 -111
  28. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +292 -0
  29. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +141 -0
  30. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +16 -4
  31. data/proto_docs/google/cloud/datacatalog/v1/search.rb +14 -0
  32. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +3 -0
  33. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +44 -21
  34. metadata +20 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a8a97349e6424b783f6e13b97cc9a4ec050ac63527f8aefe349794b38f2b40ef
4
- data.tar.gz: 74ac2b40b3434c28aa317ba17b1c2c1bcf8cab8f8f024c7ab8affe1582466d2a
3
+ metadata.gz: f0d20d7046b517c996118a5e750c47f2139b1da85f486e282a361b41f63241b5
4
+ data.tar.gz: f8a0cb9e881007eabb178a6eedb124c7b46bf9ea0394eef8b00781f2287e644b
5
5
  SHA512:
6
- metadata.gz: 4bdec3d265f60aa481ceaa979087a0701100ec9d41dec6529deb718da877729e5cbfa4b84d6dd39d55cd0c99a3bd818262ba60391b96fbd89114609a1f421814
7
- data.tar.gz: e8a068d6db78a0cac8aa3c6a2ad8542a23a1c905e3a810f8b9009850a4e8c95ead606931a765daebe5b444e3cdb73f8c70dc9d5755a34b5cc2538743194508ad
6
+ metadata.gz: ebbdb1779169cc15b708ca8c528703d7565f0ab760e7d6a8d3382c73b20e7aed15a64089849586c2cf5816b514672d3b3cca7d7da093c4d0461d966c637ef4c4
7
+ data.tar.gz: 98ddfa871e602e645e0b02339260ceb5db5b3800b18191750db7cf8704f18a199982d2f336d813198204781a13fde55063b3f179a4ea71a4a62eb44f38633ad7
@@ -17,6 +17,8 @@
17
17
  # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
18
 
19
19
  require "google/cloud/data_catalog/v1/data_catalog"
20
+ require "google/cloud/data_catalog/v1/policy_tag_manager"
21
+ require "google/cloud/data_catalog/v1/policy_tag_manager_serialization"
20
22
  require "google/cloud/data_catalog/v1/version"
21
23
 
22
24
  module Google
@@ -224,7 +224,7 @@ module Google
224
224
  # This is a custom method
225
225
  # (https://cloud.google.com/apis/design/custom_methods) and does not return
226
226
  # the complete resource, only the resource identifier and high level
227
- # fields. Clients can subsequentally call `Get` methods.
227
+ # fields. Clients can subsequently call `Get` methods.
228
228
  #
229
229
  # Note that Data Catalog search queries do not guarantee full recall. Query
230
230
  # results that match your query may not be returned, even in subsequent
@@ -256,8 +256,8 @@ module Google
256
256
  # `include_gcp_public_datasets` is considered invalid. Data Catalog will
257
257
  # return an error in such a case.
258
258
  # @param query [::String]
259
- # Required. The query string in search query syntax. The query must be
260
- # non-empty.
259
+ # Optional. The query string in search query syntax. An empty query string will result
260
+ # in all data assets (in the specified scope) that the user has access to.
261
261
  #
262
262
  # Query strings can be simple as "x" or more qualified as:
263
263
  #
@@ -274,8 +274,8 @@ module Google
274
274
  # for page_size is 1000. Throws an invalid argument for page_size > 1000.
275
275
  # @param page_token [::String]
276
276
  # Optional. Pagination token returned in an earlier
277
- # {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token},
278
- # which indicates that this is a continuation of a prior
277
+ # {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}, which
278
+ # indicates that this is a continuation of a prior
279
279
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
280
280
  # call, and that the system should return the next page of data. If empty,
281
281
  # the first page is returned.
@@ -366,16 +366,18 @@ module Google
366
366
  # the default parameter values, pass an empty Hash as a request object (see above).
367
367
  #
368
368
  # @param parent [::String]
369
- # Required. The name of the project this entry group is in. Example:
369
+ # Required. The name of the project this entry group belongs to. Example:
370
370
  #
371
- # * projects/\\{project_id}/locations/\\{location}
371
+ # `projects/{project_id}/locations/{location}`
372
372
  #
373
- # Note that this EntryGroup and its child resources may not actually be
374
- # stored in the location in this name.
373
+ # Note: The entry group itself and its child resources might not be
374
+ # stored in the location specified in its name.
375
375
  # @param entry_group_id [::String]
376
- # Required. The id of the entry group to create.
377
- # The id must begin with a letter or underscore, contain only English
378
- # letters, numbers and underscores, and be at most 64 characters.
376
+ # Required. The ID of the entry group to create.
377
+ #
378
+ # The ID must contain only letters (a-z, A-Z), numbers (0-9),
379
+ # underscores (_), and must start with a letter or underscore.
380
+ # The maximum size is 64 bytes when encoded in UTF-8.
379
381
  # @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
380
382
  # The entry group to create. Defaults to an empty entry group.
381
383
  #
@@ -518,8 +520,11 @@ module Google
518
520
  # @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
519
521
  # Required. The updated entry group. "name" field must be set.
520
522
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
521
- # The fields to update on the entry group. If absent or empty, all modifiable
522
- # fields are updated.
523
+ # Names of fields whose values to overwrite on an entry group.
524
+ #
525
+ # If this parameter is absent or empty, all modifiable fields
526
+ # are overwritten. If such fields are non-required and omitted in the
527
+ # request body, their values are emptied.
523
528
  #
524
529
  # @yield [response, operation] Access the result along with the RPC operation
525
530
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::EntryGroup]
@@ -658,16 +663,16 @@ module Google
658
663
  # the default parameter values, pass an empty Hash as a request object (see above).
659
664
  #
660
665
  # @param parent [::String]
661
- # Required. The name of the location that contains the entry groups, which
662
- # can be provided in URL format. Example:
666
+ # Required. The name of the location that contains the entry groups, which can be
667
+ # provided in URL format. Example:
663
668
  #
664
669
  # * projects/\\{project_id}/locations/\\{location}
665
670
  # @param page_size [::Integer]
666
- # Optional. The maximum number of items to return. Default is 10. Max limit
667
- # is 1000. Throws an invalid argument for `page_size > 1000`.
671
+ # Optional. The maximum number of items to return. Default is 10. Max limit is 1000.
672
+ # Throws an invalid argument for `page_size > 1000`.
668
673
  # @param page_token [::String]
669
- # Optional. Token that specifies which page is requested. If empty, the first
670
- # page is returned.
674
+ # Optional. Token that specifies which page is requested. If empty, the first page is
675
+ # returned.
671
676
  #
672
677
  # @yield [response, operation] Access the result along with the RPC operation
673
678
  # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DataCatalog::V1::EntryGroup>]
@@ -716,8 +721,8 @@ module Google
716
721
  end
717
722
 
718
723
  ##
719
- # Creates an entry. Only entries of 'FILESET' type or user-specified type can
720
- # be created.
724
+ # Creates an entry. Only entries of types 'FILESET', 'CLUSTER', 'DATA_STREAM'
725
+ # or with a user-specified type can be created.
721
726
  #
722
727
  # Users should enable the Data Catalog API in the project identified by
723
728
  # the `parent` parameter (see [Data Catalog Resource Project]
@@ -742,14 +747,18 @@ module Google
742
747
  # the default parameter values, pass an empty Hash as a request object (see above).
743
748
  #
744
749
  # @param parent [::String]
745
- # Required. The name of the entry group this entry is in. Example:
750
+ # Required. The name of the entry group this entry belongs to. Example:
746
751
  #
747
- # * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}
752
+ # `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`
748
753
  #
749
- # Note that this Entry and its child resources may not actually be stored in
750
- # the location in this name.
754
+ # Note: The entry itself and its child resources might not be stored in
755
+ # the location specified in its name.
751
756
  # @param entry_id [::String]
752
- # Required. The id of the entry to create.
757
+ # Required. The ID of the entry to create.
758
+ #
759
+ # The ID must contain only letters (a-z, A-Z), numbers (0-9),
760
+ # and underscores (_).
761
+ # The maximum size is 64 bytes when encoded in UTF-8.
753
762
  # @param entry [::Google::Cloud::DataCatalog::V1::Entry, ::Hash]
754
763
  # Required. The entry to create.
755
764
  #
@@ -823,26 +832,30 @@ module Google
823
832
  # @param entry [::Google::Cloud::DataCatalog::V1::Entry, ::Hash]
824
833
  # Required. The updated entry. The "name" field must be set.
825
834
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
826
- # The fields to update on the entry. If absent or empty, all modifiable
827
- # fields are updated.
835
+ # Names of fields whose values to overwrite on an entry.
836
+ #
837
+ # If this parameter is absent or empty, all modifiable fields
838
+ # are overwritten. If such fields are non-required and omitted in the
839
+ # request body, their values are emptied.
828
840
  #
829
841
  # The following fields are modifiable:
842
+ #
830
843
  # * For entries with type `DATA_STREAM`:
831
844
  # * `schema`
832
- # * For entries with type `FILESET`
845
+ # * For entries with type `FILESET`:
833
846
  # * `schema`
834
847
  # * `display_name`
835
848
  # * `description`
836
849
  # * `gcs_fileset_spec`
837
850
  # * `gcs_fileset_spec.file_patterns`
838
- # * For entries with `user_specified_type`
851
+ # * For entries with `user_specified_type`:
839
852
  # * `schema`
840
853
  # * `display_name`
841
854
  # * `description`
842
- # * user_specified_type
843
- # * user_specified_system
844
- # * linked_resource
845
- # * source_system_timestamps
855
+ # * `user_specified_type`
856
+ # * `user_specified_system`
857
+ # * `linked_resource`
858
+ # * `source_system_timestamps`
846
859
  #
847
860
  # @yield [response, operation] Access the result along with the RPC operation
848
861
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -1046,7 +1059,7 @@ module Google
1046
1059
  # @param options [::Gapic::CallOptions, ::Hash]
1047
1060
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1048
1061
  #
1049
- # @overload lookup_entry(linked_resource: nil, sql_resource: nil)
1062
+ # @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil)
1050
1063
  # Pass arguments to `lookup_entry` via keyword arguments. Note that at
1051
1064
  # least one keyword argument is required. To specify no parameters, or to keep all
1052
1065
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1072,8 +1085,24 @@ module Google
1072
1085
  # * `bigquery.dataset.project_id.dataset_id`
1073
1086
  # * `datacatalog.entry.project_id.location_id.entry_group_id.entry_id`
1074
1087
  #
1075
- # `*_id`s shoud satisfy the standard SQL rules for identifiers.
1088
+ # `*_id`s should satisfy the standard SQL rules for identifiers.
1076
1089
  # https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical.
1090
+ # @param fully_qualified_name [::String]
1091
+ # Fully qualified name (FQN) of the resource.
1092
+ #
1093
+ # FQNs take two forms:
1094
+ #
1095
+ # * For non-regionalized resources:
1096
+ #
1097
+ # `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
1098
+ #
1099
+ # * For regionalized resources:
1100
+ #
1101
+ # `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
1102
+ #
1103
+ # Example for a DPMS table:
1104
+ #
1105
+ # `dataproc_metastore:project_id.location_id.instance_id.database_id.table_id`
1077
1106
  #
1078
1107
  # @yield [response, operation] Access the result along with the RPC operation
1079
1108
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -1225,7 +1254,11 @@ module Google
1225
1254
  #
1226
1255
  # * projects/\\{project_id}/locations/us-central1
1227
1256
  # @param tag_template_id [::String]
1228
- # Required. The id of the tag template to create.
1257
+ # Required. The ID of the tag template to create.
1258
+ #
1259
+ # The ID must contain only lowercase letters (a-z), numbers (0-9),
1260
+ # or underscores (_), and must start with a letter or underscore.
1261
+ # The maximum size is 64 bytes when encoded in UTF-8.
1229
1262
  # @param tag_template [::Google::Cloud::DataCatalog::V1::TagTemplate, ::Hash]
1230
1263
  # Required. The tag template to create.
1231
1264
  #
@@ -1369,13 +1402,12 @@ module Google
1369
1402
  # @param tag_template [::Google::Cloud::DataCatalog::V1::TagTemplate, ::Hash]
1370
1403
  # Required. The template to update. The "name" field must be set.
1371
1404
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1372
- # The field mask specifies the parts of the template to overwrite.
1373
- #
1374
- # Allowed fields:
1375
- #
1376
- # * `display_name`
1405
+ # Names of fields whose values to overwrite on a tag template. Currently,
1406
+ # only `display_name` can be overwritten.
1377
1407
  #
1378
- # If absent or empty, all of the allowed fields above will be updated.
1408
+ # In general, if this parameter is absent or empty, all modifiable fields
1409
+ # are overwritten. If such fields are non-required and omitted in the
1410
+ # request body, their values are emptied.
1379
1411
  #
1380
1412
  # @yield [response, operation] Access the result along with the RPC operation
1381
1413
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplate]
@@ -1529,7 +1561,10 @@ module Google
1529
1561
  # * projects/\\{project_id}/locations/us-central1/tagTemplates/\\{tag_template_id}
1530
1562
  # @param tag_template_field_id [::String]
1531
1563
  # Required. The ID of the tag template field to create.
1532
- # Field ids can contain letters (both uppercase and lowercase), numbers
1564
+ #
1565
+ # Note: Adding a required field to an existing template is *not* allowed.
1566
+ #
1567
+ # Field IDs can contain letters (both uppercase and lowercase), numbers
1533
1568
  # (0-9), underscores (_) and dashes (-). Field IDs must be at least 1
1534
1569
  # character long and at most 128 characters long. Field IDs must also be
1535
1570
  # unique within their template.
@@ -1610,20 +1645,22 @@ module Google
1610
1645
  # @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
1611
1646
  # Required. The template to update.
1612
1647
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1613
- # Optional. The field mask specifies the parts of the template to be updated.
1614
- # Allowed fields:
1648
+ # Optional. Names of fields whose values to overwrite on an individual field of a tag
1649
+ # template. The following fields are modifiable:
1615
1650
  #
1616
1651
  # * `display_name`
1617
1652
  # * `type.enum_type`
1618
1653
  # * `is_required`
1619
1654
  #
1620
- # If `update_mask` is not set or empty, all of the allowed fields above will
1621
- # be updated.
1655
+ # If this parameter is absent or empty, all modifiable fields
1656
+ # are overwritten. If such fields are non-required and omitted in the request
1657
+ # body, their values are emptied with one exception: when updating an enum
1658
+ # type, the provided values are merged with the existing values. Therefore,
1659
+ # enum values can only be added, existing enum values cannot be deleted or
1660
+ # renamed.
1622
1661
  #
1623
- # When updating an enum type, the provided values will be merged with the
1624
- # existing values. Therefore, enum values can only be added, existing enum
1625
- # values cannot be deleted nor renamed. Updating a template field from
1626
- # optional to required is NOT allowed.
1662
+ # Additionally, updating a template field from optional to required is
1663
+ # *not* allowed.
1627
1664
  #
1628
1665
  # @yield [response, operation] Access the result along with the RPC operation
1629
1666
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
@@ -1697,8 +1734,7 @@ module Google
1697
1734
  #
1698
1735
  # * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}
1699
1736
  # @param new_tag_template_field_id [::String]
1700
- # Required. The new ID of this tag template field. For example,
1701
- # `my_new_field`.
1737
+ # Required. The new ID of this tag template field. For example, `my_new_field`.
1702
1738
  #
1703
1739
  # @yield [response, operation] Access the result along with the RPC operation
1704
1740
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
@@ -1745,6 +1781,77 @@ module Google
1745
1781
  raise ::Google::Cloud::Error.from_error(e)
1746
1782
  end
1747
1783
 
1784
+ ##
1785
+ # Renames an enum value in a tag template. The enum values have to be unique
1786
+ # within one enum field.
1787
+ #
1788
+ # @overload rename_tag_template_field_enum_value(request, options = nil)
1789
+ # Pass arguments to `rename_tag_template_field_enum_value` via a request object, either of type
1790
+ # {::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest} or an equivalent Hash.
1791
+ #
1792
+ # @param request [::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest, ::Hash]
1793
+ # A request object representing the call parameters. Required. To specify no
1794
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1795
+ # @param options [::Gapic::CallOptions, ::Hash]
1796
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1797
+ #
1798
+ # @overload rename_tag_template_field_enum_value(name: nil, new_enum_value_display_name: nil)
1799
+ # Pass arguments to `rename_tag_template_field_enum_value` via keyword arguments. Note that at
1800
+ # least one keyword argument is required. To specify no parameters, or to keep all
1801
+ # the default parameter values, pass an empty Hash as a request object (see above).
1802
+ #
1803
+ # @param name [::String]
1804
+ # Required. The name of the enum field value. Example:
1805
+ #
1806
+ # * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}/enumValues/\\{enum_value_display_name}
1807
+ # @param new_enum_value_display_name [::String]
1808
+ # Required. The new display name of the enum value. For example, `my_new_enum_value`.
1809
+ #
1810
+ # @yield [response, operation] Access the result along with the RPC operation
1811
+ # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1812
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1813
+ #
1814
+ # @return [::Google::Cloud::DataCatalog::V1::TagTemplateField]
1815
+ #
1816
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1817
+ #
1818
+ def rename_tag_template_field_enum_value request, options = nil
1819
+ raise ::ArgumentError, "request must be provided" if request.nil?
1820
+
1821
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest
1822
+
1823
+ # Converts hash and nil to an options object
1824
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1825
+
1826
+ # Customize the options with defaults
1827
+ metadata = @config.rpcs.rename_tag_template_field_enum_value.metadata.to_h
1828
+
1829
+ # Set x-goog-api-client and x-goog-user-project headers
1830
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1831
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1832
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
1833
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1834
+
1835
+ header_params = {
1836
+ "name" => request.name
1837
+ }
1838
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1839
+ metadata[:"x-goog-request-params"] ||= request_params_header
1840
+
1841
+ options.apply_defaults timeout: @config.rpcs.rename_tag_template_field_enum_value.timeout,
1842
+ metadata: metadata,
1843
+ retry_policy: @config.rpcs.rename_tag_template_field_enum_value.retry_policy
1844
+ options.apply_defaults metadata: @config.metadata,
1845
+ retry_policy: @config.retry_policy
1846
+
1847
+ @data_catalog_stub.call_rpc :rename_tag_template_field_enum_value, request, options: options do |response, operation|
1848
+ yield response, operation if block_given?
1849
+ return response
1850
+ end
1851
+ rescue ::GRPC::BadStatus => e
1852
+ raise ::Google::Cloud::Error.from_error(e)
1853
+ end
1854
+
1748
1855
  ##
1749
1856
  # Deletes a field in a tag template and all uses of that field.
1750
1857
  # Users should enable the Data Catalog API in the project identified by
@@ -1846,13 +1953,13 @@ module Google
1846
1953
  # the default parameter values, pass an empty Hash as a request object (see above).
1847
1954
  #
1848
1955
  # @param parent [::String]
1849
- # Required. The name of the resource to attach this tag to. Tags can be
1850
- # attached to Entries. Example:
1956
+ # Required. The name of the resource to attach this tag to. Tags can be attached to
1957
+ # entries. An entry can have up to 1000 attached tags. Example:
1851
1958
  #
1852
- # * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}/entries/\\{entry_id}
1959
+ # `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}`
1853
1960
  #
1854
- # Note that this Tag and its child resources may not actually be stored in
1855
- # the location in this name.
1961
+ # Note: The tag and its child resources might not be stored in
1962
+ # the location specified in its name.
1856
1963
  # @param tag [::Google::Cloud::DataCatalog::V1::Tag, ::Hash]
1857
1964
  # Required. The tag to create.
1858
1965
  #
@@ -1922,8 +2029,12 @@ module Google
1922
2029
  # @param tag [::Google::Cloud::DataCatalog::V1::Tag, ::Hash]
1923
2030
  # Required. The updated tag. The "name" field must be set.
1924
2031
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1925
- # The fields to update on the Tag. If absent or empty, all modifiable fields
1926
- # are updated. Currently the only modifiable field is the field `fields`.
2032
+ # Names of fields whose values to overwrite on a tag. Currently, a tag has
2033
+ # the only modifiable field with the name `fields`.
2034
+ #
2035
+ # In general, if this parameter is absent or empty, all modifiable fields
2036
+ # are overwritten. If such fields are non-required and omitted in the
2037
+ # request body, their values are emptied.
1927
2038
  #
1928
2039
  # @yield [response, operation] Access the result along with the RPC operation
1929
2040
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::Tag]
@@ -2057,8 +2168,8 @@ module Google
2057
2168
  # the default parameter values, pass an empty Hash as a request object (see above).
2058
2169
  #
2059
2170
  # @param parent [::String]
2060
- # Required. The name of the Data Catalog resource to list the tags of. The
2061
- # resource could be an {::Google::Cloud::DataCatalog::V1::Entry Entry} or an
2171
+ # Required. The name of the Data Catalog resource to list the tags of. The resource
2172
+ # could be an {::Google::Cloud::DataCatalog::V1::Entry Entry} or an
2062
2173
  # {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}.
2063
2174
  #
2064
2175
  # Examples:
@@ -2603,6 +2714,11 @@ module Google
2603
2714
  #
2604
2715
  attr_reader :rename_tag_template_field
2605
2716
  ##
2717
+ # RPC-specific configuration for `rename_tag_template_field_enum_value`
2718
+ # @return [::Gapic::Config::Method]
2719
+ #
2720
+ attr_reader :rename_tag_template_field_enum_value
2721
+ ##
2606
2722
  # RPC-specific configuration for `delete_tag_template_field`
2607
2723
  # @return [::Gapic::Config::Method]
2608
2724
  #
@@ -2683,6 +2799,8 @@ module Google
2683
2799
  @update_tag_template_field = ::Gapic::Config::Method.new update_tag_template_field_config
2684
2800
  rename_tag_template_field_config = parent_rpcs.rename_tag_template_field if parent_rpcs.respond_to? :rename_tag_template_field
2685
2801
  @rename_tag_template_field = ::Gapic::Config::Method.new rename_tag_template_field_config
2802
+ rename_tag_template_field_enum_value_config = parent_rpcs.rename_tag_template_field_enum_value if parent_rpcs.respond_to? :rename_tag_template_field_enum_value
2803
+ @rename_tag_template_field_enum_value = ::Gapic::Config::Method.new rename_tag_template_field_enum_value_config
2686
2804
  delete_tag_template_field_config = parent_rpcs.delete_tag_template_field if parent_rpcs.respond_to? :delete_tag_template_field
2687
2805
  @delete_tag_template_field = ::Gapic::Config::Method.new delete_tag_template_field_config
2688
2806
  create_tag_config = parent_rpcs.create_tag if parent_rpcs.respond_to? :create_tag
@@ -144,6 +144,29 @@ module Google
144
144
  "projects/#{project}/locations/#{location}/tagTemplates/#{tag_template}/fields/#{field}"
145
145
  end
146
146
 
147
+ ##
148
+ # Create a fully-qualified TagTemplateFieldEnumValue resource string.
149
+ #
150
+ # The resource will be in the following format:
151
+ #
152
+ # `projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{tag_template_field_id}/enumValues/{enum_value_display_name}`
153
+ #
154
+ # @param project [String]
155
+ # @param location [String]
156
+ # @param tag_template [String]
157
+ # @param tag_template_field_id [String]
158
+ # @param enum_value_display_name [String]
159
+ #
160
+ # @return [::String]
161
+ def tag_template_field_enum_value_path project:, location:, tag_template:, tag_template_field_id:, enum_value_display_name:
162
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
163
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
164
+ raise ::ArgumentError, "tag_template cannot contain /" if tag_template.to_s.include? "/"
165
+ raise ::ArgumentError, "tag_template_field_id cannot contain /" if tag_template_field_id.to_s.include? "/"
166
+
167
+ "projects/#{project}/locations/#{location}/tagTemplates/#{tag_template}/fields/#{tag_template_field_id}/enumValues/#{enum_value_display_name}"
168
+ end
169
+
147
170
  extend self
148
171
  end
149
172
  end