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.

CreateGroupSnapshot

Colaboradores
PDFs

Você pode usar CreateGroupSnapshot para criar uma cópia pontual de um grupo de volumes.

Você pode usar esse snapshot mais tarde como um backup ou reversão para garantir que os dados no grupo de volumes sejam consistentes para o ponto no tempo em que você criou o snapshot.

CLUSTER_FULLNESS

Observação Você pode criar snapshots se a plenitude do cluster estiver na fase 1, 2 ou 3. Não é possível criar instantâneos quando a plenitude do cluster atinge a fase 4 ou 5.

Parâmetros

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

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

attributes

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

Objeto JSON

Nenhum

Não

enableRemoteReplication

Especifica se o instantâneo será replicado para o armazenamento remoto ou não. Valores possíveis:

  • true: O instantâneo será replicado para o armazenamento remoto.

  • false: O instantâneo não será replicado para o armazenamento remoto.

booleano

falso

Não

ensureSerialCreation

Especifica que o snapshot não deve ser criado se uma replicação anterior de snapshot estiver em andamento. Os valores possíveis são:

  • true: Isso garante que apenas um snapshot esteja sendo replicado de cada vez. A criação de um novo snapshot falhará se uma replicação anterior de snapshot ainda estiver em andamento.

  • false: Predefinição. Esta criação de instantâneos é permitida se outra replicação de instantâneos ainda estiver em andamento.

booleano

false

Não

expirationTime

Especifique o tempo após o qual o instantâneo pode ser removido. Não pode ser utilizado com retention. Se nenhuma das expirationTime`opções , ou `retention for especificada, a captura instantânea não expirará. O formato de hora é uma string de data ISO 8601 para expiração baseada em tempo, caso contrário não expirará. Um valor de null faz com que o instantâneo seja mantido permanentemente. Um valor de fifo faz com que o snapshot seja preservado em uma base de primeiro em primeiro em primeiro em primeiro em primeiro em primeiro em primeiro lugar (FIFO), em relação a outros snapshots FIFO no volume. A API falhará se nenhum espaço FIFO estiver disponível.

String de data ISO 8601

Nenhum

Não

name

O nome do instantâneo do grupo. Se não for introduzido nenhum nome, é utilizada a data e a hora em que o instantâneo do grupo foi tirado. O comprimento máximo permitido do nome é de 255 carateres.

cadeia de carateres

Nenhum

Não

retention

Este parâmetro é o mesmo que o expirationTime parâmetro, exceto que o formato de hora é HH:mm:ss. Se não expirationTime forem especificados nem retention, o instantâneo não expirará.

cadeia de carateres

Nenhum

Não

snapMirrorLabel

O rótulo usado pelo software SnapMirror para especificar a política de retenção de snapshot em um endpoint do SnapMirror.

cadeia de carateres

Nenhum

Não

volumes

ID exclusiva da imagem de volume a partir da qual copiar.

Array volumeID

Nenhum

Sim

Valores de retorno

Este método tem os seguintes valores de retorno:

Nome

Descrição

Tipo

membros

Lista de checksum, volumeIDs e snapshotIDs para cada membro do grupo. Valores válidos:

  • Checksum: Uma pequena representação de cadeia de carateres dos dados no instantâneo armazenado. Esta soma de verificação pode ser usada mais tarde para comparar outros instantâneos para detetar erros nos dados. (string)

  • SnapshotID: ID exclusivo de um instantâneo a partir do qual o novo instantâneo é feito. O snapshotID deve ser de um instantâneo no volume dado. (número inteiro)

  • VolumeID: O ID do volume de origem para o instantâneo. (número inteiro)

Array de objetos JSON

GroupSnapshotID

ID exclusiva do novo instantâneo do grupo.

ID do GroupSnapshot

GroupSnapshot

Objeto contendo informações sobre o instantâneo de grupo recém-criado.

GroupSnapshot

Exemplo de solicitação

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

{
   "method": "CreateGroupSnapshot",
   "params": {
      "volumes": [1,2]
   },
   "id": 1
}

Exemplo de resposta

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

{
  "id": 1,
  "result": {
    "groupSnapshot": {
      "attributes": {},
      "createTime": "2016-04-04T22:43:29Z",
      "groupSnapshotID": 45,
      "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
      "members": [
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3323,
          "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
          "status": "done",
          "totalSize": 5000658944,
          "virtualVolumeID": null,
          "volumeID": 1
        },
        {
          "attributes": {},
          "checksum": "0x0",
          "createTime": "2016-04-04T22:43:29Z",
          "enableRemoteReplication": false,
          "expirationReason": "None",
          "expirationTime": null,
          "groupID": 45,
          "groupSnapshotUUID": "473b78a3-ef85-4541-9438-077306b2d3ca",
          "name": "2016-04-04T22:43:29Z",
          "snapshotID": 3324,
          "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
          "status": "done",
          "totalSize": 6001000448,
          "virtualVolumeID": null,
          "volumeID": 2
        }
      ],
      "name": "2016-04-04T22:43:29Z",
      "status": "done"
    },
    "groupSnapshotID": 45,
    "members": [
      {
        "checksum": "0x0",
        "snapshotID": 3323,
        "snapshotUUID": "7599f200-0092-4b41-b362-c431551937d1",
        "volumeID": 1
      },
      {
        "checksum": "0x0",
        "snapshotID": 3324,
        "snapshotUUID": "a0776a48-4142-451f-84a6-5315dc37911b",
        "volumeID": 2
      }
    ]
  }
}

Novo desde a versão

9,6