ApsaraVideo Live:Live stream snapshots

1. Query snapshots.

   Note

   To delete a snapshot, you must specify the timestamp of the snapshot. Before you delete the snapshot, you must query the timestamp of the snapshot.

   // Replace the placeholder values with the actual values. 
   DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
   IAcsClient client = new DefaultAcsClient(profile);
   DescribeLiveStreamSnapshotInfoRequest describeLiveStreamSnapshotInfoRequest=new DescribeLiveStreamSnapshotInfoRequest();
   describeLiveStreamSnapshotInfoRequest.setAppName("<AppName>");
   describeLiveStreamSnapshotInfoRequest.setStreamName("<StreamName>");
   describeLiveStreamSnapshotInfoRequest.setDomainName("<DomainName>");
   // The beginning of the time range to query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format and is displayed in UTC.
   describeLiveStreamSnapshotInfoRequest.setStartTime("<StartTime>");
   // The end of the time range to query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format and is displayed in UTC. The duration specified by the StartTime parameter and the EndTime parameter cannot exceed one day. 
   describeLiveStreamSnapshotInfoRequest.setEndTime("<EndTime>");
   DescribeLiveStreamSnapshotInfoResponse describeLiveStreamSnapshotInfoResponse = null;
   try {
       describeLiveStreamSnapshotInfoResponse = client.getAcsResponse(describeLiveStreamSnapshotInfoRequest);
   } catch (ClientException e) {
       e.printStackTrace();
   }
   System.out.println(new Gson().toJson(describeLiveStreamSnapshotInfoResponse));

   Important

   • Snapshot queries are limited to a single day within the past year. The duration specified by the StartTime parameter and the EndTime parameter cannot exceed one day.

   • If snapshots are captured in overwrite and real-time modes at the same time, you can query only the snapshots captured in real-time mode. In this case, you can view the snapshots captured in overwrite mode only in the OSS console. For more information, see List objects.

   • The DescribeLiveStreamSnapshotInfo operation does not support paged queries and can return a maximum of 100 entries at a time. By default, 10 entries are returned.

   • For more information about the DescribeLiveStreamSnapshotInfo operation, see DescribeLiveStreamSnapshotInfo.

2. Delete snapshots.

   Note

   If you want to delete the corresponding snapshots that are stored in OSS when you delete snapshots in ApsaraVideo Live, you must create a Resource Access Management (RAM) role named AliyunMTSVideoLifecycleRole and attach the AliyunMTSVideoLifecycleRolePolicy system policy to the role. When you delete snapshots in ApsaraVideo Live, you delete the snapshot information, such as application name, stream name, and path of OSS objects. The snapshots themselves are stored in OSS. For more information, see the "Delete snapshots in the ApsaraVideo Live console" section of the Manage snapshots topic.

   // Replace the placeholder values with the actual values. 
   DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
   IAcsClient client = new DefaultAcsClient(profile);        
   DeleteSnapshotFilesRequest deleteSnapshotFilesRequest=new DeleteSnapshotFilesRequest();
   deleteSnapshotFilesRequest.setAppName("<AppName>");
   deleteSnapshotFilesRequest.setStreamName("<StreamName>");
   deleteSnapshotFilesRequest.setDomainName("<DomainName>");
   // Specify whether to delete the corresponding snapshots stored in OSS.
   deleteSnapshotFilesRequest.setRemoveFile(true);
   List<Long> createTimestampLists=new ArrayList<>();
   // Specify the timestamp of the snapshot that you want to delete.
   // createTimestampLists.add(<Timestamp>);
   deleteSnapshotFilesRequest.setCreateTimestampLists(createTimestampLists);
   DeleteSnapshotFilesResponse deleteSnapshotFilesResponse= null;
   try {
       deleteSnapshotFilesResponse = client.getAcsResponse(deleteSnapshotFilesRequest);
   } catch (ClientException e) {
       e.printStackTrace();
   }
   System.out.println(new Gson().toJson(deleteSnapshotFilesResponse));

   Important

   • You can delete only snapshots that are captured within the past year.

   • You can delete the snapshots captured in overwrite mode only in the OSS console. For more information, see Delete objects.

   • For more information about the DeleteSnapshotFiles operation, see DeleteSnapshotFiles.

In the preceding example, the snapshot information in ApsaraVideo Live and the corresponding snapshots stored in OSS are deleted.