google-cloud-artifact_registry-v1 1.0.1 → 1.1.0

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