google-cloud-artifact_registry-v1 1.0.1 → 1.2.0

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

@@ -151,12 +151,20 @@ module Google
         # @!attribute [rw] yum_repository
         #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::YumRepository]
         #     Specific settings for a Yum remote repository.
+        # @!attribute [rw] common_repository
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::CommonRemoteRepository]
+        #     Common remote repository settings.
+        #     Used as the remote repository upstream URL.
         # @!attribute [rw] description
         #   @return [::String]
         #     The description of the remote source.
         # @!attribute [rw] upstream_credentials
         #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::UpstreamCredentials]
         #     Optional. The credentials used to access the remote repository.
+        # @!attribute [rw] disable_upstream_validation
+        #   @return [::Boolean]
+        #     Input only. A create/update remote repo option to avoid making a HEAD/GET
+        #     request to validate a remote repo and any supplied upstream credentials.
         class RemoteRepositoryConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -189,10 +197,23 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::DockerRepository::PublicRepository]
           #     One of the publicly available Docker repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::DockerRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class DockerRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the custom remote repository, for ex:
+            #     "https://registry-1.docker.io".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Predefined list of publicly available Docker repositories like Docker
             # Hub.
             module PublicRepository
@@ -209,10 +230,23 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::MavenRepository::PublicRepository]
           #     One of the publicly available Maven repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::MavenRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class MavenRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the upstream remote repository, for ex:
+            #     "https://my.maven.registry/".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Predefined list of publicly available Maven repositories like Maven
             # Central.
             module PublicRepository
@@ -229,10 +263,23 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::NpmRepository::PublicRepository]
           #     One of the publicly available Npm repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::NpmRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class NpmRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the upstream remote repository, for ex:
+            #     "https://my.npm.registry/".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Predefined list of publicly available NPM repositories like npmjs.
             module PublicRepository
               # Unspecified repository.
@@ -248,10 +295,23 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::PythonRepository::PublicRepository]
           #     One of the publicly available Python repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::PythonRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class PythonRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the upstream remote repository, for ex:
+            #     "https://my.python.registry/".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Predefined list of publicly available Python repositories like PyPI.org.
             module PublicRepository
               # Unspecified repository.
@@ -267,6 +327,9 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::AptRepository::PublicRepository]
           #     One of the publicly available Apt repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::AptRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class AptRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -293,8 +356,21 @@ module Google
 
                 # Ubuntu LTS/Pro.
                 UBUNTU = 2
+
+                # Archived Debian.
+                DEBIAN_SNAPSHOT = 3
               end
             end
+
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the upstream remote repository, for ex:
+            #     "https://my.apt.registry/".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # Configuration for a Yum remote repository.
@@ -302,6 +378,9 @@ module Google
           #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::YumRepository::PublicRepository]
           #     One of the publicly available Yum repositories supported by Artifact
           #     Registry.
+          # @!attribute [rw] custom_repository
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::RemoteRepositoryConfig::YumRepository::CustomRepository]
+          #     Customer-specified remote repository.
           class YumRepository
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -342,6 +421,25 @@ module Google
                 EPEL = 6
               end
             end
+
+            # Customer-specified publicly available remote repository.
+            # @!attribute [rw] uri
+            #   @return [::String]
+            #     An http/https uri reference to the upstream remote repository, for ex:
+            #     "https://my.yum.registry/".
+            class CustomRepository
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Common remote repository settings type.
+          # @!attribute [rw] uri
+          #   @return [::String]
+          #     Required. A common public repository base for remote repository.
+          class CommonRemoteRepository
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
         end
 
@@ -363,7 +461,8 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     The name of the repository, for example:
-        #     `projects/p1/locations/us-central1/repositories/repo1`.
+        #     `projects/p1/locations/us-central1/repositories/repo1`. For each location
+        #     in a project, repository names must be unique.
         # @!attribute [rw] format
         #   @return [::Google::Cloud::ArtifactRegistry::V1::Repository::Format]
         #     Optional. The format of packages that are stored in the repository.
@@ -410,6 +509,17 @@ module Google
         #   @return [::Boolean]
         #     Optional. If true, the cleanup pipeline is prevented from deleting versions
         #     in this repository.
