Skip to main content
Element Software
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Clonevolume

Colaboradores
PDFs

Você pode usar o CloneVolume método para criar uma cópia de um volume. Este método é assíncrono e pode levar uma quantidade variável de tempo para ser concluído.

O processo de clonagem começa imediatamente quando você faz a CloneVolume solicitação e é representativo do estado do volume quando o método API é emitido. Use GetAsyncResulto método para determinar quando o processo de clonagem está concluído e o novo volume está disponível para conexões. Você pode usar ListSyncJobs para ver o progresso da criação do clone. Os atributos iniciais e as configurações de qualidade do serviço para o volume são herdados do volume que está sendo clonado. Pode alterar estas definições com Modifyvolume.

Observação Os volumes clonados não herdam a associação do grupo de acesso ao volume do volume de origem.

Parâmetros

Este método tem os seguintes parâmetros de entrada:

Nome Descrição Tipo Valor padrão Obrigatório

acesso

Acesso permitido para o novo volume. Se um valor não for especificado, o valor de acesso não será alterado. Valores possíveis:

  • readOnly: (Opcional) somente as operações de leitura são permitidas.

  • readWrite: (Opcional) leituras e gravações são permitidas.

  • locked: (Opcional) não são permitidas leituras ou gravações. Se não for especificado, é utilizado o valor de acesso do volume a clonar.

  • replicationTarget: (Opcional) Identifique um volume como o volume de destino para um conjunto de volumes emparelhados. Se o volume não estiver emparelhado, o estado de acesso é bloqueado.

cadeia de carateres

Nenhum

Não

atributos

Lista de pares nome-valor no formato de objeto JSON.

Objeto JSON

Nenhum

Não

enable512e

Especifica se o novo volume deve usar emulação de setor de 512 bytes. Se não for especificado, é utilizada a definição do volume a clonar.

booleano

Definição do volume original

Não

EnableSnapMirrorReplication

Determina se o volume pode ser usado para replicação com endpoints SnapMirror. Valores possíveis:

  • verdadeiro

  • falso

booleano

falso

Não

nome

Nome do novo volume clonado; deve ter 1 a 64 carateres de comprimento.

cadeia de carateres

Nenhum

Sim

NewAccountID

AccountID para o proprietário do novo volume. Se não for especificado, o AccountID do proprietário do volume que está sendo clonado é usado.

número inteiro

AccountID do proprietário do volume original

Não

NewSize

Novo tamanho do volume, em bytes. Pode ser maior ou menor do que o tamanho do volume que está sendo clonado. Se não for especificado, o tamanho do volume não será alterado. O tamanho é arredondado para o tamanho mais próximo de 1MB mm.

número inteiro

Nenhum

Não

SnapshotID

ID do instantâneo que é usado como a origem do clone. Se não for fornecida nenhuma ID, é utilizado o volume ativo atual.

número inteiro

Nenhum

Não

VolumeID

VolumeID para o volume a clonar.

número inteiro

Nenhum

Sim

Valores de retorno

Este método tem os seguintes valores de retorno:

Nome

Descrição

Tipo

AsyncHandle

O valor do manípulo utilizado para obter o resultado da operação.

número inteiro

CloneID

O cloneID para o volume recém clonado.

número inteiro

curva

Os valores de curva de QoS aplicados ao clone.

Objeto JSON

volume

Um objeto contendo informações sobre o volume recém clonado.

volume

VolumeID

VolumeID para o volume recém clonado.

número inteiro

Exemplo de solicitação

As solicitações para este método são semelhantes ao seguinte exemplo:

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

Exemplo de resposta

Este método retorna uma resposta semelhante ao seguinte exemplo:

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

Novo desde a versão

9,6

Encontre mais informações