金山云-文档中心-创建虚拟交换机

接口描述

您可以通过该接口创建虚拟交换机。

请求头

参数名称	类型	是否必须	描述
X-Version	String	是	版本号，取值：2020-08-01
X-Action	String	是	操作接口名，取值：CreateVSwitch

请求参数

参数名称	类型	是否必须	示例值	描述
NamespaceId	String	是	default-UID	命名空间ID
VpcId	String	是	458f4e89-6be0-4303-a31c-280895c07658	VPCID
VSwitchName	String	否	kenc_vswitch	vswitch名称，命名规则为：长度为2~128个英文或中文字符；必须以大小写字母或中文开头；可以包含数字、下划线（_）、英文句号（.）或者连字符（-）。如果没有指定该参数，默认值为kenc_vswitch
CidrBlock	String	是	172.16.0.0/12	交换机的网段。交换机网段要求如下： · 交换机的网段的掩码长度范围为16~28位。 · 交换机的网段必须从属于所在VPC的网段。
Description	String	否	-	交换机描述，内容限制为长度不大于128个英文或中文字符；如果没有指定该参数，默认值为空

返回参数

参数名称	类型	示例值	描述
RequestID	String	3a87cc31-efe6-487c-b28b-11bec3571e7d	请求ID
Code	String	Success	状态码,有InvalidParameter,Forbidden InternalError,Success四种状态
VSwitchId	String	458f4e89-6be0-4303-a31c-280895c07658	VSwitchId

请求示例

入参示例

curl --location --request GET 'kenc.api.ksyun.com?CidrBlock=172.16.0.0%2F28&NamespaceId=demo&VpcId=4a70ee3b-9a6e-4ae9-a982-1134d6ec1614' \
--header 'X-Action: CreateVSwitch' \
--header 'X-Version: 2020-08-01' \
--header 'X-Amz-Date: 20210517T025443Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTTCrDNnS2S2iHLvz_zawSMg/20210517/beijing-6/kenc/aws4_request, SignedHeaders=host;x-amz-date, Signature=xxxxxxxxxx'

成功示例

{
"Code": "Success",
"RequestId": "1d496782-d4b8-4f7b-8e7b-50e9c0fee3d5",
"VSwitchId":"823933cb-daa1-46a6-b458-f224921e5fc9"
}

失败示例

{  
    "RequestId": "22a9015d-fd66-45a7-b82e-8e01d39ad94e",
    "Code": "InvalidParameter",
    "Message": "Invalid param NamespaceId."
}

创建交换机

接口描述

请求头

请求参数

返回参数

请求示例

入参示例

成功示例

失败示例