google-cloud-artifact_registry-v1 1.0.0 → 1.1.0

data/proto_docs/google/api/client.rb

@@ -28,6 +28,9 @@ module Google
     # @!attribute [rw] destinations
     #   @return [::Array<::Google::Api::ClientLibraryDestination>]
     #     The destination where API teams want this client library to be published.
+    # @!attribute [rw] selective_gapic_generation
+    #   @return [::Google::Api::SelectiveGapicGeneration]
+    #     Configuration for which RPCs should be generated in the GAPIC client.
     class CommonLanguageSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,32 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] experimental_features
+    #   @return [::Google::Api::PythonSettings::ExperimentalFeatures]
+    #     Experimental features to be included during client library generation.
     class PythonSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Experimental features to be included during client library generation.
+      # These fields will be deprecated once the feature graduates and is enabled
+      # by default.
+      # @!attribute [rw] rest_async_io_enabled
+      #   @return [::Boolean]
+      #     Enables generation of asynchronous REST clients if `rest` transport is
+      #     enabled. By default, asynchronous REST clients will not be generated.
+      #     This feature will be enabled by default 1 month after launching the
+      #     feature in preview packages.
+      # @!attribute [rw] protobuf_pythonic_types_enabled
+      #   @return [::Boolean]
+      #     Enables generation of protobuf code using new types that are more
+      #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
+      #     enabled by default 1 month after launching the feature in preview
+      #     packages.
+      class ExperimentalFeatures
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Node client libraries.
@@ -290,6 +316,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -298,17 +331,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -317,8 +347,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id
@@ -354,6 +384,17 @@ module Google
       end
     end
 
+    # This message is used to configure the generation of a subset of the RPCs in
+    # a service for client libraries.
+    # @!attribute [rw] methods
+    #   @return [::Array<::String>]
+    #     An allowlist of the fully qualified names of RPCs that should be included
+    #     on public client surfaces.
+    class SelectiveGapicGeneration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # The organization for which the client libraries are being published.
     # Affects the url where generated docs are published, etc.
     module ClientLibraryOrganization

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See

data/proto_docs/google/devtools/artifactregistry/v1/artifact.rb

@@ -83,7 +83,7 @@ module Google
         #     listed.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of artifacts to return.
+        #     The maximum number of artifacts to return. Maximum page size is 1,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.
@@ -162,7 +162,7 @@ module Google
         #     listed.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of artifacts to return.
+        #     The maximum number of artifacts to return. Maximum page size is 1,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.
@@ -230,7 +230,7 @@ module Google
         #     listed.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of artifacts to return.
+        #     The maximum number of artifacts to return. Maximum page size is 1,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.
@@ -302,7 +302,7 @@ module Google
         #     listed.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of artifacts to return.
+        #     The maximum number of artifacts to return. Maximum page size is 1,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.

data/proto_docs/google/devtools/artifactregistry/v1/attachment.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ArtifactRegistry
+      module V1
+        # An Attachment refers to additional metadata that can be attached to
+        # artifacts in Artifact Registry. An attachment consists of one or more files.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The name of the attachment. E.g.
+        #     `projects/p1/locations/us/repositories/repo/attachments/sbom`.
+        # @!attribute [rw] target
+        #   @return [::String]
+        #     Required. The target the attachment is for, can be a Version, Package or
+        #     Repository. E.g.
+        #     `projects/p1/locations/us-central1/repositories/repo1/packages/p1/versions/v1`.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     Type of attachment.
+        #     E.g. `application/vnd.spdx+json`
+        # @!attribute [rw] attachment_namespace
+        #   @return [::String]
+        #     The namespace this attachment belongs to.
+        #     E.g. If an attachment is created by artifact analysis, namespace is set
+        #     to `artifactanalysis.googleapis.com`.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. User annotations. These attributes can only be set and used by
+        #     the user, and not by Artifact Registry. See
+        #     https://google.aip.dev/128#annotations for more details such as format and
+        #     size limitations.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the attachment was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the attachment was last updated.
+        # @!attribute [rw] files
+        #   @return [::Array<::String>]
+        #     Required. The files that belong to this attachment.
+        #     If the file ID part contains slashes, they are escaped. E.g.
+        #     `projects/p1/locations/us-central1/repositories/repo1/files/sha:<sha-of-file>`.
+        # @!attribute [r] oci_version_name
+        #   @return [::String]
+        #     Output only. The name of the OCI version that this attachment created. Only
+        #     populated for Docker attachments. E.g.
+        #     `projects/p1/locations/us-central1/repositories/repo1/packages/p1/versions/v1`.
+        class Attachment
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The request to list attachments.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the parent resource whose attachments will be listed.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. An expression for filtering the results of the request. Filter
+        #     rules are case insensitive. The fields eligible for filtering are:
+        #
+        #       * `target`
+        #       * `type`
+        #       * `attachment_namespace`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of attachments to return. Maximum page size is 1,000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The next_page_token value returned from a previous list request, if any.
+        class ListAttachmentsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response from listing attachments.
+        # @!attribute [rw] attachments
+        #   @return [::Array<::Google::Cloud::ArtifactRegistry::V1::Attachment>]
+        #     The attachments returned.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     The token to retrieve the next page of attachments, or empty if there are
+        #     no more attachments to return.
+        class ListAttachmentsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to retrieve an attachment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the attachment to retrieve.
+        class GetAttachmentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to create a new attachment.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the parent resource where the attachment will be
+        #     created.
+        # @!attribute [rw] attachment_id
+        #   @return [::String]
+        #     Required. The attachment id to use for this attachment.
+        # @!attribute [rw] attachment
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Attachment]
+        #     Required. The attachment to be created.
+        class CreateAttachmentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to delete an attachment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the attachment to delete.
+        class DeleteAttachmentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/devtools/artifactregistry/v1/file.rb

