ModifyVolumes
Suggerisci modifiche
PDF
È possibile utilizzare questo ModifyVolumes metodo per configurare fino a 500 volumi esistenti alla volta. Le modifiche vengono eseguite immediatamente. Se ModifyVolumes non è possibile modificare uno dei volumi specificati, nessuno dei volumi specificati viene modificato.
Se non si specificano i valori QoS quando si modificano i volumi, i valori QoS per ciascun volume rimangono invariati. È possibile recuperare i valori QoS predefiniti per un volume appena creato eseguendo il GetDefaultQoS metodo.
Per evitare errori di replica, è necessario aumentare le dimensioni dei volumi che vengono replicati nel seguente ordine:
-
Aumentare le dimensioni del volume con l'accesso ReplicationTarget.
-
Aumentare le dimensioni dell'origine o del volume con l'accesso in lettura/scrittura.
Assicurarsi che i volumi di destinazione e di origine abbiano le stesse dimensioni.
|
Se si imposta lo stato di accesso su Locked o ReplicationTarget, tutte le connessioni iSCSI esistenti vengono interrotte. |
Parametri
Questo metodo ha i seguenti parametri di input:
Nome |
Descrizione |
Tipo |
Valore predefinito |
Obbligatorio |
accesso |
Accesso consentito per i volumi. Valori possibili:
|
stringa |
Nessuno |
No |
ID account |
L'ID account a cui vengono riassegnati i volumi. Se non viene specificato alcun valore, viene utilizzato il nome dell'account precedente. |
intero |
Nessuno |
No |
AssociateWithQoSPolicy |
Associare il volume al criterio QoS specificato. Valori possibili:
|
booleano |
Nessuno |
No |
attributi |
Elenco delle coppie nome-valore nel formato oggetto JSON. |
Oggetto JSON |
Nessuno |
No |
CreateTime |
Stringa di dati ISO 8601 da impostare come data di creazione del nuovo volume. Obbligatorio se setCreateTime è impostato su true. |
Stringa ISO 8601 |
Nessuno |
No |
EnableSnapMirrorReplication |
Determina se il volume può essere utilizzato per la replica con gli endpoint SnapMirror. Valori possibili:
|
booleano |
falso |
No |
FifoSize |
Specifica il numero massimo di snapshot first-in-first-out (FIFO) supportati dal volume. Si noti che gli snapshot FIFO e non FIFO utilizzano entrambi lo stesso pool di slot di snapshot disponibili su un volume. Utilizzare questa opzione per limitare il consumo di snapshot FIFO degli slot snapshot disponibili. Si noti che non è possibile modificare questo valore in modo che sia inferiore al numero corrente di snapshot FIFO. |
intero |
Nessuno |
No |
MinFifoSize |
Specifica il numero di slot di snapshot riservati solo per le istantanee FIFO (first-in-first-out). Poiché le snapshot FIFO e non FIFO condividono lo stesso pool, il parametro minFifuoSize riduce il numero totale di possibili snapshot non FIFO della stessa quantità. Si noti che non è possibile modificare questo valore in modo che sia in conflitto con il numero corrente di snapshot non FIFO. |
intero |
Nessuno |
No |
modalità |
Modalità di replica del volume. Valori possibili:
|
stringa |
Nessuno |
No |
qos |
Le nuove impostazioni della qualità del servizio per i volumi. Se non specificato, le impostazioni QoS non vengono modificate. Valori possibili:
|
Nessuno |
No |
|
QosPolicyID |
ID del criterio le cui impostazioni QoS devono essere applicate ai volumi specificati. Questo parametro si esclude a vicenda con il parametro qos. |
intero |
Nessuno |
No |
SetCreateTime |
Impostare su vero per modificare la data di creazione del volume registrata. |
booleano |
Nessuno |
No |
TotalSize (dimensioni totale) |
La nuova dimensione dei volumi in byte. 1000000000 equivale a 1 GB. Le dimensioni vengono arrotondate al megabyte più vicino. Questo parametro può essere utilizzato solo per aumentare le dimensioni di un volume. |
intero |
Nessuno |
No |
ID volume |
Un elenco di volumeID per i volumi da modificare. |
array intero |
Nessuno |
Sì |
Valore restituito
Questo metodo ha il seguente valore restituito:
Nome |
Descrizione |
Tipo |
volume |
Matrice di oggetti contenente informazioni su ciascun volume appena modificato. |
volume array |
Esempio di richiesta
Le richieste per questo metodo sono simili all'esempio seguente:
{
"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
}
Esempio di risposta
Questo metodo restituisce una risposta simile all'esempio seguente:
{
"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": []
}
]
}
}
Novità dalla versione
9,6