変更¶
POST /api/v1/log_backup_cfg/{cfg_uuid}/modify
概要¶
個別のデータ転送ルールを変更します
ルートパラメーター¶
| パラメーター名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| cfg_uuid | string | Y | 設定 UUID |
Body リクエストパラメーター¶
| パラメーター名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| extend | json | フロントエンドカスタムデータ 空欄許可: True |
|
| syncExtensionField | boolean | 拡張フィールドを同期してバックアップするかどうか。true の場合は同期、false の場合は同期しません。デフォルトは同期しません。 空欄許可: False |
|
| openPermissionSet | boolean | カスタム権限設定を有効にするかどうか(デフォルト false:無効)。有効にすると、転送ルールのデータ読み取り権限は readPermissionSet に従います(2025-03-26 イテレーションで追加)。 空欄許可: False |
|
| readPermissionSet | array | データ転送ルールのデータ読み取り権限設定。ロール(所有者を除く)を設定可能です(2025-03-26 イテレーションで追加)。 例: ['wsAdmin', 'general'] 空欄許可: False |
|
| storageClass | string | ストレージタイプ 空欄許可: False 空文字列許可: True |
|
| storageFormat | string | ストレージ形式。デフォルト値は json です。 空欄許可: False 空文字列許可: True 選択可能な値: ['json', 'parquet'] |
|
| dataType | string | データタイプ。旧クライアントからの値の受け渡しにのみ使用され、ルール作成後は変更できません。 空欄許可: False 選択可能な値: ['llm', 'logging', 'tracing', 'rum', 'keyevent', 'audit_event', 'am'] |
|
| accessCfg | json | 外部リソースアクセス設定情報 空欄許可: False |
|
| accessCfg.provider | string | プロバイダー 空欄許可: False 選択可能な値: ['aliyun', 'aws', 'huawei', 'volcengine', 'google'] |
|
| accessCfg.grantType | string | 認可タイプ 空欄許可: False 選択可能な値: ['role', 'ram', 'account', 'serviceAccount'] |
|
| accessCfg.cloudAccountId | string | クラウドアカウント ID 空欄許可: False |
|
| accessCfg.bucket | string | ストレージバケット 空欄許可: False |
|
| accessCfg.externalId | string | 外部一意識別 ID(AWS のロール認可方式における外部一意識別 ID) 空欄許可: False |
|
| accessCfg.role | string | ロール名 空欄許可: False |
|
| accessCfg.ak | string | アクセスキー ID 空欄許可: False |
|
| accessCfg.sk | string | シークレットキー 空欄許可: False |
|
| accessCfg.serviceAccountJson | json | GCP サービスアカウント JSON オブジェクト 空欄許可: False |
|
| accessCfg.topic | string | トピック 空欄許可: False 空文字列許可: True |
|
| accessCfg.url | string | 接続 URL(kafka に適用) 空欄許可: False |
|
| accessCfg.securityProtocol | string | セキュリティプロトコル(kafka に適用) 空欄許可: False 選択可能な値: ['plaintext', 'sasl_plaintext', 'sasl_ssl'] |
|
| accessCfg.ca | string | クライアント SSL 証明書の内容 空欄許可: False 空文字列許可: True |
|
| accessCfg.mechanism | string | 認証方式 空欄許可: False 空文字列許可: True 選択可能な値: ['plain', 'scram-sha-256', 'scram-sha-512'] |
|
| accessCfg.username | string | ユーザー名 空欄許可: False 空文字列許可: True |
|
| accessCfg.password | string | パスワード 空欄許可: False 空文字列許可: True |
|
| accessCfg.endpoints | string | Apache Doris FE HTTP/HTTPS アドレス。複数のアドレスはカンマ区切りで指定します。 空欄許可: False |
|
| accessCfg.database | string | Apache Doris データベース名 空欄許可: False |
|
| accessCfg.table | string | Apache Doris テーブル名。正規表現 ^[A-Za-z][A-Za-z0-9_]{0,63}$ に一致する必要があります。 空欄許可: False |
|
| accessCfg.replicationNum | integer | Apache Doris 新規テーブルのレプリカ数。省略または 0 を指定した場合はクラスターのデフォルト値が使用されます。 空欄許可: False $minValue: 0 |
|
| accessCfg.region | string | リージョン(オプション値。未入力の場合は、現在のサイトに一致するプロバイダーのリージョンがデフォルトで使用されます)。 空欄許可: False |
|
| accessCfg.endpoint | string | アクセスエンドポイント。storeType が s3/obs/oss/tos で grantType=ram の場合にオプションです。 空欄許可: False |
|
| accessCfg.bucketPath | string | ストレージバケットパス 空欄許可: False 空文字列許可: True |
|
| accessCfg.dataWaitSeconds | integer | オブジェクトストレージデータの待機時間(秒単位)。未指定の場合は既存の値を使用し、既存の値がない場合はデフォルトで 3600 になります。 空欄許可: False 選択可能な値: [900, 1800, 3600] |
|
| accessCfg.isEncrypt | boolean | 転送データを暗号化するかどうかを指定します。デフォルトは false で暗号化しません。 空欄許可: False |
パラメーター補足説明¶
リクエスト例¶
curl 'https://openapi.guance.com/api/v1/log_backup_cfg/lgbp_xxxx32/modify' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"extend":{"filters":[],"filterLogic":"and","indexs":["default"]},"syncExtensionField":true,"accessCfg":{"grantType":"ram","bucket":"test-s3-001","region":"cn-south-1","provider":"aws","endpoint":"https://s3.custom-endpoint.example.com"}}' \
--compressed
レスポンス¶
{
"code": 200,
"content": {
"conditions": "{}",
"createAt": 1697613651,
"creator": "xxx",
"dataType": "tracing",
"deleteAt": -1,
"extend": {
"filterLogic": "and",
"filters": []
},
"externalResourceAccessCfgUUID": "erac_xxxx32",
"id": 686,
"name": "temp_test",
"status": 0,
"storeType": "obs",
"syncExtensionField": true,
"taskErrorCode": "",
"taskStatusCode": -1,
"updateAt": 1697613856.5497322,
"updator": "wsak_xxxxx",
"uuid": "lgbp_xxxx32",
"workspaceUUID": "wksp_xxxx32"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-599A0794-3DD7-4731-BA2F-0A3655C09684"
}