Skip to main content
The REST API is now versioned. For more information, see "About API versioning."

Пакеты

Используйте REST API для взаимодействия с GitHub Packages.

Сведения о GitHub Packages

С помощью REST API можно управлять пакетами в репозиториях и организациях GitHub. Дополнительные сведения см. в разделе Восстановление и удаление пакетов.

Чтобы использовать REST API для управления GitHub Packages, необходимо пройти проверку подлинности с помощью personal access token (classic).

  • Чтобы получить доступ к метаданным пакета, маркер должен включать область read:packages.
  • Чтобы удалить пакеты и версии пакетов, маркер должен включать области read:packages и delete:packages.
  • Чтобы восстановить пакеты и версии пакетов, маркер должен включать области read:packages и write:packages.

Если пакет находится в реестре, который поддерживает детализированные разрешения, маркеру не требуется repo область для доступа к этому пакету или управления им. Если пакет находится в реестре, который поддерживает только разрешения на уровне репозитория, то маркер должен также включать repo область, так как пакет наследует разрешения от репозитория GitHub. Список реестров, которые поддерживают только разрешения на уровне репозитория, см. в разделе Сведения о разрешениях для GitHub Packages.

Чтобы получить доступ к ресурсам в организации с включенным единым входом, необходимо включить единый вход для personal access token (classic). Дополнительные сведения см. в разделе Авторизация personal access token для использования с единым вхожением SAMLв документации по GitHub Enterprise Cloud.

List packages for an organization

Lists all packages in an organization readable by the user.

To use this endpoint, you must authenticate using an access token with the packages:read scope. If the package_type belongs to a registry that only supports repository-scoped permissions, your token must also include the repo scope. For the list of GitHub Packages registries that only support repository-scoped permissions, see "About permissions for GitHub Packages."

Параметры

Headers
Name, Type, Description
acceptstring

Setting to application/vnd.github+json is recommended.

Path parameters
Name, Type, Description
orgstringRequired

The organization name. The name is not case sensitive.

Query parameters
Name, Type, Description
package_typestringRequired

The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry.

Can be one of: npm, maven, rubygems, docker, nuget, container

visibilitystring

The selected visibility of the packages. This parameter is optional and only filters an existing result set.

The internal visibility is only supported for GitHub Packages registries that allow for granular permissions. For other ecosystems internal is synonymous with private. For the list of GitHub Packages registries that support granular permissions, see "About permissions for GitHub Packages."

Can be one of: public, private, internal

Коды состояния HTTP-ответа

Код состоянияОписание
200

OK

401

Requires authentication

403

Forbidden