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.

CloneVolume

Collaboratori

È possibile utilizzare il CloneVolume metodo per creare una copia di un volume. Questo metodo è asincrono e potrebbe richiedere un periodo di tempo variabile.

Il processo di cloning inizia immediatamente quando si effettua la CloneVolume richiesta ed è rappresentativo dello stato del volume al momento dell'emissione del metodo API. Questo GetAsyncResult metodo consente di determinare quando il processo di cloning è completo e il nuovo volume è disponibile per le connessioni. È possibile utilizzare ListSyncJobs per visualizzare l'avanzamento della creazione del clone. Gli attributi iniziali e le impostazioni della qualità del servizio per il volume vengono ereditati dal volume clonato. È possibile modificare queste impostazioni con ModifyVolume.

Nota I volumi clonati non ereditano l'appartenenza al gruppo di accesso al volume dal volume di origine.

Parametri

Questo metodo ha i seguenti parametri di input:

Nome Descrizione Tipo Valore predefinito Obbligatorio

accesso

Accesso consentito per il nuovo volume. Se non viene specificato alcun valore, il valore di accesso non cambia. Valori possibili:

  • readOnly: (Opzionale) sono consentite solo operazioni di lettura.

  • readWrite: (Opzionale) sono consentite letture e scritture.

  • locked: (Opzionale) non sono consentite letture o scritture. Se non specificato, viene utilizzato il valore di accesso del volume clonato.

  • replicationTarget: (Opzionale) 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.

stringa

Nessuno

No

attributi

Elenco delle coppie nome-valore nel formato oggetto JSON.

Oggetto JSON

Nessuno

No

enable512e

Specifica se il nuovo volume deve utilizzare l'emulazione di settore a 512 byte. Se non specificato, viene utilizzata l'impostazione del volume clonato.

booleano

Impostazione del volume originale

No

EnableSnapMirrorReplication

Determina se il volume può essere utilizzato per la replica con gli endpoint SnapMirror. Valori possibili:

  • vero

  • falso

booleano

falso

No

nome

Nome del nuovo volume clonato; deve contenere da 1 a 64 caratteri.

stringa

Nessuno

NewAccountID

AccountID per il proprietario del nuovo volume. Se non specificato, viene utilizzato l'AccountID del proprietario del volume clonato.

intero

AccountID del proprietario del volume originale

No

NewSize

Nuove dimensioni del volume, in byte. Potrebbe essere maggiore o minore della dimensione del volume clonato. Se non specificato, le dimensioni del volume non vengono modificate. La dimensione viene arrotondata alla dimensione più vicina di 1 MB.

intero

Nessuno

No

SnapshotID

ID dello snapshot utilizzato come origine del clone. Se non viene fornito alcun ID, viene utilizzato il volume attivo corrente.

intero

Nessuno

No

ID volume

VolumeID per il volume da clonare.

intero

Nessuno

Valori restituiti

Questo metodo ha i seguenti valori restituiti:

Nome

Descrizione

Tipo

AsyncHandle

Il valore handle utilizzato per ottenere il risultato dell'operazione.

intero

ID cloneID

Il cloneID per il volume appena clonato.

intero

curva

I valori della curva QoS applicati al clone.

Oggetto JSON

volume

Oggetto contenente informazioni sul volume appena clonato.

ID volume

VolumeID per il volume appena clonato.

intero

Esempio di richiesta

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

{
   "method": "CloneVolume",
   "params": {
      "volumeID" : 5,
      "name"  : "mysqldata-snapshot1",
      "access" : "readOnly"
   },
   "id" : 1
}

Esempio di risposta

Questo metodo restituisce una risposta simile all'esempio seguente:

{
  "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
  }
}

Novità dalla versione

9,6

Trova ulteriori informazioni