Editing Backup Repository Settings

In command line interface, you can edit settings for a backup repository created with Veeam Agent for Linux in a local or network shared folder, or for a backup repository created in an object storage location.

You can edit properties of the following repository types only in the backup job settings in the Veeam Agent control panel:

Veeam backup repository.
Veeam Cloud Connect repository.

Editing Local or Shared Folder Repositories

You can edit the following parameters for a backup repository created in a local or network shared folder:

NOTE

Consider the following:

If you change location for the backup repository that is already used by a backup job and contains backup files, during the next backup job run, Veeam Agent will create a new backup chain in the new repository location.
You can temporarily change backup repository location if you want to create an ad hoc full backup in addition to the backup chain created by the backup job in the original repository location.

Changing Backup Repository Name

To change a name for the backup repository, use the following command:

veeamconfig repository edit --name <new_name> for --name <old_name>

veeamconfig repository edit --name <new_name> for --id <id>

where:

<old_name> — current name of the backup repository.
<new_name> — desired name for the backup repository.
<id> — ID of the backup repository.

For example:

user@srv01:~$ veeamconfig repository edit --name LocalRepository for --name Repository_1

Changing Backup Repository Location

To change location for the backup repository, use the following command:

veeamconfig repository edit --location <path> for --name <name>

veeamconfig repository edit --location <path> for --id <id>

where:

<path> — desired path for the backup repository.
<name> — current name of the backup repository.
<id> — ID of the backup repository.

For example:

user@srv01:~$ veeamconfig repository edit --location /home/veeam for --id 3458797-3ffe-45bc-870e-c5628643bbb3

Changing Backup Repository Name and Location

You can change a name and location for the backup repository at the same time, for example:

user@srv01:~$ veeamconfig repository edit --name LocalRepository --location /home/veeam for --name Repository_1

Editing Object Storage Repositories

To edit settings for a backup repository created in an object storage location, use the following command:

veeamconfig objectstorage editrepository <provider_type> [options] for --name <name>

where:

<provider_type> — type of the object storage repository that you want to edit. Veeam Agent supports the following options:

azureblob
google
amazonS3
s3compatible

[options] — one or more parameters that you want to change for the repository. Available options depend on the object storage provider type. For more information, see the following subsections:

<name> — current name of the object storage repository that you want to edit.

NOTE

Unlike editing a backup repository created in a local or network shared folder, you can select an object storage repository to edit by its name only — selecting a repository by ID is not supported.

Editing S3 Compatible Repository Settings

To edit settings for a backup repository created in an S3 compatible storage bucket, use the following command:

veeamconfig objectstorage editrepository s3compatible [--servicepoint <address>] [--fingerprint <ssl_thumbprint>] [--name <new_name>] [--region <storage_region>] [--bucketname <bucket_name>] [--folder <folder_name>] [--accesskeyid <id>] for --name <name>

where:

<address> — new address of the service point for the object storage.
<ssl_thumbprint> — new fingerprint to verify the SSL certificate.
<new_name> — desired name for the backup repository.
<storage_region> — desired region associated with the bucket.
<bucket_name> — desired name of the bucket.
<folder_name> — desired name of the folder in the bucket.
<id> — desired access key associated with the object storage account.
<name> — current name of the object storage repository that you want to edit.

For example:

user01@srv01:~$ veeamconfig objectstorage editrepository s3compatible --bucketname backup02 --folder folder02 for --name s3comp

Editing Amazon S3 Repository Settings

To edit settings for a backup repository created in an Amazon S3 bucket, use the following command:

veeamconfig objectstorage editrepository amazons3 [--name <new_name>] [--region <storage_region>] [--bucketname <bucket_name>] [--folder <folder_name>] [--accesskeyid <id>] for --name <name>

where:

<new_name> — desired name for the backup repository.
<storage_region> — desired region associated with the bucket.
<bucket_name> — desired name of the bucket.
<folder_name> — desired name of the folder in the bucket.
<id> — desired access key associated with the Amazon S3 storage account.
<name> — current name of the object storage repository that you want to edit.

For example:

user01@srv01:~$ veeamconfig objectstorage editrepository amazons3 --region us-west-2 for --name amazon

Editing Google Cloud Repository Settings

To edit settings for a backup repository created in a Google Cloud storage bucket, use the following command:

veeamconfig objectstorage editrepository google [--name <new_name>] [--region <storage_region>] [--bucketname <bucket_name>] [--folder <folder_name>] [--accesskeyid <id>] for --name <name>

where:

<new_name> — desired name for the backup repository.
<storage_region> — desired region associated with the bucket.
<bucket_name> — desired name of the bucket.
<folder_name> — desired name of the folder in the bucket.
<id> — desired access key associated with the Google Cloud storage account.
<name> — current name of the object storage repository that you want to edit.

For example:

user01@srv01:~$ veeamconfig objectStorage editrepository google --folder folder02 for --name google

Editing Microsoft Azure Blob Repository Settings

To edit settings for a backup repository created in a Microsoft Azure Blob container, use the following command:

veeamconfig objectstorage editrepository azureblob [--name <new_name>] [--region <storage_region>] [--bucketname <bucket_name>] [--folder <folder_name>] [--account <account_name>] for --name <name>

where:

<new_name> — desired name for the backup repository.
<storage_region> — desired region associated with the container.
<bucket_name> — desired name of the container.
<folder_name> — desired name of the folder in the container.
<account_name> — desired name of the Microsoft Azure Blob storage account.
<name> — current name of the object storage repository that you want to edit.

For example:

user01@srv01:~$ veeamconfig objectstorage editrepository azureblob --account new-account for --name azure