文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 网关/ 模型提供商管理/ 获取模型提供商详情 - ShowCustomModelProvider
更新时间:2026-09-24 GMT+08:00
分享

获取模型提供商详情 - ShowCustomModelProvider

功能介绍

获取模型提供商详情。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:customModelProvider:show

Read

customModelProvider *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/core/custom-model-providers/{custom_model_provider_id}

表1 路径参数

参数

是否必选

参数类型

描述

custom_model_provider_id

是

String

参数解释:

模型提供商ID。

约束限制:

长度固定为36字符,必须为UUID格式。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

name

String

参数解释:

模型提供商名称。

取值范围:

长度为 2-40 个字符,匹配以小写字母开头、以小写字母或数字结尾、中间可包含0到38个小写字母、数字或连字符的字符串,符合正则条件^[a-z][a-z0-9-]{0,38}[a-z0-9]$。

base_url

String

参数解释:

模型提供商的默认API基础地址。

取值范围:

长度为1-2048个字符。以https://开头的完整URL。

credential_configuration

CoreModelProviderCredentialConfiguration object

参数解释:

模型提供商的凭证信息。

取值范围:

不涉及。

network_configuration

CoreModelProviderOutboundNetworkConfiguration object

参数解释:

网络配置信息。

取值范围:

不涉及。

description

String

参数解释:

模型的详细描述。

取值范围:

长度为 0-1000 个字符。

tags

Array of CoreModelProviderTag objects

参数解释:

资源标签列表。

取值范围:

数组长度为 0-20。

id

String

参数解释:

模型提供商ID。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

created_at

String

参数解释:

模型提供商创建时间戳。

取值范围:

遵循ISO 8601标准格式,例如:2022-11-09 16:37:24。

updated_at

String

参数解释:

模型提供商最后更新时间戳。

取值范围:

遵循ISO 8601标准格式,例如:2022-11-09 16:37:24。

gateways

Array of ShowCustomModelProviderGatewayDetails objects

参数解释:

模型提供商关联的网关列表。

取值范围:

数组长度为0-100个。

表3 CoreModelProviderCredentialConfiguration

参数

参数类型

描述

provider_configuration

CoreModelProviderCredentialProviderConfiguration object

参数解释:

模型提供商的凭证提供者配置。

取值范围:

不涉及。

表4 CoreModelProviderCredentialProviderConfiguration

参数

参数类型

描述

credential_provider_type

String

参数解释:

凭证提供者类型。

取值范围:

  • iam: 使用网关 IAM 角色。

  • api_key: 使用 API 密钥。

credential_provider

CoreModelProviderCredentialProvider object

参数解释:

模型提供商的凭证提供者配置。

取值范围:

不涉及。

表5 CoreModelProviderCredentialProvider

参数

参数类型

描述

api_key_credential_provider

CoreGatewayApiKeyCredentialProvider object

参数解释:

API KEY凭证提供者配置。

取值范围:

不涉及。

iam_credential_provider

CoreGatewayIamCredentialProvider object

参数解释:

Iam凭证提供者配置。

取值范围:

不涉及。

表6 CoreGatewayApiKeyCredentialProvider

参数

参数类型

描述

provider_name

String

参数解释:

凭证提供者名称。

取值范围:

长度为 1-56 个字符,由字母、数字、下划线或短横线组成的、长度为1到56个字符的字符串,符合正则条件^[a-zA-Z0-9_-]{1,56}$。

credential_location

String

参数解释:

凭证传递位置。

取值范围:

  • header: 通过 HTTP 请求头传递 API 密钥

  • query: 通过 URL 查询参数传递 API 密钥

credential_parameter_name

String

参数解释:

凭证参数名称。

取值范围:

长度为 0-64 个字符。

credential_prefix

String

参数解释:

凭证前缀(如 "Bearer ")。

取值范围:

长度为 0-64 个字符。

表7 CoreGatewayIamCredentialProvider

