# 查询资产中心resource、doc目录下的内容 - ShowAssetResource
#### 功能介绍
查询资产资源接口用于在ModelArts平台上获取指定资产中resource、doc等目录下的资源文件内容，如说明文档、芯片配置等。
该接口适用于以下场景：当用户需要查看资产的附加文档、配置文件或其他静态资源时，可以通过此接口按资源名称获取对应内容。使用该接口的前提条件是用户已具备项目访问权限，并已知目标资产ID及资源文件名称。平台将根据资产ID和资源名称读取对应文件，并按文件类型自动返回相应的内容格式。若资产不存在或用户无权限操作，接口将返回相应的错误信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowAssetResource)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v2/{project_id}/assets/{asset_id}/resources
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**：华为云项目ID，\[获取项目ID\]在ModelArts Studio任意页面，按F12进入开发者工具，刷新页面，在开发者工具Network页签找到/rest/me接口，从此接口的response里找到project_id字段。 **约束限制**：1-64字符，英文字母，数字，下划线，中划线。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| asset_id   | 是    | String | **参数解释**：资产id。 **约束限制**：1-36字符，英文字母，数字，下划线，中划线。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                                                              |
   
表2Query参数 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| workspace_id  | 否    | String  | **参数解释**：工作空间ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 **约束限制**：1-32字母，数字。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                           |
| resource_name | 是    | String  | **参数解释**：静态资源名称。 **约束限制**：当前只支持readme文件查询（docs/RELEASE.md）。 **取值范围**：不涉及。 **默认取值**：不涉及。                                                                               |
| check_locale  | 否    | Boolean | **参数解释**：查询资源时是否拼接区域信息。如果为false，则直接查询docs/RELEASE.md文件；如果为true，则会优先匹配带有区域信息的文件（请求头传递x-language，如英文查询docs/RELEASE_en-US.md）。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**：用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，\[获取Token\]调用IAM的/v3/auth/tokens，在接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
   
#### 响应参数
**状态码：200**
成功返回二进制文件流
无
#### 请求示例
```
https://{endpoint}/v2/{project_id}/assets/{asset_id}/resources?resource_name={resource_name}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述         |
|:---|:---|
| 200 | 成功返回二进制文件流 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。