CreateVpcEndpoint
创建终端节点
服务地址:
华东1(杭州)
输入参数
只看必填
RegionId终端节点所在的地域ID
DryRun是否只预检此次请求
请选择布尔值
EndpointName终端节点名称
EndpointType终端节点类型
ZonePrivateIpAddressCount每个可用区ENI的私网IP的数量
EndpointDescription终端节点描述
VpcId终端节点所属的专有网络
ServiceId终端节点关联的终端节点服务
ServiceName终端节点关联的终端节点服务的名称
Zone终端节点可用区列表
0当前地域下的可用区ID
VSwitchId在可用区内要创建终端节点网卡的交换机
ZoneId终端节点服务对应的可用区
ip指定终端节点可用区的IP
Ipv6Address指定终端节点可用区的IPv6地址
SecurityGroupId终端节点网卡关联的安全组列表
0终端节点网卡关联的安全组
ProtectedEnabled是否开启托管保护
请选择布尔值
Tag标签列表
0标签列表
Key标签键
Value标签值
ResourceGroupId资源组ID
PolicyDocumentRAM权限策略
AddressIpVersion协议版本
幂等性参数
ClientToken客户端Token
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

CreateVpcEndpoint 接口属于异步接口,即系统会返回一个实例 ID,但该终端节点尚未创建完成,系统后台任务仍在进行中。您可以调用 GetVpcEndpointAttribute 查询终端节点的创建状态:

  • 当终端节点处于 Creating 状态时,表示终端节点正在创建中。
  • 当终端节点处于 Active 状态时,表示终端节点创建完成。

请求参数

字段名称字段详情
RegionIdstring

终端节点所在的地域 ID。展开详情

示例值:cn-huhehaote参考取值来源:
    DescribeRegions
ClientTokenstring

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

示例值:0c593ea1-3bea-11e9-b96b-88e9fe637760
DryRunboolean

是否只预检此次请求。取值:展开详情

示例值:false
EndpointNamestring

终端节点名称。展开详情

示例值:test参考取值来源:
    ListVpcEndpoints
    GetVpcEndpointAttribute
EndpointTypestring

终端节点类型。取值:展开详情

示例值:Interface参考取值来源:
    ListVpcEndpoints
    GetVpcEndpointAttribute
ZonePrivateIpAddressCountinteger<int64>

每个可用区 ENI 的私网 IP 的数量。仅取值:1

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1
EndpointDescriptionstring

终端节点描述。展开详情

示例值:This is my Endpoint.
VpcIdstring

终端节点所属的专有网络。

示例值:vpc-hp356stwkxg3fn2xe****
ServiceIdstring

终端节点关联的终端节点服务。

示例值:epsrv-hp3xdsq46ael67lo****参考取值来源:
    ListVpcEndpointServices
    CreateVpcEndpointService
    AddUserToVpcEndpointService
ServiceNamestring

终端节点关联的终端节点服务的名称。

示例值:com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****参考取值来源:
    CreateVpcEndpointService
    ListVpcEndpointServices
Zonearray<object>

终端节点可用区列表。

子级条数 <= 10
SecurityGroupIdarray<string>

终端节点网卡关联的安全组列表。

示例值:sg-hp33bw6ynvm2yb0e****子级条数 <= 10
ProtectedEnabledboolean

是否开启托管保护,STS 调用方式下生效。取值:展开详情

示例值:false
Tagarray<object>

标签列表。

子级条数 <= 21
ResourceGroupIdstring

资源组 ID。

示例值:rg-acfmy*****
PolicyDocumentstring

RAM 权限策略。关于策略定义的更多信息,请参见权限策略基本元素

示例值:{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "oss:List*", "oss:PutObject", "oss:GetObject" ], "Resource": [ "acs:oss:oss-*:*:pvl-policy-test/policy-test.txt" ], "Principal": { "RAM": [ "acs:ram::14199xxxxxx:*" ] } } ] }
AddressIpVersionstring

协议版本。取值:展开详情

示例值:IPv4枚举值:IPv4DualStack

返回参数

字段名称字段详情
EndpointDomainstring

终端节点域名。

示例值:ep-hp33b2e43fays7s8****.epsrv-hp3xdsq46ael67lo****.cn-huhehaote.privatelink.aliyuncs.com
RequestIdstring

请求 ID。

示例值:0ED8D006-F706-4D23-88ED-E11ED28DCAC0
CreateTimestring

终端节点的创建时间。

示例值:2022-01-02T19:11:12Z
EndpointBusinessStatusstring

终端节点的业务状态。取值:展开详情

示例值:Normal
EndpointDescriptionstring

终端节点描述。

示例值:This is my Endpoint.
ServiceIdstring

终端节点关联的终端节点服务的 ID。

示例值:epsrv-hp3vpx8yqxblby3i****
EndpointStatusstring

终端节点状态。取值:展开详情

示例值:Active
VpcIdstring

终端节点所属的专有网络。

示例值:vpc-hp356stwkxg3fn2xe****
EndpointNamestring

终端节点名称。

示例值:test
ServiceNamestring

终端节点关联的终端节点服务的名称。

示例值:com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****
Bandwidthinteger<int64>

终端节点的连接带宽,单位:Mbps。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:200
EndpointIdstring

终端节点 ID。

示例值:ep-hp33b2e43fays7s8****
ConnectionStatusstring

终端节点连接状态。取值:展开详情

示例值:Disconnected
AddressIpVersionstring

协议版本。取值:展开详情

示例值:IPv4
变更历史
变更时间变更内容概要操作
2024-09-18
变更错误码400
2024-09-12
变更请求参数Zone
新增请求参数AddressIpVersion
变更返回参数
2024-05-10
新增请求参数PolicyDocument
2024-04-08
变更错误码400
2023-09-26
删除请求参数PolicyDocument
2023-09-19
变更错误码400
2023-09-05
变更错误码400
新增请求参数PolicyDocument
  • 1
  • 2
  • 10 条/页