조직 멤버 역할 수정

조직 멤버 역할 수정 (Update org member role)

Docker Hub API에서 조직 멤버의 역할을 수정하는 작업이에요. 조직의 "owners" 그룹에 속한 사용자만 이 엔드포인트를 사용할 수 있어요. 이 작업은 조직 액세스 토큰(OAT)에서 발급된 bearer 토큰을 받아요.

출처: 문서

본문

PUT 요청으로 조직 멤버의 역할을 수정합니다. bearerAuth 인증이 필요하고, 조직의 "owners" 그룹 사용자만 사용할 수 있어요.

파라미터

파라미터 위치 설명
org_name path (필수) 조직 이름
username path (필수) 역할을 바꿀 멤버의 사용자 이름 (예: jonsnow)

요청 본문

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

{
  "role": "owner"
}

응답 200

수정된 멤버 정보가 org_member로 돌아와요.

{
  "date_joined": "2021-01-05T21:06:53.506400Z",
  "email": "[email protected]",
  "full_name": "Jon Snow",
  "groups": [
    "owners"
  ],
  "id": "0ab70deb065a43fcacd55d48caa945d8",
  "is_guest": false,
  "role": "Owner",
  "type": "User",
  "username": "dockeruser"
}

오류 응답

  • 400: 잘못된 요청 (bad request)
  • 401: 인증 실패 (unauthorized)
  • 403: 권한 없음
  • 404: 멤버를 찾을 수 없음

예시 요청

curl \
  --request PUT \
  --header "Authorization: Bearer ***" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "role": "owner"
}' \
  'https://hub.docker.com/v2/orgs/<ORG_NAME>/members/<USERNAME>'

더 알아보기