# Module `netapp_ontap.models.volume_rebalancing`

Copyright © 2023 NetApp Inc. All rights reserved.

This file has been automatically generated based on the ONTAP REST API documentation.

## Classes

`class VolumeRebalancingSchema (*, only: Union[Sequence[str], Set[str]] = None, exclude: Union[Sequence[str], Set[str]] = (), many: bool = False, context: Dict = None, load_only: Union[Sequence[str], Set[str]] = (), dump_only: Union[Sequence[str], Set[str]] = (), partial: Union[bool, Sequence[str], Set[str]] = False, unknown: str = None)`

  The fields of the VolumeRebalancing object

  ### Ancestors

  - netapp_ontap.resource.ResourceSchema
  - marshmallow.schema.Schema
  - marshmallow.base.SchemaABC

  ### Class variables

  `data_moved: Size GET`

    The amount of data that has been moved in or out of a constituent. A positive value represents data moving into the constituent while a negative value is data moving out of the constituent.

  `engine: VolumeRebalancing1Engine GET POST PATCH`

    The engine field of the volume_rebalancing.

  `exclude_snapshots: bool GET PATCH`

    Specifies whether or not to exclude files that are stuck in Snapshot copies during rebalancing operation. When a new capacity rebalancing operation is started on a FlexGroup volume, it uses the current "exclude_snapshots" value. Once the operation is started, any changes to the "exclude_snapshots" value do not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new "exclude_snapshots" value.

  `imbalance_percent: Size GET`

    Represents the percentage the volume is out of balance.

  `imbalance_size: Size GET`

    Represents how much the volume is out of balance, in bytes.

  `links: SelfLink GET`

    The links field of the volume_rebalancing.

  `max_constituent_imbalance_percent: Size GET`

    Absolute percentage of the constituent that is most out of balance. This value will update every 30 seconds when rebalancing is not active and every 10 seconds when rebalancing is active.

  `max_file_moves: Size GET PATCH`

    Specifies the maximum number of concurrent file moves in a volume capacity rebalancing operation on a constituent of the FlexGroup volume. When a new capacity rebalancing operation is started on a FlexGroup volume, it uses the current "max_file_moves" value. Once the operation is started, any changes to the "max_file_moves" value do not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new "max_file_moves" value.

  `max_runtime: str GET PATCH`

    This optional field specifies the maximum time a capacity rebalancing operation runs for. Once the maximum runtime has passed, the capacity rebalancing operation stops. If it is not set, the default value is 6 hours. This value cannot be updated while a capacity rebalancing operation is running. The maximum runtime can be in years, months, days, hours, and minutes. A period specified for years, months, and days is represented in the ISO-8601 format as "PY", "PM", "PD" respectively, for example "P3D" represents a duration of 3 days. A duration in hours and minutes is represented by "PTH" and "PTM" respectively.

  `max_threshold: Size GET PATCH`

    Specifies the maximum imbalance percentage for FlexGroup volume constituents. When a constituent's imbalance percentage is larger than this value, files are moved from the constituent. When a new capacity rebalancing operation is started on a FlexGroup volume, it uses the current "max_threshold" value. Once the operation is started, any changes to the "max_threshold" value do not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new "max_threshold" value.

  `min_file_size: Size GET PATCH`

    Specifies the minimum file size to consider for a volume capacity rebalancing operation. When a new capacity rebalancing operation is started on a FlexGroup volume, it uses the current "min_file_size" value. Once the operation is started, any changes to the "min_file_size" value do not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new "min_file_size" value. The value must be a multiple of 4KB. If it is not set, the default value is 100MB. Setting "min-file-size" to less than the default value leads to more files being moved. Moved files use granular data, which may impact read/write I/O performance.

  `min_threshold: Size GET PATCH`

    Specifies the minimum imbalance percentage for FlexGroup volume constituents. When a constituent's imbalance percentage is smaller than this value, files are not moved from the constituent. When a new capacity rebalancing operation is started on a FlexGroup volume, it will use the current "min_threshold" value. Once the operation is started, any changes to the "min_threshold" value do not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new "min_threshold" value.

  `notices: List[Error] GET`

    Capacity rebalancing notice messages.

  `runtime: str GET`

    Duration the capacity rebalancing operation has been running.

  `start_time: ImpreciseDateTime GET`

    Time when the current capacity rebalancing operation started.

  `state: str GET PATCH`

    State of the volume capacity rebalancing operation. PATCH the state to "starting" to trigger the capacity rebalance operation. PATCH the state to "stopping" to stop the capacity rebalance operation.
    While a FlexGroup volume is rebalancing, every constituent will have a rebalancing engine that can either be scanning the filesystem for space usage and files to move, actively moving files or temporarily doing neither.
    If one or more constituents has a state of "rebalancing_source" or "rebalancing_dest", then files are being moved to rebalance the FlexGroup.
    If no files are being moved, more information about what the rebalancing engine is doing for each constituent is available using the "rebalancing.engine" property.
    The following values apply to FlexGroup volumes.
    not_running ‐ capacity rebalancing is not running on the volume.
    starting ‐ used in a PATCH operation to start a capacity rebalancing operation.
    rebalancing ‐ capacity rebalancing is running on the volume.
    paused ‐ volume capacity rebalancing is paused on the volume.
    stopping ‐ used in a PATCH operation to stop a capacity rebalancing operation.
    unknown ‐ the system was unable to determine the rebalancing state for the volume.
    The following values apply to FlexGroup volume constiutents.
    idle ‐ capacity rebalancing is running on the constituent, however, no active scanning or file movement is currently occurring.
    scanning ‐ the constituent's file system is being scanned to find files to move and determine free space.
    rebalancing_source ‐ a file is being moved off of the constituent.
    rebalancing_dest ‐ a file is being moved to the constituent.
    not_running ‐ capacity rebalancing is not running on the constituent.
    unknown ‐ the system was unable to determine the rebalancing state for the constituent.

    Valid choices:

    - not_running
    - starting
    - rebalancing
    - paused
    - stopping
    - idle
    - scanning
    - rebalancing_source
    - rebalancing_dest
    - unknown
  `stop_time: ImpreciseDateTime GET`

    Time when the capacity rebalancing operation stopped.

  `target_used: Size GET`

    Represents the ideal used size of each constituent. Calculated by dividing the total FlexGroup volume used size by the number of constituents.

  `used_for_imbalance: Size GET`

    Represents the used size of each constituent, as determined by the rebalancing engine. Calculated by subtracting the size used by Snapshot copies, the size of files pending deletion and the size of filesystem metadata from the volume used size.