Antes de Iniciar

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

Efetue login no IBM Cloud®.

ibmcloud login --sso -a cloud.ibm.com

Esse comando retorna uma URL e solicita uma senha. Acesse essa URL em seu navegador e efetue login. Se bem-sucedido, você receberá uma senha descartável. Copie essa senha e cole-a como uma resposta no prompt. Após a autenticação bem-sucedida, você será solicitado a escolher sua conta. Se você tiver acesso a várias contas, selecione a conta com a qual deseja fazer login. Responda a quaisquer prompts restantes para concluir o login.

Antes de começar, reúna as seguintes informações:

• Um nome exclusivo para o instantâneo. O nome do snapshot do compartilhamento deve ser exclusivo no nível do compartilhamento. Para obter sugestões sobre como nomear suas capturas instantâneas, consulte Nomeando capturas instantâneas.
• O nome ou ID do compartilhamento de origem.
• Quaisquer tags que você queira anexar ao instantâneo.

Use os seguintes comandos da CLI para coletar as informações de que você precisa.

• ibmcloud is shares- Esse comando lista todos os compartilhamentos disponíveis na região que você selecionou. Localize o compartilhamento na lista e verifique o status ( available ).
• ibmcloud is share SHARE_ID- Use esse comando com a ID do compartilhamento da saída do comando anterior para revisar os detalhes do compartilhamento. Se a saída mostrar que o compartilhamento está disponível, anexado a uma instância e não está ocupado, você poderá criar um instantâneo.

Pré-requisitos para criar um instantâneo com a API

É possível criar uma captura instantânea chamando a API da VPC. Antes de começar, reúna as seguintes informações:

• Um nome exclusivo para o instantâneo. O nome do snapshot do compartilhamento deve ser exclusivo no nível do compartilhamento. Para obter sugestões sobre como nomear suas capturas instantâneas, consulte Nomeando capturas instantâneas.
• A ID do compartilhamento de origem.
• Quaisquer tags que você queira anexar ao instantâneo.

Criação de um snapshot com a API

Você pode criar programaticamente um instantâneo de um compartilhamento de arquivos chamando o método da API shares/{share-id}/snapshots. O exemplo a seguir cria um instantâneo de um compartilhamento usando o ID do compartilhamento e especifica as tags de usuário que podem ser associadas a uma política de backup.

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

Uma resposta bem-sucedida se parece com o exemplo a seguir. O estado do ciclo de vida da captura instantânea é pending enquanto ela é criada. Quando for criado com sucesso, o status muda para “ stable ”.

{
  "captured_at": "2024-12-10T01:21:12.000Z",
  "created_at": "2024-12-10T01:59:46.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "lifecycle_state": "pending",
  "minimum_size": 10,
  "name": "my-first-share-snapshot",
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "share_snapshot",
  "status": "available",
  "status_reasons": [],
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Para instantâneos de compartilhamentos de arquivos regionais, o valor da zona fica em branco nas respostas da CLI e da API.