All Products
Search
Document Center

Data Security Center:RestoreOssImage

Last Updated:Dec 01, 2025

You can call the RestoreOssImage operation to restore desensitized images.

Operation description

You can use RestoreOssImage to retrieve the original images that were processed by the MaskOssImage operation if the IsAlwaysUpload parameter is set to true.

For example, the image aliyun_dsc_desensitization/exampledir/test.png in a bucket is restored and saved as aliyun_dsc_original/exampledir/test.png.

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

Bucket

string

Yes

The OSS bucket.

test-sddp

ObjectKey

string

Yes

The full path of the file stored in OSS.

aliyun_dsc_desensitization/dir1/test.png

ServiceRegionId

string

Yes

The ID of the region where the bucket is located.

cn-hangzhou

TargetObjectKey

string

No

The storage path for the restored image.

aliyun_dsc_original /dir1/test.png

Response elements

Element

Type

Description

Example

object

The response schema.

RequestId

string

The request ID.

208B016D-4CB9-4A85-96A5-0B8ED1EBF271

RestoredImageKey

string

The storage path of the restored image in the bucket.

aliyun_dsc_original /dir1/test.png

Examples

Success response

JSON format

{
  "RequestId": "208B016D-4CB9-4A85-96A5-0B8ED1EBF271",
  "RestoredImageKey": "aliyun_dsc_original /dir1/test.png"
}

Error codes

HTTP status code

Error code

Error message

Description

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.