List IP sets
Relative path: /v1/policies/{policyUuid}/ip-sets
Query parameters
Name |
Type |
Description |
---|---|---|
pageSize |
integer |
Limit for pagination purposes. If unspecified or 0, default value is 100. The maximum value is 10000; values above 10000 will throw 400 BAD REQUEST.
|
pageToken |
string |
Page token of current page. If not given or "", the first page is returned.
|
Parameters in path
Name |
Type |
Required |
Description |
---|---|---|---|
policyUuid |
string |
Yes |
Reference to policy for which the IP Sets are listed. type: policy_management.v1.Policy |
Responses
Display Schema instead of an Example or vice-versa
Code |
Description |
Example |
Schema |
---|---|---|---|
200 |
Successful response. |
{ "ipSets": [ { "builtIn": true, "description": "string", "displayName": "string", "ipAddresses": [ "string" ], "readOnly": true, "uuid": "string" } ], "nextPageToken": "string" } |
{ "$ref": "v1ListIpSetsResponse", "ipSets": [ { "$ref": "v1IpSet", "description": { "type": "string", "description": "Description of IP Set." }, "builtIn": { "type": "boolean", "description": "Some IP Sets are delivered out of box and are always present. For those this attribute is true. User-defined IP Sets have it set to false." }, "displayName": { "type": "string", "description": "Human readable name of the IP Set." }, "ipAddresses": [ { "type": "string" } ], "readOnly": { "title": "If true, the content of IP Set cannot be updated. If false, and built in is true, the following attributes can be updated: - ip addresses", "type": "boolean" }, "uuid": { "type": "string", "description": "Unique identifier of the entity. Must be collision free - two identifiers created anywhere in the world must not collide within entity parent scope. Unless a member of aggregate, the entity scope is always global. Although most of the times compliant with RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace, do not rely on it being a RFC UUID. Treat it as an opaque identifier. RFC UUID can be recognized by being formatted according to template xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx, as explained on wikipedia. UUID is used for referencing an entity, even across domains. Example: '123e4567-e89b-12d3-a456-426614174000'" } } ], "nextPageToken": { "type": "string", "description": "Page token of next page. Empty or '' for the last page. Info: For more information, refer to Paginating Requests in APIs or https://cloud.google.com/apis/design/design_patterns#list_pagination" } } |
202 |
Response took too long; request cached. Response can be retrieved later using the response-id header. |
null |
[] |
400 |
One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided. |
null |
[] |
401 |
Token has expired or is invalid. |
null |
[] |
403 |
Access denied. Check permissions. |
null |
[] |
404 |
Requested resource not found. |
null |
[] |
429 |
Rate limit reached. Try again later. |
null |
[] |
500 |
Internal server failure. Try again later. |
null |
[] |
502 |
Internal server failure. Try again later. |
null |
[] |
503 |
Environment under maintenance. Try again later. |
null |
[] |
504 |
Action took too long; timeout reached |
null |
[] |