Domain name for API request: tcss.intl.tencentcloudapi.com.
This API is used to query the details of an image.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: DescribeAssetImageDetail. |
| Version | Yes | String | Common Params. The value used for this API: 2020-11-01. |
| Region | No | String | Common Params. This parameter is not required. |
| ImageID | Yes | String | Image ID. |
| Parameter Name | Type | Description |
|---|---|---|
| ImageID | String | Image ID. |
| ImageName | String | Image name. |
| ImageDigest | String | Image digests. |
| CreateTime | String | Creation time. |
| Size | Integer | Image size. |
| HostCnt | Integer | Number of associated hosts (including normal nodes and super nodes). |
| ContainerCnt | Integer | Number of associated containers. |
| SuperNodeCnt | Integer | Number of super nodes. |
| ScanTime | String | Last scan time. |
| VulCnt | Integer | Number of vulnerabilities. |
| RiskCnt | Integer | Number of risky behaviors. |
| SensitiveInfoCnt | Integer | Number of sensitive information entries. |
| IsTrustImage | Boolean | Whether the image is trusted. |
| OsName | String | Image OS. |
| AgentError | String | Agent image scan error. |
| ScanError | String | Backend image scan error. |
| Architecture | String | System architecture. |
| Author | String | Author. |
| BuildHistory | String | Build history. |
| ScanVirusProgress | Integer | Trojan scan progress. |
| ScanVulProgress | Integer | Vulnerability scan progress. |
| ScanRiskProgress | Integer | Sensitive information scan progress. |
| ScanVirusError | String | Trojan scan error. |
| ScanVulError | String | Vulnerability scan error. |
| ScanRiskError | String | Sensitive information error. |
| ScanStatus | String | Image scan status. |
| VirusCnt | Integer | Number of Trojans and viruses. |
| Status | Integer | Image scan status. |
| RemainScanTime | Integer | Remaining scan time. |
| IsAuthorized | Integer | Whether authorization is performed. 1 indicates authorized and 0 indicates unauthorized. |
| Solution | String | Solution. |
| Reason | String | Reason. |
| RepoDigests | Array of String | Repository digests. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
Querying Image Details
POST / HTTP/1.1
Host: tcss.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeAssetImageDetail
<Common request parameters>
{
"ImageID": "sha256:707540fd8a54ab3ebc086ecc96d2d6143fd92c1cac4d0b23353e1b7078b5937b"
}
{
"Response": {
"AgentError": "timeout",
"Architecture": "Metadata",
"Author": "symon",
"BuildHistory": "# create_time:2021-09-15 18:20:05 tags:docker.io/centos:latest,yancyw:1,yancyw:2,yancyw:3, ADD file:1114113413411342942e068863ce2a8491bb71522c652f31fb466 in / ",
"ContainerCnt": 51,
"CreateTime": "2021-09-16 02:20:05",
"HostCnt": 24,
"SuperNodeCnt": 1,
"ImageDigest": "sha256:707540fd8a54ab3ebc086ecc96d2d6143fd92c1cac4d0b23353e1b7078b5937b",
"ImageID": "sha256:707540fd8a54ab3ebc086ecc96d2d6143fd92c1cac4d0b23353e1b7078b5937b",
"ImageName": "docker.io/centos:latest",
"IsAuthorized": 1,
"IsTrustImage": true,
"OsName": "centos:8.4.2105",
"RemainScanTime": 0,
"RequestId": "a11d268f-1601-4f63-9131-0382537b9e55",
"RiskCnt": 211,
"ScanError": "timeout",
"ScanRiskError": "timeout",
"ScanRiskProgress": 0,
"ScanStatus": "SCANNED",
"ScanTime": "2024-10-25 16:13:39",
"ScanVirusError": "timeout",
"ScanVirusProgress": 0,
"ScanVulError": "timeout",
"ScanVulProgress": 0,
"SensitiveInfoCnt": 0,
"Size": 231268856,
"Status": 5,
"VirusCnt": 0,
"VulCnt": 230
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| InternalError | An internal error occurred. |
| InternalError.MainDBFail | The database operation failed. |
| InvalidParameter | The parameter is incorrect. |
| InvalidParameter.ParsingError | A parameter parsing error occurred. |
| ResourceNotFound | The resource does not exist. |
피드백