조직 액세스 토큰 생성

조직 액세스 토큰 생성 (Create access token)

Docker Hub API에서 조직 액세스 토큰(organization access token, OAT)을 새로 만드는 작업이에요. 토큰 라벨과 리소스 접근 범위를 지정하면 새 토큰이 생성돼요.

출처: 문서

본문

POST 요청으로 조직의 액세스 토큰을 생성합니다. bearerAuth 인증이 필요해요.

요청 본문

createOrgAccessTokenRequest 스키마예요. 예를 들면 이렇게 생겼어요.

{
  "description": "Token for CI/CD pipeline",
  "label": "My organization token",
  "resources": [
    {
      "path": "myorg/myrepo",
      "scopes": [
        "scope-image-pull"
      ],
      "type": "TYPE_REPO"
    }
  ]
}

응답 201

생성된 토큰이 createOrgAccessTokenResponse로 돌아와요. token 값에 실제 토큰 문자열이 담겨요.

{
  "created_at": "2022-05-20T00:54:18Z",
  "expires_at": "2023-05-20T00:54:18Z",
  "id": "a7a5ef25-8889-43a0-8cc7-f2a94268e861",
  "is_active": true,
  "label": "My organization token",
  "last_used_at": "2022-06-15T12:30:45Z",
  "resources": [
    {
      "path": "myorg/myrepo",
      "scopes": [
        "scope-image-pull"
      ],
      "type": "TYPE_REPO"
    }
  ],
  "token": "dckr_oat_7awgM4jG5SQvxcvmNzhKj8PQjxo"
}

오류 응답

  • 400: 잘못된 요청 (bad request)
  • 401: 인증 실패 (unauthorized)
  • 403: 권한 없음 (permission denied)
  • 404: 대상을 찾을 수 없음 (not found)

예시 요청

curl \
  --request POST \
  --header "Authorization: Bearer ***" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "description": "Token for CI/CD pipeline",
  "label": "My organization token",
  "resources": [
    {
      "path": "myorg/myrepo",
      "scopes": [
        "scope-image-pull"
      ],
      "type": "TYPE_REPO"
    }
  ]
}' \
  'https://hub.docker.com/v2/orgs/myorganization/access-tokens'

더 알아보기