DescribePrefixLists

GET /?Action=DescribePrefixLists
Description

Describes one or more prefix lists for available 3DS OUTSCALE services.
Each prefix list is composed of an ID, a name to identify the service it is associated with and a list of network prefixes used by this service, in CIDR notation.
You can use prefix list IDs in outbound security group rules to allow traffic from a VPC to access the corresponding service. For more information, see the AuthorizeSecurityGroupEgress method.
You can filter the described prefix lists using the PrefixListId.N parameter.
You can also use the Filter.N parameter to filter the prefix lists on the following properties:

  • prefix-list-id: The ID of a prefix list.

  • prefix-list-name: The name of a prefix list.

Note

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.
Body parameter

Required: false
Name: DescribePrefixListsRequest

Name Description Required Schema Default Example

DryRun

If set to true, checks whether you have the required permissions to perform the action.

false

boolean

Filter.N

One or more filters. Example:
osc-cli fcu DescribePrefixLists \
  --Filter.1.Name "prefix-list-id" \
  --Filter.1.Value.1 "pl-12345678"

false

Filter

MaxResults

The maximum number of results that can be returned in a single page. You can use NextToken to request the next results pages. This value is between 5 and 1000. If you provide a value larger than 1000, only 1000 results are returned.

false

integer

NextToken

The token to request the next results page.

false

string

PrefixListId.N

One or more prefix list IDs.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

DescribePrefixListsResult

Response 200

Response 200

Name Description Required Schema Default Example

nextToken

The token to request the next results page. If the value is null, there is no results left to be returned.

false

string

prefixListSet.N

Information about one or more prefix lists.

false

PrefixList

requestId

The ID of the request.

false

string