CreateSkillFileCheck - Agent Security Center - Alibaba Cloud Documentation Center

Initiates batch detection for user-defined skills.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-aisc:CreateSkillFileCheck

none

*All Resource

*

None

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
Files	array<object>	No	The file information.
	object	No	The file list.
DownloadUrl	string	No	The public URL for downloading the file. The downloaded file must be a compressed package in tar.gz or zip format.	https://test.oss-cn-hangzhou.aliyuncs.com/xxxx
FileName	string	No	The file name. If not specified, the file name is parsed from DownloadUrl.	test-file
UploadKey	string	No	The tenant-isolated OSS temporary object key returned by GenerateSkillOssUploadCredential. Specify either this parameter or DownloadUrl.	user-upload/staging/123456789/550e8400-e29b-41d4-a716-446655440000
Source	string	No	The upload source. If left empty, user_upload is used by default. Security operations agents use sec_ops_agent. Valid values: user_upload : user upload. sec_ops_agent : security operations agent.	sec_ops_agent

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	Id of the request	9FDE3D6F-26BD-5937-B0E5-8F47962B****
Data	object	The task creation result.
RootTaskId	string	The root task ID returned after the task is submitted.	c6e7fa8a77df6e182ac3fcf1478ab83a
SuccessCount	integer	The number of files that are uploaded successfully.	10
FailCount	integer	The number of files that failed to be uploaded.	0
UploadResults	array<object>	The upload results.
	object	The result of a single file upload.
FileHash	string	The SHA256 hash of the uploaded file.	514f44ebed1d0c1df5e16a116080b64b
IdentifyId	string	The unique ID of the uploaded file. You can use this ID to query the task result.	1824jcadg01bsl10b
ErrorMsg	string	The error message returned when the file fails to be uploaded.	Network error.
Success	boolean	Indicates whether the operation is successful. Valid values: true: Successful. false: Failed.	true
FileName	string	The name of the file.	test-file

Examples

Success response

JSON format

{
  "RequestId": "9FDE3D6F-26BD-5937-B0E5-8F47962B****",
  "Data": {
    "RootTaskId": "c6e7fa8a77df6e182ac3fcf1478ab83a",
    "SuccessCount": 10,
    "FailCount": 0,
    "UploadResults": [
      {
        "FileHash": "514f44ebed1d0c1df5e16a116080b64b",
        "IdentifyId": "1824jcadg01bsl10b",
        "ErrorMsg": "Network error.",
        "Success": true,
        "FileName": "test-file"
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.