Domain name for API request: csip.intl.tencentcloudapi.com.
Upload a Skill ZIP file to trigger asynchronous security detection. After a successful upload, poll the DescribeSkillScanResult API using the returned ContentHash and EngineVersion to obtain the result. The upload API is idempotent. Re-uploading a file with the same Hash does not create a repetition task. Detection results are retained for 90 days. Re-upload for detection after the retention period expires.
A maximum of 40 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: CreateSkillScan. |
| Version | Yes | String | Common Params. The value used for this API: 2022-11-21. |
| Region | No | String | Common Params. This parameter is not required. |
| FileBase64 | Yes | String | Base64-encoded ZIP file content Input limits: file size limit 7 MB (before encoding). Only valid ZIP format is accepted. |
| FileName | No | String | Filename for server log Parameter format: such as my-skill.zip |
| Parameter Name | Type | Description |
|---|---|---|
| ContentHash | String | SHA256 Hash of the file, used for polling the DescribeSkillScanResult API. Parameter format: sha256:<64-bit hex> |
| EngineVersion | Integer | Engine version number actually bound to the current request. The caller should save it and explicitly input it in subsequent DescribeSkillScanResult calls. |
| Status | String | Task status, fixed as SCANNING, indicating the task has been received. |
| Message | String | Readable operation result description |
| 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. |
POST / HTTP/1.1
Host: csip.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSkillScan
<Common request parameters>
{
"FileBase64": "UEsDBBQAAAAIAA...",
"FileName": "my-skill.zip"
}{
"Response": {
"ContentHash": "sha256:a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
"EngineVersion": 20260501,
"Status": "SCANNING",
"Message": "File received, scan task created",
"RequestId": "d3b7c5a1-6e4f-2d8a-9c1b-f5e3a7d2b8c6"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
There is no error code related to the API business logic. For other error codes, please see Common Error Codes.
피드백