통합 카탈로그 엔터티 유형 생성¶
POST /api/v1/unified_catalog/entity_type_cfg/create
개요¶
워크스페이스 사용자 정의 엔터티 유형 및 워크스페이스 확장 필드를 생성합니다.
호출 전 및 사용 단계¶
최소 요청은 유효한 entityType이며, name/description은 선택 사항입니다. 누락된 Schema/View는 default 숨김 템플릿에서 보완됩니다. 템플릿이 없으면 요청 텍스트/빈 문자열이 유지되며, 완전한 폼이 자동으로 확보된다고 보장할 수 없습니다. 생성 응답의 id는 null일 수 있고, entityCount는 0으로 고정되며 기존 엔터티의 조회 결과가 아닙니다.
extraConfig/customProperties를 동시에 저장할 수 있습니다. 생성 시 healthConfig는 처리하지 않으며, 먼저 생성한 후 구성 수정을 호출합니다. system 유형이 아닌 경우 헬스가 구성되지 않으면 기본적으로 disabled입니다. 생성은 공식 기본 정의를 복사하는 것이 아니며, 사용 중단된 유형 그룹 파라미터도 받지 않습니다.
다음 경로는 필드 값 내부의 YAML 텍스트이며, 추가 JSON Body 필드가 아닙니다. 먼저 default에서 템플릿을 생성하거나 기존 원본 구성에서 값을 가져오고, 필요한 부분만 수정합니다.
| YAML 경로 | 값, 기본값 및 출처 |
|---|---|
| schemaDefine.properties[] | base 필드 객체 배열이며, 일반적으로 name, type, required 및 title을 포함합니다. 이름/유형은 해당 엔터티의 비즈니스 Schema에서 가져오며, 엔터티 속성 값으로 정의를 대신할 수 없습니다. type은 실제 데이터와 일치해야 하며, Studio 메타데이터 처리의 기본값은 string입니다. 추가 Schema 확장은 원본 템플릿에 따라 유지합니다. |
| schemaDefine.properties[].name/type/required/title | name은 필드 코드, type은 실제 DataSchema 유형, required는 불리언(기본값 false), title은 문자열 또는 언어-텍스트 객체일 수 있습니다. 선언은 모든 엔터티 쓰기에 대한 필드별 비즈니스 검증을 대신하지 않습니다. |
| viewDefine.layout[] | 표시 레이아웃 항목 배열이며, 일반적으로 group 객체(display_name, fields) 또는 직접 bind/title 노드입니다. 내보내기도 이를 기준으로 열을 선택합니다. |
| viewDefine.layout[].group.fields[] | 필드 컨트롤 배열입니다. bind는 실제 Schema 필드를 참조하고, title은 문자열/로컬라이즈 객체이며, ui_type 및 기타 속성은 원본 템플릿/UI 기능을 따릅니다. fields는 원본 정의에 따라 중첩될 수 있으며, 서버는 각 컨트롤의 효과를 일괄 검증하지 않습니다. |
| customProperties.custom_properties[] | 사용자 정의 필드 객체이며, 최상위 배열도 호환됩니다. 빈 텍스트는 필드 없음을 의미합니다. 원문을 저장하며, 기본값을 원본 YAML에 자동으로 다시 기록하지 않습니다. |
| custom_properties[].name | 비즈니스 필드 이름으로 필수이며 비어 있을 수 없고, 문자는 숫자/영문자/_/-만 가능합니다. base properties 및 동일 배열 내에서 중복될 수 없으며, 점/공백을 포함할 수 없습니다. |
| custom_properties[].type | 필수이며 비어 있을 수 없는 유형 이름입니다. 실제 필드에 따라 string 등을 선택하며, 저장 시 통일된 열거를 강제하지 않고, 모든 유형이 UI에서 지원된다는 것을 의미하지도 않습니다. |
| custom_properties[].title | 선택적 표시 제목으로, 문자열 또는 언어 텍스트 객체(예: zh-CN/en-US)입니다. 생략하면 표시 시 필드 이름으로 대체될 수 있습니다. |
| custom_properties[].required | 선택 사항이며 기본값은 false입니다. 불리언 또는 true/1/yes/y/on 등의 불리언 문자열은 유효 계층에서 정규화됩니다. |
| custom_properties[].extension_scope | 선택 사항이며, 누락/빈 값은 유효 계층에서 custom입니다. 원본 Schema 확장 용도에 따라 사용합니다. |
| custom_properties[].writable_sources[] | 선택적 배열이며, 각 항목은 manual/gitops 등 실제 쓰기 출처 식별자입니다. 공백을 제거하고 빈 항목은 건너뛰며, 누락 시 생성하지 않습니다. 이는 Schema 기능 선언이며 현재 API 인증을 확대하지 않습니다. |
| custom_properties[].capabilities | 선택적 객체입니다. display/edit/filter/sort는 표시, 편집, 필터링, 정렬 기능의 불리언 값이며, 존재할 때 정규화됩니다. 제공되지 않은 키는 자동으로 일괄 보완되지 않습니다. 기타 확장 값은 원본 정의에 따라 유지합니다. |
| custom_properties[].기타 필드 | allowed_values, items 등 DataSchema의 기존 확장에 따라 유지하며, 저장 성공만으로 모든 소비자가 지원한다고 간주할 수 없습니다. |
요청에서는 위 YAML을 문자열로 인코딩합니다. 아래 예시의 줄바꿈은 curl JSON에서 이스케이프되며, 서버는 이를 텍스트로 파싱합니다. 로컬 파일 경로를 제출하거나 YAML을 JSON 객체로 펼치지 마십시오.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| extraConfig.telemetrySelectors | array | 기존 확장 예시 키이며, 소비자 정의 구조를 따르고 엔터티 실시간 조회 결과가 아닙니다. 키를 생략하면 전체 교체로 인해 기존 구성이 손실되므로 먼저 get 하십시오. 예시: []가져오기 또는 입력 방법: 이 유형의 기존 텔레메트리 연관 구성에서 전체 항목을 복사합니다. |
|
| extraConfig.telemetrySelectors[*] | JSON | 동적 객체는 원본 소비 구성에 따라 유지하며, 예시가 모든 시나리오에서 강제로 통일된 source/query 프로토콜을 구성하는 것은 아닙니다. 예시: {"source": "logging", "query": "service:api"}가져오기 또는 입력 방법: 현재 비즈니스에서 검증된 텔레메트리 연관 항목입니다. |
|
| extraConfig.disabledBuiltInViews | array | 기존 확장 예시 키이며, 요소는 실제 뷰 식별자를 사용하고 통일된 열거를 임의로 만들지 않습니다. []는 이 객체가 해당 뷰들을 비활성화하지 않음을 의미합니다. 예시: []가져오기 또는 입력 방법: 기존 유형 extraConfig 또는 UI에서 지원하는 내장 뷰 식별자에서 선택합니다. |
|
| extraConfig.disabledBuiltInViews[*] | string | 개별 비활성화 항목이며, 적용 여부는 해당 UI 소비에 따르고 이 API의 권한 구성이 아닙니다. 예시: view_example가져오기 또는 입력 방법: 기존 내장 뷰의 실제 식별자입니다. |
|
| extraConfig.기타 구성 키 | JSON | 동적 확장 값을 유지하며, 통일된 기본값이나 열거가 없습니다. 예시: {}가져오기 또는 입력 방법: 현재 유형 상세/소비 기능 구성 설명에서 가져옵니다. |
|
| extend.확장 필드 | JSON | 동적으로 유지하며, 통일된 기본값/열거가 없고 임의의 값이 기능에서 소비된다고 보장하지 않습니다. 예시: value가져오기 또는 입력 방법: 해당 사용자 정의 기능의 실제 약정 또는 기존 레코드입니다. |
|
| customProperties | string | 선택적 YAML 텍스트 문자열이며, 원문/주석을 보존합니다. 생략하면 생성 시 빈 문자열, 수정 시 유지되며, 빈 문자열은 비웁니다. custom_properties 배열을 권장하며 최상위 배열도 호환됩니다. 필드 이름은 base properties 또는 이 배열과 중복될 수 없습니다. 펼친 객체를 Body 값으로 직접 사용하지 마십시오. null 허용: False 예시: "# 원문과 주석 보존\ncustom_properties:\n - name: business_owner\n title: 비즈니스 담당자\n type: string\n required: false\n extension_scope: custom\n writable_sources: [manual, gitops]\n capabilities: {display: true, edit: true, filter: false, sort: false}\n"가져오기 또는 입력 방법: 이 워크스페이스 상세의 원본 customProperties 백업에서 가져오거나 아래 내장 YAML 형식에 따라 필드를 추가합니다. |
|
| description | string | 선택 사항이며 최대 512 가중 문자입니다. 생성 시 생략하면 빈 문자열, 수정 시 생략하면 유지되고 빈 문자열은 비웁니다. 공식 유형은 이 수정을 무시합니다. null 허용: False 최대 길이: 512 예시: 비즈니스 서비스 카탈로그가져오기 또는 입력 방법: 비즈니스 담당자가 제공하는 유형 용도 설명입니다. |
|
| entityType | string | Y | 생성 시 필수이며, 공백 제거 후 ^[a-zA-Z][0-9a-zA-Z_-]{0,63}$와 일치해야 합니다. 첫 글자 이후에는 숫자/영문자/_/-가 가능하며 대소문자를 구분합니다. 고유 코드를 선택해야 하며, 최소한 현재 가시 범위의 공식/사용자 정의 동일 이름은 거부됩니다. 생성 후에는 수정으로 코드를 변경할 수 없습니다. 상세에서 UUID가 누락된 경우의 위치 지정 대안입니다. null 허용: False 최대 길이: 64 예시: demo_service가져오기 또는 입력 방법: 호출자가 유형 코드를 선택하며, 읽기는 목록의 entityType에서 그대로 가져옵니다. |
| extend | json | 선택적 동적 객체이며, 생성 시 기본값은 {}입니다. 사용자 정의 수정 시 생략하면 유지되고, {}는 비우며, 비어 있지 않으면 전체 교체됩니다. 공식 기본 유형은 이 필드를 무시하며 통일된 스위치로 사용하지 않습니다. null 허용: False 예시: {}가져오기 또는 입력 방법: 현재 사용자 정의 유형의 extend에서 전체 복사하거나 비즈니스 담당자가 제공하는 확장 구성을 사용합니다. |
|
| extraConfig | json | 선택적 동적 워크스페이스 오버라이드 객체이며, 생성 시 기본값은 {}입니다. 수정 시 생략하면 유지되고, {}는 전체를 비우며, 비어 있지 않으면 깊은 병합이 아닌 전체 교체입니다. 공식 유형도 지원하며 다른 워크스페이스의 공식 기본 정의를 변경하지 않습니다. 서버는 모든 동적 키의 의미를 일괄 검증하지 않습니다. null 허용: False 예시: {"telemetrySelectors": [], "disabledBuiltInViews": []}가져오기 또는 입력 방법: 우선 이 워크스페이스의 동일 유형 상세 extraConfig에서 전체를 백업하고, 실제 프런트엔드 뷰/텔레메트리 구성 요구에 따라 조정합니다. |
|
| name | string | 선택 사항이며 최대 128 가중 문자입니다. 생성 시 생략하면 빈 문자열이 되고, 수정 시 전달된 값은 공백이 제거되며 빈 문자열은 비우고 생략하면 유지됩니다. 공식 유형에 이 필드를 전달해도 공식 이름을 덮어쓰지 않습니다. null 허용: False 최대 길이: 128 예시: 예시 서비스가져오기 또는 입력 방법: 비즈니스 담당자가 제공하는 유형 표시 이름이며 entityType 코드를 대신하지 않습니다. |
|
| schemaDefine | string | 선택적 YAML 객체 텍스트이며 properties는 배열이어야 합니다. 생성 시 누락/빈 문자열은 템플릿에서 보완되고 {entity_type}은 요청 코드로 대체됩니다. 사용자 정의 유형 수정 시에만 적용되며, 생략하면 유지되고 빈 문자열은 원본 정의를 비웁니다. effectiveSchemaDefine을 원본 schema로 다시 기록할 수 없습니다. null 허용: False 예시: "kind: DataSchema\nentity_type: demo_service\nproperties:\n - name: env\n type: string\n required: false\n"가져오기 또는 입력 방법: 먼저 entityTypeUUID=default로 템플릿을 가져오거나, get으로 대상 원본 DataSchema YAML을 백업합니다. |
|
| viewDefine | string | 선택적 YAML 객체 텍스트이며 layout/각 레벨 fields는 배열이어야 합니다. 생성 시 누락/빈 문자열은 템플릿에서 보완되고 {entity_type}이 대체됩니다. 수정 시 사용자 정의에만 적용되며, 생략하면 유지되고 빈 문자열은 비웁니다. effectiveViewDefine이 아니며, 열/컨트롤의 추가 확장은 원본 템플릿 구조를 유지하십시오. null 허용: False 예시: "kind: UIView\nlayout:\n - group:\n display_name: 기본 정보\n fields:\n - bind: env\n title: 환경\n ui_type: input\n"가져오기 또는 입력 방법: 생성 템플릿 또는 현재 유형의 원본 UIView YAML에서 가져옵니다. |
파라미터 추가 설명¶
요청 파라미터 설명
| 파라미터 이름 | type | 필수 | 설명 |
|---|---|---|---|
| entityType | string | 예 | 엔터티 유형 코드, 전역 고유 |
| name | string | 아니요 | 엔터티 유형 표시 이름 |
| description | string | 아니요 | 엔터티 유형 설명 |
| extraConfig | json | 아니요 | 현재 워크스페이스의 추가 구성 |
| healthConfig | json | 아니요 | 생성 API는 이 필드를 처리하지 않으며, 생성 성공 후 엔터티 유형 수정 API로 헬스를 구성합니다 |
| customProperties | string | 아니요 | 현재 워크스페이스에 엔터티 유형이 추가하는 DataSchema 사용자 정의 필드 YAML 텍스트이며, 최상위는 custom_properties를 권장합니다 |
| schemaDefine | string | 아니요 | DataSchema YAML 텍스트 |
| viewDefine | string | 아니요 | UIView YAML 텍스트 |
| extend | json | 아니요 | 확장 필드 |
템플릿 사용 설명
schemaDefine또는viewDefine을 전달하지 않으면 시스템이 기본 템플릿에서 자동으로 채웁니다.- 기본 템플릿의
{entity_type}은 현재 요청의entityType으로 대체됩니다. - 호출자가 템플릿을 완전히 사용자 정의하려면 전체 YAML 텍스트를 직접 전달할 수 있습니다.
- 생성 시
extraConfig와customProperties를 동시에 전달할 수 있으며, 두 값은 현재 워크스페이스 엔터티 유형 구성에 기록됩니다.
호출 시 주의 사항
- OpenAPI는 사용 중단된 엔터티 유형 그룹 파라미터를 지원하지 않습니다.
- 최소 엔터티 유형만 생성하려면
entityType만 전달하면 됩니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/unified_catalog/entity_type_cfg/create' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"entityType":"demo_service","name":"예시 서비스","description":"비즈니스 서비스 카탈로그","schemaDefine":"kind: DataSchema\nentity_type: demo_service\nproperties:\n - name: env\n type: string\n required: false\n","viewDefine":"kind: UIView\nlayout:\n - group:\n display_name: 기본 정보\n fields:\n - bind: env\n title: 환경\n ui_type: input\n","customProperties":"# 원문과 주석 보존\ncustom_properties:\n - name: business_owner\n title: 비즈니스 담당자\n type: string\n required: false\n extension_scope: custom\n writable_sources: [manual, gitops]\n capabilities: {display: true, edit: true, filter: false, sort: false}\n","extraConfig":{}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 유형 레코드 번호이며, 신규 생성 제출 전에는 null일 수 있습니다. |
| content.uuid | string | enty_ 유형 UUID이며, 생성 템플릿은 default입니다. |
| content.workspaceUUID | string | 유형이 속한 워크스페이스이며, 공식 유형은 비어 있을 수 있고, 워크스페이스 오버라이드 구성은 여전히 현재 워크스페이스 기준으로 별도 처리됩니다. |
| content.entityType | string | 안정적인 유형 코드이며 표시 이름이 아닙니다. |
| content.name | string | 표시 이름. |
| content.description | string | 설명. |
| content.sourceType | string | default는 공식/기본, custom은 사용자 정의입니다. |
| content.isSystem | integer | 시스템 레벨 표시이며 sourceType과 단순히 동일하지 않습니다. |
| content.isHidden | integer | 숨김 표시이며, 일반 목록은 숨김 시스템 유형을 제외합니다. |
| content.showRank | integer 또는 null | 시스템 유형 표시 정렬 가중치이며, 값이 없으면 null입니다. |
| content.entityTypeGroupUUID | string | 과거 그룹 식별자로 비어 있을 수 있으며, 공개 API는 사용 중단된 그룹 쓰기 파라미터를 받지 않습니다. |
| content.groupInfo | object 또는 null | 그룹 요약이며, 누락 시 {}일 수 있고, 기본 유형 수정 시 null일 수 있습니다. |
| content.groupInfo.uuid | string | 과거 그룹이 존재할 때의 UUID입니다. |
| content.groupInfo.name | string | 과거 그룹이 존재할 때의 이름입니다. |
| content.schemaDefine | string | 원본 DataSchema YAML이며, summaryOnly 목록에서는 생략됩니다. |
| content.viewDefine | string | 원본 UIView YAML이며, summaryOnly 목록에서는 생략됩니다. |
| content.extend | object | 동적 유형 확장. |
| content.extend.확장 키 | JSON | 구체적인 키는 원본 유형 정의를 따릅니다. |
| content.status | integer | 정상은 0이며, default 생성 템플릿은 3으로 목록의 활성 리소스가 아닙니다. |
| content.creator | string | 생성 주체 UUID/시스템 식별자. |
| content.updator | string | 갱신 주체. |
| content.createAt | integer | 생성 Unix 초. |
| content.updateAt | integer | 갱신 Unix 초이며, 갱신되지 않은 경우 -1일 수 있습니다. |
| content.deleteAt | integer | 삭제 Unix 초이며, 삭제되지 않은 경우 -1입니다. |
| content.entityCount | integer | 현재 워크스페이스 엔터티 수이며, 목록에서 withEntityCount=false이면 생략됩니다. 생성/수정 응답의 0은 실제 수량을 조회한 결과가 아닙니다. |
| content.extraConfig | object | 현재 워크스페이스 추가 구성이며, 기본값은 {}입니다. |
| content.extraConfig.telemetrySelectors | array | 조건부로 존재하는 텔레메트리 연관 구성이며, 엔터티 조회 결과와 동일하지 않습니다. |
| content.extraConfig.telemetrySelectors[] | JSON | 해당 구성의 동적 항목. |
| content.extraConfig.disabledBuiltInViews | array<string> | 조건부로 존재하는 비활성화된 내장 뷰 식별자. |
| content.extraConfig.disabledBuiltInViews[] | string | 개별 뷰 식별자. |
| content.extraConfig.기타 키 | JSON | 동적 확장이며 실제 값을 유지합니다. |
| content.customProperties | string | 현재 워크스페이스의 원본 사용자 정의 필드 YAML이며, 주석을 보존합니다. |
| content.effectiveSchemaDefine | string | base schema에 현재 워크스페이스의 custom_properties를 파싱·병합한 YAML이며, 주석 보존을 보장하지 않습니다. 공개 상세/생성/수정에는 포함되고 목록에는 포함되지 않습니다. 다시 기록할 수 있는 원본 Schema가 아닙니다. |
| content.declaration | object | 공통 선언. |
{
"code": 200,
"content": {
"id": null,
"uuid": "enty_example",
"workspaceUUID": "wksp_example",
"entityType": "demo_service",
"name": "예시 서비스",
"description": "비즈니스 서비스 카탈로그",
"sourceType": "custom",
"isSystem": 0,
"isHidden": 0,
"showRank": null,
"entityTypeGroupUUID": "",
"schemaDefine": "kind: DataSchema\nentity_type: demo_service\nproperties:\n - name: env\n type: string\n required: false\n",
"viewDefine": "kind: UIView\nlayout:\n - group:\n display_name: 기본 정보\n fields:\n - bind: env\n title: 환경\n ui_type: input\n",
"extend": {},
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"status": 0,
"groupInfo": {},
"entityCount": 0,
"extraConfig": {},
"customProperties": "# 원문과 주석 보존\ncustom_properties:\n - name: business_owner\n title: 비즈니스 담당자\n type: string\n required: false\n extension_scope: custom\n writable_sources: [manual, gitops]\n capabilities: {display: true, edit: true, filter: false, sort: false}\n",
"effectiveSchemaDefine": "kind: DataSchema\nentity_type: demo_service\nproperties:\n- name: env\n type: string\n required: false\ncustom_properties:\n- name: business_owner\n title: 비즈니스 담당자\n type: string\n required: false\n extension_scope: custom\n writable_sources:\n - manual\n - gitops\n capabilities:\n display: true\n edit: true\n filter: false\n sort: false\n",
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
다운스트림 오류는 Kodo 공유 매핑을 따르며, 4xx는 실제 HTTP 상태 및 ft.KodoCommonApiErr 또는 매핑된 비즈니스 코드를 반환할 수 있습니다. 모든 실패가 406으로 전환되는 것은 아닙니다. 전달되지 않은 5xx/연결 예외/성공 결과 구조 불일치는 최종적으로 500 ft.InternalServerError가 됩니다. errorCode/message/traceId를 보존하고 읽기 또는 쓰기 단계에 따라 처리하십시오. 성공 HTTP 응답이 엔터티의 실제 가시성 검증을 대신할 수는 없습니다.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방식 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드 누락 또는 필드 값이 선언된 검증 조건 위반 | 파라미터 파싱 실패 | 파라미터 위치, 필드 이름, 유형 및 값을 확인합니다. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문 무효 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정합니다. |
| 400 | ft.JsonFormatError | Body 최상위가 JSON 객체가 아님 | 일부 json 파일 형식 오류 | 예시에 따라 객체를 제출하고 배열/문자열을 사용하지 않습니다. |
| 406 | ft.InvalidParameter | 사용자 정의 필드 YAML/이름/유형/기능 구조가 잘못되었거나 Schema/View 구조로 메타데이터를 생성할 수 없음; healthConfig.mode가 잘못되었거나 비system이 default를 사용, func 모드에서 funcId 누락 또는 현재 워크스페이스의 삭제되지 않은 함수가 아님 | 파라미터 {} 무효 |
아래 YAML 필드 표와 원본 템플릿에 따라 수정하고, base 필드 중복 이름, 루트 객체/배열 및 유효 유형을 확인합니다. 먼저 유형이 허용하는 헬스 mode를 확인하고, 현재 워크스페이스 Func 관리에서 삭제되지 않은 함수 UUID를 가져오십시오. 이름/다른 워크스페이스의 함수를 입력하지 마십시오. |
| 500 | ft.InternalServerError | 구성 읽기/쓰기, 원본 이력 YAML 처리, 카운트 조회, 잠금/헬스 세대 또는 보상 작업의 미처리 실패 | 내부 오류 | 먼저 UUID로 현재 상태를 다시 읽으십시오. 오류가 제출 이후에 발생한 경우 구성이 이미 적용되었을 수 있습니다. traceId를 보존하고 무작정 반복 생성하지 마십시오. |
| 400 | ft.InvalidCatalogEntityType | 코드가 첫 글자 및 최대 64 규칙을 충족하지 않음 | 유효하지 않은 엔터티 유형 {} |
영문자로 시작하고 숫자/영문자/_/-만 사용하는 코드를 사용합니다. |
| 406 | ft.CatalogEntityTypeExists | 현재 가시 범위의 공식/사용자 정의 유형에 동일한 코드가 이미 존재 | 엔터티 유형 {}이(가) 이미 존재합니다 |
기존 UUID를 가져와 수정하거나 다른 비즈니스 고유 코드를 선택합니다. |
| 429 | ft.OperationTooFrequently | 동일 코드의 동시 생성/템플릿 작업이 잠금을 보유하여 생성 잠금을 획득할 수 없음 | 작업이 너무 빈번합니다. 잠시 후 다시 시도하십시오 | 잠시 후 백오프 재시도하기 전에 먼저 목록을 읽어 이미 생성되었는지 확인합니다. |