This page is generated from the public contract. Descriptions are shown in the original Korean.
Cassandra Table 정의·이동.
Database 소속 Cassandra Table 전체 목록#
GET /api/databases/{database_id}/cassandra-tables
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
database_id | path | string | Yes | 소속 Database ID. |
Responses
| Status | Description |
|---|---|
200 | Database 소속 CassandraTable 전체 목록 |
400 | 잘못된 경로 ID 또는 요청 형식 |
401 | UNAUTHENTICATED: 세션·토큰이 없거나 만료·폐기되었습니다. |
403 | ORGANIZATION_UNVERIFIED: 현재 Organization 또는 Agent 토큰의 Organization이 인증 대기입니다. |
404 | DATABASE_NOT_FOUND |
409 | DATABASE_ENGINE_MISMATCH 또는 ORGANIZATION_REQUIRED: 세션에 현재 Organization이 없습니다. |
500 | INTERNAL_ERROR |
200 response body
An array (CassandraTable[]). The table lists item fields.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
database_id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
name | StoredIdentifier | Yes | 앞뒤 U+0020을 제거한 1..200 code point 저장 문자열. 제어 문자 금지. 대소문자·Unicode 정규화 없음. |
summary | string | Yes | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | Yes | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinition | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
created_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
updated_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
Database 소속 Cassandra Table 생성#
POST /api/databases/{database_id}/cassandra-tables
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
database_id | path | string | Yes | 소속 Database ID. |
Origin | header | string | No | 세션 쿠키로 인증한 상태 변경 요청에서 필수이며 서버 origin과 같아야 합니다. Bearer 토큰 요청에는 적용하지 않습니다. |
Request body
application/json · Required: Yes
Type: CassandraTableCreate
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | 앞뒤 U+0020 제거 후 1..200 Unicode code point. 제어 문자 금지. 정규화 전 입력 길이/빈 값은 서비스에서 검사합니다. |
summary | string | No | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | No | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinitionInput | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
Responses
| Status | Description |
|---|---|
201 | Database 소속 CassandraTable 생성 |
400 | 잘못된 경로 ID 또는 요청 형식 |
401 | UNAUTHENTICATED: 세션·토큰이 없거나 만료·폐기되었습니다. |
403 | Origin 검사 실패 또는 인증 대기 Organization 사용 거부입니다. |
404 | DATABASE_NOT_FOUND |
409 | 부모 engine·이름 충돌 또는 ORGANIZATION_REQUIRED: 세션에 현재 Organization이 없습니다. |
413 | PAYLOAD_TOO_LARGE |
415 | UNSUPPORTED_MEDIA_TYPE |
422 | VALIDATION_FAILED |
500 | INTERNAL_ERROR |
201 response body
Type: CassandraTable
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
database_id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
name | StoredIdentifier | Yes | 앞뒤 U+0020을 제거한 1..200 code point 저장 문자열. 제어 문자 금지. 대소문자·Unicode 정규화 없음. |
summary | string | Yes | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | Yes | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinition | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
created_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
updated_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
Cassandra Table 상세#
GET /api/cassandra-tables/{id}
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | 리소스 ID. |
If-None-Match | header | string | No | 상세 GET에서 약한 비교. 강한/약한 목록·별표 허용. 일치 304. 미존재 404 우선. 목록과 다른 Method에서는 무시합니다. |
Responses
| Status | Description |
|---|---|
200 | CassandraTable 상세 |
304 | 조건 일치. 본문·Content-Type 없음. |
400 | 잘못된 경로 ID 또는 요청 형식 |
401 | UNAUTHENTICATED: 세션·토큰이 없거나 만료·폐기되었습니다. |
403 | ORGANIZATION_UNVERIFIED: 현재 Organization 또는 Agent 토큰의 Organization이 인증 대기입니다. |
404 | CASSANDRA_TABLE_NOT_FOUND |
409 | ORGANIZATION_REQUIRED: 세션에 현재 Organization이 없습니다. |
500 | INTERNAL_ERROR |
200 response body
Type: CassandraTable
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
database_id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
name | StoredIdentifier | Yes | 앞뒤 U+0020을 제거한 1..200 code point 저장 문자열. 제어 문자 금지. 대소문자·Unicode 정규화 없음. |
summary | string | Yes | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | Yes | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinition | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
created_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
updated_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
Cassandra Table 전체 수정·Database 이동#
PUT /api/cassandra-tables/{id}
자식 존재·If-Match 뒤 목적지 Cassandra 부모·정확한 Table 이름 중복을 검사한다. 목적지 Keyspace가 다르거나 미기록이어도 이동 가능하며 UDT 이름·정의를 자동 교정하지 않는다. 실패 시 전체 rollback.
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | 리소스 ID. |
If-Match | header | string | Yes | 상세 GET의 단일 강한 ETag. 별표·약한/복수 태그는 400. 일반 검사 후 누락 428·불일치 412. 미존재 404·Database 삭제 불가 409 우선. 날짜 조건으로 대체하지 않습니다. |
Origin | header | string | No | 세션 쿠키로 인증한 상태 변경 요청에서 필수이며 서버 origin과 같아야 합니다. Bearer 토큰 요청에는 적용하지 않습니다. |
Request body
application/json · Required: Yes
Type: CassandraTableUpdate
| Name | Type | Required | Description |
|---|---|---|---|
database_id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
name | string | Yes | 앞뒤 U+0020 제거 후 1..200 Unicode code point. 제어 문자 금지. 정규화 전 입력 길이/빈 값은 서비스에서 검사합니다. |
summary | string | Yes | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | Yes | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinitionInput | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
Responses
| Status | Description |
|---|---|
200 | CassandraTable 전체 수정·Database 이동 |
400 | 잘못된 경로 ID 또는 요청 형식 |
401 | UNAUTHENTICATED: 세션·토큰이 없거나 만료·폐기되었습니다. |
403 | Origin 검사 실패 또는 인증 대기 Organization 사용 거부입니다. |
404 | CASSANDRA_TABLE_NOT_FOUND |
409 | 대상 Database·engine·이름 충돌 또는 ORGANIZATION_REQUIRED: 세션에 현재 Organization이 없습니다. |
412 | PRECONDITION_FAILED |
413 | PAYLOAD_TOO_LARGE |
415 | UNSUPPORTED_MEDIA_TYPE |
422 | VALIDATION_FAILED |
428 | PRECONDITION_REQUIRED |
500 | INTERNAL_ERROR |
200 response body
Type: CassandraTable
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
database_id | string | Yes | Structly ID. Sonyflake로 발급한 정수를 고정 11자리 Base62(0-9A-Za-z)로 표현하며 대소문자를 구분합니다. |
name | StoredIdentifier | Yes | 앞뒤 U+0020을 제거한 1..200 code point 저장 문자열. 제어 문자 금지. 대소문자·Unicode 정규화 없음. |
summary | string | Yes | 목록·테이블에 한 줄로 표시하는 핵심 요약입니다. 최대 120 Unicode 코드 포인트이며 앞뒤 공백을 보존합니다. 줄바꿈·탭 등 제어 문자는 거부합니다. 빈 문자열은 요약 없음입니다. 상세 설명은 description에 기록합니다. |
description | string | Yes | 공백·개행을 보존하며 U+0000을 거부합니다. 빈 문자열로 설명을 비웁니다. null은 허용하지 않습니다. |
definition | CassandraTableDefinition | Yes | 부분 Column 기록 허용. 이름 중복·키 참조·Static 조합은 서비스에서 검사한다. CQL 타입은 opaque 문자열이며 파싱하지 않는다. 모든 배열의 순서를 보존한다. |
created_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
updated_at | string(date-time) | Yes | 서버가 기록한 UTC RFC 3339 시각. 저장된 마이크로초 정밀도를 보존합니다. 동시성 토큰이나 항상 증가하는 버전 번호가 아닙니다. |
Cassandra Table 삭제#
DELETE /api/cassandra-tables/{id}
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | 리소스 ID. |
If-Match | header | string | Yes | 상세 GET의 단일 강한 ETag. 별표·약한/복수 태그는 400. 일반 검사 후 누락 428·불일치 412. 미존재 404·Database 삭제 불가 409 우선. 날짜 조건으로 대체하지 않습니다. |
Origin | header | string | No | 세션 쿠키로 인증한 상태 변경 요청에서 필수이며 서버 origin과 같아야 합니다. Bearer 토큰 요청에는 적용하지 않습니다. |
Responses
| Status | Description |
|---|---|
204 | CassandraTable 삭제 |
400 | 잘못된 경로 ID 또는 요청 형식 |
401 | UNAUTHENTICATED: 세션·토큰이 없거나 만료·폐기되었습니다. |
403 | Origin 검사 실패 또는 인증 대기 Organization 사용 거부입니다. |
404 | CASSANDRA_TABLE_NOT_FOUND |
409 | 연결 Service가 있어 Cassandra Table을 삭제할 수 없습니다. 또는 ORGANIZATION_REQUIRED: 세션에 현재 Organization이 없습니다. |
412 | PRECONDITION_FAILED |
428 | PRECONDITION_REQUIRED |
500 | INTERNAL_ERROR |