List points of presence

This lists available points of presence (POPs).

The parameters you set determine which POPs the operation returns. If your tenant has private POPs enabled, the operation always returns the tenant's private POPs and ignores shared, global_shared, and global_poc. Otherwise, it applies the first of these that matches. If shared is true, it returns the tenant's private POPs plus the POPs from the tenant's logical POP domain selections. If you set global_shared, it returns all globally shared POPs. If you set global_poc, it returns all POPs in the POC category. If none of these match, it returns only the tenant's private POPs.

The localization parameter filters the results in every case. The order of the results isn't defined.

Query Params
integer
≥ 0
Defaults to 1000

The number of items to include on each page of results, which defaults to the maximum 1000 items. A value of 0 or more than 1000 returns 1000 items.

integer
≥ 0
Defaults to 0

The number of results to skip before the first result, starting at the default 0.

boolean

Setting this to true returns the tenant's private POPs plus POPs from the tenant's logical POP domain selections. See the operation description for how this parameter combines with the others.

string

Providing any value returns all globally shared POPs where pop_type is shared.

string

Providing any value returns all POPs whose pop_category includes POC.

string

A free-text, case-insensitive substring filter on the POP name or region. It applies only when global_shared selects the results. Otherwise it's ignored.

string
enum

Enum Filters by localization. Use DF for Default or CN for China.

Allowed:
boolean

When set to true, includes nested logical POP data in each POP response.

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/json
application/problem+json