리포지토리 불변 태그 검증
리포지토리 불변 태그 검증
요청 바디로 전달된 불변 태그 정규식(regex)을 검증하고, 이 리포지토리에서 그와 일치하는 태그 목록을 반환해요. 리포지토리에 대한 관리 권한이 있는 사용자만 이 엔드포인트를 호출할 수 있어요.
출처: 문서
본문
POST /v2/namespaces/{namespace}/repositories/{repository}/immutabletags/verify
리포지토리 불변 태그 검증 작업이에요. 요청 바디로 전달된 불변 태그 정규식(regex)을 검증하고, 이 리포지토리에서 그와 일치하는 태그 목록을 반환해요. 리포지토리에 대한 관리 권한이 있는 사용자만 이 엔드포인트를 호출할 수 있어요.
요청 예시
실행 전에 자리 표시자를 바꾸고 필요 자격 증명이나 요청 바디를 채워야 해요.
curl \
--request POST \
--header "Authorization: Bearer ${TOKEN}" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"regex": "v.*"
}' \
'https://hub.docker.com/v2/namespaces/<NAMESPACE>/repositories/<REPOSITORY>/immutabletags/verify'
요청과 응답
응답 200 Schema:
{
"$ref": "#/components/schemas/immutable_tags_verify_response"
}
Schema example:
{
"tags": [
"v1.0.0",
"v2.1.3",
"latest"
]
}
응답 400 Bad Request
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "bad request"
}
응답 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"
}
전체 작업 계약
{
"description": "Validates the immutable tags regex passed in the request body and returns a list of tags matching it in this repository.\n\n**Only users with administrative privileges for the repository can call this endpoint.**\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "VerifyRepositoryImmutableTags",
"requestBody": {
"$ref": "#/components/requestBodies/immutable_tags_verify_request"
},
"responses": {
"200": {
"$ref": "#/components/responses/immutable_tags_verify_response"
},
"400": {
"$ref": "#/components/responses/bad_request"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/not_found"
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "Verify repository immutable tags",
"tags": [
"repositories"
]
}