SCIM 사용자 수정

SCIM 사용자 수정 (Update a user)

Docker Hub SCIM 2.0 API에서 조직의 특정 사용자 정보를 수정(PUT)하는 작업이에요. 사용자 ID로 대상을 지정하고 새 사용자 정보를 본문에 담아 보내면 전체 교체 방식으로 갱신돼요.

출처: 문서

본문

PUT 요청으로 사용자 한 명을 ID로 수정합니다. 이 작업은 scimToken 인증이 필요해요.

파라미터

파라미터 위치 설명
id path (필수) 수정할 사용자의 SCIM ID

요청 본문

필수 필드는 schemas와 userName이에요. active 필드는 사용자 활성 여부이고 생략하면 기본 false로 지정돼요.

{
  "active": true,
  "name": {
    "familyName": "Snow",
    "givenName": "Jon"
  },
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "[email protected]"
}

응답 200

수정된 scim_user 객체가 돌아와요.

{
  "active": true,
  "displayName": "jonsnow",
  "emails": [
    {
      "display": "[email protected]",
      "primary": true,
      "value": "[email protected]"
    }
  ],
  "id": "d80f7c79-7730-49d8-9a41-7c42fb622d9c",
  "name": {
    "familyName": "Snow",
    "givenName": "Jon"
  },
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "[email protected]"
}

오류 응답

  • 400: 잘못된 요청
  • 401: 인증 실패
  • 403: 권한 없음
  • 404: 사용자를 찾을 수 없음
  • 409: 충돌
  • 500: 서버 오류

예시 요청

curl \
  --request PUT \
  --header "Authorization: Bearer ***" \
  --header 'Accept: application/scim+json' \
  --header 'Content-Type: application/scim+json' \
  --data-raw '{
  "active": true,
  "name": {
    "familyName": "Snow",
    "givenName": "Jon"
  },
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "[email protected]"
}' \
  'https://hub.docker.com/v2/scim/2.0/Users/<ID>'

더 알아보기