Restores media assets.
Operation description
You can call this operation to restore only Archive and Cold Archive audio and video files. You can access the audio and video files after the files are restored. You cannot change the storage class of an audio or video file that is being restored. You are charged for the retrieval traffic generated during restoration. After a Cold Archive audio or video file is restored, a Standard replica of the file is generated for access. You are charged for the storage of the replica before the file returns to the frozen state.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
MediaIds | string | Yes | The ID of the media asset (VideoId). Separate multiple IDs with commas (,). You can specify a maximum of 20 IDs. You can use one of the following methods to obtain the ID of the media asset:
| 8bc8e94fe4e55abde85718****,eb186180e989dd56**** |
Scope | string | No | The modification range. Valid values:
| All |
RestoreDays | string | No | The number of days during which media assets remain in the restored state. Default value: 1. The maximum validity period of a restored Archive media asset is 7 days and the maximum validity period of a restored Cold Archive media asset is 365 days. | 2 |
RestoreTier | string | No | The restoration priority. This parameter is required only when you restore a Cold Archive media file. Valid values:
| Standard |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "8E70E3F8-E2EE-47BC-4677-379D6F28****",
"Success": true,
"IgnoredList": {
"MediaId": [
"['7f29b8d0c5fa71ed9685e6f7d559****']"
]
},
"ForbiddenList": {
"MediaForbiddenReasonDTO": [
{
"MediaId": "fa10ee70898671edb99f6eb3690d****",
"Reason": "Forbidden.RestoreMedia"
}
]
}
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-04-11 | The internal configuration of the API is changed, but the call is not affected | View Change Details |