REST Resource: projects.locations.repositories

{
  "name": string,
  "format": enum (Format),
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "kmsKeyName": string,
  "mode": enum (Mode),
  "cleanupPolicies": {
    string: {
      object (CleanupPolicy)
    },
    ...
  },
  "sizeBytes": string,
  "satisfiesPzs": boolean,
  "cleanupPolicyDryRun": boolean,
  "disallowUnspecifiedMode": boolean,
  "satisfiesPzi": boolean,

  // Union field format_config can be only one of the following:
  "mavenConfig": {
    object (MavenRepositoryConfig)
  },
  "dockerConfig": {
    object (DockerRepositoryConfig)
  }
  // End of list of possible types for union field format_config.

  // Union field mode_config can be only one of the following:
  "virtualRepositoryConfig": {
    object (VirtualRepositoryConfig)
  },
  "remoteRepositoryConfig": {
    object (RemoteRepositoryConfig)
  }
  // End of list of possible types for union field mode_config.
}

string

The name of the repository, for example: projects/p1/locations/us-central1/repositories/repo1. For each location in a project, repository names must be unique.

enum (Format)

Optional. The format of packages that are stored in the repository.

string

The user-provided description of the repository.

map (key: string, value: string)

Labels with user-defined metadata. This field may contain up to 64 entries. Label keys and values may be no longer than 63 characters. Label keys must begin with a lowercase letter and may only contain lowercase letters, numeric characters, underscores, and dashes.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string (Timestamp format)

Output only. The time when the repository was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Output only. The time when the repository was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

string

The Cloud KMS resource name of the customer managed encryption key that's used to encrypt the contents of the Repository. Has the form: projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. This value may not be changed after the Repository has been created.

enum (Mode)

Optional. The mode of the repository.

map (key: string, value: object (CleanupPolicy))

Optional. Cleanup policies for this repository. Cleanup policies indicate when certain package versions can be automatically deleted. Map keys are policy IDs supplied by users during policy creation. They must unique within a repository and be under 128 characters in length.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string (int64 format)

Output only. The size, in bytes, of all artifact storage in this repository. Repositories that are generally available or in public preview use this to calculate storage costs.

boolean

Output only. If set, the repository satisfies physical zone separation.

boolean

Optional. If true, the cleanup pipeline is prevented from deleting versions in this repository.

boolean

Optional. If this is true, an unspecified repo type will be treated as error rather than defaulting to standard.

boolean

Output only. If set, the repository satisfies physical zone isolation.

object (MavenRepositoryConfig)

Maven repository config contains repository level configuration for the repositories of maven type.

object (DockerRepositoryConfig)

Docker repository config contains repository level configuration for the repositories of docker type.

object (VirtualRepositoryConfig)

Configuration specific for a Virtual Repository.

object (RemoteRepositoryConfig)

Configuration specific for a Remote Repository.

{
  "allowSnapshotOverwrites": boolean,
  "versionPolicy": enum (VersionPolicy)
}

boolean

The repository with this flag will allow publishing the same snapshot versions.

enum (VersionPolicy)

Version policy defines the versions that the registry will accept.

{
  "immutableTags": boolean
}

boolean

The repository which enabled this flag prevents all tags from being modified, moved or deleted. This does not prevent tags from being created.

{
  "upstreamPolicies": [
    {
      object (UpstreamPolicy)
    }
  ]
}

object (UpstreamPolicy)

Policies that configure the upstream artifacts distributed by the Virtual Repository. Upstream policies cannot be set on a standard repository.

{
  "id": string,
  "repository": string,
  "priority": integer
}

string

The user-provided ID of the upstream policy.

string

A reference to the repository resource, for example: projects/p1/locations/us-central1/repositories/repo1.

integer

Entries with a greater priority value take precedence in the pull order.

{
  "description": string,
  "upstreamCredentials": {
    object (UpstreamCredentials)
  },
  "disableUpstreamValidation": boolean,

  // Union field remote_source can be only one of the following:
  "dockerRepository": {
    object (DockerRepository)
  },
  "mavenRepository": {
    object (MavenRepository)
  },
  "npmRepository": {
    object (NpmRepository)
  },
  "pythonRepository": {
    object (PythonRepository)
  },
  "aptRepository": {
    object (AptRepository)
  },
  "yumRepository": {
    object (YumRepository)
  },
  "commonRepository": {
    object (CommonRemoteRepository)
  }
  // End of list of possible types for union field remote_source.
}

string

The description of the remote source.

object (UpstreamCredentials)

Optional. The credentials used to access the remote repository.

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.

object (DockerRepository)

