Virtual Private Cloud API, gRPC: AddressService.List
Retrieves the list of Address resources in the specified folder.
gRPC request
rpc List (ListAddressesRequest) returns (ListAddressesResponse)
ListAddressesRequest
{
"folderId": "string",
"pageSize": "int64",
"pageToken": "string",
"filter": "string"
}
Field |
Description |
folderId |
string Required field. ID of the folder to list addresses in. To get the folder ID use a yandex.cloud.resourcemanager.v1.FolderService.List request. |
pageSize |
int64 The maximum number of results per page to return. If the number of available |
pageToken |
string Page token. To get the next page of results, set |
filter |
string A filter expression that filters Address listed in the response. The expression must specify:
|
ListAddressesResponse
{
"addresses": [
{
"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"
}
]
}
],
"nextPageToken": "string"
}
Field |
Description |
addresses[] |
List of addresses. |
nextPageToken |
string Token for getting the next page of the list. If the number of results is greater than Each subsequent page will have its own |
Address
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". |