ModifyVolumes
Sugerir alterações
PDFs
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:
-
Aumente o tamanho do volume com o acesso de replicationTarget.
-
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.
|
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:
|
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:
|
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:
|
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:
|
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:
|
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