参数

参数类型

描述

provider_name

String

参数解释:

凭证提供者名称。

取值范围:

长度为 1-56 个字符,由字母、数字、下划线或短横线组成的、长度为1到56个字符的字符串,符合正则条件^[a-zA-Z0-9_-]{1,56}$。

表8 CoreModelProviderOutboundNetworkConfiguration

参数

参数类型

描述

network_mode

String

参数解释:

网络模式。

取值范围:

  • public: 使用公网访问

  • vpc: 使用VPC网络访问(需配置vpc_config)

vpc_config

CoreGatewayVpcConfig object

参数解释:

VPC网络配置。

取值范围:

不涉及。

表9 CoreGatewayVpcConfig

参数

参数类型

描述

vpc_id

String

参数解释:

VPC ID,VPC网络的唯一标识。

VPC ID获取方式:

  1. 进入虚拟私有云,在左侧导航栏选择“我的VPC”。

  2. 在虚拟私有云VPC列表中“名称/ID”处复制VPC ID即可。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

subnet_id

String

参数解释:

子网ID,VPC子网的唯一标识。

子网ID获取方式:

  1. 进入虚拟私有云,在左侧导航栏选择“子网”。

  2. 在子网列表中“名称/ID”处复制子网ID即可。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

security_group_ids

Array of strings

参数解释:

安全组ID列表。

取值范围:

数组长度为0-10。

表10 CoreModelProviderTag

参数

参数类型

描述

key

String

参数解释:

标签键。

取值范围:

最大长度128个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

value

String

参数解释:

标签值。

取值范围:

最大长度255个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

表11 ShowCustomModelProviderGatewayDetails

参数

参数类型

描述

id

String

参数解释:

网关的唯一标识符。

网关ID获取方式:

  1. 进入AgentArts平台,在左侧导航栏选择“托管与运行 > 网关”,进入网关界面。

  2. 在网关列表中“网关名称/ID”处复制网关ID即可。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

name

String

参数解释:

网关名称。

取值范围:

长度为 2-40 个字符,匹配以小写字母开头、以小写字母或数字结尾、中间可包含0到38个小写字母、数字或连字符的字符串,符合正则条件^[a-z][a-z0-9-]{0,38}[a-z0-9]$。

endpoint_url

String

参数解释:

访问网关的 URL 端点。

取值范围:

长度为 1-512 个字符。

  • 示例:https://gateway-fo2ao8pg-beta1-gw-gu2geoldgz.cn-southwest-301.huaweicloud-agentarts.com

inbound_authorizer_type

String

参数解释:

入站认证类型。

取值范围:

  • iam: 使用 IAM 认证

  • api_key: 使用 API 密钥认证

workload_identity_urn

String

参数解释:

工作负载标识的统一资源名称,格式为''agentIdentity:<region-id>:<account-id>:workloadIdentity:gateway_<gateway-name>''。

取值范围:

长度为 1-200 个字符。

log_delivery_configuration

CoreGatewayLogDeliveryConfiguration object

参数解释:

日志上报配置。

agent_gateway_id

String

参数解释:

AgentGateway ID,关联底层 AgentGateway 实例。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

description

String

参数解释:

详细描述。

取值范围:

长度为 1-1000 个字符。

tags

Array of CoreGatewayTag objects

参数解释:

资源标签列表。

取值范围:

数组长度为0-20。

表12 CoreGatewayLogDeliveryConfiguration

参数

参数类型

描述

enabled

Boolean

参数解释:

是否启用日志。

取值范围:

当取值为true时,表示启用日志。当取值为false时,表示不启用日志。

log_group_id

String

参数解释:

LTS日志组ID,云日志服务的日志组唯一标识。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

log_stream_id

String

参数解释:

LTS日志流ID,云日志服务的日志流唯一标识。

取值范围:

匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

表13 CoreGatewayTag

参数

参数类型

描述

key

String

参数解释:

标签键。

