Artifact Registry API (artifactregistry:v1)

2022-01-16

27 new methods

Additions

    Methods
  • artifactregistry.projects.updateProjectSettings

      HTTP Method: PATCH

      Flat Path: v1/projects/{projectsId}/projectSettings

      Description: Updates the Settings for the Project.

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameter Order: name

      Path: v1/{+name}

      Parameters:

        updateMask

          Format: google-fieldmask

          Type: string

          Location: query

          Description: Field mask to support partial updates.

        name

          Type: string

          Pattern: ^projects/[^/]+/projectSettings$

          Location: path

          Required: Yes

          Description: The name of the project's settings. Always of the form: projects/{project-id}/projectSettings In update request: never set In response: always set

  • artifactregistry.projects.getProjectSettings

  • artifactregistry.projects.locations.repositories.packages.list

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • HTTP Method: GET

      Description: Lists packages.

      Path: v1/{+parent}/packages

      Parameters:

        pageToken

          Description: The next_page_token value returned from a previous list request, if any.

          Location: query

          Type: string

        parent

          Location: path

          Description: Required. The name of the parent resource whose packages will be listed.

          Required: Yes

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Type: string

        pageSize

          Type: integer

          Location: query

          Description: The maximum number of packages to return. Maximum page size is 1,000.

          Format: int32

      Parameter Order: parent

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages

  • artifactregistry.projects.locations.repositories.packages.delete

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Path: v1/{+name}

      HTTP Method: DELETE

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}

      Parameter Order: name

      Parameters:

        name

          Required: Yes

          Location: path

          Type: string

          Description: Required. The name of the package to delete.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$

      Description: Deletes a package and all of its versions and tags. The returned operation will complete once the package has been deleted.

  • artifactregistry.projects.locations.repositories.packages.get

  • artifactregistry.projects.locations.repositories.packages.tags.get

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Description: Gets a tag.

      Parameter Order: name

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/tags/{tagsId}

      HTTP Method: GET

      Path: v1/{+name}

      Parameters:

        name

          Type: string

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+/tags/[^/]+$

          Required: Yes

          Location: path

          Description: The name of the tag to retrieve.

  • artifactregistry.projects.locations.repositories.packages.tags.create

      Parameters:

        parent

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$

          Location: path

          Required: Yes

          Type: string

          Description: The name of the parent resource where the tag will be created.

        tagId

          Type: string

          Location: query

          Description: The tag id to use for this repository.

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/tags

      Path: v1/{+parent}/tags

      Description: Creates a tag.

      Parameter Order: parent

      HTTP Method: POST

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • artifactregistry.projects.locations.repositories.packages.tags.patch

      Description: Updates a tag.

      Path: v1/{+name}

      Parameter Order: name

      Parameters:

        updateMask

          Type: string

          Format: google-fieldmask

          Location: query

          Description: The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask

        name

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+/tags/[^/]+$

          Location: path

          Required: Yes

          Type: string

          Description: The name of the tag, for example: "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/tags/tag1". If the package part contains slashes, the slashes are escaped. The tag part can only have characters in [a-zA-Z0-9\-._~:@], anything else must be URL encoded.

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/tags/{tagsId}

      HTTP Method: PATCH

  • artifactregistry.projects.locations.repositories.packages.tags.list

      Parameters:

        parent

          Type: string

          Description: The name of the parent resource whose tags will be listed.

          Required: Yes

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$

          Location: path

        pageSize

          Location: query

          Type: integer

          Format: int32

          Description: The maximum number of tags to return. Maximum page size is 10,000.

        filter

          Description: An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `version` An example 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`.

          Location: query

          Type: string

        pageToken

          Type: string

          Location: query

          Description: The next_page_token value returned from a previous list request, if any.

      Path: v1/{+parent}/tags

      Description: Lists tags.

      Parameter Order: parent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • HTTP Method: GET

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/tags

  • artifactregistry.projects.locations.repositories.packages.tags.delete

      Parameters:

        name

          Type: string

          Description: The name of the tag to delete.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+/tags/[^/]+$

          Required: Yes

          Location: path

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/tags/{tagsId}

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Description: Deletes a tag.

      Path: v1/{+name}

      HTTP Method: DELETE

      Parameter Order: name

  • artifactregistry.projects.locations.repositories.packages.versions.get

      Path: v1/{+name}

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/versions/{versionsId}

      Description: Gets a version

      Parameters:

        name

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+/versions/[^/]+$

          Type: string

          Description: The name of the version to retrieve.

          Location: path

          Required: Yes

        view

          Enum Descriptions:

        • The default / unset value. The API will default to the BASIC view.
        • Includes basic information about the version, but not any related tags.
        • Include everything.
        • Enum:

        • VERSION_VIEW_UNSPECIFIED
        • BASIC
        • FULL
        • Description: The view that should be returned in the response.

          Location: query

          Type: string

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • HTTP Method: GET

      Parameter Order: name

  • artifactregistry.projects.locations.repositories.packages.versions.delete

      Parameters:

        force

          Type: boolean

          Location: query

          Description: By default, a version that is tagged may not be deleted. If force=true, the version and any tags pointing to the version are deleted.

        name

          Description: The name of the version to delete.

          Location: path

          Type: string

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+/versions/[^/]+$

          Required: Yes

      Parameter Order: name

      Description: Deletes a version and all of its content. The returned operation will complete once the version has been deleted.

      Path: v1/{+name}

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/versions/{versionsId}

      Scopes: https://www.googleapis.com/auth/cloud-platform

      HTTP Method: DELETE

  • artifactregistry.projects.locations.repositories.packages.versions.list

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Path: v1/{+parent}/versions

      Parameters:

        view

          Location: query

          Enum:

        • VERSION_VIEW_UNSPECIFIED
        • BASIC
        • FULL
        • Enum Descriptions:

        • The default / unset value. The API will default to the BASIC view.
        • Includes basic information about the version, but not any related tags.
        • Include everything.
        • Description: The view that should be returned in the response.

          Type: string

        pageToken

          Type: string

          Description: The next_page_token value returned from a previous list request, if any.

          Location: query

        pageSize

          Description: The maximum number of versions to return. Maximum page size is 1,000.

          Location: query

          Format: int32

          Type: integer

        parent

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+/packages/[^/]+$

          Description: The name of the parent resource whose versions will be listed.

          Location: path

          Type: string

          Required: Yes

        orderBy

          Description: Optional. Sorting field and order

          Location: query

          Type: string

      HTTP Method: GET

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/packages/{packagesId}/versions

      Parameter Order: parent

      Description: Lists versions.

  • artifactregistry.projects.locations.repositories.gooGetArtifacts.import

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/gooGetArtifacts:import

      Description: Imports GooGet artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.

      Parameter Order: parent

      Parameters:

        parent

          Required: Yes

          Description: The name of the parent resource where the artifacts will be imported.

          Location: path

          Type: string

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

      Path: v1/{+parent}/gooGetArtifacts:import

      HTTP Method: POST

  • artifactregistry.projects.locations.repositories.yumartifacts.upload

      Description: Directly uploads a Yum artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.

      Parameters:

        parent

          Required: Yes

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Location: path

          Type: string

          Description: The name of the parent resource where the artifacts will be uploaded.

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/yumArtifacts:create

      Path: v1/{+parent}/yumArtifacts:create

      Mediaupload:

        Protocols:

          Simple:

            Multipart: Yes

            Path: /upload/v1/{+parent}/yumArtifacts:create

        Accept: */*

      Supportsmediaupload: Yes

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameter Order: parent

      HTTP Method: POST

  • artifactregistry.projects.locations.repositories.files.list

      Parameters:

        pageSize

          Type: integer

          Location: query

          Format: int32

          Description: The maximum number of files to return.

        filter

          Type: string

          Location: query

          Description: An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` An example of using a filter: * `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`.

        parent

          Location: path

          Description: The name of the parent resource whose files will be listed.

          Required: Yes

          Type: string

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

        pageToken

          Description: The next_page_token value returned from a previous list request, if any.

          Type: string

          Location: query

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/files

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Parameter Order: parent

      Path: v1/{+parent}/files

      HTTP Method: GET

      Description: Lists files.

  • artifactregistry.projects.locations.repositories.files.get

  • artifactregistry.projects.locations.repositories.aptArtifacts.import

      HTTP Method: POST

      Description: Imports Apt artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.

      Path: v1/{+parent}/aptArtifacts:import

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameters:

        parent

          Description: The name of the parent resource where the artifacts will be imported.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Required: Yes

          Location: path

          Type: string

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/aptArtifacts:import

      Parameter Order: parent

  • artifactregistry.projects.locations.repositories.googetartifacts.upload

      Mediaupload:

        Protocols:

          Simple:

            Path: /upload/v1/{+parent}/googetArtifacts:create

            Multipart: Yes

        Accept: */*

      Path: v1/{+parent}/googetArtifacts:create

      Supportsmediaupload: Yes

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/googetArtifacts:create

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameter Order: parent

      Parameters:

        parent

          Required: Yes

          Type: string

          Description: The name of the parent resource where the artifacts will be uploaded.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Location: path

      HTTP Method: POST

      Description: Directly uploads a GooGet artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.

  • artifactregistry.projects.locations.repositories.yumArtifacts.import

      Description: Imports Yum (RPM) artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.

      Parameters:

        parent

          Location: path

          Required: Yes

          Description: The name of the parent resource where the artifacts will be imported.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Type: string

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/yumArtifacts:import

      Scopes: https://www.googleapis.com/auth/cloud-platform

      HTTP Method: POST

      Parameter Order: parent

      Path: v1/{+parent}/yumArtifacts:import

  • artifactregistry.projects.locations.repositories.aptartifacts.upload

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/aptArtifacts:create

      Mediaupload:

        Protocols:

          Simple:

            Path: /upload/v1/{+parent}/aptArtifacts:create

            Multipart: Yes

        Accept: */*

      HTTP Method: POST

      Parameter Order: parent

      Supportsmediaupload: Yes

      Description: Directly uploads an Apt artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.

      Parameters:

        parent

          Location: path

          Required: Yes

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Description: The name of the parent resource where the artifacts will be uploaded.

          Type: string

      Path: v1/{+parent}/aptArtifacts:create

  • artifactregistry.projects.locations.repositories.patch

      Parameters:

        updateMask

          Format: google-fieldmask

          Type: string

          Location: query

          Description: The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask

        name

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Required: Yes

          Type: string

          Location: path

          Description: The name of the repository, for example: "projects/p1/locations/us-central1/repositories/repo1".

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}

      HTTP Method: PATCH

      Path: v1/{+name}

      Description: Updates a repository.

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • artifactregistry.projects.locations.repositories.create

      Path: v1/{+parent}/repositories

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

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories

      Scopes: https://www.googleapis.com/auth/cloud-platform

      HTTP Method: POST

      Parameter Order: parent

      Parameters:

        parent

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

          Pattern: ^projects/[^/]+/locations/[^/]+$

          Location: path

          Required: Yes

          Type: string

        repositoryId

          Description: The repository id to use for this repository.

          Type: string

          Location: query

  • artifactregistry.projects.locations.repositories.testIamPermissions

      Path: v1/{+resource}:testIamPermissions

      Parameters:

        resource

          Required: Yes

          Location: path

          Description: REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Type: string

      Description: Tests if the caller has a list of permissions on a resource.

      Parameter Order: resource

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:testIamPermissions

      HTTP Method: POST

  • artifactregistry.projects.locations.repositories.setIamPolicy

      Description: Updates the IAM policy for a given resource.

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:setIamPolicy

      HTTP Method: POST

      Path: v1/{+resource}:setIamPolicy

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameters:

        resource

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Location: path

          Type: string

          Required: Yes

          Description: REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.

      Parameter Order: resource

  • artifactregistry.projects.locations.repositories.getIamPolicy

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Path: v1/{+resource}:getIamPolicy

      HTTP Method: GET

      Parameter Order: resource

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:getIamPolicy

      Description: Gets the IAM policy for a given resource.

      Parameters:

        resource

          Required: Yes

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Location: path

          Type: string

          Description: REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.

        options.requestedPolicyVersion

          Type: integer

          Description: Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

          Format: int32

          Location: query

  • artifactregistry.projects.locations.repositories.delete

      HTTP Method: DELETE

      Flat Path: v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}

      Path: v1/{+name}

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Description: Deletes a repository and all of its contents. The returned Operation will finish once the repository has been deleted. It will not have any Operation metadata and will return a google.protobuf.Empty response.

      Parameters:

        name

          Location: path

          Required: Yes

          Type: string

          Pattern: ^projects/[^/]+/locations/[^/]+/repositories/[^/]+$

          Description: Required. The name of the repository to delete.