> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# update

<div>
  <h2>Name</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>nebius storage v1alpha1 transfer update</code>
  </p>
</div>

<div>
  <h2>Deprecated</h2>

  <p style={{ paddingLeft: "4ch" }}>
    Command transfer is deprecated and will be removed on 2026-06-01. Please use the 'storage transfer' command instead. All existing transfers remain accessible through the new command.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius storage v1alpha1 transfer update [id]
      --after-n-empty-iterations-empty-iterations-threshold
      --after-one-iteration
      --destination-credentials-access-key-access-key-id
      --destination-credentials-access-key-secret-access-key
      --destination-credentials-anonymous
      --destination-credentials-azure-access-key-access-key
      --destination-credentials-azure-access-key-account-name
      --id
      --infinite
      --inter-iteration-interval
      --labels
      --labels-add
      --labels-remove
      --name
      --overwrite-strategy
      --parent-id
      --resource-version
      --source-credentials-access-key-access-key-id
      --source-credentials-access-key-secret-access-key
      --source-credentials-anonymous
      --source-credentials-azure-access-key-access-key
      --source-credentials-azure-access-key-account-name
      --source-limiters-bandwidth-bytes-per-second
      --source-limiters-requests-per-second
      --async
      --clear-mask
      --diff
      --full
      --patch
    ```
  </p>
</div>

<div>
  <h2>Positional Arguments</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>id</code>
  </p>

  <p style={{ paddingLeft: "8ch" }}>
    Identifier for the resource, unique for its resource type.
  </p>
</div>

<div>
  <h2>Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--after-n-empty-iterations-empty-iterations-threshold` (uint32)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Number of consecutive iterations with zero transferred objects required to stop transfer.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--after-one-iteration`, `--infinite`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--after-one-iteration` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--after-n-empty-iterations-empty-iterations-threshold`, `--infinite`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--destination-credentials-access-key-access-key-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-credentials-anonymous`, `--destination-credentials-azure-access-key-access-key`, `--destination-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--destination-credentials-access-key-secret-access-key` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-credentials-anonymous`, `--destination-credentials-azure-access-key-access-key`, `--destination-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--destination-credentials-anonymous` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-credentials-access-key-access-key-id`, `--destination-credentials-access-key-secret-access-key`, `--destination-credentials-azure-access-key-access-key`, `--destination-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--destination-credentials-azure-access-key-access-key` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-credentials-access-key-access-key-id`, `--destination-credentials-access-key-secret-access-key`, `--destination-credentials-anonymous`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--destination-credentials-azure-access-key-account-name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-credentials-access-key-access-key-id`, `--destination-credentials-access-key-secret-access-key`, `--destination-credentials-anonymous`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Identifier for the resource, unique for its resource type.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--infinite` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Infinite transfers do not stop automatically and can be stopped manually by the user.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--after-n-empty-iterations-empty-iterations-threshold`, `--after-one-iteration`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--inter-iteration-interval` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Time to wait between transfer iterations. Default is 15 minutes if not specified.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--labels` (string->string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Labels associated with the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--labels-add` (string->string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Add values to Labels associated with the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--labels-remove` (string array)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Remove values from Labels associated with the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Human readable name for the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--overwrite-strategy` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Overwrite strategy set logic of overwrite already existed objects in destination bucket.
    </p>

    <p style={{ paddingLeft: "4ch" }}>A value must be one of:</p>

    <ul style={{ paddingLeft: "8ch" }}>
      <li>
        <code>overwrite\_strategy\_unspecified</code>
      </li>

      <li>
        <code>never</code>
      </li>

      <li>
        <code>if\_newer</code>
      </li>

      <li>
        <code>always</code>
      </li>
    </ul>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--parent-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Identifier of the parent resource to which the resource belongs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--resource-version` (int64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Version of the resource for safe concurrent modifications and consistent reads.<br />
      Positive and monotonically increases on each resource spec change (but *not* on each change of the<br />
      resource's container(s) or status).<br />
      Service allows zero value or current.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-credentials-access-key-access-key-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--source-credentials-anonymous`, `--source-credentials-azure-access-key-access-key`, `--source-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-credentials-access-key-secret-access-key` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--source-credentials-anonymous`, `--source-credentials-azure-access-key-access-key`, `--source-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-credentials-anonymous` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--source-credentials-access-key-access-key-id`, `--source-credentials-access-key-secret-access-key`, `--source-credentials-azure-access-key-access-key`, `--source-credentials-azure-access-key-account-name`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-credentials-azure-access-key-access-key` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--source-credentials-access-key-access-key-id`, `--source-credentials-access-key-secret-access-key`, `--source-credentials-anonymous`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-credentials-azure-access-key-account-name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--source-credentials-access-key-access-key-id`, `--source-credentials-access-key-secret-access-key`, `--source-credentials-anonymous`.</p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-limiters-bandwidth-bytes-per-second` (uint64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Maximum bandwidth in bytes per second. If set to zero, default limit will be applied.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--source-limiters-requests-per-second` (uint64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Maximum number of requests per second. If set to zero, default limit will be applied.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--async` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--clear-mask` (string array)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Reset-mask field paths to clear in patch mode. Can be repeated.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--diff` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show diff of resource before commiting update.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--full` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Update full resource state. Automatically set to true if the --file or argument provided.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--patch` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Update only specified fields.
    </p>
  </div>
</div>

<div>
  <h2>Global Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-h, --help` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show this message.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-p, --profile` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set a profile for interacting with the cloud.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--format` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Output format. Supported values: yaml|json|jsonpath|table|text.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-f, --file` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Input file. For 'update' commands automatically set --full=true.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-c, --config` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Provide path to config file.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--debug` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable debug logs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--color` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable colored output.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-browser` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Do not open browser automatically on auth.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--insecure` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Disable transport security.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--auth-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the request including authentication process, default is 15m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--per-retry-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for each retry attempt, default is 20s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--retries` (uint)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the number of retry attempts, 1 is disable retries, default is 3.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the main request, default is 1m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-check-update` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress check for updates.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-progress` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress progress indicators and spinners.
    </p>
  </div>
</div>

<Expandable title="Input argument JSON Schema">
  <Tabs>
    <Tab title="Full">
      ```json theme={null}
      {              
        "metadata": {                // [required]
          "id": string,              // [identifier]
                                     // Identifier for the resource, unique for its resource type.
          "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]
            "credentials": {        // [input_only]
                                    // Credentials for accessing the destination bucket. These credentials must have head and write permissions.
                                    // This parameter must be specified only during create operations.
              "access_key": {                // Cannot be set together with: anonymous, azure_access_key
                "access_key_id": string,     // [required] [sensitive]
                "secret_access_key": string  // [required] [sensitive]
              },
              "anonymous": { // [meaningful_empty_value]
                             // Cannot be set together with: access_key, azure_access_key
              },
              "azure_access_key": {     // Cannot be set together with: anonymous, access_key
                "access_key": string,   // [required] [sensitive]
                "account_name": string  // [required] [sensitive]
              }
            }
          },
          "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]
                                                  // Time to wait between transfer iterations. Default is 15 minutes if not specified.
          "overwrite_strategy": enum(         // [required]
                                              // 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 data loss.
            "IF_NEWER",                       // Overwrite only if source object is newer than destination.
                                              // Comparison based on Last-Modified timestamp.
                                              // Recommended for incremental sync scenarios.
            "ALWAYS"                          // Always overwrite destination objects unconditionally.
                                              // Use with caution - may cause data loss in destination.
                                              // Suitable for full bucket synchronization.
          ),
          "source": {        // [required]
            "credentials": {        // [input_only]
                                    // Credentials for accessing the source bucket. These credentials must have list and get permissions.
                                    // This parameter must be specified only during create operations.
              "access_key": {                // Cannot be set together with: anonymous, azure_access_key
                "access_key_id": string,     // [required] [sensitive]
                "secret_access_key": string  // [required] [sensitive]
              },
              "anonymous": { // [meaningful_empty_value]
                             // Cannot be set together with: access_key, azure_access_key
              },
              "azure_access_key": {     // Cannot be set together with: anonymous, access_key
                "access_key": string,   // [required] [sensitive]
                "account_name": string  // [required] [sensitive]
              }
            },
            "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.
            }
          }
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius storage v1alpha1 transfer update '
      {              
        "metadata": {           
          "id": "",             
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {                                                                           
          "after_n_empty_iterations": {     
            "empty_iterations_threshold": 0 
          },
          "destination": {  
            "credentials": {       
              "access_key": {           
                "access_key_id": "",    
                "secret_access_key": "" 
              }
            }
          },
          "inter_iteration_interval": "2h30m10s",                                           
          "overwrite_strategy": "overwrite_strategy_unspecified"|"never"|"if_newer"|"always",
          "source": {       
            "credentials": {       
              "access_key": {           
                "access_key_id": "",    
                "secret_access_key": "" 
              }
            },
            "limiters": {                     
              "bandwidth_bytes_per_second": 0,
              "requests_per_second": 0        
            }
          }
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

<strong>Auto generated on 12-May-2026</strong>