取值范围:

最大长度128个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

value

String

参数解释:

标签值。

取值范围:

最大长度255个unicode字符,可用 UTF-8 格式表示的字母、数字和空格,以及以下字符:_ . : / = + - @。

状态码:400

表14 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:401

表15 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:403

表16 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息,可通过统一身份认证服务IAM的解密鉴权失败的原因接口解码获取详细授权失败原因。

取值范围:

取值为 1-4096 个字符。

details

Array of CoreGatewayCommonError objects

参数解释:

依赖的下游服务错误信息列表。

取值范围:

数组长度为 0-10。

表17 CoreGatewayCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:429

表18 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:500

表19 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

取值为1-32个字符。

error_msg

String

参数解释:

错误消息。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释:

错误原因。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释:

错误处理建议。

取值范围:

取值为 1-256 个字符,匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串,符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

请求示例

无

响应示例

状态码:200

成功检索模型提供商详情。

{
  "id" : "aaac0463-8b28-46c5-87ba-6267295ffc57",
  "name" : "my-provider",
  "base_url" : [ "https//example.com/v1" ],
  "credential_configuration" : {
    "provider_configuration" : {
      "credential_provider_type" : "iam",
      "credential_provider" : {
        "iam_credential_provider" : {
          "provider_name" : "my-secret-provider"
        }
      }
    }
  },
  "network_configuration" : {
    "network_mode" : "public"
  },
  "description" : "我的 MCP 网关",
  "tags" : [ {
    "key" : "Environment",
    "value" : "production"
  }, {
    "key" : "Team",
    "value" : "ai-platform"
  } ],
  "gateways" : [ {
    "id" : "bbac0463-8b28-46c5-87ba-6267295ffc57",
    "name" : "test",
    "inbound_authorizer_type" : "api_key",
    "endpoint_url" : "https://gateway-fo2ao8pg-beta1-gw-gu2geoldgz.cn-southwest-301.huaweicloud-agentarts.com",
    "workload_identity_urn" : "agentIdentity:cn-north-4:3226a8d8-39a9-445e-949f-04e3d679f668:workloadIdentity:gateway_example-gateway"
  } ],
  "created_at" : "2022-11-09 16:37:24",
  "updated_at" : "2022-11-09 16:37:24"
}

状态码:400

请求参数错误

{
  "error_code" : "AgentArts.02000001",
  "error_msg" : "请求参数错误",
  "error_reason" : "请求参数错误",
  "error_suggestion" : "根据接口返回的具体原因修改请求参数"
}

状态码:401

认证信息无法识别

{
  "error_code" : "AgentArts.02000300",
  "error_msg" : "认证信息无法识别",
  "error_reason" : "认证信息无法识别",
  "error_suggestion" : "使用正确的认证信息访问"
}

状态码:403

权限不足,拒绝访问

{
  "error_code" : "AgentArts.02000200",
  "error_msg" : "没有权限执行该操作",
  "error_reason" : "没有权限执行该操作",
  "error_suggestion" : "请检查权限是否配置正确",
  "encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
  "details" : [ {
    "error_code" : "IAM.0082",
    "error_msg" : "权限不足,拒绝访问"
  } ]
}

状态码:429

请求频率超限。

{
  "error_code" : "AgentArts.02000400",
  "error_msg" : "请求过于频繁,请稍后重试",
  "error_reason" : "请求过于频繁,请稍后重试",
  "error_suggestion" : "稍后重试"
}

状态码:500

内部服务器错误

{
  "error_code" : "AgentArts.02000500",
  "error_msg" : "服务连接超时",
  "error_reason" : "服务连接超时",
  "error_suggestion" : "请稍后重试"
}

状态码

状态码

描述

200

成功检索模型提供商详情。

400

请求参数错误

401

认证信息无法识别

403

权限不足,拒绝访问

429

请求频率超限。

500

内部服务器错误

错误码

请参见错误码。

相关文档