Skip to main content
Element Software
12.5
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

ModifyVolume

Collaboratori
PDF

È possibile utilizzare il ModifyVolume metodo per modificare le impostazioni di un volume esistente. È possibile apportare modifiche a un volume alla volta e le modifiche vengono eseguite immediatamente.

Se non si specificano i valori QoS quando si modifica un volume, questi rimangono gli stessi di prima della modifica. È possibile recuperare i valori QoS predefiniti per un volume appena creato eseguendo il GetDefaultQoS metodo.

Per evitare errori di replica, è necessario aumentare le dimensioni di un volume da replicare nel seguente ordine:

  1. Aumentare le dimensioni del volume con l'accesso ReplicationTarget.

  2. 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.

Nota 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

ID volume

L'ID volume per il volume da modificare.

intero

Nessuno

Sì

accesso

Accesso consentito per il volume. Valori possibili:

  • readOnly: Sono consentite solo operazioni di lettura.

  • readWrite: Sono consentite letture e scritture.

  • locked: Non sono consentite letture o scritture. Se non specificato, il valore di accesso non cambia.

  • replicationTarget: Consente di identificare un volume come volume di destinazione per un set di volumi associati. Se il volume non è associato, lo stato di accesso è bloccato. Se non viene specificato alcun valore, il valore di accesso non cambia.

  • snapMirrorTarget: Consente di identificare un volume come volume di destinazione per la replica SnapMirror.

stringa

Nessuno

No

ID account

L'ID account a cui viene riassegnato il volume. 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:

  • true: Associare il volume al criterio QoS specificato nel parametro QoSPolicyID.

  • false: Non associare il volume al criterio QoS specificato nel parametro QoSPolicyID. Se false, qualsiasi associazione di policy esistente viene rimossa, indipendentemente dal fatto che si specifichi o meno un policy QoS nel parametro QoSPolicy.

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:

  • true

  • false

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:

  • asynch: Attende che il sistema riconosca che i dati sono memorizzati sulla sorgente prima di scrivere sulla destinazione.

  • sync: Non attende che la conferma della trasmissione dei dati dall'origine inizi a scrivere i dati sulla destinazione.

stringa

Nessuno

No

qos

Le nuove impostazioni della qualità del servizio per questo volume. Se non specificato, le impostazioni QoS non vengono modificate. Valori possibili:

  • minIOPS

  • maxIOPS

  • burstIOPS

QoS

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 del volume 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

Valore restituito

Questo metodo ha il seguente valore restituito:

Nome

Descrizione

Tipo

volume

Oggetto contenente informazioni sul volume appena modificato.

volume

Esempio di richiesta

Le richieste per questo metodo sono simili all'esempio seguente:

{
  "method": "ModifyVolume",
  "params": {
     "volumeID": 5,
     "attributes": {
        "name1": "value1",
        "name2": "value2",
        "name3": "value3"
     },
     "qos": {
        "minIOPS": 60,
        "maxIOPS": 100,
        "burstIOPS": 150,
        "burstTime": 60
     },
      "access" :"readWrite"
     },
      "totalSize": 20000000000,
     "id": 1
}

Esempio di risposta

Questo metodo restituisce una risposta simile all'esempio seguente:

{
  "id": 1,
  "result": {
      "volume": {
          "access": "readWrite",
          "accountID": 1,
          "attributes": {
              "name1": "value1",
              "name2": "value2",
              "name3": "value3"
          },
          "blockSize": 4096,
          "createTime": "2016-03-28T16:16:13Z",
          "deleteTime": "",
          "enable512e": true,
          "iqn": "iqn.2010-01.com.solidfire:jyay.1459181777648.5",
          "name": "1459181777648",
          "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": 60
          },
          "scsiEUIDeviceID": "6a79617900000005f47acc0100000000",
          "scsiNAADeviceID": "6f47acc1000000006a79617900000005",
          "sliceCount": 1,
          "status": "active",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeAccessGroups": [
              1
          ],
          "volumeID": 5,
          "volumePairs": []
      }
  }
}

Novità dalla versione

9,6

Trova ulteriori informazioni

GetDefaultQoS