# 创建资源 - CreateResource #### 功能介绍 创建一个新资源，作业节点类型MRS Spark、MRS MapReduce、DLI Spark可以通过资源引用JAR、properties等文件。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DGC/doc?api=CreateResource)中调试该接口，支持自动认证鉴权。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI - URI格式 POST /v1/{project_id}/resources - 参数说明 表1URI参数说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 | #### 请求参数 表2请求Header参数 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | workspace | 否 | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。 - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。 - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。 | 表3Resource参数说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | name | 是 | String | 资源名称，只能包含英文字母、数字、中文字符、下划线或中划线，且长度为1-32个字符。 | | type | 是 | String | 资源类型，包含： - archive - file - jar | | location | 是 | String | 资源文件所在OBS路径，当类型为jar时，location为主Jar包所在路径。最多1023个字符。示例：obs://myBucket/test.jar | | dependFiles | 否 | List\ | 主Jar包所依赖的JAR包、properties文件。总的长度不能超过10240个字符。 | | desc | 否 | String | 描述，长度不能超过255个字符。 | | directory | 否 | String | 资源所在目录。 通过DataArts Studio管理控制台 \> 数据开发，左侧列表选择"配置管理 \> 资源管理"。在资源的目录树上，可以查看到当前已经创建的目录，默认在根目录/。 | #### 响应参数 表4参数说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | resourceId | 是 | String | 资源ID | #### 请求示例 创建资源名称为test的资源，资源类型为jar，资源文件所在OBS路径为**obs://dlf-test/hadoop-mapreduce-examples-2.4.1.jar** ，资源主Jar包所依赖的JAR包、properties文件为**obs://dlf-test/depend1.jar","obs://dlf-test/depend2.jar** ，描述为test，资源所在目录为**/resource**。 ``` POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/resources { "name": "test", "type": "jar", "location": "obs://dlf-test/hadoop-mapreduce-examples-2.4.1.jar", "dependFiles": ["obs://dlf-test/depend1.jar","obs://dlf-test/depend2.jar"], "desc": "test", "directory":"/resource" } ``` #### 响应示例 - 成功响应 ``` { "resourceId":"3624d1c3-5df5-4f20-9af9-98eadad6c5f9" } ``` - 失败响应 HTTP状态码 400 ``` { "error_code":"DLF.6259", "error_msg":"Files of the same name exist in the directory." } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0310.html)。