Skip to main content
Element Software
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.

ModifyVolumes

Colaboradores

Você pode usar o ModifyVolumes método para configurar até 500 volumes existentes ao mesmo tempo. As alterações ocorrem imediatamente. Se ModifyVolumes não conseguir modificar qualquer um dos volumes especificados, nenhum dos volumes especificados será alterado.

Se você não especificar valores de QoS ao modificar volumes, os valores de QoS para cada volume permanecerão inalterados. Você pode recuperar valores de QoS padrão para um volume recém-criado executando o GetDefaultQoS método.

Quando for necessário aumentar os volumes de tamanho que estão sendo replicados, faça isso na seguinte ordem para evitar erros de replicação:

  1. Aumente o tamanho do volume com o acesso de replicationTarget.

  2. Aumente o tamanho da fonte ou do volume com o acesso readWrite.

Certifique-se de que os volumes de destino e de origem tenham o mesmo tamanho.

Observação Se você alterar o status de acesso para bloqueado ou replicationTarget, todas as conexões iSCSI existentes serão encerradas.

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 os volumes. Valores possíveis:

  • readOnly: Só são permitidas operações de leitura.

  • readWrite: Leituras e gravações são permitidas.

  • locked: Não são permitidas leituras ou gravações. Se não for especificado, o valor de acesso não muda.

  • replicationTarget: Identificar um volume como o volume alvo para um conjunto de volumes emparelhado. Se o volume não estiver emparelhado, o estado de acesso é bloqueado. Se um valor não for especificado, o valor de acesso não será alterado.

cadeia de carateres

Nenhum

Não

ID Contabilística

O AccountID ao qual os volumes são reatribuídos. Se nenhum for especificado, o nome da conta anterior será usado.

número inteiro

Nenhum

Não

AssociateWithQoSPolicy

Associe o volume à política de QoS especificada. Valores possíveis:

  • Verdadeiro: Associe o volume à política de QoS especificada no parâmetro QoSPolicyID.

  • False: Não associe o volume à política de QoS especificada no parâmetro QoSPolicyID. Quando falsa, qualquer associação de política existente é removida, independentemente de você especificar uma política de QoS no parâmetro QoSPolicy.

booleano

Nenhum

Não

atributos

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

Objeto JSON

Nenhum

Não

CreateTime

Uma string de data ISO 8601 para definir como a nova data de criação de volume. Necessário se setCreateTime estiver definido como true.

ISO 8601 string

Nenhum

Não

EnableSnapMirrorReplication

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

  • true

  • false

booleano

falso

Não

FifoSize

Especifica o número máximo de instantâneos First-in-First-out (FIFO) suportados pelo volume. Observe que os snapshots FIFO e não FIFO usam o mesmo pool de slots de snapshot disponíveis em um volume. Use esta opção para limitar o consumo de snapshot FIFO dos slots de snapshot disponíveis. Note que não é possível modificar este valor para ser inferior à contagem de instantâneos FIFO atual.

número inteiro

Nenhum

Não

MinFifoSize

Especifica o número de slots de snapshot que são reservados apenas para snapshots First-in-First-out (FIFO). Como os snapshots FIFO e não FIFO compartilham o mesmo pool, o parâmetro minFfoSize reduz o número total de possíveis snapshots não FIFO pela mesma quantidade. Observe que você não pode modificar esse valor para que ele fique em conflito com a contagem de instantâneos não FIFO atual.

número inteiro

Nenhum

Não

modo

Modo de replicação de volume. Valores possíveis:

  • asynch: Aguarda que o sistema reconheça que os dados são armazenados na fonte antes de gravar no destino.

  • sync: Não espera que a confirmação da transmissão de dados da origem comece a gravar dados no destino.

cadeia de carateres

Nenhum

Não

qos

As novas configurações de qualidade de serviço para os volumes. Se não for especificado, as definições de QoS não são alteradas. Valores possíveis:

  • minIOPS

  • maxIOPS

  • burstIOPS

QoS

Nenhum

Não

QosPolicyID

O ID da diretiva cujas configurações de QoS devem ser aplicadas aos volumes especificados. Este parâmetro é mutuamente exclusivo com o parâmetro qos.

número inteiro

Nenhum

Não

SetCreateTime

Defina como True (verdadeiro) para alterar a data gravada da criação do volume.

booleano

Nenhum

Não

Totalizar tamanho

O novo tamanho dos volumes em bytes. 1000000000 é igual a 1GB. O tamanho é arredondado para cima até o megabyte mais próximo em tamanho. Este parâmetro só pode ser utilizado para aumentar o tamanho de um volume.

número inteiro

Nenhum

Não

VolumeIDs

Uma lista de volumeIDs para os volumes a serem modificados.

array inteiro

Nenhum

Sim

Valor de retorno

Este método tem o seguinte valor de retorno:

Nome

Descrição

Tipo

volume

Um array de objetos contendo informações sobre cada volume recém-modificado.

volume array

Exemplo de solicitação

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

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

Exemplo de resposta

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

{
  "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": []
      }
    ]
  }
}

Novo desde a versão

9,6

Encontre mais informações