@@ -49,7 +49,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     The name of the file, for example:
-        #     "projects/p1/locations/us-central1/repositories/repo1/files/a%2Fb%2Fc.txt".
+        #     `projects/p1/locations/us-central1/repositories/repo1/files/a%2Fb%2Fc.txt`.
         #     If the file ID part contains slashes, they are escaped.
         # @!attribute [rw] size_bytes
         #   @return [::Integer]
@@ -70,9 +70,21 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time when the last attempt to refresh the file's data was
         #     made. Only set when the repository is remote.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Client specified annotations.
         class File
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # The request to list files.
@@ -87,16 +99,54 @@ module Google
         #
         #       * `name`
         #       * `owner`
+        #       * `annotations`
+        #
+        #     Examples of using a filter:
+        #
+        #      To filter the results of your request to files with the name `my_file.txt`
+        #      in project `my-project` in the `us-central` region, in repository
+        #      `my-repo`, append the following filter expression to your request:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt"`
+        #
+        #      You can also use wildcards to match any number of characters before or
+        #      after the value:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-*"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file*"`
+        #
+        #      To filter the results of your request to files owned by the version `1.0`
+        #      in package `pkg1`, append the following filter expression to your request:
+        #
+        #       * `owner="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"`
+        #
+        #      To filter the results of your request to files with the annotation
+        #      key-value pair [`external_link`: `external_link_value`], append the
+        #      following filter expression to your request:
+        #
+        #       * `"annotations.external_link:external_link_value"`
+        #
+        #      To filter just for a specific annotation key `external_link`, append the
+        #      following filter expression to your request:
+        #
+        #       * `"annotations.external_link"`
         #
-        #      An example of using a filter:
+        #      If the annotation key or value contains special characters, you can escape
+        #      them by surrounding the value with backticks. For example, to filter the
+        #      results of your request to files with the annotation key-value pair
+        #      [`external.link`:`https://example.com/my-file`], append the following
+        #      filter expression to your request:
         #
-        #       * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*"` --> Files with an
-        #       ID starting with "a/b/".
-        #       * `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"` -->
-        #       Files owned by the version `1.0` in package `pkg1`.
+        #       * `` "annotations.`external.link`:`https://example.com/my-file`" ``
+        #
+        #      You can also filter with annotations with a wildcard to
+        #      match any number of characters before or after the value:
+        #
+        #       * `` "annotations.*_link:`*example.com*`" ``
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of files to return.
+        #     The maximum number of files to return. Maximum page size is 1,000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.
@@ -129,6 +179,29 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # The request to delete a file.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the file to delete.
+        class DeleteFileRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to update a file.
+        # @!attribute [rw] file
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::File]
+        #     Required. The File that replaces the resource on the server.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The update mask applies to the resource. For the `FieldMask`
+        #     definition, see
+        #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+        class UpdateFileRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/devtools/artifactregistry/v1/generic.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ArtifactRegistry
+      module V1
+        # GenericArtifact represents a generic artifact
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Resource name of the generic artifact.
+        #     project, location, repository, package_id and version_id
+        #     create a unique generic artifact.
+        #     i.e. "projects/test-project/locations/us-west4/repositories/test-repo/
+        #     genericArtifacts/package_id:version_id"
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     The version of the generic artifact.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the Generic module is created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the Generic module is updated.
+        class GenericArtifact
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/devtools/artifactregistry/v1/package.rb

@@ -37,9 +37,21 @@ module Google
         #   @return [::Google::Protobuf::Timestamp]
         #     The time when the package was last updated. This includes publishing a new
         #     version of the package.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Client specified annotations.
         class Package
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # The request to list packages.
@@ -52,6 +64,56 @@ module Google
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request, if any.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. An expression for filtering the results of the request. Filter
+        #     rules are case insensitive. The fields eligible for filtering are:
+        #
+        #       * `name`
+        #       * `annotations`
+        #
+        #     Examples of using a filter:
+        #
+        #      To filter the results of your request to packages with the name
+        #      `my-package` in project `my-project` in the `us-central` region, in
+        #      repository `my-repo`, append the following filter expression to your
+        #      request:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package"`
+        #
+        #      You can also use wildcards to match any number of characters before or
+        #      after the value:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-*"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*package"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*pack*"`
+        #
+        #      To filter the results of your request to packages with the annotation
+        #      key-value pair [`external_link`: `external_link_value`], append the
+        #      following filter expression to your request":
+        #
+        #       * `"annotations.external_link:external_link_value"`
+        #
+        #      To filter the results just for a specific annotation key `external_link`,
+        #      append the following filter expression to your request:
+        #
+        #       * `"annotations.external_link"`
+        #
+        #      If the annotation key or value contains special characters, you can escape
+        #      them by surrounding the value with backticks. For example, to filter the
+        #      results of your request to packages with the annotation key-value pair
+        #      [`external.link`:`https://example.com/my-package`], append the following
+        #      filter expression to your request:
+        #
+        #       * `` "annotations.`external.link`:`https://example.com/my-package`" ``
+        #
+        #      You can also filter with annotations with a wildcard to
+        #      match any number of characters before or after the value:
+        #
+        #       * `` "annotations.*_link:`*example.com*`" ``
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. The field to order the results by.
         class ListPackagesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -87,6 +149,20 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # The request to update a package.
+        # @!attribute [rw] package
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Package]
+        #     The package that replaces the resource on the server.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The update mask applies to the resource. For the `FieldMask` definition,
+        #     see
+        #     https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+        class UpdatePackageRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end