InfoGrab DocsInfoGrab Docs

조직 API

요약

이 API를 사용하여 GitLab 조직과 상호작용합니다. 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다. 조직을 소프트 삭제합니다. 성공하면 202 Accepted를 반환합니다.

이 API를 사용하여 GitLab 조직과 상호작용합니다. 자세한 내용은 조직을 참조하세요.

조직 생성#

히스토리
  • GitLab 17.5에서 allow_organization_creation이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됨. 이 기능은 실험 단계입니다.
  • GitLab 18.4에서 변경되었습니다. 기능 플래그 allow_organization_creation이 통합되어 organization_switching으로 이름 변경됨.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요.

조직을 생성합니다.

이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.

POST /organizations

매개변수:

속성 유형 필수 설명
name 문자열 조직의 이름
path 문자열 조직의 경로
description 문자열 아니요 조직의 설명
avatar 파일 아니요 조직의 아바타 이미지

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--form "name=New Organization" \
--form "path=new-org" \
--form "description=A new organization" \
--form "avatar=@/path/to/avatar.png" \
"https://gitlab.example.com/api/v4/organizations"

응답 예시:

{
  "id": 42,
  "uuid": "0192f8c2-1a2b-7cde-89ab-0123456789ab",
  "name": "New Organization",
  "path": "new-org",
  "description": "A new organization",
  "created_at": "2024-09-18T02:35:15.371Z",
  "updated_at": "2024-09-18T02:35:15.371Z",
  "web_url": "https://gitlab.example.com/o/new-org/-/overview",
  "avatar_url": "https://gitlab.example.com/uploads/-/system/organizations/organization_detail/avatar/42/avatar.png"
}

조직 소프트 삭제#

히스토리
  • GitLab 19.2에서 도입되었습니다. 이 기능은 실험 단계입니다.

조직을 소프트 삭제합니다. 조직은 비어 있어야 하며(그룹 또는 프로젝트가 없어야 함) 기본 조직이 아니어야 합니다. 조직 소유자와 관리자만 조직을 소프트 삭제할 수 있습니다.

이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.

DELETE /organizations/:id

매개변수:

속성 유형 필수 설명
id 정수 조직의 ID

요청 예시:

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/organizations/42"

성공하면 202 Accepted를 반환합니다.

조직 API

GitLab v19.2
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed
원문 보기
요약

이 API를 사용하여 GitLab 조직과 상호작용합니다. 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다. 조직을 소프트 삭제합니다. 성공하면 202 Accepted를 반환합니다.

이 API를 사용하여 GitLab 조직과 상호작용합니다. 자세한 내용은 조직을 참조하세요.

조직 생성#

히스토리
  • GitLab 17.5에서 allow_organization_creation이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됨. 이 기능은 실험 단계입니다.
  • GitLab 18.4에서 변경되었습니다. 기능 플래그 allow_organization_creation이 통합되어 organization_switching으로 이름 변경됨.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요.

조직을 생성합니다.

이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.

POST /organizations

매개변수:

속성 유형 필수 설명
name 문자열 조직의 이름
path 문자열 조직의 경로
description 문자열 아니요 조직의 설명
avatar 파일 아니요 조직의 아바타 이미지

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--form "name=New Organization" \
--form "path=new-org" \
--form "description=A new organization" \
--form "avatar=@/path/to/avatar.png" \
"https://gitlab.example.com/api/v4/organizations"

응답 예시:

{
  "id": 42,
  "uuid": "0192f8c2-1a2b-7cde-89ab-0123456789ab",
  "name": "New Organization",
  "path": "new-org",
  "description": "A new organization",
  "created_at": "2024-09-18T02:35:15.371Z",
  "updated_at": "2024-09-18T02:35:15.371Z",
  "web_url": "https://gitlab.example.com/o/new-org/-/overview",
  "avatar_url": "https://gitlab.example.com/uploads/-/system/organizations/organization_detail/avatar/42/avatar.png"
}

조직 소프트 삭제#

히스토리
  • GitLab 19.2에서 도입되었습니다. 이 기능은 실험 단계입니다.

조직을 소프트 삭제합니다. 조직은 비어 있어야 하며(그룹 또는 프로젝트가 없어야 함) 기본 조직이 아니어야 합니다. 조직 소유자와 관리자만 조직을 소프트 삭제할 수 있습니다.

이 엔드포인트는 실험 단계이며 사전 공지 없이 변경되거나 제거될 수 있습니다.

DELETE /organizations/:id

매개변수:

속성 유형 필수 설명
id 정수 조직의 ID

요청 예시:

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/organizations/42"

성공하면 202 Accepted를 반환합니다.