Crea volume
Puoi usare il CreateVolume metodo per creare un nuovo volume vuoto sul cluster. Non appena il volume viene creato, è disponibile per la connessione tramite iSCSI.
I volumi creati senza valori QoS specificati utilizzano i valori predefiniti. È possibile visualizzare i valori predefiniti per un volume utilizzando GetDefaultQoS metodo.
Parametri
Questo metodo ha i seguenti parametri di input:
| Nome | Descrizione | Tipo | Valore predefinito | Necessario |
|---|---|---|---|---|
|
Modalità di accesso al volume. Se questo parametro è incluso, l'unico valore supportato è |
corda |
Nessuno |
NO |
|
L'ID dell'account proprietario di questo volume. |
intero |
Nessuno |
SÌ |
|
Associare il volume al criterio QoS specificato. Valori possibili:
|
booleano |
VERO |
NO |
|
Elenco di coppie nome-valore nel formato oggetto JSON. La dimensione totale dell'attributo deve essere inferiore a 1000B o 1KB, inclusi i caratteri di formattazione JSON. |
Oggetto JSON |
Nessuno |
NO |
|
Impedisce lo spostamento di un volume durante il bilanciamento del carico con IOPS effettivi. Questa impostazione è disponibile a partire da Element 12.8 ed è efficace solo quando"VolumeLoadBalanceOnActualIOPS" è abilitato. Valori possibili:
Nota: il bilanciamento per l'alta disponibilità (guasto del nodo) ha la precedenza su |
booleano |
falso |
NO |
|
Abilita l'emulazione del settore da 512 byte. Valori possibili:
|
booleano |
Nessuno |
SÌ |
|
Determina se il volume può essere utilizzato per la replica con endpoint SnapMirror . Valori possibili:
|
booleano |
falso |
NO |
|
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 snapshot disponibili su un volume. Utilizzare questa opzione per limitare il consumo di snapshot FIFO degli slot snapshot disponibili. Se omesso, il valore predefinito è 24. |
intero |
24 |
NO |
|
Specifica il numero minimo di slot snapshot First-In-First-Out (FIFO) riservati dal volume. Ciò garantisce che se si utilizzano sia snapshot FIFO che snapshot non FIFO su un volume, gli snapshot non FIFO non consumino involontariamente troppi slot FIFO. Garantisce inoltre che almeno questo numero di snapshot FIFO siano sempre disponibili. Poiché gli snapshot FIFO e non FIFO condividono lo stesso pool, |
intero |
0 |
NO |
|
Nome del gruppo di accesso al volume (può essere specificato dall'utente). Non è obbligatorio che sia unico, ma è consigliato. Deve essere lungo da 1 a 64 caratteri. |
corda |
Nessuno |
SÌ |
|
Impostazioni iniziali della qualità del servizio per questo volume. Se non ne viene specificato alcuno, vengono utilizzati i valori predefiniti. Valori possibili:
|
Oggetto QoS |
Nessuno |
NO |
|
ID del criterio le cui impostazioni QoS devono essere applicate ai volumi specificati. Questo parametro è mutuamente esclusivo con il |
intero |
Nessuno |
NO |
|
Dimensione totale del volume, in byte. La dimensione è arrotondata al megabyte più vicino. |
intero |
Nessuno |
SÌ |
Valori di ritorno
Questo metodo ha i seguenti valori di ritorno:
| Nome | Descrizione | Tipo |
|---|---|---|
volume |
Oggetto contenente informazioni sul volume appena creato. |
|
ID volume |
VolumeID per il volume appena creato. |
intero |
curva |
La curva è un insieme di coppie chiave-valore. Le chiavi sono le dimensioni I/O in byte. I valori rappresentano il costo di esecuzione di un IOP a una dimensione I/O specifica. La curva è calcolata in relazione a un'operazione da 4096 byte impostata a 100 IOPS. |
Oggetto JSON |
Richiedi esempio
Le richieste per questo metodo sono simili al seguente esempio:
{
"method": "CreateVolume",
"params": {
"name": "testit",
"accountID": 22,
"dontMoveForIopsRebalance": true,
"totalSize": 100000000000,
"enable512e": false,
"attributes": {},
"qos": {
"minIOPS": 500,
"maxIOPS": 27000,
"burstIOPS": 27000,
"burstTime": 60
}
},
"id": 1
}
Esempio di risposta
Questo metodo restituisce una risposta simile al seguente esempio:
{
"id": 1,
"result": {
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500,
"4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"volume": {
"access": "readWrite",
"accountID": 22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-02T13:03:02Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": true,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
"lastAccessTime": null,
"lastAccessTimeIO": null,
"minFifoSize": 0,
"name": "testit",
"previousProtectionScheme": null,
"purgeTime": "",
"qos": {
"burstIOPS": 27000,
"burstTime": 60,
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500,
"4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"maxIOPS": 27000,
"minIOPS": 500
},
"qosPolicyID": null,
"scsiEUIDeviceID": "3365657500000140f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000003365657500000140",
"sliceCount": 0,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeConsistencyGroupUUID": "8ed68e57-13ee-47df-8381-29b125142718",
"volumeID": 320,
"volumePairs": [],
"volumeUUID": "e0e2c938-4ecd-4de9-a1be-f6b17c93ce5d"
},
"volumeID": 320
}
}
Nuovo dalla versione
9,6