DescribePrefixListAssociations -

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	DescribePrefixListAssociations	The operation that you want to perform. Set the value to DescribePrefixListAssociations.
RegionId	String	Yes	cn-chengdu	The region ID of the prefix list. You can call the DescribeRegions operation to query the most recent region list.
PrefixListId	String	Yes	pl-x1j1k5ykzqlixdcy****	The ID of the prefix list.
NextToken	String	No	AAAAAdDWBF2****	The query token. Set the value to the `NextToken` value returned in the previous call to the DescribePrefixListAssociations operation. Leave this parameter empty the first time you call this operation.
MaxResults	Integer	No	10	The number of entries to return on each page. Maximum value: 100. Default value: 10.

Response parameters


Parameter	Type	Example	Description
NextToken	String	AAAAAdDWBF2****	The query token returned in this call. If the return value is empty, no more data is returned.
RequestId	String	38793DB8-A4B2-4AEC-BFD3-111234E9188D	The ID of the request.
PrefixListAssociations	Array of PrefixListAssociation		Details about the resources that are associated with the prefix list.
PrefixListAssociation
ResourceId	String	sg-bp11ujym6xsff6l0****	The ID of the resource.
ResourceType	String	securitygroup	The type of the resource.

Examples

Sample requests

http(s)://ecs.aliyuncs.com/?Action=DescribePrefixListAssociations
&RegionId=cn-chengdu
&PrefixListId=pl-x1j1k5ykzqlixdcy****
&NextToken=AAAAAdDWBF2****
&MaxResults=10
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribePrefixListAssociationsResponse>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <RequestId>38793DB8-A4B2-4AEC-BFD3-111234E9188D</RequestId>
    <PrefixListAssociations>
        <ResourceId>sg-bp11ujym6xsff6l0****</ResourceId>
        <ResourceType>securitygroup</ResourceType>
    </PrefixListAssociations>
</DescribePrefixListAssociationsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "AAAAAdDWBF2****",
  "RequestId" : "38793DB8-A4B2-4AEC-BFD3-111234E9188D",
  "PrefixListAssociations" : [ {
    "ResourceId" : "sg-bp11ujym6xsff6l0****",
    "ResourceType" : "securitygroup"
  } ]
}

Error codes


HTTP status code	Error code	Error message	Description
400	InvalidParameter	%s	The error message returned because a specified parameter is invalid.
400	NotSupported.ResourceType	The specified resource type is not supported.	The error message returned because the specified resource type is not supported.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	The error message returned because the specified prefix list does not exist.

For a list of error codes, visit the API Error Center.