调用CreateSnatEntry接口在SNAT列表中添加SNAT条目。
API描述
调用本接口添加SNAT条目时,请注意:
- CreateSnatEntry接口属于异步接口,即系统会先返回一个SNAT条目ID,但该SNAT条目并未添加完成,系统后台的添加任务仍在进行。您可以调用DescribeNatGateways查询SNAT条目的状态:
- 当SNAT条目处于Pending状态时,表示SNAT条目正在添加中,在该状态下,您只能执行查询操作,不能执行其他操作。
- 当SNAT条目处于Available状态时,表示SNAT条目添加完成。
- SNAT条目中指定的交换机和ECS实例必须在NAT网关所属的VPC内。
- 每个交换机和ECS实例只能属于一个SNAT条目。
- 如果交换机中存在HAVIP实例,则无法添加SNAT条目。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateSnatEntry |
要执行的操作,取值:CreateSnatEntry。 |
RegionId | String | 是 | cn-hangzhou |
NAT网关所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
SnatIp | String | 是 | 47.xx.xx.98 |
公网IP地址,多个IP之间用逗号隔开。 说明 指定多个公网IP配置SNAT IP地址池时,需确保每个公网IP都加入到同一个共享带宽中。
|
SnatTableId | String | 是 | stb-bp190wu8io1vgev**** |
SNAT表ID。 |
SourceVSwitchId | String | 否 | vsw-bp1nhx2s9ui5o**** |
需要公网访问的交换机的ID。 |
SourceCIDR | String | 否 | 10.1.1.0/24 |
交换机或ECS实例的网段。
此参数和SourceVSwtichId参数互斥,不能同时出现。如果指定了SourceVSwitchId,则不能指定SourceCIDR参数。如果指定了SourceCIDR参数,则不能指定SourceVSwitchId参数。 |
SnatEntryName | String | 否 | SnatEntry-1 |
SNAT条目的名称。 长度为2~128个字符,必须以字母或中文开头,但不能以 |
ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-001sdfg |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
SnatEntryId | String | snat-kmd6nv8fy**** |
SNAT条目ID。 |
RequestId | String | 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
请求ID。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=CreateSnatEntry
&RegionId=cn-hangzhou
&SnatIp=47.xx.xx.98
&SnatTableId=stb-bp190wu8io1vgevx****
&<公共请求参数>
正常返回示例
XML
格式
<CreateSnatEntryResponse>
<RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
<SnatEntryId>snat-119smw5tkx****</SnatEntryId>
</CreateSnatEntryResponse>
JSON
格式
{
"SnatEntryId": "snat-kmd6nv8fyx****",
"RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交