Skip to main content

ociRepos

List OCI repositories in your organization's bundle catalog.

Returns a paginated list of repositories of every artifact type (bundles and resource types). Each repository is the container for all published versions of its artifact. Use filter to narrow by name, artifact type, or full-text search.

The list holds every repository you can see:

  • repositories your repo:view group policies match, plus
  • bundle repositories granted to a project you can view.

A grant to one of your projects adds its repository to the list even when no repo:view policy matches it, and a deny repo:view policy does not remove it. Use filter.projectId for the bundles granted to one project, and filter.viewer for the repositories your own policies match. When both are set, a repository must match both. To list a project's bundles and your own bundles together, make two queries.

Example: you can view projects checkout and billing, and your group policy allows repo:view on repositories with TEAM=payments.

RepositoryTEAMGranted to
aws-aurorapaymentsnone
aws-s3paymentscheckout
aws-iam-rolenonecheckout
aws-vpcnonebilling
filterResult
noneaws-aurora, aws-iam-role, aws-s3, aws-vpc
{ projectId: "checkout" }aws-iam-role, aws-s3
{ projectId: "billing" }aws-vpc
{ viewer: true }aws-aurora, aws-s3
{ viewer: false }aws-iam-role, aws-vpc
{ projectId: "checkout", viewer: true }aws-s3
{ projectId: "checkout", viewer: false }aws-iam-role
{ projectId: "billing", viewer: true }empty list
{ projectId: "x" }, no project:view on xNOT_FOUND error
query {
ociRepos(organizationId: "your-org-id", filter: { projectId: "ecomm" }) {
items { name }
}
}
query {
ociRepos(organizationId: "your-org-id", filter: { name: { startsWith: "aws-" } }) {
items {
id
name
tags(sort: { field: VERSION, order: DESC }) {
items { tag }
}
}
cursor { next }
}
}
ociRepos(
organizationId: ID!
filter: OciReposFilter
sort: OciReposSort
cursor: Cursor
): OciReposPage

Arguments​

ociRepos.organizationId ● ID! non-null scalar {#organization-id}​

Your organization's unique identifier.

ociRepos.filter ● OciReposFilter input {#filter}​

Narrow results by name, artifact type, or search term.

ociRepos.sort ● OciReposSort input {#sort}​

Explicit sort order. Defaults to name ascending. When a search filter is active and no sort is provided, results are ranked by relevance.

ociRepos.cursor ● Cursor input {#cursor}​

Cursor from a previous page's cursor.next or cursor.previous.

Type​

OciReposPage object​