Usando as recuperações de recursos

É possível usar a CLI da IBM Cloud® ou a API do IBM Cloud® Resource Controller para gerenciar o processo de recuperação de recursos específicos. Para obter mais informações, consulte Perguntas frequentes sobre recursos

Listando recursos recuperados usando a CLI

Para listar recursos recuperados que podem ser restaurados ou excluídos usando a CLI, execute o comando a seguir:

ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]

Insira a opção de comando a seguir:

  • --resource-instance-id: o ID globalmente exclusivo (GUID) da instância de recurso.

O exemplo a seguir mostra como listar as recuperações de uma determinada instância de serviço:

ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699

Listando recursos recuperados usando a API

Para listar recursos recuperados que podem ser restaurados ou excluídos, chame a API do IBM Cloud® Resource Controller, conforme mostrado no exemplo a seguir:

Use o ListReclamationsOptions.Builder para criar um objeto ListReclamationsOptions que contenha os valores de parâmetro para o método listReclamations.

Instancie a estrutura ListReclamationsOptions e configure os campos para fornecer valores de parâmetro para o método ListReclamations.

curl -X GET https://resource-controller.cloud.ibm.com/v1/reclamations?account_id=b80a8b513ae24e178438b7a18bd8d609 -H 'Authorization: Bearer <IAM_TOKEN>'

ListReclamationsOptions listReclamationsOptions = new ListReclamationsOptions.Builder()
  .accountId(accountId)
  .build();

Response<ReclamationsList> response = service.listReclamations(listReclamationsOptions).execute();
ReclamationsList reclamationsList = response.getResult();

System.out.printf("listReclamations() response:\n%s\n", reclamationsList.toString());

const params = {
  accountId: accountId,
};

