새 조직 그룹 생성

새 조직 그룹 생성 (Create a new group)

Docker Hub API에서 조직 안에 새 그룹(team)을 만드는 작업이에요. 그룹 이름은 필수이고 설명은 선택적으로 넣을 수 있어요. 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.

출처: 문서

본문

POST 요청으로 조직 안에 새 그룹을 생성합니다. bearerAuth 인증이 필요해요.

파라미터

파라미터 위치 설명
org_name path (필수) 조직 이름

요청 본문

name은 필수, description은 선택이에요.

{
  "description": "Development team",
  "name": "developers"
}

응답 201

생성된 그룹 정보가 org_group으로 돌아와요.

{
  "description": "Development team",
  "id": 10,
  "member_count": 1,
  "name": "developers",
  "role": "member",
  "uuid": "e36eca69-4cc8-4f17-9845-ae8c2b832691"
}

오류 응답

  • 400: 잘못된 요청 (bad request)
  • 401: 인증 실패 (unauthorized)
  • 403: 권한 없음 (permission denied)

예시 요청

curl \
  --request POST \
  --header "Authorization: Bearer ***" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "description": "Development team",
  "name": "developers"
}' \
  'https://hub.docker.com/v2/orgs/<ORG_NAME>/groups'

더 알아보기