Call the DetectImage operation to initiate an image detection process.

Usage notes

For prerequisites and precautions for calling this operation, see Image detection overview.

Request description

You can call the DescribeImages operation and pass in the ID of the target image to obtain the detection result.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: DetectImage

The action that you want to perform. Valid value: DetectImage.

Version string required Sample value: 2020-04-01

The version of the API. Valid value: 2020-04-01.

ImageId string required Sample value: image-yczf9rotssgh*****

The image ID. You can call the DescribeImages operation to query and obtain the image ID.

Response parameters

This operation has no specific response parameters. For more information, refer to Response structure.

Sample request

Sample response

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	InvalidImageStatus	The specified image is not in the correct status for the request.	The current status of the image does not support this operation.
400	InvalidPlatformForDetect.UnSupported	The specified image platform cannot be used for detect.	The specified image platform does not support detection
400	MissingParameter.ImageId	The required parameter ImageId is not supplied.	The image ID cannot be empty.
404	InvalidImage.NotFound	The specified image does not exist.	The specified image does not exist.
412	OperationDenied.ImageIsDetecting	The specified operation is denied as your image is detecting.	The specified operation is rejected because the image is being detected.
500	InternalError	An internal error has occurred.	An internal error occurred. Try again. If multiple attempts fail, submit a ticket.