Skip to main content

Get

Returns the specified Address resource.

To get the list of all available Address resources, make a List request.

import { cloudApi, serviceClients, Session } from "@yandex-cloud/nodejs-sdk";

const GetAddressRequest = cloudApi.vpc.address_service.GetAddressRequest;

(async () => {
  const authToken = process.env["YC_OAUTH_TOKEN"];
  const session = new Session({ oauthToken: authToken });
  const client = session.client(serviceClients.AddressServiceClient);

  const result = await client.get(
    GetAddressRequest.fromPartial({
      addressId: "addressId",
    })
  );
  console.log(result);
})();

GetAddressRequest​

addressId : string​

ID of the Address resource to return.

To get Address resource ID make a AddressService.List request.

Address​

An Address resource. For more information, see Address.

Type​

  • TYPE_UNSPECIFIED

  • INTERNAL

    Internal IP address.

  • EXTERNAL

    Public IP address.

IpVersion​

  • IP_VERSION_UNSPECIFIED

  • IPV4

    IPv4 address.

  • IPV6

    IPv6 address.

id : string​

ID of the address. Generated at creation time.

folderId : string​

ID of the folder that the address belongs to.

createdAt : google.protobuf.Timestamp​

Creation timestamp.

name : string​

Name of the address. The name is unique within the folder. Value must match the regular expression \|[a-zA-Z]([-_a-zA-Z0-9]{0,61}[a-zA-Z0-9])?.

description : string​

Description of the address. 0-256 characters long.

labels : string​

Address labels as key:value pairs. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.

One of address​

External ipv4 address specification.

  • externalIpv4Address : ExternalIpv4Address​
reserved : bool​

Specifies if address is reserved or not.

used : bool​

Specifies if address is used or not.

type : Type​

Type of the IP address.

ipVersion : IpVersion​

Version of the IP address.

deletionProtection : bool​

Specifies if address protected from deletion.

dnsRecords : DnsRecord​

Optional DNS record specifications

ExternalIpv4Address​

address : string​

Value of address.

zoneId : string​

Availability zone from which the address will be allocated.

requirements : AddressRequirements​

Parameters of the allocated address, for example DDoS Protection.

DnsRecord​

fqdn : string​

DNS record name (absolute or relative to the DNS zone in use).

dnsZoneId : string​

ID of the public DNS zone.

ttl : int64​

TTL of record.

ptr : bool​

If the PTR record is required, this parameter must be set to "true".

AddressRequirements​

ddosProtectionProvider : string​

DDoS protection provider ID.

outgoingSmtpCapability : string​

Capability to send SMTP traffic.