mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
a2428508e2
(1) add support to create/delete/revert vm snapshots on running vms with QCOW2 format (2) add new API to create volume snapshot from vm snapshot (3) delete metadata of vm snapshots before stopping/migrating and recover vm snapshots after starting/migrating (4) enable deleting of VM snapshot on stopped vm or vm snapshot is not listed in qcow2 image. (5) enable smoke tests for vmsnaphsots on KVM
115 lines
4.3 KiB
Java
115 lines
4.3 KiB
Java
// Licensed to the Apache Software Foundation (ASF) under one
|
|
// or more contributor license agreements. See the NOTICE file
|
|
// distributed with this work for additional information
|
|
// regarding copyright ownership. The ASF licenses this file
|
|
// to you under the Apache License, Version 2.0 (the
|
|
// "License"); you may not use this file except in compliance
|
|
// with the License. You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing,
|
|
// software distributed under the License is distributed on an
|
|
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
// KIND, either express or implied. See the License for the
|
|
// specific language governing permissions and limitations
|
|
// under the License.
|
|
package com.cloud.storage.snapshot;
|
|
|
|
import java.util.List;
|
|
|
|
import org.apache.cloudstack.api.command.user.snapshot.CreateSnapshotPolicyCmd;
|
|
import org.apache.cloudstack.api.command.user.snapshot.DeleteSnapshotPoliciesCmd;
|
|
import org.apache.cloudstack.api.command.user.snapshot.ListSnapshotPoliciesCmd;
|
|
import org.apache.cloudstack.api.command.user.snapshot.ListSnapshotsCmd;
|
|
|
|
import com.cloud.api.commands.ListRecurringSnapshotScheduleCmd;
|
|
import com.cloud.exception.ResourceAllocationException;
|
|
import com.cloud.storage.Snapshot;
|
|
import com.cloud.storage.Volume;
|
|
import com.cloud.user.Account;
|
|
import com.cloud.utils.Pair;
|
|
import org.apache.cloudstack.api.command.user.snapshot.UpdateSnapshotPolicyCmd;
|
|
|
|
public interface SnapshotApiService {
|
|
|
|
/**
|
|
* List all snapshots of a disk volume. Optionally lists snapshots created by specified interval
|
|
*
|
|
* @param cmd
|
|
* the command containing the search criteria (order by, limit, etc.)
|
|
* @return list of snapshots
|
|
*/
|
|
Pair<List<? extends Snapshot>, Integer> listSnapshots(ListSnapshotsCmd cmd);
|
|
|
|
/**
|
|
* Delete specified snapshot from the specified. If no other policies are assigned it calls destroy snapshot. This
|
|
* will be
|
|
* used for manual snapshots too.
|
|
*
|
|
* @param snapshotId
|
|
* TODO
|
|
*/
|
|
boolean deleteSnapshot(long snapshotId);
|
|
|
|
/**
|
|
* Creates a policy with specified schedule. maxSnaps specifies the number of most recent snapshots that are to be
|
|
* retained.
|
|
* If the number of snapshots go beyond maxSnaps the oldest snapshot is deleted
|
|
*
|
|
* @param cmd
|
|
* the command that
|
|
* @param policyOwner
|
|
* TODO
|
|
* @return the newly created snapshot policy if success, null otherwise
|
|
*/
|
|
SnapshotPolicy createPolicy(CreateSnapshotPolicyCmd cmd, Account policyOwner);
|
|
|
|
/**
|
|
* Get the recurring snapshots scheduled for this volume currently along with the time at which they are scheduled
|
|
*
|
|
* @param cmd
|
|
* the command wrapping the volumeId (volume for which the snapshots are required) and policyId (to show
|
|
* snapshots for only this policy).
|
|
* @return The list of snapshot schedules.
|
|
*/
|
|
public List<? extends SnapshotSchedule> findRecurringSnapshotSchedule(ListRecurringSnapshotScheduleCmd cmd);
|
|
|
|
/**
|
|
* list all snapshot policies assigned to the specified volume
|
|
*
|
|
* @param cmd
|
|
* the command that specifies the volume criteria
|
|
* @return list of snapshot policies
|
|
*/
|
|
Pair<List<? extends SnapshotPolicy>, Integer> listPoliciesforVolume(ListSnapshotPoliciesCmd cmd);
|
|
|
|
boolean deleteSnapshotPolicies(DeleteSnapshotPoliciesCmd cmd);
|
|
|
|
Snapshot allocSnapshot(Long volumeId, Long policyId, String snapshotName, Snapshot.LocationType locationType) throws ResourceAllocationException;
|
|
|
|
/**
|
|
* Create a snapshot of a volume
|
|
*
|
|
* @param snapshotOwner
|
|
* TODO
|
|
* @param cmd
|
|
* the API command wrapping the parameters for creating the snapshot (mainly volumeId)
|
|
*
|
|
* @return the Snapshot that was created
|
|
*/
|
|
Snapshot createSnapshot(Long volumeId, Long policyId, Long snapshotId, Account snapshotOwner);
|
|
|
|
/**
|
|
* @param vol
|
|
* @return
|
|
*/
|
|
Long getHostIdForSnapshotOperation(Volume vol);
|
|
|
|
Snapshot revertSnapshot(Long snapshotId);
|
|
|
|
Snapshot backupSnapshotFromVmSnapshot(Long snapshotId, Long vmId, Long volumeId, Long vmSnapshotId);
|
|
|
|
SnapshotPolicy updateSnapshotPolicy(UpdateSnapshotPolicyCmd updateSnapshotPolicyCmd);
|
|
}
|