> ## 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 transfer update</code>
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius storage transfer update [id]
      --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-s3-compatible-access-key-access-key-id
      --destination-s3-compatible-access-key-secret-access-key
      --destination-s3-compatible-anonymous
      --id
      --infinite
      --inter-iteration-interval
      --labels
      --labels-add
      --labels-remove
      --limiters-bandwidth-bytes-per-second
      --limiters-requests-per-second
      --name
      --parent-id
      --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-nebius-access-key-access-key-id
      --source-nebius-access-key-secret-access-key
      --source-nebius-anonymous
      --source-s3-compatible-access-key-access-key-id
      --source-s3-compatible-access-key-secret-access-key
      --source-s3-compatible-anonymous
      --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-nebius-access-key-access-key-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Access key ID.
    </p>

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

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

    <p style={{ paddingLeft: "4ch" }}>
      Secret access key.
    </p>

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

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

    <p style={{ paddingLeft: "4ch" }}>
      Access key ID.
    </p>

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

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

    <p style={{ paddingLeft: "4ch" }}>
      Secret access key.
    </p>

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

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

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--destination-nebius-access-key-access-key-id`, `--destination-nebius-access-key-secret-access-key`, `--destination-s3-compatible-access-key-access-key-id`, `--destination-s3-compatible-access-key-secret-access-key`.</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" }}>
      The time to wait since the previous iteration before starting the next one.<br />
      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>
      `--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>
      `--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>
      `--name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Human readable name for the resource.
    </p>
  </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-azure-blob-storage-anonymous` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Storage account access key.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Storage account name.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Access key ID.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-nebius-anonymous`, `--source-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Secret access key.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-nebius-anonymous`, `--source-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>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-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`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Access key ID.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-nebius-access-key-access-key-id`, `--source-nebius-access-key-secret-access-key`, `--source-nebius-anonymous`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Secret access key.
    </p>

    <p style={{ paddingLeft: "4ch" }}>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-nebius-access-key-access-key-id`, `--source-nebius-access-key-secret-access-key`, `--source-nebius-anonymous`, `--source-s3-compatible-anonymous`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>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-nebius-access-key-access-key-id`, `--source-nebius-access-key-secret-access-key`, `--source-nebius-anonymous`, `--source-s3-compatible-access-key-access-key-id`, `--source-s3-compatible-access-key-secret-access-key`.</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]
                               // 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.
              }
            },
            "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
              }
            }
          },
          "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.
          },
          "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.
              }
            },
            "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
              }
            },
            "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
              }
            }
          }
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius storage transfer update '
      {              
        "metadata": {           
          "id": "",             
          "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": "" 
              }
            }
          },
          "inter_iteration_interval": "2h30m10s",
          "limiters": {                     
            "bandwidth_bytes_per_second": 0,
            "requests_per_second": 0        
          },
          "source": {              
            "azure_blob_storage": {     
              "anonymous": {
              }
            }
          }
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

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