네임스페이스 안의 리포지토리 조회
네임스페이스 안의 리포지토리 조회
지정한 네임스페이스(조직 또는 사용자) 안의 리포지토리를 반환해요. 공개 리포지토리는 누구나 접근할 수 있지만, 비공개 리포지토리는 적절한 인증과 권한이 필요해요.
출처: 문서
본문
GET /v2/namespaces/{namespace}/repositories/{repository}
네임스페이스 안의 리포지토리 조회 작업이에요. 지정한 네임스페이스(조직 또는 사용자) 안의 리포지토리를 반환해요. 공개 리포지토리는 누구나 접근할 수 있지만, 비공개 리포지토리는 적절한 인증과 권한이 필요해요.
요청 예시
실행 전에 자리 표시자를 바꾸고 필요 자격 증명이나 요청 바디를 채워야 해요.
curl \
--request GET \
--header "Authorization: Bearer ${TOKEN}" \
--header 'Accept: application/json' \
'https://hub.docker.com/v2/namespaces/<NAMESPACE>/repositories/<REPOSITORY>'
요청과 응답
응답 200 Schema:
{
"$ref": "#/components/schemas/repository_info"
}
Example:
{
"categories": [],
"collaborator_count": 0,
"content_types": [],
"date_registered": "2025-01-20T10:30:00Z",
"description": "A sample application repository",
"full_description": "This is a comprehensive description of my application repository that contains additional details about the project.",
"has_starred": false,
"hub_user": "myorganization",
"immutable_tags_settings": {
"enabled": false,
"rules": []
},
"is_automated": false,
"is_private": false,
"last_updated": "2025-01-20T10:30:00Z",
"media_types": [],
"name": "my-app",
"namespace": "myorganization",
"permissions": {
"admin": true,
"read": true,
"write": true
},
"pull_count": 0,
"repository_type": "image",
"source": null,
"star_count": 0,
"status": 1,
"status_description": "Active",
"storage_size": null,
"user": "myorganization"
}
응답 401 Unauthorized
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "unauthorized"
}
응답 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"
}
응답 500 Internal
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "internal error"
}
전체 작업 계약
{
"description": "Returns a repository within the specified namespace (organization or user).\n\nPublic repositories are accessible to everyone, while private repositories require appropriate authentication and permissions.\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "GetRepository",
"responses": {
"200": {
"content": {
"application/json": {
"example": {
"categories": [],
"collaborator_count": 0,
"content_types": [],
"date_registered": "2025-01-20T10:30:00Z",
"description": "A sample application repository",
"full_description": "This is a comprehensive description of my application repository that contains additional details about the project.",
"has_starred": false,
"hub_user": "myorganization",
"immutable_tags_settings": {
"enabled": false,
"rules": []
},
"is_automated": false,
"is_private": false,
"last_updated": "2025-01-20T10:30:00Z",
"media_types": [],
"name": "my-app",
"namespace": "myorganization",
"permissions": {
"admin": true,
"read": true,
"write": true
},
"pull_count": 0,
"repository_type": "image",
"source": null,
"star_count": 0,
"status": 1,
"status_description": "Active",
"storage_size": null,
"user": "myorganization"
},
"schema": {
"$ref": "#/components/schemas/repository_info"
}
}
}
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/not_found"
},
"500": {
"$ref": "#/components/responses/internal_error"
}
},
"security": [
{
"bearerAuth": []
},
{}
],
"summary": "Get repository in a namespace",
"tags": [
"repositories"
]
}