Creates an ApiMcpServerCore resource.
Operation description
This public API operation queries only public information and does not require authorization.
Try it now
Test
RAM authorization
Request syntax
POST /apimcpservercore HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| clientToken |
string |
No |
A client-generated token that ensures the request is idempotent. This token must be unique across all requests. |
123e4567-e89b-12d3-a456-426655440000 |
| oauthClientId |
string |
No |
The custom OAuth client ID. This parameter is used when you select a custom OAuth configuration. Note: Only web and native applications are supported. The OAuth scope must include |
403*************370 |
| vpcWhitelists |
array |
No |
The VPC whitelist. Each value is the ID of a source VPC. |
|
|
string |
No |
Specifies the allowed source VPCs when public access is disabled. If this parameter is omitted or left empty, all sources are allowed. |
vpc-j6cgd2if5lg**0xs6m5se |
|
| enableAssumeRole |
boolean |
No |
Specifies whether to enable multi-account access. |
true |
| assumeRoleOverridePolicy |
string |
No |
An additional policy applied when you assume a role for multi-account access. If specified, this policy overrides the permissions of the assumed role. |
{"Version":"1","Statement":[{"Effect":"Allow","Action":["ecs:Describe*"],"Resource":"*"}]} |
| assumeRoleName |
string |
No |
The name of the RAM role to assume in the target account for cross-account operations. This parameter is required only if multi-account access is enabled. |
test |
| publicAccessType |
string |
No |
The type of public access. Valid values: Valid values:
|
public |
| enableCustomVpcWhitelist |
boolean |
No |
Specifies whether to enable a custom VPC whitelist. If this parameter is set to false, the account-level configuration is used. |
true |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response object. |
||
| requestId |
string |
The request ID. |
A707AFA8-1A4C-5B2A-A165-8436C1EA38DB |
| id |
string |
The ID of the created ApiMcpServerCore resource. |
v6ZZ7ftCzEILW*** |
Examples
Success response
JSON format
{
"requestId": "A707AFA8-1A4C-5B2A-A165-8436C1EA38DB",
"id": "v6ZZ7ftCzEILW***"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 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. | The request used the same client token as the previous request, but with different parameters. Do not reuse the same token in requests with different parameters. Each request must use a unique token. |
| 400 | Missing.AccountId | x-acs-account-id is mandatory in request header for this action. | The required parameter x-acs-account-id is missing in the request header. |
| 400 | Missing.CallerUid | x-acs-caller-uid is mandatory in request header for this action. | The required parameter x-acs-caller-uid is missing in the request header. |
| 400 | Missing.PrincipalId | x-acs-sts-token-principal-id is mandatory in request header in STS assumeRole scenario for this action. | In the STS role-playing scenario, the required parameter x-acs-sts-token-principal-id is missing in the request header. |
| 400 | InvalidParam.ClientToken | The specified client token is not valid. | The idempotent parameter is incorrect, please check. |
| 429 | QuotaExceeded | The number of MCP server created by the user has reached the upper limit. | The number of MCP server created by the user has reached the upper limit. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.