Virtual Private Cloud API, gRPC: AddressService.Get
Returns the specified Address resource.
To get the list of all available Address resources, make a List request.
gRPC request
rpc Get (GetAddressRequest) returns (Address)
GetAddressRequest
{
"addressId": "string"
}
Field |
Description |
addressId |
string Required field. ID of the Address resource to return. To get Address resource ID make a AddressService.List request. |
Address
{
"id": "string",
"folderId": "string",
"createdAt": "google.protobuf.Timestamp",
"name": "string",
"description": "string",
"labels": "string",
// Includes only one of the fields `externalIpv4Address`
"externalIpv4Address": {
"address": "string",
"zoneId": "string",
"requirements": {
"ddosProtectionProvider": "string",
"outgoingSmtpCapability": "string"
}
},
// end of the list of possible fields
"reserved": "bool",
"used": "bool",
"type": "Type",
"ipVersion": "IpVersion",
"deletionProtection": "bool",
"dnsRecords": [
{
"fqdn": "string",
"dnsZoneId": "string",
"ttl": "int64",
"ptr": "bool"
}
]
}
An Address resource. For more information, see Address.
Field |
Description |
id |
string ID of the address. Generated at creation time. |
folderId |
string ID of the folder that the address belongs to. |
createdAt |
Creation timestamp. |
name |
string Name of the address. |
description |
string Description of the address. 0-256 characters long. |
labels |
string Address labels as |
externalIpv4Address |
Includes only one of the fields External ipv4 address specification. |
reserved |
bool Specifies if address is reserved or not. |
used |
bool Specifies if address is used or not. |
type |
enum Type Type of the IP address.
|
ipVersion |
enum IpVersion Version of the IP address.
|
deletionProtection |
bool Specifies if address protected from deletion. |
dnsRecords[] |
Optional DNS record specifications |
ExternalIpv4Address
Field |
Description |
address |
string Value of address. |
zoneId |
string Availability zone from which the address will be allocated. |
requirements |
Parameters of the allocated address, for example DDoS Protection. |
AddressRequirements
Field |
Description |
ddosProtectionProvider |
string DDoS protection provider ID. |
outgoingSmtpCapability |
string Capability to send SMTP traffic. |
DnsRecord
Field |
Description |
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". |