添加链接
link之家
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
相关文章推荐
追风的鼠标  ·  【转】在'git ...·  2 月前    · 
聪明的小狗  ·  ruby - RUBY_LIBRARY ...·  1 年前    · 
淡定的匕首  ·  Android -- ...·  1 年前    · 
豪气的电脑桌  ·  [WPF] ...·  1 年前    · 

首次创建 NAT 网关时,系统会自动创建一个名称为 AliyunServiceRoleForNatgw 的服务关联角色,并且为该角色添加名称为 AliyunServiceRolePolicyForNatgw 的权限策略,授予 NAT 网关拥有访问其他云资源的权限。更多信息,请参见 服务关联角色

增强型公网 NAT 网关创建后,系统会在 VPC 的路由表中自动添加一条目标网段为 0.0.0.0/0,下一跳为 NAT 网关的路由条目,用于将流量路由到 NAT 网关。

CreateNatGateway 接口属于异步接口,即系统会先返回一个 NAT 网关(公网 NAT 网关或 VPC NAT 网关)实例 ID,但该 NAT 网关实例并未创建完成,系统后台的创建任务仍在进行。您可以调用 DescribeNatGateways 查询 NAT 网关的状态。

当 NAT 网关处于 Creating 状态时,表示 NAT 网关正在创建中,在该状态下,您只能执行查询操作,不能执行其他操作。

当 NAT 网关处于 Available 状态时,表示 NAT 网关创建完成。

