RubyGems - google-apis-cloudnumberregistry_v1alpha - Versions diffs - 0.1.0 → 0.2.0 - Mend

google-apis-cloudnumberregistry_v1alpha 0.1.0 → 0.2.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 (7) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +5 -0
data/OVERVIEW.md +1 -1
data/lib/google/apis/cloudnumberregistry_v1alpha/classes.rb +142 -106
data/lib/google/apis/cloudnumberregistry_v1alpha/gem_version.rb +3 -3
data/lib/google/apis/cloudnumberregistry_v1alpha/service.rb +54 -49
metadata +3 -3

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 195680f59e4f8ccc2e4786d1fe3728b9cccb7bf5220691ec92bbf800332975c5
-  data.tar.gz: e3f4e18b6c6efdfe1a0deec5a867cc15b148917a3db24536bb14f06c8ee99f20
+  metadata.gz: a0365770b76bc0866875942379c0d7b61dd7936d3369da9c789e14d89439fef4
+  data.tar.gz: 3e18986220e19fe2bc6d90ac696cc8f88781f25aaa3328789620dd18110bd345
 SHA512:
-  metadata.gz: 5bcb9d76da0e8cfb3c731b8a021fd0ecb3badcf1ee6320d7d90b2785b3a52c038b332c85674715ac3e49d8eb76e72e047c478e0e4fbb78b9b64f963c5aba25c1
-  data.tar.gz: b606a9f90620d1ea1f2d51769a80ef011a2a22e0720cc681842e6047d452daadcadbe8377652b8ac22e8f52f09465501e2ed3590108c46c02f13caae93e82b28
+  metadata.gz: 95e4c5470c0d29f44e2a7e3bba6b350887c0d29d0c798a3f1093121cdd433257397c9697d318261800c8254a654e425d63c032ca824a560741174bf07314a928
+  data.tar.gz: cb36c849a70583d1f7838034da6a24f2e7bf99a39e329358528dc0d4844dc993c975a30e35e07f562f4cac13bbb1ec5b8412ff2ca5d84fcc7bacdf3479915a1c

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,10 @@
 # Release history for google-apis-cloudnumberregistry_v1alpha
+### v0.2.0 (2026-06-14)
+* Regenerated from discovery document revision 20260527
+* Regenerated using generator version 0.19.0
 ### v0.1.0 (2026-05-17)
 * Regenerated from discovery document revision 20260506

data/OVERVIEW.md CHANGED Viewed

@@ -83,7 +83,7 @@ The [product documentation](https://docs.cloud.google.com/number-registry/refere
 ## Supported Ruby versions
-This library is supported on Ruby 3.1+.
+This library is supported on Ruby 3.2+.
 Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.

data/lib/google/apis/cloudnumberregistry_v1alpha/classes.rb CHANGED Viewed

@@ -26,22 +26,22 @@ module Google
       class AggregatedData
         include Google::Apis::Core::Hashable
-        # Output only. Number of custom ranges in the RegistryBook.
+        # Output only. Number of CustomRanges in the RegistryBook.
         # Corresponds to the JSON property `customRangesCount`
         # @return [Fixnum]
         attr_accessor :custom_ranges_count
-        # Output only. Number of custom realms in the RegistryBook.
+        # Output only. Number of custom Realms in the RegistryBook.
         # Corresponds to the JSON property `customRealmsCount`
         # @return [Fixnum]
         attr_accessor :custom_realms_count
-        # Output only. Number of discovered ranges in the RegistryBook.
+        # Output only. Number of DiscoveredRanges in the RegistryBook.
         # Corresponds to the JSON property `discoveredRangesCount`
         # @return [Fixnum]
         attr_accessor :discovered_ranges_count
-        # Output only. Number of discovered realms in the RegistryBook.
+        # Output only. Number of discovered Realms in the RegistryBook.
         # Corresponds to the JSON property `discoveredRealmsCount`
         # @return [Fixnum]
         attr_accessor :discovered_realms_count
@@ -65,16 +65,16 @@ module Google
         end
       end
-      # Message describing Attribute object
+      # A key-value pair representing a custom attribute associated with a resource.
       class Attribute
         include Google::Apis::Core::Hashable
-        # Required. Key of attribute
+        # Required. The key of the attribute.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
-        # Required. Value of attribute
+        # Required. The value of the attribute.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -103,7 +103,8 @@ module Google
         end
       end
-      # Message for response to checking the availability of IpamAdminScopes
+      # Response message for the CloudNumberRegistry.CheckAvailabilityIpamAdminScopes
+      # method.
       class CheckAvailabilityIpamAdminScopesResponse
         include Google::Apis::Core::Hashable
@@ -122,7 +123,7 @@ module Google
         end
       end
-      # Message for cleaning up a IpamAdminScope
+      # Request message for the CloudNumberRegistry.CleanupIpamAdminScope method.
       class CleanupIpamAdminScopeRequest
         include Google::Apis::Core::Hashable
@@ -150,7 +151,7 @@ module Google
         end
       end
-      # Message describing CustomRange object
+      # A CustomRange represents a user-defined IP address range.
       class CustomRange
         include Google::Apis::Core::Hashable
@@ -159,7 +160,7 @@ module Google
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::Attribute>]
         attr_accessor :attributes
