Queries the information about one or more image templates.
Operation description
You can use NextToken
to configure the query token. Set the value to the NextToken
value that is returned in the previous call to the DescribeImagePipelines
operation. Then, use MaxResults
to specify the maximum number of entries to return on each page.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the image template. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
ResourceGroupId | string | No | The ID of the resource group. If this parameter is specified to query resources, up to 1,000 resources that belong to the specified resource group can be displayed in the response. Note
Resources in the default resource group are displayed in the response regardless of how this parameter is set.
| rg-bp67acfmxazb4p**** |
Tag | array<object> | No | The tags of the image template. | |
object | No | The value of tag N of the image template. Valid values of N: 1 to 20. | ||
Key | string | No | The key of tag N. Valid values of N: 1 to 20. | TestKey |
Value | string | No | The value of tag N. Valid values of N: 1 to 20. | TestValue |
Name | string | No | The name of the image template. | testImagePipeline |
NextToken | string | No | The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of | AAAAAdDWBF2**** |
MaxResults | integer | No | The number of entries per page. Valid values: 1 to 500. Default value: 50. | 50 |
ImagePipelineId | array | No | The IDs of image templates. Valid values of N: 1 to 20. | |
string | No | The ID of image template N. Valid values of N: 1 to 20. | ip-2ze5tsl5bp6nf2b3**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"NextToken": "AAAAAdDWBF2****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 1,
"MaxResults": 50,
"ImagePipeline": {
"ImagePipelineSet": [
{
"CreationTime": "2020-11-24T06:00:00Z",
"DeleteInstanceOnFailure": true,
"InstanceType": "ecs.g6.large",
"InternetMaxBandwidthOut": 0,
"ImagePipelineId": "ip-2ze5tsl5bp6nf2b3****",
"VSwitchId": "vsw-bp67acfmxazb4p****",
"SystemDiskSize": 40,
"Description": "This is description.",
"BaseImage": "m-bp67acfmxazb4p****",
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"ImageName": "testImageName",
"BaseImageType": "IMAGE",
"Name": "testImagePipeline",
"BuildContent": "FROM IMAGE:m-bp67acfmxazb4p****",
"Tags": {
"Tag": [
{
"TagValue": "TestValue",
"TagKey": "TestKey"
}
]
},
"ToRegionIds": {
"ToRegionId": [
"[\"cn-hangzhou\"]"
]
},
"AddAccounts": {
"AddAccount": [
"[\"1234567890\"]"
]
}
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidImagePipelineIdSize.ExceededMaxNumber | %s | The number of specified ImagePipelineId.N parameters exceeds the upper limit. Valid values of N: 1 to 20. |
400 | InvalidName.Malformed | %s | - |
403 | Invalid.NextToken | The specified NextToken is not valid. | - |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|