NAT 网关创建一般需要 1~3 分钟,请您耐心等待。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的 Action 元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用 全部资源 表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 访问级别 资源类型 条件关键字 关联操作
vpc:CreateNatGateway Write
  • NatGateway
    acs:vpc:{#regionId}:{#accountId}:natgateway/*

请求参数

名称 类型 必填 描述 示例值
RegionId string

NAT 网关所在的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
VpcId string

需要创建 NAT 网关的 VPC 的 ID。

vpc-bp1di7uewzmtvfuq8****
Name string

NAT 网关的名称。

名称长度为 2~128 个字符,以大小写字母或中文开头,可包含数字、下划线(_)和短划线(-)。

如果没有指定该参数,系统会为 NAT 网关创建默认的名称。

fortest
Description string

NAT 网关的描述。

描述可以为空;或填写 2~256 个字符,不能以 http:// https:// 开头。

testnat
ClientToken string

客户端 Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一。

若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
5A2CFF0E-5718-45B5-9D4D-70B3FF3898
Spec string

包年包月公网 NAT 网关已停止新购,该参数不再使用。

无效参数
InstanceChargeType string

NAT 网关的付费模式,取值:

PostPaid (默认值):按量付费。

更多信息,请参见 公网 NAT 网关计费 VPC NAT 网关计费

PostPaid
PricingCycle string

包年包月公网 NAT 网关已停止新购,该参数不再使用。

无效参数
Duration string

包年包月公网 NAT 网关已停止新购,该参数不再使用。

无效参数
AutoPay boolean

包年包月公网 NAT 网关已停止新购,该参数不再使用。

无效参数
VSwitchId string

NAT 网关所属的交换机的 ID。

创建 NAT 网关时,您必须指定 NAT 网关所属的交换机,系统会为 NAT 网关分配一个交换机内的空闲私网 IP 地址。

如果您要在存量交换机中创建 NAT 网关,请确保交换机所属的可用区支持创建 NAT 网关,且交换机有可用的 IP。

如果您还未创建交换机,请先在支持创建 NAT 网关的可用区创建交换机,然后再指定 NAT 网关所属的交换机。

您可以通过 ListEnhanhcedNatGatewayAvailableZones 接口查询 NAT 网关的资源可用区,通过 DescribeVSwitches 接口查询交换机中的可用 IP 数。
vsw-bp1e3se98n9fq8hle****
NatType string

NAT 网关的类型,取值: Enhanced ,增强型 NAT 网关。

Enhanced
InternetChargeType string

NAT 网关的计费类型,取值: PayByLcu ,表示按使用量计费。

PayByLcu
NetworkType string

创建的 NAT 网关类型,取值:

internet :公网 NAT 网关。

intranet :VPC NAT 网关。

internet
SecurityProtectionEnabled deprecated boolean

是否开启防火墙功能,取值:

  • false (默认值):不开启。
    注意 该参数已弃用。
  • false
    IcmpReplyEnabled boolean

    是否开启 ICMP 代回。取值:

  • true (默认值):开启。
  • false :不开启。
  • true
    EipBindMode string

    NAT 网关的 EIP 绑定模式,取值:

  • MULTI_BINDED (默认值):多 EIP 网卡可见模式。
  • NAT :EIP 普通模式,兼容 IPv4 网关。 NAT 网关的 EIP 绑定模式为 EIP 普通模式时,EIP 将占用 NAT 网关所在交换机的一个私网 IP,请确保 NAT 网关所在交换机内私网 IP 地址充足,如果 NAT 网关所在的交换机没有可用的空闲私网地址时,将无法绑定新的 EIP。NAT 网关的 EIP 绑定模式为 EIP 普通模式时,NAT 网关支持绑定的 EIP 数量上限为 50 个。
  • MULTI_BINDED
    Tag object []

    标签列表。

    Key string

    标签键。API 调用时使用 Tag.N.Key 的形式,N 的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

    TestKey
    Value string

    标签值。API 调用时使用 Tag.N.Value 的形式,N 的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持 128 个字符,不能以 aliyun 或 acs:开头,不能包含 http://或 https://。

    TestValue

    返回参数

    名称 类型 描述 示例值
    object

    返回数据结构体。

    NatGatewayId string

    创建的 NAT 网关的实例 ID。

    ngw-112za33e4****
    RequestId string

    请求 ID。

    2315DEB7-5E92-423A-91F7-4C1EC9AD97C3
    ForwardTableIds array

    DNAT 列表。

    string

    DNAT 列表。

    ftb-11tc6xgmv****
    SnatTableIds array

    SNAT 列表。

    string

    SNAT 列表。

    stb-SnatTableIds****
    FullNatTableIds array

    FULLNAT 列表。

    string

    FULLNAT 列表。

    fulltb-gw88z7hhlv43rmb26****

    示例

    正常返回示例

    JSON 格式

    {
      "NatGatewayId": "ngw-112za33e4****",
      "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3",
      "ForwardTableIds": {
        "ForwardTableId": [
          "ftb-11tc6xgmv****"
      "SnatTableIds": {
        "SnatTableId": [
          "stb-SnatTableIds****"
      "FullNatTableIds": {
        "FullNatTableId": [
          "fulltb-gw88z7hhlv43rmb26****"
    }

    错误码

    HTTP status code 错误码 错误信息 描述
    400 Forbidden.NatPayBySpec Pay-by-specification NAT is no longer supported. Newly purchased pay-as-you-go NAT gateways only support the pay-by-CU metering method. 按规格计费的NAT网关已经不再进行售卖,请选择按CU使用量计费的NAT网关
    400 UnsupportedFeature.PrivateLink The feature of %s is not supported. -
    400 DependencyViolation.FullNatEntry The specified resource of %s depends on %s, so the operation cannot be completed. -
    400 UnsupportedFeature.InternetChargeType The feature of InternetChargeType is not supported. -
    400 InvalidVPCStatus vpc incorrect status. 该 VPC 状态非法,请您检查 VPC 状态是否输入正确。
    400 InvalidNatGatewayName.MalFormed NatGateway name is not valid. 网关名称不合法。
    400 InvalidNatGatewayDescription.MalFormed NatGateway description is not valid. 网关描述不合法。
    400 MissingParameter.BandwidthPackage only support one BandwidthPackage be created with NatGateway. 必须指定一个共享带宽包。
    400 OperationDenied The user cannot allow to create natgw, please call PD to authorize -
    400 RouterEntryConflict.Duplicated A route entry already exists, which CIDR is '0.0.0.0/0' -
    400 MissingParameter Miss mandatory parameter. 缺少必要参数,请您检查必填参数是否都已填后再进行操作。
    400 QuotaExceeded.BandwidthPackageIps The specified ipCount exceeded quota. IP数量超过上限,可以在配额管理页面申请增加配额。
    400 AllocateIpFailed Alloc bandwidthPackage ips failed, maybe no available ip. -
    400 InvalidParameter.Name.Malformed The specified Name is not valid. 该名称不合法,请您按照正确的格式书写名称。
    400 InvalidParameter.Description.Malformed The specified Description is not valid. 该描述不合法。
    400 ZONE_NO_AVAILABLE_IP The Zone have no available ip. 该可用区没有可用IP。
    400 ParameterIllegal ipCount,bandwidth parameter invalid -
    400 InvalidParameter.BandwidthPackage.n.ISP.ValueNotSupport The specified ISP of BandwidthPackage is not valid. 该共享带宽包的ISP不合法。
    400 InvalidNatGatewayId.NotFound The NatGatewayId not exist. 指定的 NatGatewayId 不存在,请您检查填写的 NatGatewayId 是否正确。
    400 VswitchStatusError The VSwitch is creating . 交换机正在创建中。
    400 VpcStatusError The Vpc is creating . 正在创建VPC。
    400 InvalidParameter.Spec.ValueNotSupported The specified Spec is not valid. 该规格不合法。
    400 TaskConflict The operation is too frequent, TaskConflict. 操作太频繁,请稍后重试
    400 COMMODITY.INVALID_COMPONENT The instance component is invalid. -
    400 CreateNatGateway.RouteConflict.DynamicRoute Route conflict exists in routing table. -
    400 OperationUnsupported.MultiNatGateway More than one natGateway per vpc is unsupported. -
    400 Forbidden.CheckEntryRuleQuota Route entry quota rule check error. 检查路由条目配额时发生了错误。
    400 OperationFailed.UnpaidBillsExist The account has unpaid bills. Please pay your overdue bill first. 此账户有未支付的订单。
    400 IncorrectStatus.RouteEntry Specified routeEntry status error. -
    400 OperationFailed.RiskControl Risk control check failed. 我们检测到您的付款方式存在安全风险。请通过电子邮件或控制台消息中的链接继续验证,并在验证后重新提交订单。
    400 IncorrectStatus.RouteTableStatus %s -
    400 OperationFailed.TokenVerfiy Token verify failed. -
    400 %s %s -
    400 IllegalParam.Name The specified Name is invalid, shorter than 2 characters. -
    400 OperationFailed.EnhancedQuotaExceed Enhanced nat gateway per vpc quota is exceeded 当前vpc下创建增强型nat网关配额超限
    400 OrderError.NoAvailablePaymentMethod %s -
    400 OrderError.BasicInfoUncompleted %s -
    400 OperationUnsupported.EnhancedCURegion %s -
    400 NoPermission.CreateServiceLinkedRole You are not authorized to create service linked role -
    400 OperationUnsupported.EnhancedRegion %s -
    400 OperationFailed.EnhancedInventoryNotEnough Operation failed because inventory is not enough. -
    400 OperationFailed.VswNotBelongToVpc Operation failed because the specified VSwitch is not bound to the same VPC with NAT gateway. 操作失败,因为交换机和NAT网关不属于同一个VPC。
    400 OperationFailed.EnhancedUserIsUnAuthorized Operation failed because the user is not authorized to create an enhanced NAT gateway. 操作失败因为用户未授权创建增强型NAT网关。
    400 OperationUnsupported.PrePaidPyByLcu The operation failed because the subscription NAT gateway does not support the pay-by-LCU billing method. 预付费的NAT网关实例不支持PayByLcu的计费方式。
    400 OperationFailed.NormalInventoryNotEnough Standard NAT gateways are no longer offered. You can create enhanced NAT gateways and set the correct natType. 普通型NAT网关已不支持创建,请创建增强型NAT网关并确保正确配置NatType参数。
    400 OperationFailed.VSwitchNoAvailableIp Operation failed because the specified vswitch does not have availabe ip. -
    400 OperationFailed.EnhancedCheckInventory Operation failed because check inventory result is unexpected. -
    400 UnsupportedFeature.IcmpReplyEnabled The feature of IcmpReplyEnabled is not supported. Icmp 代答使能功能修改不支持。
    400 UnsupportedFeature.SecurityProtectionEnabled The feature of SecurityProtectionEnabled is not supported. -
    400 OperationFailed.RegionConvert Operation failed because do not find region info. -
    400 OperationFailed.EnhancedUserIsUnAuthorized Operation failed because user is unauthorized service account. -
    400 UnsupportedFeature.VpcNat The feature of VpcNat is not supported. -
    400 InvalidVSWITCHID.NotFound The specified resource of %s is not found. -
    400 Forbidden.OperateShareResource Operate share resource is forbidden. -
    400 IncorrectStatus.VSWITCH The status of VSWITCH is incorrect. -
    400 OperationFailed.VpcNatGatewayInventoryNotEnough The operation is failed because of inventory is not enough. -
    400 OperationFailed.VpcNatGatewayCheckInventory The operation is failed because of check inventory result is unexpected -
    400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive. 参数 %s 和 %s 相互排斥。
    400 SecurityGroupType.NotSupported The specified security group type is not supported. 安全组已经被托管,不能使用
    400 SecurityGroup.NotExist The specified security group is not exist. 安全组不存在于此VPC。
    400 OperationFailed.ContainForbiddenLabel There is a label that prohibits ordering, please contact your distributor for processing. 存在禁止下单的标签,请联系您的分销商处理。
    400 OperationDenied.PrePaidInstance The operation is not allowed because prepaid instance is no longer supported. 预付费实例不再支持购买。
    400 UnsupportedFeature.Geneve The feature of Geneve is not supported. 当前不支持创建Geneve模式的NAT网关。
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的RegionId不存在。
    404 InvalidVpcId.NotFound Specified value of VpcId is not found in our record. 该VPC不存在,请您检查输入的VPC是否正确。
    404 InvalidZoneId.NotFound Specified value of ZoneId is not exists. 该可用区不存在。
    404 InvalidZoneId.NotFound Can not find ZoneId for allocated ip. 该IP的可用区不正确。
    404 VPC_ONLY_CAN_CREATE_ONE_NAT_GATEWAY NatGateway in one vpc support only one. -
    404 OperationFailed.CrateEntryTimeOut Operation failed because create custom routeEntry timeout. -
    404 Forbidden.CreateSpecialSpecNatGateway You are not authorized to create special spec nat gateway. -
    404 UnsupportedZoneForFwNat The zone is unsupported for FW NAT. 该可用区不支持防护型NAT网关。
    500 OrderError.NatGateway The Account failed to create order. -
    500 OperationFailed.NoAvailableResource The Zone have no available resource. 区域没有可用资源。

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

    变更历史

    变更时间 变更内容概要 操作
    2024-05-06 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      错误码 400 变更
      删除错误码:404
      删除错误码:500
    2024-01-18 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      错误码 400 变更
      删除错误码:404
      删除错误码:500
    2023-12-14 OpenAPI 描述信息更新、OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    API 描述 OpenAPI 描述信息更新
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      删除错误码:500
    2023-06-30 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      删除错误码:500
    2023-03-01 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      删除错误码:500
    2023-01-10 OpenAPI 错误码发生变更、OpenAPI 入参发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      删除错误码:500
    入参 OpenAPI 入参发生变更
      新增入参:Tag
    2022-08-12 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      删除错误码:500
    2022-08-03 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      错误码 404 变更
      删除错误码:400
      删除错误码:500
    2022-07-22 OpenAPI 错误码发生变更 看变更集
    变更项 变更内容
    错误码 OpenAPI 错误码发生变更
      错误码 404 变更
      错误码 500 变更
      删除错误码:400
    • 本页导读 (1)