-        # Optional. Description of the CustomRange.
+        # Optional. The description of the CustomRange.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -174,33 +175,37 @@ module Google
         # @return [String]
         attr_accessor :ipv6_cidr_range
-        # Optional. Labels as key value pairs
+        # Optional. User-defined labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Required. Identifier. name of resource
+        # Required. Identifier. The resource name of the CustomRange, in the format `
+        # projects/`project`/locations/`location`/customRanges/`custom_range``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Optional. The parent range of the CustomRange. Do not allow setting parent
-        # range if realm is specified. Format must follow this pattern: projects/`
-        # project`/locations/`location`/customRanges/`custom_range`
+        # Optional. The resource name of the parent CustomRange, in the format `projects/
+        # `project`/locations/`location`/customRanges/`custom_range``. If specified, the
+        # parent CustomRange must be in the same RegistryBook. This field is mutually
+        # exclusive with the `realm` field, as the Realm is inherited from the parent
+        # CustomRange.
         # Corresponds to the JSON property `parentRange`
         # @return [String]
         attr_accessor :parent_range
-        # Optional. The realm of the CustomRange. The realm must be in the same project
-        # as the custom range. Do not allow setting realm if parent range is specified,
-        # since the realm should be inherited from the parent range. Format must follow
-        # this pattern: projects/`project`/locations/`location`/realms/`realm`
+        # Optional. The resource name of the Realm associated with the CustomRange, in
+        # the format `projects/`project`/locations/`location`/realms/`realm``. The Realm
+        # must be in the same project as the CustomRange. This field must not be set if
+        # the `parent_range` field is set, as the Realm will be inherited from the
+        # parent CustomRange.
         # Corresponds to the JSON property `realm`
         # @return [String]
         attr_accessor :realm
-        # Output only. The registry book of the CustomRange. This field is inherited
-        # from the realm or parent range depending on which one is specified.
+        # Output only. The RegistryBook of the CustomRange. This field is inherited from
+        # the Realm or parent CustomRange depending on which one is specified.
         # Corresponds to the JSON property `registryBook`
         # @return [String]
         attr_accessor :registry_book
@@ -223,7 +228,7 @@ module Google
         end
       end
-      # Message for disabling a IpamAdminScope
+      # Request message for the CloudNumberRegistry.DisableIpamAdminScope method.
       class DisableIpamAdminScopeRequest
         include Google::Apis::Core::Hashable
@@ -251,7 +256,8 @@ module Google
         end
       end
-      # Message describing DiscoveredRange object
+      # A DiscoveredRange represents an IP address range automatically detected by the
+      # discovery pipeline.
       class DiscoveredRange
         include Google::Apis::Core::Hashable
@@ -260,14 +266,14 @@ module Google
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::Attribute>]
         attr_accessor :attributes
-        # Output only. If true, allow child ranges of this range to overlap with each
-        # other.
+        # Output only. If true, allows child DiscoveredRanges of this DiscoveredRange to
+        # overlap with each other.
         # Corresponds to the JSON property `childCidrOverlapAllowed`
         # @return [Boolean]
         attr_accessor :child_cidr_overlap_allowed
         alias_method :child_cidr_overlap_allowed?, :child_cidr_overlap_allowed
-        # Output only. [Output only] Create time stamp
+        # Output only. The time at which the DiscoveredRange was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -277,7 +283,8 @@ module Google
         # @return [String]
         attr_accessor :description
-        # Discovery metadata of the discovered resource.
+        # Metadata about a discovered resource, tracking event times, state, and source
+        # information.
         # Corresponds to the JSON property `discoveryMetadata`
         # @return [Google::Apis::CloudnumberregistryV1alpha::DiscoveryMetadata]
         attr_accessor :discovery_metadata
@@ -292,32 +299,34 @@ module Google
         # @return [String]
         attr_accessor :ipv6_cidr_range
-        # Optional. Labels as key value pairs
+        # Optional. User-defined labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Required. Identifier. Name of the DiscoveredRange.
+        # Required. Identifier. The resource name of the DiscoveredRange, in the format `
+        # projects/`project`/locations/`location`/discoveredRanges/`discovered_range``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Optional. The parent range of the DiscoveredRange.
+        # Optional. The resource name of the parent DiscoveredRange, in the format `
+        # projects/`project`/locations/`location`/discoveredRanges/`discovered_range``.
         # Corresponds to the JSON property `parentRange`
         # @return [String]
         attr_accessor :parent_range
