조직 그룹 상세 수정

조직 그룹 상세 수정 (Update the details for an organization group)

Docker Hub API에서 조직 그룹(team)의 상세 정보를 수정하는 작업이에요. 그룹의 이름·설명을 갱신할 수 있어요. 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.

출처: 문서

본문

PUT 요청으로 조직 그룹의 상세 정보를 수정합니다. bearerAuth 인증이 필요해요.

파라미터

파라미터 위치 설명
org_name path (필수) 조직 이름
group_name path (필수) 수정할 그룹 이름 (예: developers)

요청 본문

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

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

응답 200

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

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

오류 응답

  • 401: 인증 실패 (unauthorized)
  • 403: 권한 없음 (permission denied)
  • 404: 그룹을 찾을 수 없음 (not found)

예시 요청

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

더 알아보기