ModificyVolumes
Sugerir cambios
PDF
Puede utilizar el ModifyVolumes método para configurar hasta 500 volúmenes existentes a la vez. Los cambios se realizan inmediatamente. Si ModifyVolumes no se puede modificar ninguno de los volúmenes especificados, no se modifica ninguno de los volúmenes especificados.
Si no se especifican los valores de calidad de servicio al modificar volúmenes, los valores de calidad de servicio de cada volumen permanecen sin cambios. Puede recuperar los valores de calidad de servicio predeterminados para un volumen recién creado mediante la ejecución de GetDefaultQoS método.
Cuando se necesitan aumentar los volúmenes de tamaño que se están replicando, hágalo en el siguiente orden para evitar errores de replicación:
-
Aumente el tamaño del volumen con replicationTarget Access.
-
Aumente el tamaño del origen o del volumen con el acceso READWRITE.
Asegúrese de que los volúmenes de destino y origen tengan el mismo tamaño.
|
Si cambia el estado de acceso a Locked o replicationTarget, se finalizan todas las conexiones iSCSI existentes. |
Parámetros
Este método tiene los siguientes parámetros de entrada:
Nombre |
Descripción |
Tipo |
Valor predeterminado |
Obligatorio |
acceso |
Acceso permitido para los volúmenes. Los posibles valores son los siguientes:
|
cadena |
Ninguno |
No |
ID de cuenta |
El ID de cuenta a la que se reasignan los volúmenes. Si no se especifica ninguno, se utiliza el nombre de cuenta anterior. |
entero |
Ninguno |
No |
AsociateWithQoSPolicy |
Asocie el volumen con la política de calidad de servicio especificada. Los posibles valores son los siguientes:
|
booleano |
Ninguno |
No |
atributos |
La lista de pares nombre-valor en el formato de objetos JSON. |
Objeto JSON |
Ninguno |
No |
CreateTime |
Una cadena de fecha ISO 8601 que se establecerá como fecha de creación del nuevo volumen. Requerido si setCreateTime se establece en TRUE. |
Cadena ISO 8601 |
Ninguno |
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 |
Tamaño 50 |
Especifica el número máximo de instantáneas de primera entrada y salida (FIFO) admitidas por el volumen. Tenga en cuenta que las instantáneas FIFO y no FIFO utilizan el mismo pool de ranuras de instantánea disponibles en un volumen. Utilice esta opción para limitar el consumo de instantáneas FIFO de las ranuras de instantánea disponibles. Tenga en cuenta que no puede modificar este valor para que sea inferior al recuento de instantáneas FIFO actual. |
entero |
Ninguno |
No |
MinFioSize |
Especifica el número de ranuras de instantánea reservadas sólo para las instantáneas primero en salir (FIFO). Puesto que las instantáneas FIFO y no FIFO comparten la misma agrupación, el parámetro minFifoSize reduce el número total de posibles instantáneas no FIFO en la misma cantidad. Tenga en cuenta que no puede modificar este valor para que entre en conflicto con el recuento de instantáneas no FIFO actual. |
entero |
Ninguno |
No |
modo |
Modo de replicación del volumen. Los posibles valores son los siguientes:
|
cadena |
Ninguno |
No |
calidad de servicio |
La nueva configuración de calidad de servicio de los volúmenes. Si no se especifica, la configuración de calidad de servicio no se modifica. Los posibles valores son los siguientes:
|
Ninguno |
No |
|
QosPolicyID |
El ID de la política cuya configuración de calidad de servicio debe aplicarse a los volúmenes especificados. Este parámetro es mutuamente exclusivo con qos. |
entero |
Ninguno |
No |
SetCreateTime |
Establezca esta opción en true para cambiar la fecha registrada de creación del volumen. |
booleano |
Ninguno |
No |
Tamaño total |
El tamaño nuevo de los volúmenes en bytes. 1000000000 es igual a 1 GB. El tamaño se redondea hasta el megabyte más cercano. Este parámetro solo se puede usar para aumentar el tamaño de un volumen. |
entero |
Ninguno |
No |
ID de volumen |
Una lista de identificadores de volumen de los volúmenes que se van a modificar. |
matriz en números enteros |
Ninguno |
Sí |
Valor de retorno
Este método tiene el siguiente valor devuelto:
Nombre |
Descripción |
Tipo |
volumen |
Una cabina de objetos que contienen información sobre cada volumen recién modificado. |
volumen cabina |
Ejemplo de solicitud
Las solicitudes de este método son similares al ejemplo siguiente:
{
"method": "ModifyVolumes",
"params": {
"volumeIDs": [2,3],
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"qos": {
"minIOPS": 50,
"maxIOPS": 100,
"burstIOPS": 150,
"burstTime": 60
},
"access" : "replicationTarget"
},
"totalSize": 80000000000,
"id": 1
}
Ejemplo de respuesta
Este método devuelve una respuesta similar al siguiente ejemplo:
{
"id": 1,
"result": {
"volumes": [
{
"access": "replicationTarget",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-04-06T17:25:13Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:jo73.2",
"name": "doctest1",
"purgeTime": "",
"qos": {
"burstIOPS": 150,
"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": "6a6f373300000002f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a6f373300000002",
"sliceCount": 1,
"status": "active",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 2,
"volumePairs": []
},
{
"access": "replicationTarget",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-04-06T17:26:31Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:jo73.3",
"name": "doctest2",
"purgeTime": "",
"qos": {
"burstIOPS": 150,
"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": "6a6f373300000003f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a6f373300000003",
"sliceCount": 1,
"status": "active",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 3,
"volumePairs": []
}
]
}
}
Nuevo desde la versión
9.6