-        # Optional. The realm of the DiscoveredRange.
+        # Optional. The Realm of the DiscoveredRange.
         # Corresponds to the JSON property `realm`
         # @return [String]
         attr_accessor :realm
-        # Output only. The registry book of the DiscoveredRange.
+        # Output only. The RegistryBook of the DiscoveredRange.
         # Corresponds to the JSON property `registryBook`
         # @return [String]
         attr_accessor :registry_book
-        # Output only. [Output only] Update time stamp
+        # Output only. The time at which the DiscoveredRange was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -344,7 +353,8 @@ module Google
         end
       end
-      # Discovery metadata of the discovered resource.
+      # Metadata about a discovered resource, tracking event times, state, and source
+      # information.
       class DiscoveryMetadata
         include Google::Apis::Core::Hashable
@@ -377,7 +387,7 @@ module Google
         # Output only. A single source resource can be the source of multiple CNR
         # resources. This sub_id is used to distinguish between the different CNR
         # resources derived from the same upstream resource. For example, a single
-        # subnetwork can be the source of multiple ranges, one for each protocol. In
+        # subnetwork can be the source of multiple Ranges, one for each protocol. In
         # this case, the sub_id could be "private-ipv4" or "private-ipv6".
         # Corresponds to the JSON property `sourceSubId`
         # @return [String]
@@ -426,11 +436,12 @@ module Google
         end
       end
-      # Message for the response to finding free IP ranges.
+      # Response message for the CloudNumberRegistry.FindCustomRangeFreeIpRanges
+      # method.
       class FindCustomRangeFreeIpRangesResponse
         include Google::Apis::Core::Hashable
-        # Output only. Free IP CIDR ranges found in the CustomRange.
+        # Output only. The free IP CIDR ranges found.
         # Corresponds to the JSON property `freeIpCidrRanges`
         # @return [Array<String>]
         attr_accessor :free_ip_cidr_ranges
@@ -445,11 +456,12 @@ module Google
         end
       end
-      # Message for the response to finding free IP ranges.
+      # Response message for the CloudNumberRegistry.FindDiscoveredRangeFreeIpRanges
+      # method.
       class FindDiscoveredRangeFreeIpRangesResponse
         include Google::Apis::Core::Hashable
-        # Output only. Free IP CIDR ranges found in the DiscoveredRange.
+        # Output only. The free IP CIDR ranges found.
         # Corresponds to the JSON property `freeIpCidrRanges`
         # @return [Array<String>]
         attr_accessor :free_ip_cidr_ranges
@@ -464,27 +476,29 @@ module Google
         end
       end
-      # Message describing IpamAdminScope object
+      # An IpamAdminScope defines the administrative boundary for IP address discovery
+      # and management. It configures which platforms and organizational scopes are
+      # enabled for IP tracking.
       class IpamAdminScope
         include Google::Apis::Core::Hashable
-        # Output only. [Output only] Create time stamp
+        # Output only. The time at which the IpamAdminScope was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
-        # Required. Addon platforms that are enabled for this IPAM admin scope. Cloud
+        # Required. Add-on platforms that are enabled for this IpamAdminScope. Cloud
         # Number Registry only discovers the IP addresses from the enabled platforms.
         # Corresponds to the JSON property `enabledAddonPlatforms`
         # @return [Array<String>]
         attr_accessor :enabled_addon_platforms
-        # Optional. Labels as key value pairs
+        # Optional. User-defined labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Required. Identifier. name of resource
+        # Required. Identifier. The resource name of the IpamAdminScope.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -501,7 +515,7 @@ module Google
         # @return [String]
         attr_accessor :state
-        # Output only. [Output only] Update time stamp
+        # Output only. The time at which the IpamAdminScope was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -522,7 +536,7 @@ module Google
         end
       end
-      # Message for the availability of an IpamAdminScope
+      # Availability details for a specific IpamAdminScope.
       class IpamAdminScopeAvailability
         include Google::Apis::Core::Hashable
@@ -553,16 +567,17 @@ module Google
         end
       end
-      # Message for response to listing CustomRanges
+      # Response message for the CloudNumberRegistry.ListCustomRanges method.
       class ListCustomRangesResponse
         include Google::Apis::Core::Hashable
-        # The list of CustomRange
+        # The list of CustomRanges.
         # Corresponds to the JSON property `customRanges`
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::CustomRange>]
         attr_accessor :custom_ranges
-        # A token identifying a page of results the server should return.
+        # A 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
@@ -584,16 +599,17 @@ module Google
         end
       end
-      # Message for response to listing DiscoveredRanges
+      # Response message for the CloudNumberRegistry.ListDiscoveredRanges method.
       class ListDiscoveredRangesResponse
         include Google::Apis::Core::Hashable
-        # The list of DiscoveredRange
+        # The list of DiscoveredRanges.
         # Corresponds to the JSON property `discoveredRanges`
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::DiscoveredRange>]
         attr_accessor :discovered_ranges
