리포지토리 태그 목록 조회
리포지토리 태그 목록 조회
지정한 리포지토리의 태그 목록을 반환해요. 이 작업은 조직 액세스 토큰(OAT)에서 발급한 bearer 토큰을 받아요.
출처: 문서
본문
GET /v2/namespaces/{namespace}/repositories/{repository}/tags
리포지토리 태그 목록 조회 작업이에요. 지정한 리포지토리의 태그 목록을 반환해요. 이 작업은 조직 액세스 토큰(OAT)에서 발급한 bearer 토큰을 받아요.
요청 예시
실행 전에 자리 표시자를 바꾸고 필요 자격 증명이나 요청 바디를 채워야 해요.
curl \
--request GET \
--header "Authorization: Bearer ${TOKEN}" \
--header 'Accept: application/json' \
'https://hub.docker.com/v2/namespaces/<NAMESPACE>/repositories/<REPOSITORY>/tags'
요청과 응답
응답 200 list repository tags
Schema:
{
"$ref": "#/components/schemas/paginated_tags"
}
Schema example:
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"creator": 1234,
"full_size": 123456,
"id": 12345,
"images": [
{
"architecture": "amd64",
"features": null,
"last_pulled": null,
"last_pushed": "2021-01-05T21:06:53.506400Z",
"os": "linux",
"os_features": null,
"os_version": null,
"size": 123456,
"status": "active",
"variant": null
}
],
"last_updated": "2021-01-05T21:06:53.506400Z",
"last_updater": 1234,
"last_updater_username": "dockeruser",
"name": "latest",
"repository": 5678,
"tag_last_pulled": null,
"tag_last_pushed": "2021-01-05T21:06:53.506400Z",
"tag_status": "active",
"v2": true
}
]
}
응답 403 Forbidden
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "permission denied"
}
응답 404 Not Found
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "not found"
}
전체 작업 계약
{
"description": "Returns the list of tags for the specified repository.\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "ListRepositoryTags",
"parameters": [
{
"description": "Page number to get. Defaults to 1.",
"in": "query",
"name": "page",
"required": false,
"schema": {
"type": "integer"
}
},
{
"description": "Number of items to get per page. Defaults to 10. Max of 100.",
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"$ref": "#/components/responses/list_tags"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "List repository tags",
"tags": [
"repositories"
]
}