Specific settings for a Docker remote repository.

object (MavenRepository)

Specific settings for a Maven remote repository.

object (NpmRepository)

Specific settings for an Npm remote repository.

object (PythonRepository)

Specific settings for a Python remote repository.

object (AptRepository)

Specific settings for an Apt remote repository.

object (YumRepository)

Specific settings for a Yum remote repository.

object (CommonRemoteRepository)

Common remote repository settings. Used as the remote repository upstream URL.

{

  // Union field upstream can be only one of the following:
  "publicRepository": enum (PublicRepository),
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

enum (PublicRepository)

One of the publicly available Docker repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "uri": string
}

string

An http/https uri reference to the custom remote repository, for ex: "https://registry-1.docker.io".

{

  // Union field upstream can be only one of the following:
  "publicRepository": enum (PublicRepository),
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

enum (PublicRepository)

One of the publicly available Maven repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "uri": string
}

string

An http/https uri reference to the upstream remote repository, for ex: "https://my.maven.registry/".

{

  // Union field upstream can be only one of the following:
  "publicRepository": enum (PublicRepository),
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

enum (PublicRepository)

One of the publicly available Npm repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "uri": string
}

string

An http/https uri reference to the upstream remote repository, for ex: "https://my.npm.registry/".

{

  // Union field upstream can be only one of the following:
  "publicRepository": enum (PublicRepository),
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

enum (PublicRepository)

One of the publicly available Python repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "uri": string
}

string

An http/https uri reference to the upstream remote repository, for ex: "https://my.python.registry/".

{

  // Union field upstream can be only one of the following:
  "publicRepository": {
    object (PublicRepository)
  },
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

object (PublicRepository)

One of the publicly available Apt repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "repositoryBase": enum (RepositoryBase),
  "repositoryPath": string
}

enum (RepositoryBase)

A common public repository base for Apt.

string

A custom field to define a path to a specific repository from the base.

{
  "uri": string
}

string

An http/https uri reference to the upstream remote repository, for ex: "https://my.apt.registry/".

{

  // Union field upstream can be only one of the following:
  "publicRepository": {
    object (PublicRepository)
  },
  "customRepository": {
    object (CustomRepository)
  }
  // End of list of possible types for union field upstream.
}

object (PublicRepository)

One of the publicly available Yum repositories supported by Artifact Registry.

object (CustomRepository)

Customer-specified remote repository.

{
  "repositoryBase": enum (RepositoryBase),
  "repositoryPath": string
}

enum (RepositoryBase)

A common public repository base for Yum.

string

A custom field to define a path to a specific repository from the base.

{
  "uri": string
}

string

An http/https uri reference to the upstream remote repository, for ex: "https://my.yum.registry/".

{
  "uri": string
}

string

Required. A common public repository base for remote repository.

{

  // Union field credentials can be only one of the following:
  "usernamePasswordCredentials": {
    object (UsernamePasswordCredentials)
  }
  // End of list of possible types for union field credentials.
}

object (UsernamePasswordCredentials)

Use username and password to access the remote repository.

{
  "username": string,
  "passwordSecretVersion": string
}

string

The username to access the remote repository.

string

The Secret Manager key version that holds the password to access the remote repository. Must be in the format of projects/{project}/secrets/{secret}/versions/{version}.

{
  "id": string,
  "action": enum (Action),

  // Union field condition_type can be only one of the following:
  "condition": {
    object (CleanupPolicyCondition)
  },
  "mostRecentVersions": {
    object (CleanupPolicyMostRecentVersions)
  }
  // End of list of possible types for union field condition_type.
}

string

The user-provided ID of the cleanup policy.

enum (Action)

Policy action.

object (CleanupPolicyCondition)

Policy condition for matching versions.

object (CleanupPolicyMostRecentVersions)

Policy condition for retaining a minimum number of versions. May only be specified with a Keep action.

{
  "tagPrefixes": [
    string
  ],
  "versionNamePrefixes": [
    string
  ],
  "packageNamePrefixes": [
    string
  ],
  "tagState": enum (TagState),
  "olderThan": string,
  "newerThan": string
}

string

Match versions by tag prefix. Applied on any prefix match.

string

Match versions by version name prefix. Applied on any prefix match.

string

Match versions by package prefix. Applied on any prefix match.

enum (TagState)

Match versions by tag status.

string (Duration format)

Match versions older than a duration.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

string (Duration format)

Match versions newer than a duration.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

{
  "packageNamePrefixes": [
    string
  ],
  "keepCount": integer
}

string

List of package name prefixes that will apply this rule.

integer

Minimum number of versions to keep.