Skip to main content

GetByValue

Returns the specified Address resource by a given value.

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

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

const GetAddressByValueRequest =
  cloudApi.vpc.address_service.GetAddressByValueRequest;

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

  const result = await client.getByValue(
    GetAddressByValueRequest.fromPartial({
      // externalIpv4Address: "externalIpv4Address"
    })
  );
  console.log(result);
})();

GetAddressByValueRequest​

One of address​

External ipv4 address specification.

  • externalIpv4Address : string​

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]*.

  • 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.