-        # A token identifying a page of results the server should return.
+        # A 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
@@ -615,16 +631,17 @@ module Google
         end
       end
-      # Message for response to listing ipamAdminScopes
+      # Response message for the CloudNumberRegistry.ListIpamAdminScopes method.
       class ListIpamAdminScopesResponse
         include Google::Apis::Core::Hashable
-        # The list of IpamAdminScope
+        # The list of IpamAdminScopes.
         # Corresponds to the JSON property `ipamAdminScopes`
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::IpamAdminScope>]
         attr_accessor :ipam_admin_scopes
-        # A token identifying a page of results the server should return.
+        # A 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
@@ -705,7 +722,7 @@ module Google
         end
       end
-      # Message for response to listing Realms
+      # Response message for the CloudNumberRegistry.ListRealms method.
       class ListRealmsResponse
         include Google::Apis::Core::Hashable
@@ -714,7 +731,7 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
-        # The list of Realm
+        # The list of Realms.
         # Corresponds to the JSON property `realms`
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::Realm>]
         attr_accessor :realms
@@ -736,7 +753,7 @@ module Google
         end
       end
-      # Message for response to listing RegistryBooks
+      # Response message for the CloudNumberRegistry.ListRegistryBooks method.
       class ListRegistryBooksResponse
         include Google::Apis::Core::Hashable
@@ -935,21 +952,23 @@ module Google
         end
       end
-      # Message describing either a CustomRange or a DiscoveredRange.
+      # Represents either a CustomRange or a DiscoveredRange.
       class Range
         include Google::Apis::Core::Hashable
-        # Message describing CustomRange object
+        # A CustomRange represents a user-defined IP address range.
         # Corresponds to the JSON property `customRange`
         # @return [Google::Apis::CloudnumberregistryV1alpha::CustomRange]
         attr_accessor :custom_range
-        # Message describing DiscoveredRange object
+        # A DiscoveredRange represents an IP address range automatically detected by the
+        # discovery pipeline.
         # Corresponds to the JSON property `discoveredRange`
         # @return [Google::Apis::CloudnumberregistryV1alpha::DiscoveredRange]
         attr_accessor :discovered_range
-        # Message for the utilization of an IP range
+        # Utilization metrics for an IP Range, including consumed and produced address
+        # counts.
         # Corresponds to the JSON property `utilization`
         # @return [Google::Apis::CloudnumberregistryV1alpha::RangeUtilization]
         attr_accessor :utilization
@@ -966,21 +985,22 @@ module Google
         end
       end
-      # Message for the utilization of an IP range
+      # Utilization metrics for an IP Range, including consumed and produced address
+      # counts.
       class RangeUtilization
         include Google::Apis::Core::Hashable
-        # Output only. The total number of IP addresses consumed in the range.
+        # Output only. The total number of IP addresses consumed in the Range.
         # Corresponds to the JSON property `totalConsumed`
         # @return [String]
         attr_accessor :total_consumed
-        # Output only. The total number of IP addresses produced in the range.
+        # Output only. The total number of IP addresses produced in the Range.
         # Corresponds to the JSON property `totalProduced`
         # @return [String]
         attr_accessor :total_produced
-        # Output only. The usage of the range as a percentage. This is marked as
+        # Output only. The usage of the Range as a percentage. This is marked as
         # optional so that we have presence tracking and API responses show 0.0 instead
         # of NULL.
         # Corresponds to the JSON property `usage`
@@ -999,7 +1019,9 @@ module Google
         end
       end
-      # Message describing Realm object
+      # A Realm represents a distinct network domain or security zone. It groups
+      # Ranges that share the same traffic and management characteristics. All the
+      # ranges in a Realm are routable to each other, meaning that they cannot overlap.
       class Realm
         include Google::Apis::Core::Hashable
@@ -1008,47 +1030,48 @@ module Google
         # @return [Google::Apis::CloudnumberregistryV1alpha::RealmAggregatedData]
         attr_accessor :aggregated_data
-        # Output only. [Output only] Create time stamp
+        # Output only. The time at which the Realm was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
-        # Discovery metadata of the discovered resource.
+        # Metadata about a discovered resource, tracking event times, state, and source
+        # information.
         # Corresponds to the JSON property `discoveryMetadata`
         # @return [Google::Apis::CloudnumberregistryV1alpha::DiscoveryMetadata]
         attr_accessor :discovery_metadata
-        # Optional. IP version of the realm.
+        # Optional. IP version of the Realm.
         # Corresponds to the JSON property `ipVersion`
         # @return [String]
         attr_accessor :ip_version
-        # Optional. Labels as key value pairs
+        # Optional. User-defined labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Required. Management type of realm.
+        # Required. Management type of the Realm.
         # Corresponds to the JSON property `managementType`
         # @return [String]
         attr_accessor :management_type
