Skip to main content
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

테넌트 관리 API 이해

PDF

테넌트 관리자 사용자 인터페이스 대신 테넌트 관리 REST API를 사용하여 시스템 관리 작업을 수행할 수 있습니다. 예를 들어, API를 사용하여 작업을 자동화하거나 사용자와 같은 여러 엔터티를 더 빠르게 생성할 수 있습니다.

테넌트 관리 API:

  • Swagger 오픈 소스 API 플랫폼을 사용합니다. Swagger는 개발자와 비개발자 모두가 API와 상호 작용할 수 있는 직관적인 사용자 인터페이스를 제공합니다. Swagger 사용자 인터페이스는 각 API 작업에 대한 전체 세부 정보와 설명서를 제공합니다.

  • 용도"중단 없는 업그레이드를 지원하는 버전 관리" .

테넌트 관리 API에 대한 Swagger 문서에 액세스하려면 다음을 수행하세요.

  1. 테넌트 관리자에 Sign in .

  2. 테넌트 관리자 상단에서 도움말 아이콘을 선택하고 *API 설명서*를 선택하세요.

API 작업

테넌트 관리 API는 사용 가능한 API 작업을 다음 섹션으로 구성합니다.

  • 계정: 저장소 사용 정보를 가져오는 것을 포함하여 현재 테넌트 계정에 대한 작업입니다.

  • auth: 사용자 세션 인증을 수행하는 작업입니다.

    테넌트 관리 API는 베어러 토큰 인증 체계를 지원합니다. 테넌트 로그인의 경우 인증 요청의 JSON 본문에 사용자 이름, 비밀번호 및 계정 ID를 제공합니다(즉, POST /api/v3/authorize ). 사용자가 성공적으로 인증되면 보안 토큰이 반환됩니다. 이 토큰은 후속 API 요청의 헤더에 제공되어야 합니다("Authorization: Bearer token").

    인증 보안을 개선하는 방법에 대한 자세한 내용은 다음을 참조하세요."크로스 사이트 요청 위조로부터 보호" .

    참고 StorageGRID 시스템에 대해 SSO(Single Sign-On)가 활성화된 경우 인증을 위해 다양한 단계를 수행해야 합니다. 를 참조하십시오"그리드 관리 API 사용 지침" .

  • config: 테넌트 관리 API의 제품 릴리스 및 버전과 관련된 작업입니다. 해당 릴리스에서 지원하는 제품 릴리스 버전과 주요 API 버전을 나열할 수 있습니다.

  • 컨테이너: S3 버킷 또는 Swift 컨테이너에서의 작업입니다.

  • deactivated-features: 비활성화되었을 수 있는 기능을 확인하는 작업입니다.

  • 엔드포인트: 엔드포인트를 관리하는 작업. 엔드포인트를 사용하면 S3 버킷에서 StorageGRID CloudMirror 복제, 알림 또는 검색 통합을 위해 외부 서비스를 사용할 수 있습니다.

  • grid-federation-connections: 그리드 페더레이션 연결 및 그리드 간 복제에 대한 작업입니다.

  • 그룹: 로컬 테넌트 그룹을 관리하고 외부 ID 소스에서 페더레이션된 테넌트 그룹을 검색하는 작업입니다.

  • identity-source: 외부 ID 소스를 구성하고 페더레이션 그룹 및 사용자 정보를 수동으로 동기화하는 작업입니다.

  • ilm: 정보 수명 주기 관리(ILM) 설정에 대한 작업입니다.

  • regions: StorageGRID 시스템에 대해 구성된 지역을 확인하는 작업입니다.

  • s3: 테넌트 사용자의 S3 액세스 키를 관리하는 작업입니다.

  • s3-object-lock: 규정 준수를 지원하는 데 사용되는 글로벌 S3 개체 잠금 설정에 대한 작업입니다.

  • 사용자: 테넌트 사용자를 보고 관리하는 작업입니다.

작업 세부 정보

각 API 작업을 확장하면 HTTP 작업, 엔드포인트 URL, 필수 또는 선택 매개변수 목록, 요청 본문의 예(필요한 경우), 가능한 응답을 볼 수 있습니다.

Swagger API에서 GET 그룹 작업을 보여주는 예

API 요청 발행

주의 API 문서 웹페이지를 사용하여 수행하는 모든 API 작업은 실시간 작업입니다. 실수로 구성 데이터나 기타 데이터를 생성, 업데이트 또는 삭제하지 않도록 주의하세요.
단계

  1. 요청 세부 정보를 보려면 HTTP 작업을 선택하세요.

  2. 요청에 그룹이나 사용자 ID와 같은 추가 매개변수가 필요한지 확인합니다. 그런 다음 이러한 값을 얻습니다. 필요한 정보를 얻으려면 먼저 다른 API 요청을 발행해야 할 수도 있습니다.

  3. 예제 요청 본문을 수정해야 하는지 확인하세요. 그렇다면 *모델*을 선택하여 각 필드의 요구 사항을 알아볼 수 있습니다.

  4. *시도해보기*를 선택하세요.

  5. 필요한 매개변수를 제공하거나, 필요에 따라 요청 본문을 수정하세요.

  6. *실행*을 선택하세요.

  7. 요청이 성공했는지 확인하려면 응답 코드를 검토하세요.