CloneVolume
Sugerir cambios
PDF
Puede utilizar el CloneVolume método para crear una copia de un volumen. Este método es asíncrono y puede tardar una cantidad variable de tiempo en completarse.
El proceso de clonación comienza inmediatamente cuando hace el CloneVolume Solicite y es representativo del estado del volumen cuando se emite el método API. Puede utilizar el GetAsyncResult el método para determinar cuándo se completa el proceso de clonado y el nuevo volumen está disponible para las conexiones. Puede utilizar ListSyncJobs para ver el progreso de la creación del clon. Los atributos iniciales y la configuración de calidad de servicio del volumen se heredan del volumen que se clona. Puede cambiar esta configuración con Volumen ModificíoVolume.
|
Los volúmenes clonados no heredan pertenencia al grupo de acceso de volúmenes en el volumen de origen. |
Parámetros
Este método tiene los siguientes parámetros de entrada:
| Nombre | Descripción | Tipo | Valor predeterminado | Obligatorio |
|---|---|---|---|---|
acceso |
Acceso permitido para el volumen nuevo. Si no se especifica un valor, el valor de acceso no cambia. Los posibles valores son los siguientes:
|
cadena |
Ninguno |
No |
atributos |
La lista de pares nombre-valor en el formato de objetos JSON. |
Objeto JSON |
Ninguno |
No |
enable512e |
Especifica si el nuevo volumen debe usar la emulación de sector de 512 bytes. Si no se especifica, se utiliza la configuración del volumen que se clona. |
booleano |
Ajuste del volumen original |
No |
EnableSnapMirrorReplication |
Determina si el volumen se puede usar para la replicación con extremos de SnapMirror. Los posibles valores son los siguientes:
|
booleano |
falso |
No |
nombre |
Nombre del nuevo volumen clonado; debe tener entre 1 y 64 caracteres de longitud. |
cadena |
Ninguno |
Sí |
NewAccountID |
AccountID del propietario del nuevo volumen. Si no se especifica, se utiliza el ID de cuenta del propietario del volumen que se va a clonar. |
entero |
ID de cuenta del propietario del volumen original |
No |
NuevoTamaño |
El nuevo tamaño, en bytes. Puede ser mayor o menor que el tamaño del volumen que se clona. Si no se especifica, no se cambia el tamaño del volumen. El tamaño se redondea al tamaño de 1 MB más cercano. |
entero |
Ninguno |
No |
ID de copia Snapshot |
ID de la copia de Snapshot que se utiliza como origen del clon. Si no se proporciona ningún ID, se utiliza el volumen activo actual. |
entero |
Ninguno |
No |
ID de volumen |
ID de volumen del volumen que se va a clonar. |
entero |
Ninguno |
Sí |
Valores devueltos
Este método tiene los siguientes valores devueltos:
Nombre |
Descripción |
Tipo |
Establish asyncHandle |
El valor del mango utilizado para obtener el resultado de la operación. |
entero |
ClonID |
ClonId para el volumen recién clonado. |
entero |
curva |
Los valores de curva de calidad de servicio que se aplican al clon. |
Objeto JSON |
volumen |
Un objeto que contiene información acerca del volumen que se acaba de clonar. |
|
ID de volumen |
VolumeID del volumen que se acaba de clonar. |
entero |
Ejemplo de solicitud
Las solicitudes de este método son similares al ejemplo siguiente:
{
"method": "CloneVolume",
"params": {
"volumeID" : 5,
"name" : "mysqldata-snapshot1",
"access" : "readOnly"
},
"id" : 1
}
Ejemplo de respuesta
Este método devuelve una respuesta similar al siguiente ejemplo:
{
"id": 1,
"result": {
"asyncHandle": 42,
"cloneID": 37,
"volume": {
"access": "readOnly",
"accountID": 1,
"attributes": {},
"blockSize": 4096,
"createTime": "2016-03-31T22:26:03Z",
"deleteTime": "",
"enable512e": true,
"iqn": "iqn.2010-01.com.solidfire:jyay.mysqldata-snapshot1.680",
"name": "mysqldata-snapshot1",
"purgeTime": "",
"qos": {
"burstIOPS": 100,
"burstTime": 60,
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"maxIOPS": 100,
"minIOPS": 50
},
"scsiEUIDeviceID": "6a796179000002a8f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a796179000002a8",
"sliceCount": 0,
"status": "init",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 680,
"volumePairs": []
},
"volumeID": 680
}
}
Nuevo desde la versión
9.6