published on Thursday, Apr 23, 2026 by Volcengine
published on Thursday, Apr 23, 2026 by Volcengine
The endpoint node is a private network service access point deployed by the service user in their own VPC, used to access the service provider’s services via the private network.
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
privateLinkVpcEndpointDemo:
type: volcenginecc:privatelink:VpcEndpoint
name: PrivateLinkVpcEndpointDemo
properties:
description: this is a test
endpointName: ccapi-test-1001
ipAddressVersions:
- ipv4
- ipv6
privateDnsEnabled: true
projectName: default
securityGroupIds:
- sg-btg9xxxxxc5h0b2u913txw
serviceId: epsvc-13fpxxxxx03n6nu5omuqde
serviceName: com.volces.xxxx.cn-beijing.api-ipv6.ticket
tags:
- key: env
value: test
vpcId: vpc-btg9hmxxxxx5h0b2tnp1on8
zones:
- private_ip_address: 192.168.xxx.xx
private_ipv_6_address: 2406:d440:103:xxxxx:xxxxx:7eef:35c4:8d79
subnet_id: subnet-ijif1pxxxxx4o8culvzg85
zone_id: cn-beijing-a
Create VpcEndpoint Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new VpcEndpoint(name: string, args?: VpcEndpointArgs, opts?: CustomResourceOptions);@overload
def VpcEndpoint(resource_name: str,
args: Optional[VpcEndpointArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def VpcEndpoint(resource_name: str,
opts: Optional[ResourceOptions] = None,
description: Optional[str] = None,
endpoint_name: Optional[str] = None,
ip_address_versions: Optional[Sequence[str]] = None,
private_dns_enabled: Optional[bool] = None,
project_name: Optional[str] = None,
security_group_ids: Optional[Sequence[str]] = None,
service_id: Optional[str] = None,
service_managed: Optional[bool] = None,
service_name: Optional[str] = None,
tags: Optional[Sequence[VpcEndpointTagArgs]] = None,
vpc_id: Optional[str] = None,
zones: Optional[Sequence[VpcEndpointZoneArgs]] = None)func NewVpcEndpoint(ctx *Context, name string, args *VpcEndpointArgs, opts ...ResourceOption) (*VpcEndpoint, error)public VpcEndpoint(string name, VpcEndpointArgs? args = null, CustomResourceOptions? opts = null)
public VpcEndpoint(String name, VpcEndpointArgs args)
public VpcEndpoint(String name, VpcEndpointArgs args, CustomResourceOptions options)
type: volcenginecc:privatelink:VpcEndpoint
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args VpcEndpointArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args VpcEndpointArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args VpcEndpointArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args VpcEndpointArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args VpcEndpointArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var vpcEndpointResource = new Volcenginecc.Privatelink.VpcEndpoint("vpcEndpointResource", new()
{
Description = "string",
EndpointName = "string",
IpAddressVersions = new[]
{
"string",
},
PrivateDnsEnabled = false,
ProjectName = "string",
SecurityGroupIds = new[]
{
"string",
},
ServiceId = "string",
ServiceManaged = false,
ServiceName = "string",
Tags = new[]
{
new Volcenginecc.Privatelink.Inputs.VpcEndpointTagArgs
{
Key = "string",
Value = "string",
},
},
VpcId = "string",
Zones = new[]
{
new Volcenginecc.Privatelink.Inputs.VpcEndpointZoneArgs
{
PrivateIpAddress = "string",
PrivateIpv6Address = "string",
SubnetId = "string",
ZoneId = "string",
},
},
});
example, err := privatelink.NewVpcEndpoint(ctx, "vpcEndpointResource", &privatelink.VpcEndpointArgs{
Description: pulumi.String("string"),
EndpointName: pulumi.String("string"),
IpAddressVersions: pulumi.StringArray{
pulumi.String("string"),
},
PrivateDnsEnabled: pulumi.Bool(false),
ProjectName: pulumi.String("string"),
SecurityGroupIds: pulumi.StringArray{
pulumi.String("string"),
},
ServiceId: pulumi.String("string"),
ServiceManaged: pulumi.Bool(false),
ServiceName: pulumi.String("string"),
Tags: privatelink.VpcEndpointTagArray{
&privatelink.VpcEndpointTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
VpcId: pulumi.String("string"),
Zones: privatelink.VpcEndpointZoneArray{
&privatelink.VpcEndpointZoneArgs{
PrivateIpAddress: pulumi.String("string"),
PrivateIpv6Address: pulumi.String("string"),
SubnetId: pulumi.String("string"),
ZoneId: pulumi.String("string"),
},
},
})
var vpcEndpointResource = new VpcEndpoint("vpcEndpointResource", VpcEndpointArgs.builder()
.description("string")
.endpointName("string")
.ipAddressVersions("string")
.privateDnsEnabled(false)
.projectName("string")
.securityGroupIds("string")
.serviceId("string")
.serviceManaged(false)
.serviceName("string")
.tags(VpcEndpointTagArgs.builder()
.key("string")
.value("string")
.build())
.vpcId("string")
.zones(VpcEndpointZoneArgs.builder()
.privateIpAddress("string")
.privateIpv6Address("string")
.subnetId("string")
.zoneId("string")
.build())
.build());
vpc_endpoint_resource = volcenginecc.privatelink.VpcEndpoint("vpcEndpointResource",
description="string",
endpoint_name="string",
ip_address_versions=["string"],
private_dns_enabled=False,
project_name="string",
security_group_ids=["string"],
service_id="string",
service_managed=False,
service_name="string",
tags=[{
"key": "string",
"value": "string",
}],
vpc_id="string",
zones=[{
"private_ip_address": "string",
"private_ipv6_address": "string",
"subnet_id": "string",
"zone_id": "string",
}])
const vpcEndpointResource = new volcenginecc.privatelink.VpcEndpoint("vpcEndpointResource", {
description: "string",
endpointName: "string",
ipAddressVersions: ["string"],
privateDnsEnabled: false,
projectName: "string",
securityGroupIds: ["string"],
serviceId: "string",
serviceManaged: false,
serviceName: "string",
tags: [{
key: "string",
value: "string",
}],
vpcId: "string",
zones: [{
privateIpAddress: "string",
privateIpv6Address: "string",
subnetId: "string",
zoneId: "string",
}],
});
type: volcenginecc:privatelink:VpcEndpoint
properties:
description: string
endpointName: string
ipAddressVersions:
- string
privateDnsEnabled: false
projectName: string
securityGroupIds:
- string
serviceId: string
serviceManaged: false
serviceName: string
tags:
- key: string
value: string
vpcId: string
zones:
- privateIpAddress: string
privateIpv6Address: string
subnetId: string
zoneId: string
VpcEndpoint Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The VpcEndpoint resource accepts the following input properties:
- Description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- Endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- Ip
Address List<string>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- Private
Dns boolEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- Project
Name string - Name of the project to which the endpoint node belongs.
- Security
Group List<string>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- Service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- Service
Managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- Service
Name string - Name of the endpoint service to be associated.
-
List<Volcengine.
Vpc Endpoint Tag> - Vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- Zones
List<Volcengine.
Vpc Endpoint Zone>
- Description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- Endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- Ip
Address []stringVersions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- Private
Dns boolEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- Project
Name string - Name of the project to which the endpoint node belongs.
- Security
Group []stringIds - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- Service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- Service
Managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- Service
Name string - Name of the endpoint service to be associated.
-
[]Vpc
Endpoint Tag Args - Vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- Zones
[]Vpc
Endpoint Zone Args
- description String
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Name String - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- ip
Address List<String>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- private
Dns BooleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- project
Name String - Name of the project to which the endpoint node belongs.
- security
Group List<String>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id String - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed Boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name String - Name of the endpoint service to be associated.
-
List<Vpc
Endpoint Tag> - vpc
Id String - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
List<Vpc
Endpoint Zone>
- description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- ip
Address string[]Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- private
Dns booleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- project
Name string - Name of the project to which the endpoint node belongs.
- security
Group string[]Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name string - Name of the endpoint service to be associated.
-
Vpc
Endpoint Tag[] - vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
Vpc
Endpoint Zone[]
- description str
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint_
name str - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- ip_
address_ Sequence[str]versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- private_
dns_ boolenabled - Enable private DNS name. false (default): disabled. true: enabled.
- project_
name str - Name of the project to which the endpoint node belongs.
- security_
group_ Sequence[str]ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service_
id str - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service_
managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service_
name str - Name of the endpoint service to be associated.
-
Sequence[Vpc
Endpoint Tag Args] - vpc_
id str - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
Sequence[Vpc
Endpoint Zone Args]
- description String
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Name String - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- ip
Address List<String>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- private
Dns BooleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- project
Name String - Name of the project to which the endpoint node belongs.
- security
Group List<String>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id String - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed Boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name String - Name of the endpoint service to be associated.
- List<Property Map>
- vpc
Id String - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones List<Property Map>
Outputs
All input properties are implicitly available as output properties. Additionally, the VpcEndpoint resource produces the following output properties:
- Bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- Business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- Connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- Creation
Time string - Creation time of the endpoint.
- Deleted
Time string - Deletion time of the endpoint.
- Endpoint
Domain string - Domain name of the endpoint.
- Endpoint
Id string - ID of the endpoint node.
- Endpoint
Index int - Endpoint index
- Endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- Id string
- The provider-assigned unique ID for this managed resource.
- Payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- Private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- Status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- Update
Time string - Most recent operation time of the endpoint.
- Bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- Business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- Connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- Creation
Time string - Creation time of the endpoint.
- Deleted
Time string - Deletion time of the endpoint.
- Endpoint
Domain string - Domain name of the endpoint.
- Endpoint
Id string - ID of the endpoint node.
- Endpoint
Index int - Endpoint index
- Endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- Id string
- The provider-assigned unique ID for this managed resource.
- Payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- Private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- Status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- Update
Time string - Most recent operation time of the endpoint.
- bps Integer
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status String - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status String - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time String - Creation time of the endpoint.
- deleted
Time String - Deletion time of the endpoint.
- endpoint
Domain String - Domain name of the endpoint.
- endpoint
Id String - ID of the endpoint node.
- endpoint
Index Integer - Endpoint index
- endpoint
Type String - Type of the endpoint node. Interface: interface endpoint node.
- id String
- The provider-assigned unique ID for this managed resource.
- payer String
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns StringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- status String
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- update
Time String - Most recent operation time of the endpoint.
- bps number
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time string - Creation time of the endpoint.
- deleted
Time string - Deletion time of the endpoint.
- endpoint
Domain string - Domain name of the endpoint.
- endpoint
Id string - ID of the endpoint node.
- endpoint
Index number - Endpoint index
- endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- id string
- The provider-assigned unique ID for this managed resource.
- payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- update
Time string - Most recent operation time of the endpoint.
- bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business_
status str - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection_
status str - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation_
time str - Creation time of the endpoint.
- deleted_
time str - Deletion time of the endpoint.
- endpoint_
domain str - Domain name of the endpoint.
- endpoint_
id str - ID of the endpoint node.
- endpoint_
index int - Endpoint index
- endpoint_
type str - Type of the endpoint node. Interface: interface endpoint node.
- id str
- The provider-assigned unique ID for this managed resource.
- payer str
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private_
dns_ strname - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- status str
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- update_
time str - Most recent operation time of the endpoint.
- bps Number
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status String - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status String - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time String - Creation time of the endpoint.
- deleted
Time String - Deletion time of the endpoint.
- endpoint
Domain String - Domain name of the endpoint.
- endpoint
Id String - ID of the endpoint node.
- endpoint
Index Number - Endpoint index
- endpoint
Type String - Type of the endpoint node. Interface: interface endpoint node.
- id String
- The provider-assigned unique ID for this managed resource.
- payer String
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns StringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- status String
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- update
Time String - Most recent operation time of the endpoint.
Look up Existing VpcEndpoint Resource
Get an existing VpcEndpoint resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: VpcEndpointState, opts?: CustomResourceOptions): VpcEndpoint@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
bps: Optional[int] = None,
business_status: Optional[str] = None,
connection_status: Optional[str] = None,
creation_time: Optional[str] = None,
deleted_time: Optional[str] = None,
description: Optional[str] = None,
endpoint_domain: Optional[str] = None,
endpoint_id: Optional[str] = None,
endpoint_index: Optional[int] = None,
endpoint_name: Optional[str] = None,
endpoint_type: Optional[str] = None,
ip_address_versions: Optional[Sequence[str]] = None,
payer: Optional[str] = None,
private_dns_enabled: Optional[bool] = None,
private_dns_name: Optional[str] = None,
project_name: Optional[str] = None,
security_group_ids: Optional[Sequence[str]] = None,
service_id: Optional[str] = None,
service_managed: Optional[bool] = None,
service_name: Optional[str] = None,
status: Optional[str] = None,
tags: Optional[Sequence[VpcEndpointTagArgs]] = None,
update_time: Optional[str] = None,
vpc_id: Optional[str] = None,
zones: Optional[Sequence[VpcEndpointZoneArgs]] = None) -> VpcEndpointfunc GetVpcEndpoint(ctx *Context, name string, id IDInput, state *VpcEndpointState, opts ...ResourceOption) (*VpcEndpoint, error)public static VpcEndpoint Get(string name, Input<string> id, VpcEndpointState? state, CustomResourceOptions? opts = null)public static VpcEndpoint get(String name, Output<String> id, VpcEndpointState state, CustomResourceOptions options)resources: _: type: volcenginecc:privatelink:VpcEndpoint get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- Business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- Connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- Creation
Time string - Creation time of the endpoint.
- Deleted
Time string - Deletion time of the endpoint.
- Description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- Endpoint
Domain string - Domain name of the endpoint.
- Endpoint
Id string - ID of the endpoint node.
- Endpoint
Index int - Endpoint index
- Endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- Endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- Ip
Address List<string>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- Payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- Private
Dns boolEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- Private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- Project
Name string - Name of the project to which the endpoint node belongs.
- Security
Group List<string>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- Service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- Service
Managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- Service
Name string - Name of the endpoint service to be associated.
- Status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
-
List<Volcengine.
Vpc Endpoint Tag> - Update
Time string - Most recent operation time of the endpoint.
- Vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- Zones
List<Volcengine.
Vpc Endpoint Zone>
- Bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- Business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- Connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- Creation
Time string - Creation time of the endpoint.
- Deleted
Time string - Deletion time of the endpoint.
- Description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- Endpoint
Domain string - Domain name of the endpoint.
- Endpoint
Id string - ID of the endpoint node.
- Endpoint
Index int - Endpoint index
- Endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- Endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- Ip
Address []stringVersions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- Payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- Private
Dns boolEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- Private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- Project
Name string - Name of the project to which the endpoint node belongs.
- Security
Group []stringIds - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- Service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- Service
Managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- Service
Name string - Name of the endpoint service to be associated.
- Status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
-
[]Vpc
Endpoint Tag Args - Update
Time string - Most recent operation time of the endpoint.
- Vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- Zones
[]Vpc
Endpoint Zone Args
- bps Integer
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status String - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status String - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time String - Creation time of the endpoint.
- deleted
Time String - Deletion time of the endpoint.
- description String
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Domain String - Domain name of the endpoint.
- endpoint
Id String - ID of the endpoint node.
- endpoint
Index Integer - Endpoint index
- endpoint
Name String - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- endpoint
Type String - Type of the endpoint node. Interface: interface endpoint node.
- ip
Address List<String>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- payer String
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns BooleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- private
Dns StringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- project
Name String - Name of the project to which the endpoint node belongs.
- security
Group List<String>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id String - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed Boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name String - Name of the endpoint service to be associated.
- status String
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
-
List<Vpc
Endpoint Tag> - update
Time String - Most recent operation time of the endpoint.
- vpc
Id String - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
List<Vpc
Endpoint Zone>
- bps number
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status string - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status string - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time string - Creation time of the endpoint.
- deleted
Time string - Deletion time of the endpoint.
- description string
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Domain string - Domain name of the endpoint.
- endpoint
Id string - ID of the endpoint node.
- endpoint
Index number - Endpoint index
- endpoint
Name string - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- endpoint
Type string - Type of the endpoint node. Interface: interface endpoint node.
- ip
Address string[]Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- payer string
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns booleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- private
Dns stringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- project
Name string - Name of the project to which the endpoint node belongs.
- security
Group string[]Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id string - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name string - Name of the endpoint service to be associated.
- status string
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
-
Vpc
Endpoint Tag[] - update
Time string - Most recent operation time of the endpoint.
- vpc
Id string - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
Vpc
Endpoint Zone[]
- bps int
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business_
status str - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection_
status str - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation_
time str - Creation time of the endpoint.
- deleted_
time str - Deletion time of the endpoint.
- description str
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint_
domain str - Domain name of the endpoint.
- endpoint_
id str - ID of the endpoint node.
- endpoint_
index int - Endpoint index
- endpoint_
name str - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- endpoint_
type str - Type of the endpoint node. Interface: interface endpoint node.
- ip_
address_ Sequence[str]versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- payer str
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private_
dns_ boolenabled - Enable private DNS name. false (default): disabled. true: enabled.
- private_
dns_ strname - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- project_
name str - Name of the project to which the endpoint node belongs.
- security_
group_ Sequence[str]ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service_
id str - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service_
managed bool - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service_
name str - Name of the endpoint service to be associated.
- status str
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
-
Sequence[Vpc
Endpoint Tag Args] - update_
time str - Most recent operation time of the endpoint.
- vpc_
id str - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones
Sequence[Vpc
Endpoint Zone Args]
- bps Number
- Maximum bandwidth limit for the endpoint node connection, in Mbps.
- business
Status String - Whether the endpoint is locked. Normal: Normal. FinancialLocked: Locked. If this parameter is empty, the endpoint is not locked.
- connection
Status String - Status of the endpoint node connection. PendingAcceptance: waiting for connection. Connecting: connecting. Connected: connected. Disconnecting: disconnecting. Rejected: connection rejected. Failed: connection failed. PartialFailed: partial connection failure. ServiceDeleted: service deleted.
- creation
Time String - Creation time of the endpoint.
- deleted
Time String - Deletion time of the endpoint.
- description String
- Description of the endpoint node. The default value is an empty string. It must start with a letter, number, or Chinese character, and can include letters, numbers, Chinese characters, and the following special characters: comma (,), period (.), underscore (_), space ( ), equals sign (=), hyphen (-), Chinese comma (,), and Chinese period (。). Length limit: 0–255 characters.
- endpoint
Domain String - Domain name of the endpoint.
- endpoint
Id String - ID of the endpoint node.
- endpoint
Index Number - Endpoint index
- endpoint
Name String - Endpoint name. Must start with a letter, number, or Chinese character. Can include letters, numbers, Chinese characters, and the following special characters: period (.), underscore (_), and hyphen (-). Length must be between 1 and 128 characters. If not specified, defaults to the endpoint ID.
- endpoint
Type String - Type of the endpoint node. Interface: interface endpoint node.
- ip
Address List<String>Versions - IP protocol type for the interface endpoint. Options are ipv4 and ipv6. The default for interface endpoints is ipv4. If only ipv4 is used, do not provide this parameter. If the interface endpoint is dual stack (ipv4 & ipv6), you must provide this parameter. Before providing it, ensure the following: your account has enabled IPv6 for private network connections; the subnet associated with the interface endpoint has enabled the IPv6 segment; the endpoint service associated with the interface endpoint is dual stack. Parameter -N: indicates the sequence number of the IP protocol type for the interface endpoint, with a range of 1–2. Use & to separate the sequence numbers of the two IP protocol types. Currently, only providing IPv6 is not supported.
- payer String
- Billing account for the private network connection. Endpoint: endpoint account. EndpointService: endpoint service account.
- private
Dns BooleanEnabled - Enable private DNS name. false (default): disabled. true: enabled.
- private
Dns StringName - The private DNS name of the endpoint node. If the parameter PrivateDNSEnabled returns false, this parameter is empty.
- project
Name String - Name of the project to which the endpoint node belongs.
- security
Group List<String>Ids - ID of the security group to be bound to the endpoint. You can call the DescribeSecurityGroups API to obtain the security group ID. Parameter -N: Indicates the sequence number of the security group ID, value range: 1–5. Separate multiple security group IDs with &.
- service
Id String - ID of the endpoint service to be associated. You can call the DescribeVpcEndpointServices API to obtain the endpoint service ID.
- service
Managed Boolean - Whether the endpoint is managed. false: Unmanaged endpoint. true: Managed endpoint.
- service
Name String - Name of the endpoint service to be associated.
- status String
- Status of the endpoint. Creating: Creating. Pending: Modifying configuration. Available: Available. Deleting: Deleting.
- List<Property Map>
- update
Time String - Most recent operation time of the endpoint.
- vpc
Id String - ID of the VPC to which the endpoint belongs. You can call the DescribeVpcs API to obtain the VPC ID.
- zones List<Property Map>
Supporting Types
VpcEndpointTag, VpcEndpointTagArgs
- Key string
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- Value string
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
- Key string
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- Value string
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
- key String
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- value String
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
- key string
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- value string
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
- key str
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- value str
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
- key String
- Tag key of the endpoint user tag. Length limit: 1–128 characters. Case sensitive. Cannot start with 'or' or 'sys:' in any case combination. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @.
- value String
- Tag value of the endpoint user tag. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Allowed characters: letters, numbers, spaces ( ), underscores (_), periods (.), colons (:), slashes (/), equal signs (=), plus signs (+), hyphens (-), and @
VpcEndpointZone, VpcEndpointZoneArgs
- Private
Ip stringAddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- Private
Ipv6Address string - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- Subnet
Id string - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- Zone
Id string - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
- Private
Ip stringAddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- Private
Ipv6Address string - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- Subnet
Id string - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- Zone
Id string - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
- private
Ip StringAddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- private
Ipv6Address String - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- subnet
Id String - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- zone
Id String - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
- private
Ip stringAddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- private
Ipv6Address string - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- subnet
Id string - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- zone
Id string - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
- private_
ip_ straddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- private_
ipv6_ straddress - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- subnet_
id str - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- zone_
id str - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
- private
Ip StringAddress - The private IPv4 address of the endpoint node's network interface must belong to the subnet's IPv4 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv4 address, with a value range of 1–10. Use & to separate multiple private IPv4 addresses.
- private
Ipv6Address String - The private IPv6 address of the endpoint node's network interface must belong to the subnet's IPv6 CIDR block. You can call the DescribeSubnets API to obtain the subnet's CIDR block. Parameter -N: indicates the sequence number of the private IPv6 address, with a value range of 1–10. Use & to separate multiple private IPv6 addresses. If not specified, an IPv6 address will be randomly assigned within the subnet's IPv6 CIDR block by default.
- subnet
Id String - ID of the subnet to which the NIC of the endpoint to be created belongs. You can call the DescribeSubnets API to obtain the subnet ID. Parameter -N: Indicates the sequence number of the subnet ID, value range: 1–10. Separate multiple subnet IDs with &.
- zone
Id String - ID of the availability zone to which the NIC of the endpoint to be created belongs. For more information about availability zones, see Regions and Availability Zones. Parameter -N: Indicates the sequence number of the availability zone, value range: 1–10. Separate multiple availability zone IDs with &.
Import
$ pulumi import volcenginecc:privatelink/vpcEndpoint:VpcEndpoint example "endpoint_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Apr 23, 2026 by Volcengine
