新增用户自定义配置文件

最近更新时间: 2026-09-17 00:05:50

1. 接口描述

接口请求域名： tbdsnew.api3.fincloud.tencent.cn。

新增用户自定义配置文件

默认接口请求频率限制：20次/秒。

接口更新时间：2025-09-12 14:29:11。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：AddServiceConfFile
Version	是	否	String	公共参数，本接口取值：2019-01-03
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceId	是	否	String	集群ID 示例值： tbds-nu7ckm3g
ServiceType	是	否	Int64	组件名示例值： 0
FileName	是	否	String	文件名示例值： test
FileContent	是	否	String	文件内容示例值： echo test
FileMode	是	否	String	文件权限示例值： 777
FileUser	否	否	String	文件所属用户示例值： hadoop
FileGroup	否	否	String	文件所属用户组示例值： hadoop
FilePath	是	否	String	文件所在的绝对路径示例值： /data/test1
ServiceName	否	否	String	服务名示例值： 1

3. 输出参数

参数名称	类型	描述
FlowId	Int64	流程ID 示例值： 1
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError	内部错误。
InternalError.CamCgwError	内部服务调用异常。
InvalidParameter.IllegalParameterType	用户或用户组不合法。
InternalError.WoodServerError	内部服务调用异常。
InvalidParameter.InvalidJobFlow	无效的流程任务。
InvalidParameter	参数错误。
ResourceNotFound.InstanceNotFound	无法找到该实例。

5. 示例

示例1 新增用户自定义配置文件

输入示例

POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: AddServiceConfFile
<公共请求参数>

{
  "ServiceType": 0,
  "InstanceId": "tbds-nu7ckm3g",
  "FileName": "test",
  "FileContent": "echo test",
  "FileMode": "777",
  "FileGroup": "hadoop",
  "FileUser": "hadoop",
  "FilePath": "/data/test1"
}

输出示例

{
  "Response": {
    "FlowId": 804,
    "RequestId": "39ee9b72-b47e-4a3d-9839-55a6bc614a66"
  }
}