그룹 목록 조회
조직이나 사용자 계정에 속한 그룹들의 목록을 가져오는 API예요. 어떤 그룹이 있고 각 그룹이 어디에 위치하는지 한눈에 볼 때 유용해요.
출처: 문서
본문
조직이나 사용자에 속한 그룹 목록을 반환해요.
curl -L https://api.turso.tech/v1/organizations/{organizationSlug}/groups \
-H 'Authorization: Bearer ***'
import { createClient } from "@tursodatabase/api";
const turso = createClient({
org: "...",
token: "",
});
const groups = await turso.groups.list();
OpenAPI
openapi: 3.0.1
info:
title: Turso Platform API
description: API description here
license:
name: MIT
version: 0.1.0
servers:
- url: https://api.turso.tech
description: Turso's Platform API
security: []
paths:
/v1/organizations/{organizationSlug}/groups:
get:
summary: List Groups
description: Returns a list of groups belonging to the organization or user.
operationId: listGroups
parameters:
- $ref: '#/components/parameters/organizationSlug'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
groups:
type: array
items:
$ref: '#/components/schemas/Group'
components:
parameters:
organizationSlug:
in: path
name: organizationSlug
required: true
schema:
type: string
description: The slug of the organization or user account.
schemas:
Group:
allOf:
- $ref: '#/components/schemas/BaseGroup'
- type: object
BaseGroup:
type: object
properties:
name:
type: string
description: The group name, unique across your organization.
example: default
version:
type: string
description: >-
The current libSQL server version the databases in that group are
running.
example: v0.23.7
deprecated: true
uuid:
type: string
description: The group universal unique identifier (UUID).
example: 0a28102d-6906-11ee-8553-eaa7715aeaf2
locations:
type: array
items:
type: string
description: An array of location keys the group is located.
example:
- aws-us-east-1
deprecated: true
primary:
type: string
description: The primary location key.
example: us-east-1
delete_protection:
type: boolean
description: >-
The current status for delete protection. If enabled, the group and
all its databases cannot be deleted.
example: false