IniciarLeituraEmMassa
Você pode usar o StartBulkVolumeRead Método para iniciar uma sessão de leitura em massa de um volume especificado.
Apenas dois processos de grande volume podem ser executados simultaneamente em um mesmo volume. Ao inicializar a sessão, os dados são lidos de um volume de armazenamento SolidFire para serem armazenados em uma fonte de backup externa. Os dados externos são acessados por um servidor web executado em um nó de armazenamento Element. As informações de interação com o servidor para acesso a dados externos são transmitidas por um script executado no sistema de armazenamento.
No início de uma operação de leitura em massa de um volume, é criado um instantâneo do volume, que é excluído quando a leitura é concluída. Você também pode ler um instantâneo do volume inserindo o ID do instantâneo como parâmetro. Ao ler um snapshot anterior, o sistema não cria um novo snapshot do volume, nem exclui o snapshot anterior quando a leitura é concluída.
|
|
Este processo cria um novo instantâneo caso o ID de um instantâneo existente não seja fornecido. É possível criar snapshots se o nível de preenchimento do cluster estiver no estágio 2 ou 3. Não são criados snapshots quando o nível de preenchimento do cluster está no estágio 4 ou 5. |
Parâmetros
Este método possui os seguintes parâmetros de entrada:
| Nome | Descrição | Tipo | Valor padrão | Obrigatório |
|---|---|---|---|---|
formatar |
O formato dos dados de volume. Pode ser qualquer uma das duas opções:
|
corda |
Nenhum |
Sim |
ID do volume |
O ID do volume a ser lido. |
inteiro |
Nenhum |
Sim |
ID do instantâneo |
O ID de um snapshot criado anteriormente, usado para leituras em massa de volumes. Caso nenhum ID seja inserido, será criada uma imagem instantânea do volume ativo atual. |
inteiro |
Nenhum |
Não |
roteiro |
O nome de um script executável. Caso nenhum nome de script seja fornecido, a chave e o URL serão necessários para acessar os nós de armazenamento do Element. O script é executado no nó primário, e a chave e o URL são retornados ao script para que o servidor web local possa ser contatado. |
corda |
Nenhum |
Não |
Parâmetros do script |
Parâmetros JSON a serem passados para o script. |
objeto JSON |
Nenhum |
Não |
atributos |
Lista de pares nome-valor no formato de objeto JSON. "Saber mais". |
objeto JSON |
Nenhum |
Não |
Valores de retorno
Este método tem os seguintes valores de retorno:
Nome |
Descrição |
Tipo |
manipulador assíncrono |
O ID do processo assíncrono que deve ser verificado quanto à conclusão. |
inteiro |
chave |
Chave opaca que identifica exclusivamente a sessão. |
corda |
URL |
URL para acessar o servidor web do nó. |
corda |
Exemplo de solicitação
As solicitações para esse método são semelhantes ao seguinte exemplo:
{
"method": "StartBulkVolumeRead",
"params": {
"volumeID" : 5,
"format" : "native",
"snapshotID" : 2
},
"id": 1
}
Exemplo de resposta
Este método retorna uma resposta semelhante ao exemplo a seguir:
{
"id" : 1,
"result" : {
"asyncHandle" : 1,
"key" : "11eed8f086539205beeaadd981aad130",
"url" : "https://127.0.0.1:44000/"
}
}
Novidade desde a versão
9,6