統合カタログ エンティティタイプの変更¶
POST /api/v1/unified_catalog/entity_type_cfg/{entity_type_uuid}/modify
概要¶
統合カタログのエンティティタイプを変更します。
ルートパラメータ¶
| パラメータ名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| entity_type_uuid | string | Y | エンティティタイプ UUID |
Body リクエストパラメータ¶
| パラメータ名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| name | string | エンティティタイプ表示名 空を許可: False 最大長: 128 |
|
| description | string | エンティティタイプの説明 空を許可: False 最大長: 512 |
|
| extraConfig | json | 現在のワークスペースにおけるエンティティタイプの追加設定 空を許可: False |
|
| healthConfig | json | すべてのタイプで常に設定可能。system は {"mode":"default"}、{"mode":"func","funcId":"xxx"}、{"mode":"disabled"} をサポート。その他のタイプは func/disabled をサポート。バックエンドの readiness クリーンアップの進行状況に依存しません。 空を許可: False |
|
| customProperties | string | 現在のワークスペースでエンティティタイプに追加する DataSchema カスタムフィールドの YAML テキスト。トップレベルは custom_properties を推奨。 空を許可: False |
|
| schemaDefine | string | DataSchema YAML テキスト。カスタムタイプのみ有効。 空を許可: False |
|
| viewDefine | string | UIView YAML テキスト。カスタムタイプのみ有効。 空を許可: False |
|
| extend | json | 拡張フィールド 空を許可: False |
パラメータ補足説明¶
ルートパラメータの説明
| パラメータ名 | type | 必須 | 説明 |
|---|---|---|---|
| entity_type_uuid | string | はい | 対象のエンティティタイプ UUID |
リクエストボディパラメータの説明
| パラメータ名 | type | 必須 | 説明 |
|---|---|---|---|
| name | string | いいえ | エンティティタイプ表示名 |
| description | string | いいえ | エンティティタイプの説明 |
| extraConfig | json | いいえ | 現在のワークスペースにおける追加設定 |
| customProperties | string | いいえ | 現在のワークスペースでエンティティタイプに追加する DataSchema カスタムフィールドの YAML テキスト。トップレベルは custom_properties を推奨。 |
| schemaDefine | string | いいえ | DataSchema YAML テキスト |
| viewDefine | string | いいえ | UIView YAML テキスト |
| extend | json | いいえ | 拡張フィールド |
呼び出し時の注意事項
- デフォルトタイプは
extraConfigとcustomPropertiesの変更をサポートします。 - すべてのエンティティタイプは常に
healthConfigの変更をサポートします。system はdefault/func/disabledをサポート、その他のタイプはfunc/disabledをサポート。バックエンドの readiness クリーンアップの進行状況に依存しません。 - カスタムタイプは
name、description、schemaDefine、viewDefine、extendを変更でき、同時にextraConfigとcustomPropertiesも変更できます。 extraConfigは完全なオブジェクトを渡すことを推奨し、部分的な patch としての値渡しは推奨しません。customPropertiesはトップレベルにcustom_properties配列を含む YAML テキストを推奨します。互換性のため、トップレベル YAML 配列も受け付けます。customPropertiesのフィールド名は、現在のエンティティタイプの DataSchemaproperties内のフィールドと重複してはいけません。フィールドは YAML テキストとして保存され、コメントはそのまま保持されます。
リクエスト例¶
curl 'https://openapi.guance.com/api/v1/unified_catalog/entity_type_cfg/cate_xxxx/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"healthConfig":{"mode":"disabled"}}'