调用CreateFile，在数据开发中创建一个文件。目前不支持调用该接口创建数据集成节点任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| dataworks:* | create | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| FileFolderPath | string | 是 | 文件的路径。 | 业务流程/第一个业务流程/MaxCompute/文件夹1/文件夹2 |
| ProjectId | long | 是 | DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台，进入工作空间配置页面获取工作空间 ID。 该参数与 ProjectIdentifier 参数，二者必须设置其一，用来确定本次 API 调用操作的 DataWorks 工作空间。 | 10000 |
| FileName | string | 是 | 文件的名称。 | 文件名 |
| FileDescription | string | 否 | 文件的描述信息。 | 这里是文件描述 |
| FileType | integer | 是 | 文件的代码类型。 不同文件类型其代码不同，详情请参见 DataWorks 节点合集。 您可以调用 ListFileType 接口，查询文件的代码类型。 | 10 |
| Owner | string | 否 | 文件责任人的阿里云用户 ID。如果该参数为空，则默认使用调用者的阿里云用户 ID。 | 1000000000001 |
| Content | string | 否 | 文件代码内容，不同代码类型（fileType）的文件，代码格式不同。您可以在运维中心找到对应类型的任务，右键单击查看代码，查看具体的代码格式。 | SHOW TABLES; |
| AutoRerunTimes | integer | 否 | 出错自动重跑的次数，取值最大为 10。 | 3 |
| AutoRerunIntervalMillis | integer | 否 | 出错自动重跑时间间隔，单位为毫秒。最大为 1800000 毫秒（30 分钟）。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>出错自动重跑”的”重跑间隔“配置对应。 控制台中“重跑间隔”的时间单位为分钟，请在调用时注意转换时间。 | 120000 |
| RerunMode | string | 否 | 重跑属性。取值如下：
该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>重跑属性”配置内容对应。 | ALL_ALLOWED |
| Stop | boolean | 否 | false | |
| ParaValue | string | 否 | 调度参数。多个参数之间用空格进行分割。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>参数”对应。您可以参考调度参数配置。 | a=x b=y |
| StartEffectDate | long | 否 | 开始自动调度的毫秒时间戳。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>生效日期”配置的开始时间的毫秒时间戳对应。 | 1671608450000 |
| EndEffectDate | long | 否 | 停止自动调度的时间戳，单位为毫秒。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>生效日期”配置的结束时间的毫秒时间戳对应。 | 1671694850000 |
| CronExpress | string | 否 | 周期调度的 cron 表达式，该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>cron 表达式”对应。配置完“调度周期”及“定时调度时间”后，DataWorks 会自动生成相应 cron 表达式。 示例如下：
由于 DataWorks 调度系统的规则，cron 表达式有以下限制：
| 00 05 00 * * ? |
| CycleType | string | 否 | 调度周期的类型，包括 NOT_DAY（分钟、小时）和 DAY（日、周、月）。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>时间属性>调度周期”对应。 | DAY |
| DependentType | string | 否 | 依赖上一周期的方式。取值如下：
| NONE |
| DependentNodeIdList | string | 否 | 依赖上一周期的节点列表。 | abc |
| InputList | string | 是 | 文件依赖的上游文件的输出名称，多个输出使用英文逗号（,）分隔。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>调度依赖“选择”同周期“时的”父节点输出名称”对应。 | project_root,project.file1,project.001_out |
| ProjectIdentifier | string | 否 | DataWorks 工作空间的名称。您可以登录 DataWorks 控制台，进入工作空间配置页面获取工作空间名称。 该参数与 ProjectId 参数，二者必须设置其一，用来确定本次 API 调用操作的 DataWorks 工作空间。 | dw_project |
| ResourceGroupIdentifier | string | 否 | 文件发布成任务后，任务执行时对应的资源组。您可以调用 ListResourceGroups 通过 identifier 字段获取工作空间可用的资源组列表。 说明
您需确认 ListResourceGroups 接口返回的资源组已绑定至创建文件所使用的工作空间，绑定后才能在 CreateFile 中使用。
| group_375827434852437 |
| ResourceGroupId | long | 否 | 该字段已废弃，请勿使用。 文件发布成任务后，任务执行时对应的资源组。对应页面上调度配置>资源属性>调度资源组的配置。与 ResourceGroupIdentifier 二者设置其一即可。 您可以通过 ListResourceGroups 接口获取工作空间可用的资源组列表。ResourceGroupType 传 1，拿到结果后取出 ID 字段。 | 375827434852437 |
| ConnectionName | string | 否 | 文件发布成任务后，任务执行时连接的数据源。 您可以调用 UpdateDataSource 接口获取工作空间可用的数据源列表。 | odps_source |
| AutoParsing | boolean | 否 | 文件是否开启自动解析功能。取值如下：
该参数与 DataWorks 控制台中，数据开发任务的“调度配置>调度依赖”选择“同周期”时的“代码解析”对应。 | true |
| SchedulerType | string | 否 | 调度的类型，取值如下：
| NORMAL |
| AdvancedSettings | string | 否 | 任务的高级配置。 该参数与 DataWorks 控制台中，EMR Spark Streaming 和 EMR Streaming SQL 数据开发任务，编辑页面右侧导航栏的“高级设置“对应。 当前仅 EMR Spark Streaming 和 EMR Streaming SQL 任务支持配置该参数，并且参数为 JSON 格式。 | {"queue":"default","SPARK_CONF":"--conf spark.driver.memory=2g"} |
| StartImmediately | boolean | 否 | 发布后是否立即启动。 该参数与 DataWorks 控制台中，EMR Spark Streaming 和 EMR Streaming SQL 数据开发任务，编辑页面右侧导航栏的“配置>时间属性>启动方式“对应。 | true |
| InputParameters | string | 否 | 节点的上下文输入参数。参数为 JSON 格式，包含的字段可参考 GetFile 接口返回值中的 InputContextParameterList 参数结构。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>节点上下文>本节点输入参数“对应。 | [{"ValueSource": "project_001.first_node:bizdate_param","ParameterName": "bizdate_input"}] |
| OutputParameters | string | 否 | 节点的上下文输出参数。参数为 JSON 格式，包含的字段可参考 GetFile 接口返回值中的 OutputContextParameterList 参数结构。 该参数与 DataWorks 控制台中，数据开发任务的“调度配置>节点上下文>本节点输出参数“对应。 | [{"Type": 1,"Value": "${bizdate}","ParameterName": "bizdate_param"}] |
| IgnoreParentSkipRunningProperty | boolean | 否 | 是否沿用上一周期空跑属性。取值如下：
| false |
| CreateFolderIfNotExists | boolean | 否 | 当参数中指定的目录（FileFolderPath）在系统中不存在时，是否自动创建此目录。取值如下： true：若此目录不存在，自动创建此目录 false：若此目录不存在，调用失败 | false |
| ApplyScheduleImmediately | boolean | 否 | 是否发布后立即生效调度配置 | true |
| Timeout | integer | 否 | 调度配置超时定义 | 1 |
返回参数
示例
正常返回示例
JSON格式
{
"HttpStatusCode": 200,
"Data": 1000001,
"RequestId": "0000-ABCD-EFG",
"ErrorMessage": "The connection does not exist.",
"Success": true,
"ErrorCode": "Invalid.Tenant.ConnectionNotExists"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 403 | Forbidden.Access | Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. | 没有权限，请授权 |
| 429 | Throttling.Api | The request for this resource has exceeded your available limit. | 对该资源的请求已超过您的可用上限。 |
| 429 | Throttling.System | The DataWorks system is busy. Try again later. | DataWorks系统繁忙，请稍后再试。 |
| 429 | Throttling.User | Your request is too frequent. Try again later. | 您的请求过于频繁，请尝试放缓请求速度。 |
| 500 | InternalError.System | An internal system error occurred. Try again later. | 系统内部错误，请稍后再试。 |
| 500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | 系统内部错误，请稍后再试。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-12-13 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-09-02 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-04-03 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-07-14 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2023-04-25 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |