create

Name

nebius storage transfer create

Synopsis

nebius storage transfer create
  --after-n-empty-iterations-empty-iterations-threshold
  --after-one-iteration
  --destination-nebius-access-key-access-key-id
  --destination-nebius-access-key-secret-access-key
  --destination-nebius-bucket-name
  --destination-nebius-region
  --destination-prefix
  --destination-s3-compatible-access-key-access-key-id
  --destination-s3-compatible-access-key-secret-access-key
  --destination-s3-compatible-anonymous
  --destination-s3-compatible-bucket-name
  --destination-s3-compatible-endpoint
  --destination-s3-compatible-region
  --infinite
  --inter-iteration-interval
  --labels
  --limiters-bandwidth-bytes-per-second
  --limiters-requests-per-second
  --name
  --overwrite-strategy [required]
  --parent-id [required]
  --resource-version
  --source-azure-blob-storage-anonymous
  --source-azure-blob-storage-azure-storage-account-access-key
  --source-azure-blob-storage-azure-storage-account-account-name
  --source-azure-blob-storage-container-name
  --source-azure-blob-storage-endpoint
  --source-nebius-access-key-access-key-id
  --source-nebius-access-key-secret-access-key
  --source-nebius-anonymous
  --source-nebius-bucket-name
  --source-nebius-region
  --source-prefix
  --source-s3-compatible-access-key-access-key-id
  --source-s3-compatible-access-key-secret-access-key
  --source-s3-compatible-anonymous
  --source-s3-compatible-bucket-name
  --source-s3-compatible-endpoint
  --source-s3-compatible-region
  --touch-unmanaged
  --async
  -i, --interactive

Options

--after-n-empty-iterations-empty-iterations-threshold (uint32)

Number of consecutive iterations with zero transferred objects required to stop transfer.

Mutually exclusive with: --after-one-iteration, --infinite.

--after-one-iteration (bool)

Mutually exclusive with: --after-n-empty-iterations-empty-iterations-threshold, --infinite.

--destination-nebius-access-key-access-key-id (string)

Access key ID.

Mutually exclusive with: --destination-s3-compatible-access-key-access-key-id, --destination-s3-compatible-access-key-secret-access-key, --destination-s3-compatible-anonymous, --destination-s3-compatible-bucket-name, --destination-s3-compatible-endpoint, --destination-s3-compatible-region.

--destination-nebius-access-key-secret-access-key (string)

Secret access key.

--destination-nebius-bucket-name (string)

Name of the destination bucket.

--destination-nebius-region (string)

Nebius region where the destination bucket is located.

--destination-prefix (string)

Prefix to add to the beginning of each transferred object key in the destination.
During transfer, the resulting object key in the destination is computed
by removing source.prefix (if provided) from the original key and then prepending destination.prefix.
Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
Use prefixes that guarantee valid resulting object keys for your objects after transformation.

--destination-s3-compatible-access-key-access-key-id (string)

Access key ID.

Mutually exclusive with: --destination-nebius-access-key-access-key-id, --destination-nebius-access-key-secret-access-key, --destination-nebius-bucket-name, --destination-nebius-region, --destination-s3-compatible-anonymous.

--destination-s3-compatible-access-key-secret-access-key (string)

Secret access key.

--destination-s3-compatible-anonymous (bool)

--destination-s3-compatible-bucket-name (string)

Name of the destination bucket.

Mutually exclusive with: --destination-nebius-access-key-access-key-id, --destination-nebius-access-key-secret-access-key, --destination-nebius-bucket-name, --destination-nebius-region.

--destination-s3-compatible-endpoint (string)

The endpoint must be in the form of a URL, starting with the protocol (https),
followed by the endpoint address without a trailing slash.
Example: “https://storage.some-cloud".

Mutually exclusive with: --destination-nebius-access-key-access-key-id, --destination-nebius-access-key-secret-access-key, --destination-nebius-bucket-name, --destination-nebius-region.

--destination-s3-compatible-region (string)

S3-compatible provider region where destination bucket is located.

Mutually exclusive with: --destination-nebius-access-key-access-key-id, --destination-nebius-access-key-secret-access-key, --destination-nebius-bucket-name, --destination-nebius-region.

--infinite (bool)

Infinite transfers do not stop automatically and can be stopped manually by the user.

Mutually exclusive with: --after-n-empty-iterations-empty-iterations-threshold, --after-one-iteration.

--inter-iteration-interval (duration: 2h30m10s)

The time to wait since the previous iteration before starting the next one.
Default is 15 minutes if not specified.

--labels (string->string)

Labels associated with the resource.

--limiters-bandwidth-bytes-per-second (uint64)

Maximum bandwidth in bytes per second. If set to zero, default limit will be applied.

--limiters-requests-per-second (uint64)

Maximum number of requests per second. If set to zero, default limit will be applied.

--name (string)

Human readable name for the resource.

--overwrite-strategy (string) [required]

Overwrite strategy set logic of overwrite already existed objects in destination bucket.

A value must be one of:

never
if_newer

--parent-id (string) [required]

Identifier of the parent resource to which the resource belongs.

--resource-version (int64)

Version of the resource for safe concurrent modifications and consistent reads.
Positive and monotonically increases on each resource spec change (but not on each change of the
resource’s container(s) or status).
Service allows zero value or current.

--source-azure-blob-storage-anonymous (bool)

Mutually exclusive with: --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-azure-blob-storage-azure-storage-account-access-key (string)

Storage account access key.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-azure-blob-storage-azure-storage-account-account-name (string)

Storage account name.

--source-azure-blob-storage-container-name (string)

Name of the source Azure Blob Storage container.

Mutually exclusive with: --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-azure-blob-storage-endpoint (string)

The endpoint must be in the form of a URL, starting with the protocol (https),
followed by the endpoint address without a trailing slash.
Example: “https://storageaccountname.blob.core.windows.net".

--source-nebius-access-key-access-key-id (string)

Access key ID.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-anonymous, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-nebius-access-key-secret-access-key (string)

Secret access key.

--source-nebius-anonymous (bool)

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-nebius-bucket-name (string)

Name of the source bucket.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-nebius-region (string)

Nebius region where the source bucket is located.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key, --source-s3-compatible-anonymous, --source-s3-compatible-bucket-name, --source-s3-compatible-endpoint, --source-s3-compatible-region.

--source-prefix (string)

Prefix to filter objects in the source. Only objects whose keys start with this prefix will be transferred.
During transfer, the resulting object key in the destination is computed
by removing source.prefix from the original key and then prepending destination.prefix (if provided).
Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
Use prefixes that guarantee valid resulting object keys for your objects after transformation.

--source-s3-compatible-access-key-access-key-id (string)

Access key ID.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-anonymous.

--source-s3-compatible-access-key-secret-access-key (string)

Secret access key.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-anonymous.

--source-s3-compatible-anonymous (bool)

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region, --source-s3-compatible-access-key-access-key-id, --source-s3-compatible-access-key-secret-access-key.

--source-s3-compatible-bucket-name (string)

Name of the source bucket.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region.

--source-s3-compatible-endpoint (string)

The endpoint must be in the form of a URL, starting with the protocol (https),
followed by the endpoint address without a trailing slash.
Example: “https://storage.some-cloud".

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region.

--source-s3-compatible-region (string)

S3-compatible provider region where source bucket is located.

Mutually exclusive with: --source-azure-blob-storage-anonymous, --source-azure-blob-storage-azure-storage-account-access-key, --source-azure-blob-storage-azure-storage-account-account-name, --source-azure-blob-storage-container-name, --source-azure-blob-storage-endpoint, --source-nebius-access-key-access-key-id, --source-nebius-access-key-secret-access-key, --source-nebius-anonymous, --source-nebius-bucket-name, --source-nebius-region.

--touch-unmanaged (bool)

If touch_unmanaged flag is set, service will be allowed to overwrite and delete from destination objects that were not
created by Data Transfer Service. If this flag is false, Data Transfer Service will never overwrite or delete objects
that haven’t been created by Data Transfer service.

--async (bool)

If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.

-i, --interactive (bool)

If set, suggests to insert field values in interactive mode.

Global Options

-h, --help (bool)

Show this message.

-p, --profile (string)

Set a profile for interacting with the cloud.

--format (string)

Output format. Supported values: yaml|json|jsonpath|table|text.

-f, --file (string)

Input file. For ‘update’ commands automatically set —full=true.

-c, --config (string)

Provide path to config file.

--debug (bool)

Enable debug logs.

--color (bool)

Enable colored output.

--no-browser (bool)

Do not open browser automatically on auth.

--insecure (bool)

Disable transport security.

--auth-timeout (duration: 2h30m10s)

Set the timeout for the request including authentication process, default is 15m0s.

--per-retry-timeout (duration: 2h30m10s)

Set the timeout for each retry attempt, default is 20s.

--retries (uint)

Set the number of retry attempts, 1 is disable retries, default is 3.

--timeout (duration: 2h30m10s)

Set the timeout for the main request, default is 1m0s.

--no-check-update (bool)

Suppress check for updates.

Show Input argument JSON Schema

Full
CopyPaste Friendly

{              
  "metadata": {                // [required]
    "labels": {                // [map]
                               // Labels associated with the resource.
      string: string                  
    },
    "name": string,            // Human readable name for the resource.
    "parent_id": string,       // [required]
                               // Identifier of the parent resource to which the resource belongs.
    "resource_version": int64  // Version of the resource for safe concurrent modifications and consistent reads.
                               // Positive and monotonically increases on each resource spec change (but *not* on each change of the
                               // resource's container(s) or status).
                               // Service allows zero value or current.
  },
  "spec": {                                 // [required]
    "after_n_empty_iterations": {           // Cannot be set together with: after_one_iteration, infinite
      "empty_iterations_threshold": uint32  // [required]
                                            // Number of consecutive iterations with zero transferred objects required to stop transfer.
    },
    "after_one_iteration": { // [meaningful_empty_value]
                             // Cannot be set together with: after_n_empty_iterations, infinite
    },
    "destination": {     // [required]
                         // Destination to which the transfer writes data.
      "nebius": {              // Cannot be set together with: s3_compatible
        "access_key": {               
          "access_key_id": string,     // [required]
                                       // Access key ID.
          "secret_access_key": string  // [sensitive] [input_only]
                                       // Secret access key.
        },
        "bucket_name": string, // [required] [immutable]
                               // Name of the destination bucket.
        "region": string       // [required] [immutable]
                               // Nebius region where the destination bucket is located.
      },
      "prefix": string,  // [immutable]
                         // Prefix to add to the beginning of each transferred object key in the destination.
                         // During transfer, the resulting object key in the destination is computed
                         // by removing source.prefix (if provided) from the original key and then prepending destination.prefix.
                         // Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
                         // Use prefixes that guarantee valid resulting object keys for your objects after transformation.
      "s3_compatible": {       // Cannot be set together with: nebius
        "access_key": {                // Cannot be set together with: anonymous
          "access_key_id": string,     // [required]
                                       // Access key ID.
          "secret_access_key": string  // [sensitive] [input_only]
                                       // Secret access key.
        },
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: access_key
        },
        "bucket_name": string, // [required] [immutable]
                               // Name of the destination bucket.
        "endpoint": string,    // [required] [immutable]
                               // The endpoint must be in the form of a URL, starting with the protocol (https),
                               // followed by the endpoint address without a trailing slash.
                               // Example: "https://storage.some-cloud".
        "region": string       // [required] [immutable]
                               // S3-compatible provider region where destination bucket is located.
      }
    },
    "infinite": { // [meaningful_empty_value]
                  // Cannot be set together with: after_one_iteration, after_n_empty_iterations
                  // Infinite transfers do not stop automatically and can be stopped manually by the user.
    },
    "inter_iteration_interval": "2h30m10s", // [google.protobuf.Duration] [non_empty_default]
                                            // The time to wait since the previous iteration before starting the next one.
                                            // Default is 15 minutes if not specified.
    "limiters": {                           // Limiters applied to source bucket operations. These limits include all operations
                                            // required for transfer (HeadObject, GetObject, ListObjects). For details about
                                            // which operations are used, see public documentation: http://docs.nebius.com/object-storage/transfer/quickstart#background.
                                            // 
                                            // Note: Since the service performs comparable request volumes and data transfers
                                            // to both source and destination, these limits will indirectly constrain
                                            // destination operations as well.
      "bandwidth_bytes_per_second": uint64, // Maximum bandwidth in bytes per second. If set to zero, default limit will be applied.
      "requests_per_second": uint64         // Maximum number of requests per second. If set to zero, default limit will be applied.
    },
    "overwrite_strategy": enum(         // [required] [immutable]
                                        // Overwrite strategy set logic of overwrite already existed objects in destination bucket.
      "OVERWRITE_STRATEGY_UNSPECIFIED",
      "NEVER",                          // Never overwrite objects that exist in the destination.
                                        // If object exists in destination bucket, skip it.
                                        // Safest option to prevent any data loss.
      "IF_NEWER"                        // Overwrite only if source object is newer than destination.
                                        // Comparison based on Last-Modified timestamp.
                                        // Recommended for incremental sync scenarios.
                                        // If touch_unmanaged flag isn't set, we do not overwrite objects that haven't been created by Data Transfer service.
    ),
    "source": {               // [required]
                              // Source from which the transfer reads data.
      "azure_blob_storage": {      // Cannot be set together with: nebius, s3_compatible
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: azure_storage_account
        },
        "azure_storage_account": { // Cannot be set together with: anonymous
          "access_key": string,    // [sensitive] [input_only]
                                   // Storage account access key.
          "account_name": string   // [required]
                                   // Storage account name.
        },
        "container_name": string,  // [required] [immutable]
                                   // Name of the source Azure Blob Storage container.
        "endpoint": string         // [required] [immutable]
                                   // The endpoint must be in the form of a URL, starting with the protocol (https),
                                   // followed by the endpoint address without a trailing slash.
                                   // Example: "https://storageaccountname.blob.core.windows.net".
      },
      "nebius": {              // Cannot be set together with: s3_compatible, azure_blob_storage
        "access_key": {                // Cannot be set together with: anonymous
          "access_key_id": string,     // [required]
                                       // Access key ID.
          "secret_access_key": string  // [sensitive] [input_only]
                                       // Secret access key.
        },
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: access_key
        },
        "bucket_name": string, // [required] [immutable]
                               // Name of the source bucket.
        "region": string       // [required] [immutable]
                               // Nebius region where the source bucket is located.
      },
      "prefix": string,       // [immutable]
                              // Prefix to filter objects in the source. Only objects whose keys start with this prefix will be transferred.
                              // During transfer, the resulting object key in the destination is computed
                              // by removing source.prefix from the original key and then prepending destination.prefix (if provided).
                              // Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
                              // Use prefixes that guarantee valid resulting object keys for your objects after transformation.
      "s3_compatible": {       // Cannot be set together with: nebius, azure_blob_storage
        "access_key": {                // Cannot be set together with: anonymous
          "access_key_id": string,     // [required]
                                       // Access key ID.
          "secret_access_key": string  // [sensitive] [input_only]
                                       // Secret access key.
        },
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: access_key
        },
        "bucket_name": string, // [required] [immutable]
                               // Name of the source bucket.
        "endpoint": string,    // [required] [immutable]
                               // The endpoint must be in the form of a URL, starting with the protocol (https),
                               // followed by the endpoint address without a trailing slash.
                               // Example: "https://storage.some-cloud".
        "region": string       // [required] [immutable]
                               // S3-compatible provider region where source bucket is located.
      }
    },
    "touch_unmanaged": bool                 // [immutable]
                                            // If touch_unmanaged flag is set, service will be allowed to overwrite and delete from destination objects that were not
                                            // created by Data Transfer Service. If this flag is false, Data Transfer Service will never overwrite or delete objects
                                            // that haven't been created by Data Transfer service.
  }
}

nebius storage transfer create '
{              
  "metadata": {           
    "labels": {           
      "": ""                  
    },
    "name": "",           
    "parent_id": "",      
    "resource_version": 0 
  },
  "spec": {                                                                  
    "after_n_empty_iterations": {     
      "empty_iterations_threshold": 0 
    },
    "destination": {    
      "nebius": {         
        "access_key": {           
          "access_key_id": "",    
          "secret_access_key": "" 
        },
        "bucket_name": "",
        "region": ""      
      },
      "prefix": ""      
    },
    "inter_iteration_interval": "2h30m10s",                                  
    "limiters": {                     
      "bandwidth_bytes_per_second": 0,
      "requests_per_second": 0        
    },
    "overwrite_strategy": "overwrite_strategy_unspecified"|"never"|"if_newer",
    "source": {              
      "azure_blob_storage": {     
        "anonymous": {
        },
        "container_name": "",     
        "endpoint": ""            
      },
      "prefix": ""           
    },
    "touch_unmanaged": false                                                 
  }
}
'

Nebius AI Cloud CLI

Nebius AI Cloud provider for Terraform

Nebius AI Cloud API

Name

Synopsis

Options

Global Options

Nebius AI Cloud CLI

Nebius AI Cloud provider for Terraform

Nebius AI Cloud API

​Name

​Synopsis

​Options

​Global Options

Name

Synopsis

Options

Global Options