Skip to content
StratumStratum Docs

List resolver inbound endpoints in a project.

GET
/v1/projects/{projectId}/dns/resolver-inbound-endpoints
Code sample: Shell / cURL
curl --request GET \
  --url https://stratum.example.com/v1/projects/example/dns/resolver-inbound-endpoints \
  --header 'Authorization: Bearer <token>'

The inbound half of hybrid DNS. The outbound half (forward chosen domains from a VPC to on-prem resolvers) is the existing /dns/resolver-rules surface.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
projectId
required
string
/^p-[a-z0-9-]+$/

Query Parameters

Section titled “Query Parameters”
vpcId
string
/^vpc-[a-z0-9-]+$/

Responses

Section titled “Responses”

200

Section titled “200”

Resolver inbound endpoints.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
/^rie-[a-z0-9-]+$/
projectId
required
string
vpcId
required
string
/^vpc-[a-z0-9-]+$/
floatingIPId
required
string
/^fip-[a-z0-9-]+$/
address

The floating IP address on-prem resolvers point at (port 53 udp+tcp).

string
state
required
string
Allowed values: available deleted
allowedCidrs

Client networks permitted to query through this endpoint. Empty means only the VPC’s own clients can resolve through it. See CreateResolverInboundEndpointRequest.allowedCidrs.

Array<string>
subnetIds

Tenant subnets the endpoint has an interface in.

Array<string>
securityGroupIds

Security groups applied to the endpoint’s interfaces. Empty when the endpoint uses the pre- shared-recursor path.

Array<string>
nicIds

The Stratum-owned NICs backing this endpoint, one per subnet. These carry the security groups and their addresses are what the floating IP forwards to.

Array<string>
tags

AWS-shape resource tags. Freeform UTF-8 keys (1-128 bytes, no leading/trailing whitespace) mapped to freeform UTF-8 values (0-256 bytes). Max 50 tags per resource. Reserved prefixes (stratum.dev/, stratum.platform_health., stratum:, aws:) return 400 RESERVED_NAMESPACE on customer input. PATCH replaces the whole map..

object
<= 50 properties
key
additional properties
string
<= 256 characters
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
deletedAt
string format: date-time
createdBy
string
nextPageToken
string
isTruncated

True when the server had more rows than it returned. The response is a valid prefix of the result, not the whole of it.

Without this flag a client at the server’s row ceiling receives a full page and no nextPageToken, which means “this is the complete set” — so data it never saw would be indistinguishable from data that does not exist.

It does not imply a cursor exists. These queries do not all sort on a total order, so a resumable token cannot be minted for them yet. The remedy is to narrow the request (a filter, or a tighter scope), not to page.

boolean

Example 

{
  "items": [
    {
      "state": "available"
    }
  ]
}