CreateApiMcpServerCore - 创建 API MCP Core服务

更新时间:
复制为 MD 格式

创建ApiMcpServerCore。

接口说明

该接口查询的是公开信息,不涉及账号特殊归属等信息,故不支持授权。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /apimcpservercore HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

body

object

创建 API MCP Core 服务

clientToken

string

幂等校验 TOKEN。

123e4567-e89b-12d3-a456-426655440000

oauthClientId

string

选择自定义 OAuth 配置时的自定义 OAuth Client ID。

仅支持 Web/Native 应用,且 OAuth 范围必须包含 /acs/mcp-server

403*************370

vpcWhitelists

array

每一个限定的 VPC 白名单,值为来源 VPC ID。

string

关闭公网访问后,限定来源的 VPC 白名单,不设置或为空表示不限制来源。

vpc-j6cgd2if5lg**0xs6m5se

enableAssumeRole

boolean

是否开启多账号访问。

true

assumeRoleOverridePolicy

string

开启多账号访问时,角色扮演额外的策略,该策略存在时,角色扮演的权限以当前值为准,覆盖角色本身的权限定义。

{"Version":"1","Statement":[{"Effect":"Allow","Action":["ecs:Describe*"],"Resource":"*"}]}

assumeRoleName

string

开启多账号访问进行跨账号操作时,扮演的目标账号 RAM 角色名称。

test

publicAccessType

string

公网访问类型:允许公网访问、不允许公网访问、继承账号配置。 public(开启), private(关闭), inherit(跟随账号配置)

枚举值:

  • private :

    关闭

  • public :

    开启

  • inherit :

    跟随账号配置

public

enableCustomVpcWhitelist

boolean

是否开启自定义 VPC 白名单,不开启则跟随账户级别的配置。

true

返回参数

名称

类型

描述

示例值

object

requestId

string

请求 ID。

A707AFA8-1A4C-5B2A-A165-8436C1EA38DB

id

string

创建成功的 API MCP Core 服务 ID。

v6ZZ7ftCzEILW***

示例

正常返回示例

JSON格式

{
  "requestId": "A707AFA8-1A4C-5B2A-A165-8436C1EA38DB",
  "id": "v6ZZ7ftCzEILW***"
}

错误码

HTTP status code

错误码

错误信息

描述

400 IdempotentParameterMismatch The request uses the same client token as a previous request but with different parameters. Client tokens should not be reused across non-identical requests. Each unique request must have a distinct client token. 请求使用了与之前请求相同的客户端令牌,但参数不同。请勿在参数不同的请求中重复使用同一令牌,每个独立请求必须使用唯一的令牌。
400 Missing.AccountId x-acs-account-id is mandatory in request header for this action. 请求头中缺少必填参数x-acs-account-id。
400 Missing.CallerUid x-acs-caller-uid is mandatory in request header for this action. 请求头中缺少必填参数x-acs-caller-uid。
400 Missing.PrincipalId x-acs-sts-token-principal-id is mandatory in request header in STS assumeRole scenario for this action. STS角色扮演场景下,请求头中缺少必填参数x-acs-sts-token-principal-id。
400 InvalidParam.ClientToken The specified client token is not valid. 该幂等参数有误,请检查。
429 QuotaExceeded The number of MCP server created by the user has reached the upper limit. 用户创建的MCP服务器数量已达到上限。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情