Check Snapshot Group Availability

GET/zstack/v1/volume-snapshots/groups/availabilities

Headers

Authorization: OAuth the-session-uuid

Curl Example

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X GET http://localhost:8080/zstack/v1/volume-snapshots/groups/availabilities?uuids=cc389f9eb3223c698f565621d2abcf72

Parameter List

NameTypeLocationDescriptionAllowed ValuesStarting Version
uuidsListquerySnapshot group UUIDs 3.6.0
systemTags (Optional)Listquery  3.6.0
userTags (Optional)Listquery  3.6.0

API Response

Response Example

{
  "results": [
    {
      "uuid": "78dd38e3e58134cead860f270143a474",
      "available": true,
      "reason": ""
    }
  ]
}
NameTypeDescriptionStarting Version
errorErrorCodeThe error code. If not null, the operation failed. This field is null when the operation succeeds. For details, see error3.6.0
resultsListFor details, see results3.6.0

error

NameTypeDescriptionStarting Version
codeStringThe error code number. A globally unique identifier for the error, for example, SYS.1000, HOST.10013.6.0
descriptionStringA brief description of the error3.6.0
detailsStringThe detailed error information3.6.0
elaborationStringA reserved field. The default value is null3.6.0
opaqueLinkedHashMapA reserved field. The default value is null3.6.0
causeErrorCodeThe root error. The source error that caused the current error. If no root error exists, this field is null3.6.0

results

NameTypeDescriptionStarting Version
uuidStringThe UUID of the resource. Uniquely identifies the resource3.6.0
availablebooleanWhether the snapshot group can be reverted3.6.0
reasonStringThe reason why the snapshot group cannot be reverted. Empty if it can be reverted3.6.0

SDK Examples

Java SDK

CheckVolumeSnapshotGroupAvailabilityAction action = new CheckVolumeSnapshotGroupAvailabilityAction();
action.uuids = asList("cc389f9eb3223c698f565621d2abcf72");
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
CheckVolumeSnapshotGroupAvailabilityAction.Result res = action.call();

Python SDK

CheckVolumeSnapshotGroupAvailabilityAction action = CheckVolumeSnapshotGroupAvailabilityAction()
action.uuids = [cc389f9eb3223c698f565621d2abcf72]
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
CheckVolumeSnapshotGroupAvailabilityAction.Result res = action.call()