+        # @!attribute [rw] vulnerability_scanning_config
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Repository::VulnerabilityScanningConfig]
+        #     Optional. Config and state for vulnerability scanning of resources within
+        #     this Repository.
+        # @!attribute [rw] disallow_unspecified_mode
+        #   @return [::Boolean]
+        #     Optional. If this is true, an unspecified repo type will be treated as
+        #     error rather than defaulting to standard.
+        # @!attribute [r] satisfies_pzi
+        #   @return [::Boolean]
+        #     Output only. If set, the repository satisfies physical zone isolation.
         class Repository
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -456,6 +566,56 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Config on whether to perform vulnerability scanning for resources in this
+          # repository, as well as output fields describing current state.
+          # @!attribute [rw] enablement_config
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::Repository::VulnerabilityScanningConfig::EnablementConfig]
+          #     Optional. Config for whether this repository has vulnerability scanning
+          #     disabled.
+          # @!attribute [r] last_enable_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The last time this repository config was enabled.
+          # @!attribute [r] enablement_state
+          #   @return [::Google::Cloud::ArtifactRegistry::V1::Repository::VulnerabilityScanningConfig::EnablementState]
+          #     Output only. State of feature enablement, combining repository enablement
+          #     config and API enablement state.
+          # @!attribute [r] enablement_state_reason
+          #   @return [::String]
+          #     Output only. Reason for the repository state.
+          class VulnerabilityScanningConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Config for vulnerability scanning of resources in this repository.
+            module EnablementConfig
+              # Not set. This will be treated as INHERITED.
+              ENABLEMENT_CONFIG_UNSPECIFIED = 0
+
+              # Scanning is Enabled, but dependent on API enablement.
+              INHERITED = 1
+
+              # No automatic vulnerability scanning will be performed for this
+              # repository.
+              DISABLED = 2
+            end
+
+            # Describes the state of vulnerability scanning in this repository,
+            # including both repository enablement and API enablement.
+            module EnablementState
+              # Enablement state is unclear.
+              ENABLEMENT_STATE_UNSPECIFIED = 0
+
+              # Repository does not support vulnerability scanning.
+              SCANNING_UNSUPPORTED = 1
+
+              # Vulnerability scanning is disabled for this repository.
+              SCANNING_DISABLED = 2
+
+              # Vulnerability scanning is active for this repository.
+              SCANNING_ACTIVE = 3
+            end
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -502,6 +662,9 @@ module Google
 
             # Go package format.
             GO = 10
+
+            # Generic package format.
+            GENERIC = 11
           end
 
           # The mode configures the repository to serve artifacts from different
@@ -532,6 +695,30 @@ 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`
+        #
+        #      Examples of using a filter:
+        #
+        #     To filter the results of your request to repositories with the name
+        #     `my-repo` in project `my-project` in the `us-central` region, append the
+        #     following filter expression to your request:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo"`
+        #
+        #      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-*"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/*repo"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/*repo*"`
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. The field to order the results by.
         class ListRepositoriesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -0,0 +1,149 @@
+# 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
+        # A rule defines the deny or allow action of the operation it applies to and
+        # the conditions required for the rule to apply. You can set one rule for an
+        # entire repository and one rule for each package within.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The name of the rule, for example:
+        #     `projects/p1/locations/us-central1/repositories/repo1/rules/rule1`.
+        # @!attribute [rw] action
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Rule::Action]
+        #     The action this rule takes.
+        # @!attribute [rw] operation
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Rule::Operation]
+        # @!attribute [rw] condition
+        #   @return [::Google::Type::Expr]
+        #     Optional. A CEL expression for conditions that must be met in order for the
+        #     rule to apply. If not provided, the rule matches all objects.
+        # @!attribute [rw] package_id
+        #   @return [::String]
+        #     The package ID the rule applies to.
+        #     If empty, this rule applies to all packages inside the repository.
+        class Rule
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Defines the action of the rule.
+          module Action
+            # Action not specified.
+            ACTION_UNSPECIFIED = 0
+
+            # Allow the operation.
+            ALLOW = 1
+
+            # Deny the operation.
+            DENY = 2
+          end
+
+          # The operation the rule applies to.
+          module Operation
+            # Operation not specified.
+            OPERATION_UNSPECIFIED = 0
+
+            # Download operation.
+            DOWNLOAD = 1
+          end
+        end
+
+        # The request to list rules.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the parent repository whose rules will be listed.
+        #     For example:
+        #     `projects/p1/locations/us-central1/repositories/repo1`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of rules 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 ListRulesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response from listing rules.
+        # @!attribute [rw] rules
+        #   @return [::Array<::Google::Cloud::ArtifactRegistry::V1::Rule>]
+        #     The rules returned.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     The token to retrieve the next page of rules, or empty if there are no
+        #     more rules to return.
+        class ListRulesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to retrieve a rule.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the rule to retrieve.
+        class GetRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to create a new rule.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the parent resource where the rule will be created.
+        # @!attribute [rw] rule_id
+        #   @return [::String]
+        #     The rule id to use for this repository.
+        # @!attribute [rw] rule
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Rule]
+        #     The rule to be created.
+        class CreateRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to update a rule.
+        # @!attribute [rw] rule
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Rule]
+        #     The rule 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 UpdateRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request to delete a rule.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the rule to delete.
+        class DeleteRuleRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -34,6 +34,10 @@ module Google
         # @!attribute [rw] legacy_redirection_state
         #   @return [::Google::Cloud::ArtifactRegistry::V1::ProjectSettings::RedirectionState]
         #     The redirection state of the legacy repositories in this project.