-        # Required. Identifier. Unique name/ID of the realm
+        # Required. Identifier. The resource name of the Realm.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Required. URI of the registry book that claims the realm.
+        # Required. Name of the RegistryBook that claims the Realm.
         # Corresponds to the JSON property `registryBook`
         # @return [String]
         attr_accessor :registry_book
-        # Required. Traffic type of realm.
+        # Required. Traffic type of the Realm.
         # Corresponds to the JSON property `trafficType`
         # @return [String]
         attr_accessor :traffic_type
-        # Output only. [Output only] Update time stamp
+        # Output only. The time at which the Realm was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -1076,12 +1099,12 @@ module Google
       class RealmAggregatedData
         include Google::Apis::Core::Hashable
-        # Output only. Number of custom ranges in the Realm.
+        # Output only. Number of CustomRanges in the Realm.
         # Corresponds to the JSON property `customRangesCount`
         # @return [Fixnum]
         attr_accessor :custom_ranges_count
-        # Output only. Number of discovered ranges in the Realm.
+        # Output only. Number of DiscoveredRanges in the Realm.
         # Corresponds to the JSON property `discoveredRangesCount`
         # @return [Fixnum]
         attr_accessor :discovered_ranges_count
@@ -1097,7 +1120,8 @@ module Google
         end
       end
-      # Message describing RegistryBook object
+      # A RegistryBook organizes and manages IP address space. It claims specific
+      # scopes (such as projects) and groups related Realms and Ranges.
       class RegistryBook
         include Google::Apis::Core::Hashable
@@ -1113,7 +1137,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :claimed_scopes
-        # Output only. [Output only] Create time stamp
+        # Output only. The time at which the RegistryBook was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -1124,17 +1148,17 @@ module Google
         attr_accessor :is_default
         alias_method :is_default?, :is_default
-        # Optional. Labels as key value pairs
+        # Optional. User-defined labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
-        # Required. Identifier. name of resource
+        # Required. Identifier. The resource name of the RegistryBook.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Output only. [Output only] Update time stamp
+        # Output only. The time at which the RegistryBook was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -1155,11 +1179,16 @@ module Google
         end
       end
-      # Message for searching IP resources
+      # Request message for the CloudNumberRegistry.SearchIpResources method.
       class SearchIpResourcesRequest
         include Google::Apis::Core::Hashable
-        # Optional. Hint for how to order the results
+        # Optional. Hint for how to order the results. Supported sort fields are: - `
+        # name`: Sort alphabetically by the resource name. - `create_time`: Sort by the
+        # creation timestamp of the resource. - `update_time`: Sort by the last update
+        # timestamp of the resource. Supported directions are `asc` (ascending) and `
+        # desc` (descending). If unspecified, direction defaults to `asc`. Only sorting
+        # by a single field is supported.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
         attr_accessor :order_by
@@ -1178,30 +1207,31 @@ module Google
         # Optional. Search query. This string filters resources in an AIP-160-like
         # format. It has some limitations. You can only specify top level conjunctions
         # or attribute level negations. Each restriction can only be used once except
-        # the attribute restriction. The available restrictions for ranges are: - `realm`
-        # : The realm name to search in. - `ip_address`: The IP address to search for
-        # within ranges. - `ip_version`: The IP version to filter by (e.g., "IPV4", "
-        # IPV6"). - `parent_range`: The parent range of the range to search for. - `
-        # attribute_text`: The attribute text to search for within ranges. - `attribute`:
+        # the attribute restriction. The available restrictions for Ranges are: - `realm`
+        # : The Realm name to search in. - `ip_address`: The IP address to search for
+        # within Ranges. - `ip_version`: The IP version to filter by (e.g., "IPV4", "
+        # IPV6"). - `parent_range`: The parent Range of the Range to search for. - `
+        # attribute_text`: The attribute text to search for within Ranges. - `attribute`:
         # The attribute key and value to filter by. The available restrictions for
-        # realms are: - `ip_version`: The IP version to search for. Only one of
+        # Realms are: - `ip_version`: The IP version to search for. - `management_type`:
+        # The management type of the Realm (e.g., "CNR", "USER"). Only one of
         # attribute_text or multiple attribute filters can be specified. Examples: - `
         # realm=test-realm` - `realm=test-realm AND ip_address=10.0.0.0` - `realm=test-
         # realm AND ip_version=IPV6` - `realm=test-realm AND attribute_text=test` - `
         # ip_address=10.0.0.0 AND attribute:(key1=value1) AND attribute:(key2=value2)` -
         # `attribute_text=test AND parent_range=projects/123/locations/global/
-        # discoveredRanges/test-parent-range`
+        # discoveredRanges/test-parent-range` - `management_type=CNR`
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
         # Optional. The type of resources to search for. If not specified, the server
-        # will return ranges.
+        # will return Ranges.
         # Corresponds to the JSON property `searchResourceTypes`
         # @return [Array<String>]
         attr_accessor :search_resource_types
