계정 그룹 이동

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

계정 그룹의 위치를 이동합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /open-api/v1/group/move

요청 헤더

Organization API에서 공통으로 사용하는 헤더에 대한 정보는 Organization 요청 헤더를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
organizationGroupNo Integer Required 계정 그룹 번호
upperOrganizationGroupNo Integer Required 상위 계정 그룹 번호
groupYn String Required 계정 그룹 여부
  • Y | N
    • Y: 계정 그룹
    • N: 계정 그룹 아님
  • Y 입력해야 정상 동작
wholePath String Required 계정 그룹 계층 구조
  • 마스터 계층부터 대상 그룹 위치까지 전체 경로 입력
  • 계층 구분은 / 사용

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://organization.apigw.ntruss.com/open-api/v1/group/move' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '[
  {
    "organizationGroupNo": 1452,
    "upperOrganizationGroupNo": 1451,
    "groupYn": "Y",
    "wholePath": "1449/1451/1452"
  }
]'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
displayName String - 계정 그룹/계정 이름
organizationGroupNo Integer - 계정 그룹 번호
organizationGroupName String - 계정 그룹 이름
upperOrganizationGroupNo Integer - 상위 계정 그룹 번호
memberNo Integer - 계정 회원 번호
memberName String - 계정 사용자 이름
memberAlias String - 계정 Alias(별칭)
  • 마스터 계정: Master 표시
  • 멤버 계정: 콘솔에서 Alias 설정 시 표시
loginId String - 계정 로그인 아이디
memberStatusCode String - 계정 상태 코드
memberStatusName String - 계정 상태
wholePath String - 계정 그룹 계층 구조
policyNo Integer - 정책 번호
policyName String - 정책 이름
groupYn String - 계정 그룹 여부
  • Y | N
    • Y: 계정 그룹
    • N: 계정 그룹 아님
masterMemberYn String - 마스터 계정 여부
  • Y | N
    • Y: 마스터 계정
    • N: 마스터 계정 아님
modYmdt String - 생성/가입 일시(밀리초)
  • Unix Timestamp 형식
orgNoForLev Integer - 계정 그룹 번호
leaveReqYmdt String - 탈퇴 신청 일시
  • 탈퇴 신청 시 표시

응답 상태 코드

Organization API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Organization 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

[
    {
        "displayName": "네이버클라우드 주식회사",
        "organizationGroupNo": 1449,
        "organizationGroupName": "네이버클라우드 주식회사",
        "memberNo": 279****,
        "memberName": "홍길동",
        "memberAlias": "Master",
        "loginId": "n******@navercorp.com",
        "memberStatusCode": "JOIN",
        "memberStatusName": "가입 완료",
        "wholePath": "1449",
        "policyNo": 4951,
        "policyName": "Organization_Default_Policy",
        "groupYn": "N",
        "masterMemberYn": "Y",
        "modYmdt": 1738651093642,
        "orgNoForLev": 2712
    },
    {
        "displayName": "Team1",
        "organizationGroupNo": 1451,
        "organizationGroupName": "Team1",
        "upperOrganizationGroupNo": 1449,
        "wholePath": "1449/1451",
        "policyNo": 4951,
        "policyName": "Organization_Default_Policy",
        "groupYn": "Y",
        "masterMemberYn": "N",
        "modYmdt": 1738658351596,
        "orgNoForLev": 2712
    },
    {
        "displayName": "Team2",
        "organizationGroupNo": 1452,
        "organizationGroupName": "Team2",
        "upperOrganizationGroupNo": 1449,
        "wholePath": "1449/1452",
        "policyNo": 4951,
        "policyName": "Organization_Default_Policy",
        "groupYn": "Y",
        "masterMemberYn": "N",
        "modYmdt": 1738660641792,
        "orgNoForLev": 2712
    },
    {
        "displayName": "네이버클라우드 주식회사",
        "organizationGroupNo": 1452,
        "organizationGroupName": "Team2",
        "memberNo": 270****,
        "memberName": "김철수",
        "memberAlias": "Member1",
        "loginId": "l******@navercorp.com",
        "memberStatusCode": "JOIN",
        "memberStatusName": "가입 완료",
        "upperOrganizationGroupNo": 1451,
        "wholePath": "1449/1451/1452",
        "groupYn": "N",
        "masterMemberYn": "N",
        "modYmdt": 1738658439000
    }
]