
# 按region获取所有技术栈 - ListStacksTagsByRegion
#### 功能介绍
按region获取所有技术栈详细信息，例如技术栈ID、名称、描述、标签等。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CloudIDE/doc?api=ListStacksTagsByRegion)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-cloudide/cloudide_03_0027.html)。
| 授权项                           | 访问级别                  | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| CodeArtsIDEOnline::listStacks | Permission_management | -           | -   | -  | -      |
   
#### URI
GET /v2/stacks/tag
表1Query参数 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| tags | 否    | String | **参数解释：** 技术栈标签。 **约束限制：** 不涉及。 **取值范围：** Java、CPP、GO、Python等多种标签。 **默认取值：** 空值，表示查询全部标签。 |
#### 请求参数
表2请求Header参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| X-Auth-Token     | 是    | String | **参数解释：** 用户Token。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。       |
| X-Sdk-Date       | 否    | String | **参数解释：** 请求发起时间。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。        |
| host             | 否    | String | **参数解释：** 请求host地址。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。      |
| x-security-token | 否    | String | **参数解释：** IAM5.0鉴权token。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| Authorization    | 否    | String | **参数解释：** AK/SK签名。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 空值。        |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型                                                                                           | 描述                                                                      |
|:---|:---|:---|
| stack  | [StacksTags] object | **参数解释：** 技术栈。 **取值范围：** 不涉及                                            |
| status | String                                                                                         | **参数解释：** 请求响应的状态，表明请求是否成功。 **取值范围：** - success：请求响应成功。 - error：请求响应失败。 |
   
 表4StacksTags 
| 参数         | 参数类型                                                                                                   | 描述                                |
|:---|:---|:---|
| stack_list | Array of [StackInfo] objects | **参数解释：** 技术栈列表。 **取值范围：** 不涉及    |
| tags       | Array of strings                                                                                       | **参数解释：** 技术栈tag集合。 **取值范围：** 不涉及 |
   
 表5StackInfo 
| 参数           | 参数类型                                                                                               | 描述                                         |
|:---|:---|:---|
| arm_config   | [StacksConfig] object | **参数解释：** ARM配置。 **取值范围：** 不涉及             |
| bundle_url   | String                                                                                             | **参数解释：** bundleUrl信息。 **取值范围：** 长度为0\~255 |
| config       | [StacksConfig] object | **参数解释：** X86配置。 **取值范围：** 不涉及             |
| created_time | String                                                                                             | **参数解释：** 创建时间。 **取值范围：** 不涉及              |
| delete       | Boolean                                                                                            | **参数解释：** 是否删除。 **取值范围：** 不涉及              |
| description  | String                                                                                             | **参数解释：** 描述。 **取值范围：** 不涉及                |
| disable      | Boolean                                                                                            | **参数解释：** 是否可用。 **取值范围：** - 是：可用。 - 否：不可用。 |
| display_name | String                                                                                             | **参数解释：** 显示名称。 **取值范围：** 长度为0\~40         |
| id           | Long                                                                                               | **参数解释：** ID信息。 **取值范围：** 不涉及              |
| label        | String                                                                                             | **参数解释：** 标签。 **取值范围：** 长度为0\~32           |
| logo         | String                                                                                             | **参数解释：** 图标。 **取值范围：** 不涉及                |
| region       | String                                                                                             | **参数解释：** 区域信息。 **取值范围：** 长度为0\~40         |
| show         | Boolean                                                                                            | 是否显示                                       |
| stack_name   | String                                                                                             | **参数解释：** 技术栈名称。 **取值范围：** 长度为0\~40.       |
| tags         | Array of strings                                                                                   | **参数解释：** 技术栈标签。 **取值范围：** 不涉及             |
| updated_time | String                                                                                             | **参数解释：** 修改时间。 **取值范围：** 不涉及              |
| users        | Array of strings                                                                                   | **参数解释：** 使用者。 **取值范围：** 不涉及               |
   
 表6StacksConfig 
| 参数         | 参数类型                                                                                                     | 描述                               |
|:---|:---|:---|
| attributes | [StacksAttribute] object | **参数解释：** 技术栈属性值。 **取值范围：** 不涉及。 |
| recipe     | [Recipe] object                   | **参数解释：** 镜像。 **取值范围：** 不涉及。     |
   
 表7StacksAttribute 
| 参数            | 参数类型             | 描述                             |
|:---|:---|:---|
| specs         | Array of strings | **参数解释：** 规格列表。 **取值范围：** 不涉及  |
| suggest       | String           | **参数解释：** 提示ID。 **取值范围：** 不涉及  |
| suggest_title | String           | **参数解释：** 提示信息。 **取值范围：** 不涉及  |
| volumes       | Array of strings | **参数解释：** 卷容量列表。 **取值范围：** 不涉及 |
   
 表8Recipe 
| 参数      | 参数类型   | 描述                                                              |
|:---|:---|:---|
| content | String | **参数解释：** 镜像内容。 **取值范围：** 不涉及                                   |
| type    | String | **参数解释：** 镜像类型。 **取值范围：** - x86：镜像支持x86架构类型。 - arm：镜像支持arm架构类型。 |
   
**状态码：403**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                             |
|:---|:---|:---|
| error_msg  | String | **参数解释：** 错误描述信息。详情请参见[错误码](https://support.huaweicloud.com/api-cloudide/ErrorCode.html)。 **取值范围：** 长度为0\~255。 |
| error_code | String | **参数解释：** 错误码。详情请参见[错误码](https://support.huaweicloud.com/api-cloudide/ErrorCode.html)。 **取值范围：** 长度为0\~100。    |
   
#### 请求示例
按region获取标签所有技术栈
```
GET https://{endpoint}/v2/stacks/tag?tags=Java
```
#### 响应示例
**状态码：200**
OK
```
{
  "stack" : {
    "tags" : [ "Quantum", "Java", "Maven", "CPP", "JavaScript", "Vue", "ServiceComb", "GO", "Node.js", "Ruby", "Python" ],
    "stack_list" : [ {
      "id" : 6,
      "stack_name" : "python",
      "display_name" : "Python",
      "tags" : [ "Python" ],
      "region" : "cn-north-7",
      "users" : [ "ide" ],
      "description" : "支持Python开发，集成pypi",
      "disable" : false,
      "show" : true,
      "arm_config" : {
        "recipe" : {
          "content" : "hishell-python:x86_64_inner_latest_fuxi",
          "type" : "dockerimage"
        },
        "attributes" : {
          "specs" : [ "4U8G" ],
          "volumes" : [ "5GB", "10GB", "20GB" ]
        }
      },
      "config" : {
        "recipe" : {
          "content" : "hishell-python:x86_64_inner_latest_fuxi",
          "type" : "dockerimage"
        },
        "attributes" : {
          "specs" : [ "1U1G", "2U4G" ],
          "volumes" : [ "5GB", "10GB", "20GB" ]
        }
      },
      "created_time" : "2021-10-15 14:28:40",
      "updated_time" : "2021-12-27 16:01:22",
      "bundle_url" : "https://test-static-resource.obs.cn-north-7.huawei.com/CloudIDEStatic/1.0.33.20211227153454/bundle.js",
      "delete" : false
    } ]
  },
  "status" : "success"
}
```
**状态码：403**
Forbidden
```
{
  "error_msg" : "not subscribe codeArts ide online",
  "error_code" : "IDE.00000004"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | OK        |
| 403 | Forbidden |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cloudide/ErrorCode.html)。