-        # Optional. Whether to show the utilization of the ranges in the response.
+        # Optional. Whether to show the utilization of the Ranges in the response.
         # Corresponds to the JSON property `showUtilization`
         # @return [Boolean]
         attr_accessor :show_utilization
@@ -1222,7 +1252,7 @@ module Google
         end
       end
-      # Message for response to searching IP resources
+      # Response message for the CloudNumberRegistry.SearchIpResources method.
       class SearchIpResourcesResponse
         include Google::Apis::Core::Hashable
@@ -1231,7 +1261,7 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
-        # Deprecated: Use results field instead. The list of ranges matching the search
+        # Deprecated: Use results field instead. The list of Ranges matching the search
         # query.
         # Corresponds to the JSON property `ranges`
         # @return [Array<Google::Apis::CloudnumberregistryV1alpha::Range>]
@@ -1260,16 +1290,18 @@ module Google
         end
       end
-      # A result matching the search query, which can be either a range or a realm.
+      # A result matching the search query, which can be either a Range or a Realm.
       class SearchIpResourcesResult
         include Google::Apis::Core::Hashable
-        # Message describing either a CustomRange or a DiscoveredRange.
+        # Represents either a CustomRange or a DiscoveredRange.
         # Corresponds to the JSON property `range`
         # @return [Google::Apis::CloudnumberregistryV1alpha::Range]
         attr_accessor :range
-        # Message describing Realm object
+        # A Realm represents a distinct network domain or security zone. It groups
+        # Ranges that share the same traffic and management characteristics. All the
+        # ranges in a Realm are routable to each other, meaning that they cannot overlap.
         # Corresponds to the JSON property `realm`
         # @return [Google::Apis::CloudnumberregistryV1alpha::Realm]
         attr_accessor :realm
@@ -1285,16 +1317,17 @@ module Google
         end
       end
-      # Message for the response to getting the utilization of a CustomRange
+      # Response message for the CloudNumberRegistry.ShowCustomRangeUtilization method.
       class ShowCustomRangeUtilizationResponse
         include Google::Apis::Core::Hashable
-        # Message describing CustomRange object
+        # A CustomRange represents a user-defined IP address range.
         # Corresponds to the JSON property `customRange`
         # @return [Google::Apis::CloudnumberregistryV1alpha::CustomRange]
         attr_accessor :custom_range
-        # Message for the utilization of an IP range
+        # Utilization metrics for an IP Range, including consumed and produced address
+        # counts.
         # Corresponds to the JSON property `rangeUtilization`
         # @return [Google::Apis::CloudnumberregistryV1alpha::RangeUtilization]
         attr_accessor :range_utilization
@@ -1310,16 +1343,19 @@ module Google
         end
       end
-      # Message for the response to getting the utilization of a DiscoveredRange
+      # Response message for the CloudNumberRegistry.ShowDiscoveredRangeUtilization
+      # method.
       class ShowDiscoveredRangeUtilizationResponse
         include Google::Apis::Core::Hashable
-        # Message describing DiscoveredRange object
+        # A DiscoveredRange represents an IP address range automatically detected by the
+        # discovery pipeline.
         # Corresponds to the JSON property `discoveredRange`
         # @return [Google::Apis::CloudnumberregistryV1alpha::DiscoveredRange]
         attr_accessor :discovered_range
-        # Message for the utilization of an IP range
+        # Utilization metrics for an IP Range, including consumed and produced address
+        # counts.
         # Corresponds to the JSON property `rangeUtilization`
         # @return [Google::Apis::CloudnumberregistryV1alpha::RangeUtilization]
         attr_accessor :range_utilization

data/lib/google/apis/cloudnumberregistry_v1alpha/gem_version.rb CHANGED Viewed

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudnumberregistryV1alpha
       # Version of the google-apis-cloudnumberregistry_v1alpha gem
-      GEM_VERSION = "0.1.0"
+      GEM_VERSION = "0.2.0"
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.18.0"
+      GENERATOR_VERSION = "0.19.0"
       # Revision of the discovery document this client was generated from
-      REVISION = "20260506"
+      REVISION = "20260527"
     end
   end
 end

data/lib/google/apis/cloudnumberregistry_v1alpha/service.rb CHANGED Viewed

@@ -139,10 +139,11 @@ module Google
         # Creates a new CustomRange in a given project and location.
         # @param [String] parent
-        #   Required. Value for parent.
+        #   Required. The parent resource name where the CustomRange will be created.
         # @param [Google::Apis::CloudnumberregistryV1alpha::CustomRange] custom_range_object
         # @param [String] custom_range_id
-        #   Required. Id of the requesting object.
+        #   Required. The ID to use for the CustomRange, which will become the final
+        #   segment of the resource name.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
         #   request ID so that if you must retry your request, the server will know to
@@ -187,7 +188,7 @@ module Google
         # Deletes a single CustomRange.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the CustomRange to delete.
         # @param [Boolean] force
         #   Optional. If set to true, all associated resources will be deleted.
         # @param [String] request_id
