j9九游会登录/ 大模型即服务平台 maas/ api参考/ / 获取区域信息
更新时间：2026-02-10 gmt 08:00

获取区域信息-j9九游会登录

功能介绍

该api用于获取ai开发平台modelarts-在线服务的区域信息。当创建自定义接入点的“source”参数选择“custom_from_modelarts_v2”时，获取请求中的region参数。

接口约束

该功能仅支持“西南-贵阳一”区域。

uri

get /v1/{project_id}/maas/services/custom-endpoint/regions

表1 路径参数

参数

是否必选

参数类型

描述

project-id

是

string

参数解释：项目id。关于如何获取项目id，请参见获取项目id和名称。

约束限制：不涉及。

取值范围：只能由小写英文字母和数字组成，长度为32。

默认取值：不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

是

string

参数解释：用户token。通过调用iam服务的获取用户token接口获取（响应消息头中x-subject-token的值）。获取方式请参见认证鉴权。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

content-type

是

string

参数解释：消息体的类型，固定为application/json。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

响应参数

表3 响应body参数

参数

参数类型

描述

region_items

array[regioninfo]

参数解释：ai开发平台modelarts-在线服务所有的region信息。

取值范围：不涉及。
表4 regioninfo

参数

参数类型

描述

region_id

string

参数解释：ai开发平台modelarts-在线服务的region。

取值范围：不涉及。

locales

localinfo

参数解释：接入点中英文名称。

取值范围：不涉及。
表5 localinfo

参数

参数类型

描述

en_us

string

参数解释：英文名称。

取值范围：不涉及。

zh_cn

string

参数解释：中文名称。

取值范围：不涉及。
表6 错误响应参数

参数

参数类型

描述

error_msg

string

参数解释：错误描述信息。

取值范围：不涉及。

error_code

string

参数解释：错误码，标识错误类型。

取值范围：不涉及。

请求示例

get
/v1/{project_id}/maas/services/custom-endpoint/regions

响应示例

  • 成功响应，状态码：200。 
    {
    "region_items": [
        {
            "region_id": "cn-southwest-2",
            "locales": {
                "en_us": "cn-southwest-2",
                "zh_cn": "贵阳一"
            }
        },
        {
            "region_id": "cn-north-12",
            "locales": {
                "en_us": "cn-north-12",
                "zh_cn": "华北三"
            }
        },
        {
            "region_id": "cn-east-4",
            "locales": {
                "en_us": "cn-east-4",
                "zh_cn": "华东二"
            }
        },
        {
            "region_id": "cn-north-9",
            "locales": {
                "en_us": "cn-north-9",
                "zh_cn": "乌兰察布一"
            }
        }
    ]
}
  • 错误响应，状态码：400。 
    {
"error_msg": "invalid token.",
"error_code": "modelarts.0104"
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：

相关文档

网站地图