v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1340127143.5 KB
projects

Creates a repository. The returned Operation will finish once the repository has been created. Its response will be the created Repository.

post/v1/{+parent}/repositories

Path parameters

parentstring required

Required. The name of the parent resource where the repository will be created.

Query parameters

repositoryIdstring

Required. The repository id to use for this repository.

Request body

descriptionstring

The user-provided description of the repository.

mode'MODE_UNSPECIFIED' | 'STANDARD_REPOSITORY' | 'VIRTUAL_REPOSITORY' | 'REMOTE_REPOSITORY' | 'AOSS_REPOSITORY' | 'ASSURED_OSS_REPOSITORY'

Optional. The mode of the repository.

labelsobject

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.

disallowUnspecifiedModeboolean

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

sizeBytesstring int64

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.

format'FORMAT_UNSPECIFIED' | 'DOCKER' | 'MAVEN' | 'NPM' | 'APT' | 'YUM' | 'GOOGET' | 'PYTHON' | 'KFP' | 'GO' | 'GENERIC' | 'RUBY'

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

cleanupPoliciesobject

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.

kmsKeyNamestring

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.

createTimestring google-datetime

Output only. The time when the repository was created.

registryUristring

Output only. The repository endpoint, for example: us-docker.pkg.dev/my-proj/my-repo.

satisfiesPziboolean

Output only. Whether or not this repository satisfies PZI.

namestring

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.

updateTimestring google-datetime

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

cleanupPolicyDryRunboolean

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

satisfiesPzsboolean

Output only. Whether or not this repository satisfies PZS.

Response

Successful response