@@ -232,7 +233,7 @@ module Google
         # Finds free IP ranges in a single CustomRange.
         # @param [String] name
-        #   Required. Name of the CustomRange.
+        #   Required. The resource name of the CustomRange to search within.
         # @param [Fixnum] cidr_prefix_length
         #   Required. The prefix length of the free IP ranges to find.
         # @param [Fixnum] range_count
@@ -280,7 +281,7 @@ module Google
         # Gets details of a single CustomRange.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the CustomRange to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -310,9 +311,9 @@ module Google
         # Lists CustomRanges in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for ListCustomRangesRequest
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Filtering results.
+        #   Optional. Filter expression to filter the results.
         # @param [String] order_by
         #   Optional. Hint for how to order the results.
         # @param [Fixnum] page_size
@@ -353,7 +354,8 @@ module Google
         # Updates the parameters of a single CustomRange.
         # @param [String] name
-        #   Required. Identifier. name of resource
+        #   Required. Identifier. The resource name of the CustomRange, in the format `
+        #   projects/`project`/locations/`location`/customRanges/`custom_range``.
         # @param [Google::Apis::CloudnumberregistryV1alpha::CustomRange] custom_range_object
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -405,7 +407,7 @@ module Google
         # Gets the details of a single CustomRange and its utilization.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the CustomRange.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -435,7 +437,7 @@ module Google
         # Finds free IP ranges in a single DiscoveredRange.
         # @param [String] name
-        #   Required. Name of the DiscoveredRange.
+        #   Required. The resource name of the DiscoveredRange to search within.
         # @param [Fixnum] cidr_prefix_length
         #   Required. The prefix length of the free IP ranges to find.
         # @param [Fixnum] range_count
@@ -483,7 +485,7 @@ module Google
         # Gets details of a single DiscoveredRange.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the DiscoveredRange to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -513,9 +515,9 @@ module Google
         # Lists DiscoveredRanges in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for ListDiscoveredRangesRequest
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Filtering results.
+        #   Optional. Filter expression to filter the results.
         # @param [String] order_by
         #   Optional. Hint for how to order the results.
         # @param [Fixnum] page_size
@@ -556,7 +558,7 @@ module Google
         # Gets the details of a single DiscoveredRange and its utilization.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the DiscoveredRange.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -584,11 +586,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # Checks the availability of IPAM admin scopes in a given project and location.
+        # Checks the availability of IpamAdminScopes in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for the IpamAdminScopes.
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [Array<String>, String] scopes
-        #   Required. The scopes of the IpamAdminScopes to look for.
+        #   Required. The administrative scopes to check for availability.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -619,7 +621,7 @@ module Google
         # Cleans up a single IpamAdminScope.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the IpamAdminScope to clean up.
         # @param [Google::Apis::CloudnumberregistryV1alpha::CleanupIpamAdminScopeRequest] cleanup_ipam_admin_scope_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -652,10 +654,11 @@ module Google
         # Creates a new IpamAdminScope in a given project and location.
         # @param [String] parent
-        #   Required. Value for parent.
+        #   Required. The parent resource name where the IpamAdminScope will be created.
         # @param [Google::Apis::CloudnumberregistryV1alpha::IpamAdminScope] ipam_admin_scope_object
         # @param [String] ipam_admin_scope_id
-        #   Required. Id of the requesting object.
+        #   Required. The ID to use for the IpamAdminScope, which will become the final
+        #   segment of the resource name.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
         #   request ID so that if you must retry your request, the server will know to
@@ -700,7 +703,7 @@ module Google
         # Deletes a single IpamAdminScope.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the IpamAdminScope to delete.
         # @param [Boolean] force
         #   Optional. If set to true, all associated resources will be deleted.
         # @param [String] request_id
@@ -745,7 +748,7 @@ module Google
         # Disables a single IpamAdminScope.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the IpamAdminScope to disable.
         # @param [Google::Apis::CloudnumberregistryV1alpha::DisableIpamAdminScopeRequest] disable_ipam_admin_scope_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -778,7 +781,7 @@ module Google
         # Gets details of a single IpamAdminScope.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the IpamAdminScope to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -806,13 +809,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
-        # List all IPAM admin scopes in a given project and location.
+        # Lists IpamAdminScopes in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for ListIpamAdminScopesRequest
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Filtering results
+        #   Optional. Filter expression to filter the results.
         # @param [String] order_by
-        #   Optional. Hint for how to order the results
+        #   Optional. Hint for how to order the results.
         # @param [Fixnum] page_size
         #   Optional. Requested page size. Server may return fewer items than requested.
         #   If unspecified, server will pick an appropriate default.
@@ -851,7 +854,7 @@ module Google
         # Updates the parameters of a single IpamAdminScope.
         # @param [String] name