resourceControllerService.listReclamations(params)
  .then(res => {
    var resources = res.result.resources;
    resources.forEach(reclaim => {
      if (reclaim.resource_instance_id.toString() === instanceGuid) {
        reclamationId = reclaim.id;
      }
    });
    console.log('listReclamations() response:\n' + JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

reclamations_list = resource_controller_service.list_reclamations(
    account_id=account_id
).get_result()

print('\nlist_reclamations() response:\n',
      json.dumps(reclamations_list, indent=2))

listReclamationsOptions := resourceControllerService.NewListReclamationsOptions()
listReclamationsOptions = listReclamationsOptions.SetAccountID(accountID)
reclamationsList, response, err := resourceControllerService.ListReclamations(listReclamationsOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(reclamationsList, "", "  ")
fmt.Printf("\nListReclamations() response:\n%s\n", string(b))

Excluindo um recurso recuperado usando a CLI

Para excluir um recurso recuperado usando a CLI, execute o comando a seguir:

ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]

Insira as opções de comando a seguir:

  • ID: o ID da recuperação do recurso. Esse é o ID de recuperação e não o ID da instância de recurso. (Obrigatório)
  • --comment: comentários sobre a ação.
  • -f, --force: forçar exclusão sem confirmação.

O exemplo a seguir mostra como excluir uma recuperação de recurso com o ID d9fendfwlw:

ibmcloud resource reclamation-delete "d9fendfwlw"

O exemplo a seguir mostra como excluir um resgate de recursos com o ID d9fendfwlw e deixar um comentário de no longer needed sem confirmação:

ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f

Excluindo recurso usando a API

Para recuperar (excluir provisoriamente) um recurso, chame a API do IBM Cloud® Resource Controller, conforme mostrado no exemplo a seguir. Especifique reclaim para excluir um recurso. O id é o ID de recuperação e não o ID da instância do recurso.

curl -X POST https://resource-controller.cloud.ibm.com/v1/reclamations/0114be9024c6eede47d08a85ac0c5c43/actions/reclaim -H 'Authorization: Bearer <IAM_TOKEN>' -H 'Content-Type: application/json' -d '{
    "request_by": "bar",
    "comment": "reclaim resource instance 614fc866-1d4f-4c9e-973e-637f1089a6a1"
  }'

RunReclamationActionOptions runReclamationActionOptions = new RunReclamationActionOptions.Builder()
  .id(reclamationId)
  .actionName("reclaim")
  .build();

Response<Reclamation> response = service.runReclamationAction(runReclamationActionOptions).execute();
Reclamation reclamation = response.getResult();

System.out.printf("runReclamationAction() response:\n%s\n", reclamation.toString());

const params = {
  id: reclamationId,
  actionName: 'reclaim',
};

resourceControllerService.runReclamationAction(params)
  .then(res => {
    console.log('runReclamationAction() response:\n' + JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

reclamation = resource_controller_service.run_reclamation_action(
    id=reclamation_id,
    action_name='reclaim'
).get_result()

print('\nrun_reclamation_action() response:\n',
      json.dumps(reclamation, indent=2))

runReclamationActionOptions := resourceControllerService.NewRunReclamationActionOptions(
  reclamationID,
  "reclaim",
)

reclamation, response, err := resourceControllerService.RunReclamationAction(runReclamationActionOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(reclamation, "", "  ")
fmt.Printf("\nRunReclamationAction() response:\n%s\n", string(b))

Restaurando um recurso usando a CLI

Normalmente, os recursos podem ser restaurados em até 3 dias após a exclusão. No entanto, os períodos de restauração podem variar dependendo do serviço, pois cada um segue sua própria política de retenção. Para obter mais informações, consulte a documentação do serviço individual.

Nem todos os recursos podem ser restaurados. É possível executar o comando ibmcloud resource reclamations para verificar os recursos que podem ser restaurados.

Para restaurar um recurso usando a CLI, execute o comando a seguir:

ibmcloud resource reclamation-restore ID [--comment COMMENT]

Insira as opções de comando a seguir:

  • ID: o ID da recuperação do recurso. Esse é o ID de recuperação e não o ID da instância de recurso.  (obrigatório)
  • --comment: comentários sobre a ação.

O exemplo a seguir mostra como restaurar um recurso com o ID d9fendfwlw:

ibmcloud resource reclamation-restore "d9fendfwlw"

Para obter mais informações, consulte a referência de comando ibmcloud resource reclamations.

Restaurando um recurso usando a API

Normalmente, os recursos podem ser restaurados em até 3 dias após a exclusão. No entanto, os períodos de restauração podem variar dependendo do serviço, pois cada um segue sua própria política de retenção. Para obter mais informações, consulte a documentação do serviço individual.

Nem todos os recursos podem ser restaurados. Obtenha uma lista de todas as recuperações para verificar os recursos que podem ser restaurados.

Para restaurar um recurso usando a API, chame a API do IBM Cloud® Resource Controller, conforme mostrado no exemplo a seguir. Especificar restore para restaurar um recurso. id é o ID de recuperação e não o ID da instância de recurso.

curl -X POST https://resource-controller.cloud.ibm.com/v1/reclamations/0114be9024c6eede47d08a85ac0c5c43/actions/restore -H 'Authorization: Bearer <IAM_TOKEN>' -H 'Content-Type: application/json' -d '{
    "request_by": "bar",
    "comment": "restore resource instance 614fc866-1d4f-4c9e-973e-637f1089a6a1"
  }'

RunReclamationActionOptions runReclamationActionOptions = new RunReclamationActionOptions.Builder()
  .id(reclamationId)
  .actionName("restore")
  .build();

Response<Reclamation> response = service.runReclamationAction(runReclamationActionOptions).execute();
Reclamation reclamation = response.getResult();

System.out.printf("runReclamationAction() response:\n%s\n", reclamation.toString());

const params = {
  id: reclamationId,
  actionName: 'restore',
};

resourceControllerService.runReclamationAction(params)
  .then(res => {
    console.log('runReclamationAction() response:\n' + JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

reclamation = resource_controller_service.run_reclamation_action(
    id=reclamation_id,
    action_name='restore'
).get_result()

print('\nrun_reclamation_action() response:\n',
      json.dumps(reclamation, indent=2))

runReclamationActionOptions := resourceControllerService.NewRunReclamationActionOptions(
  reclamationID,
  "restore",
)

reclamation, response, err := resourceControllerService.RunReclamationAction(runReclamationActionOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(reclamation, "", "  ")
fmt.Printf("\nRunReclamationAction() response:\n%s\n", string(b))