google-cloud-data_catalog-v1 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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