-        #   Required. Identifier. name of resource
+        #   Required. Identifier. The resource name of the IpamAdminScope.
         # @param [Google::Apis::CloudnumberregistryV1alpha::IpamAdminScope] ipam_admin_scope_object
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -1056,10 +1059,11 @@ module Google
         # Creates a new Realm in a given project and location.
         # @param [String] parent
-        #   Required. Value for parent.
+        #   Required. The parent resource name where the Realm will be created.
         # @param [Google::Apis::CloudnumberregistryV1alpha::Realm] realm_object
         # @param [String] realm_id
-        #   Required. Id of the requesting object.
+        #   Required. The ID to use for the Realm, which will become the final segment of
+        #   the resource name.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
         #   request ID so that if you must retry your request, the server will know to
@@ -1098,7 +1102,7 @@ module Google
         # Deletes a single Realm.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the Realm to delete.
         # @param [Boolean] force
         #   Optional. If set to true, all associated resources will be deleted.
         # @param [String] request_id
@@ -1137,9 +1141,9 @@ module Google
         # Gets details of a single Realm.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the Realm to retrieve.
         # @param [String] view
-        #   Optional. The view of the Realm.
+        #   Optional. The view of the Realm to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1170,18 +1174,18 @@ module Google
         # Lists Realms in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for ListRealmsRequest
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Filtering results
+        #   Optional. Filter expression to filter the results.
         # @param [String] order_by
-        #   Optional. Hint for how to order the results
+        #   Optional. Hint for how to order the results.
         # @param [Fixnum] page_size
         #   Optional. Requested page size. Server may return fewer items than requested.
         #   If unspecified, server will pick an appropriate default.
         # @param [String] page_token
         #   Optional. A token identifying a page of results the server should return.
         # @param [String] view
-        #   Optional. The view of the Realm.
+        #   Optional. The view of the Realm to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1216,7 +1220,7 @@ module Google
         # Updates the parameters of a single Realm.
         # @param [String] name
-        #   Required. Identifier. Unique name/ID of the realm
+        #   Required. Identifier. The resource name of the Realm.
         # @param [Google::Apis::CloudnumberregistryV1alpha::Realm] realm_object
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -1259,10 +1263,11 @@ module Google
         # Creates a new RegistryBook in a given project and location.
         # @param [String] parent
-        #   Required. Value for parent.
+        #   Required. The parent resource name where the RegistryBook will be created.
         # @param [Google::Apis::CloudnumberregistryV1alpha::RegistryBook] registry_book_object
         # @param [String] registry_book_id
-        #   Required. Id of the requesting object.
+        #   Required. The ID to use for the RegistryBook, which will become the final
+        #   segment of the resource name.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
         #   request ID so that if you must retry your request, the server will know to
@@ -1307,7 +1312,7 @@ module Google
         # Deletes a single RegistryBook.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the RegistryBook to delete.
         # @param [Boolean] force
         #   Optional. If set to true, all associated resources will be deleted.
         # @param [String] request_id
@@ -1352,9 +1357,9 @@ module Google
         # Gets details of a single RegistryBook.
         # @param [String] name
-        #   Required. Name of the resource
+        #   Required. The resource name of the RegistryBook to retrieve.
         # @param [String] view
-        #   Optional. The view of the RegistryBook.
+        #   Optional. The view of the RegistryBook to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1385,18 +1390,18 @@ module Google
         # Lists RegistryBooks in a given project and location.
         # @param [String] parent
-        #   Required. Parent value for ListRegistryBooksRequest
+        #   Required. The parent resource name, for example `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Filtering results
+        #   Optional. Filter expression to filter the results.
         # @param [String] order_by
-        #   Optional. Hint for how to order the results
+        #   Optional. Hint for how to order the results.
         # @param [Fixnum] page_size
         #   Optional. Requested page size. Server may return fewer items than requested.
         #   If unspecified, server will pick an appropriate default.
         # @param [String] page_token
         #   Optional. A token identifying a page of results the server should return.
         # @param [String] view
-        #   Optional. The view of the RegistryBook.
+        #   Optional. The view of the RegistryBook to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1431,7 +1436,7 @@ module Google
         # Updates the parameters of a single RegistryBook.
         # @param [String] name
-        #   Required. Identifier. name of resource
+        #   Required. Identifier. The resource name of the RegistryBook.
         # @param [Google::Apis::CloudnumberregistryV1alpha::RegistryBook] registry_book_object
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -1483,7 +1488,7 @@ module Google
         # Searches IP resources in a given RegistryBook.
         # @param [String] name
-        #   Required. The name of the RegistryBook to search in.
+        #   Required. The resource name of the RegistryBook to search in.
         # @param [Google::Apis::CloudnumberregistryV1alpha::SearchIpResourcesRequest] search_ip_resources_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudnumberregistry_v1alpha
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudnumberregistry_v1alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudnumberregistry_v1alpha/v0.1.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudnumberregistry_v1alpha/v0.2.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudnumberregistry_v1alpha
 rdoc_options: []
 require_paths:
@@ -66,7 +66,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="