조직 그룹 상세 일부 수정

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

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

출처: 문서

본문

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

파라미터

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

요청 본문

name, description, role 필드를 담을 수 있어요. role의 유효 값은 코어 역할 owner·editor·member 또는 기존 커스텀 역할의 이름이에요. 커스텀 역할은 라벨이나 UUID가 아니라 이름 식별자를 사용해야 합니다.

{
  "description": "Development team",
  "role": "member"
}

응답 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 PATCH \
  --header "Authorization: Bearer ***" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "description": "Development team",
  "role": "member"
}' \
  'https://hub.docker.com/v2/orgs/<ORG_NAME>/groups/<GROUP_NAME>'

더 알아보기