CloneVolume
Colaboradores
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