yandex_vpc_address (Resource)
Статья создана
Обновлена 16 марта 2026 г.
Manages a address within the Yandex Cloud. You can only create a reserved (static) address via this resource. An ephemeral address could be obtained via implicit creation at a compute instance creation only. For more information, see the official documentation.
- How-to Guides
Example usage
//
// Create a new VPC regular IPv4 Address.
//
resource "yandex_vpc_address" "addr" {
name = "exampleAddress"
external_ipv4_address {
zone_id = "ru-central1-a"
}
}
//
// Create a new VPC IPv4 Address with DDoS Protection.
//
resource "yandex_vpc_address" "vpnaddr" {
name = "vpnaddr"
external_ipv4_address {
zone_id = "ru-central1-a"
ddos_protection_provider = "qrator"
}
}
//
// Create a new VPC internal IPv4 Address.
// The address can be used in compute_instance, vpc_private_endpoint or lb_network_load_balancer resources.
//
resource "yandex_vpc_address" "internal_addr" {
name = "internalAddress"
internal_ipv4_address {
subnet_id = yandex_vpc_subnet.foo.id
}
}
// Auxiliary resources for VPC Address
resource "yandex_vpc_network" "foo" {}
resource "yandex_vpc_subnet" "foo" {
zone = "ru-central1-a"
network_id = yandex_vpc_network.foo.id
v4_cidr_blocks = ["10.5.0.0/24"]
}
Arguments & Attributes Reference
created_at(Read-Only) (String). The creation timestamp of the resource.deletion_protection(Bool). Thetruevalue means that resource is protected from accidental deletion.description(String). The resource description.folder_id(String). The folder identifier that resource belongs to. If it is not provided, the default providerfolder-idis used.id(String).labels(Map Of String). A set of key/value label pairs which assigned to resource.name(String). The resource name.reserved(Read-Only) (Bool).falsemeans that address is ephemeral.used(Read-Only) (Bool).trueif address is used.dns_record[Block]. DNS record specification of address.dns_zone_id(Required)(String). DNS zone id to create record at.fqdn(Required)(String). FQDN for record to address.ptr(Bool). If PTR record is needed.ttl(Number). TTL of DNS record.
external_ipv4_address[Block]. Specification of IPv4 address.
Важно
Either one address or zone_id arguments can be specified.
Важно
Either one ddos_protection_provider or outgoing_smtp_capability arguments can be specified.
Важно
Change any argument in external_ipv4_address will cause an address recreate.
address(Read-Only) (String). Allocated IP address.ddos_protection_provider(String). Enable DDOS protection. Possible values are:qratoroutgoing_smtp_capability(String). Wanted outgoing smtp capability.zone_id(String). The availability zone where resource is located. If it is not provided, the default provider zone will be used.internal_ipv4_address[Block]. Specification of internal IPv4 address.
Важно
Change any argument in internal_ipv4_address will cause an address recreate.
address(Read-Only) (String). Allocated IP address.subnet_id(Required)(String). Subnet ID from which the address will be allocated.
Import
The resource can be imported by using their resource ID. For getting it you can use Yandex Cloud Web Console
# terraform import yandex_vpc_address.<resource Name> <resource Id>
terraform import yandex_vpc_address.addr ...