Documentation Index

Fetch the complete documentation index at: https://kb.vastdata.com/llms.txt

Use this file to discover all available pages before exploring further.

user copy

  • Updated on Feb 18, 2026
  • Published on Jan 28, 2026
  • 1 minute(s) read
Prev Next

This command copies users from the default VAST provider to another VAST provider.

Copying from a non-default provider is not supported.

Usage

user copy  --destination-provider-id ID
          [--tenant-id TENANT]
          [--user-ids USERS]

Required Parameters

--destination-provider-id ID

Specifies the VAST provider to which the users are copied. Cannot be the default provider.

Options

--tenant-id TENANT

Specifies the tenant containing the provider and users. If included, then all users with S3 access keys for this tenant are copied.

This parameter cannot be specified together with --user-ids.

--user-ids USERS

Specifies a list of a users to copy.

This parameter cannot be specified together with --tenant-id.

Example

To copy three users (IDs 10, 11, 12) from the default VAST provider to provider with ID 2:

vcli: admin> user copy --destination-provider-id 2 --user-ids 10, 11, 12

This example copies all users from a tenant (ID 7):

vcli: admin> user copy --destination-provider-id 2 --tenant-id 7

Related articles
  • user copy
    VAST Cluster > Version 5.3 > VAST Cluster 5.3 CLI Command Reference > user commands
  • Managing Local Users
    VAST Cluster > Version 5.4 > VAST Cluster 5.4 Administrator's Guide > Managing Users > Providers > VAST Providers
  • user modify
    VAST Cluster > Version 5.4 > VAST Cluster 5.4 CLI Command Reference > user commands