+        # @!attribute [rw] pull_percent
+        #   @return [::Integer]
+        #     The percentage of pull traffic to redirect from GCR to AR when using
+        #     partial redirection.
         class ProjectSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -51,6 +55,12 @@ module Google
 
             # Redirection is enabled, and has been finalized so cannot be reverted.
             REDIRECTION_FROM_GCR_IO_FINALIZED = 3
+
+            # Redirection is enabled and missing images are copied from GCR
+            REDIRECTION_FROM_GCR_IO_ENABLED_AND_COPYING = 5
+
+            # Redirection is partially enabled and missing images are copied from GCR
+            REDIRECTION_FROM_GCR_IO_PARTIAL_AND_COPYING = 6
           end
         end
 

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

@@ -33,7 +33,7 @@ module Google
         # @!attribute [rw] version
         #   @return [::String]
         #     The name of the version the tag refers to, for example:
-        #     "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/sha256:5243811"
+        #     `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/sha256:5243811`
         #     If the package or version ID parts contain slashes, the slashes are
         #     escaped.
         class Tag
@@ -52,15 +52,33 @@ module Google
         #     An expression for filtering the results of the request. Filter rules are
         #     case insensitive. The fields eligible for filtering are:
         #
+        #       * `name`
         #       * `version`
         #
-        #      An example of using a filter:
+        #      Examples of using a filter:
         #
-        #       * `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"`
-        #       --> Tags that are applied to the version `1.0` in package `pkg1`.
+        #      To filter the results of your request to tags with the name `my-tag` in
+        #      package `my-package` in repository `my-repo` in project "`y-project` in
+        #      the us-central region, append the following filter expression to your
+        #      request:
+        #
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag"`
+        #
+        #      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-package/tags/my*"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*"`
+        #
+        #      To filter the results of your request to tags applied to the version
+        #      `1.0` in package `my-package`, append the following filter expression to
+        #      your request:
+        #
+        #       * `version="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The maximum number of tags to return. Maximum page size is 10,000.
+        #     The maximum number of tags 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/version.rb

@@ -27,7 +27,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     The name of the version, for example:
-        #     "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/art1".
+        #     `projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/art1`.
         #     If the package or version ID parts contain slashes, the slashes are
         #     escaped.
         # @!attribute [rw] description
@@ -50,9 +50,21 @@ module Google
         #     resource. Currently, the resources could be:
         #     {::Google::Cloud::ArtifactRegistry::V1::DockerImage DockerImage}
         #     {::Google::Cloud::ArtifactRegistry::V1::MavenArtifact MavenArtifact}
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Client specified annotations.
         class Version
           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 versions.
@@ -71,6 +83,53 @@ module Google
         # @!attribute [rw] order_by
         #   @return [::String]
         #     Optional. The field to order the results by.
+        # @!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 versions with the name
+        #      `my-version` 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/versions/my-version"`
+        #
+        #      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-package/versions/*version"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my*"`
+        #       * `name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version*"`
+        #
+        #      To filter the results of your request to versions 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"`
+        #
+        #      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 versions with the annotation key-value pair
+        #      [`external.link`:`https://example.com/my-version`], append the following
+        #      filter expression to your request:
+        #
+        #       * `` "annotations.`external.link`:`https://example.com/my-version`" ``
+        #
+        #      You can also filter with annotations with a wildcard to
+        #      match any number of characters before or after the value:
+        #
+        #       * `` "annotations.*_link:`*example.com*`" ``
         class ListVersionsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -139,6 +198,20 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The request to update a version.
+        # @!attribute [rw] version
+        #   @return [::Google::Cloud::ArtifactRegistry::V1::Version]
+        #     Required. The Version 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 UpdateVersionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The view, which determines what version information is returned in a
         # response.
         module VersionView