ancestor: null
releases:
  1.10.0:
    changes:
      bugfixes:
      - purefb_connect - Resolve connection issues between two FBs that are throttling
        capable
      - purefb_policy - Fix incorrect API call for NFS export policy rule creation
      minor_changes:
      - All - Update documentation examples with FQCNs
      - purefb_ad - Allow service to be a list
      - purefb_bucket - Allow setting of bucket type to support VSO - requires Purity//FB
        3.3.3 or higher
      - purefb_certs - Fix several misspellings of certificate
      - purefb_info - Added filesystem default, user and group quotas where available
      - purefb_info - Expose object store bucket type from Purity//FB 3.3.3
      - purefb_info - Show information for current timezone
      - purefb_policy - Allow rename of NFS Export Policies from Purity//FB 3.3.3
      - purefb_tz - Add support for FlashBlade timezone management
    fragments:
    - 179_fqcn.yaml
    - 183_v2_connections.yaml
    - 184_certificate_typos.yaml
    - 185_nfs_export_rule.yaml
    - 186_add_tz.yaml
    - 187_rename_nfs_policy.yaml
    - 188_bucket_type.yaml
    - 191_add_quota_info.yaml
    - 194_lists_for_service.yaml
    modules:
    - description: List FlashBlade Alert Messages
      name: purefb_messages
      namespace: ''
    - description: Configure Pure Storage FlashBlade timezone
      name: purefb_tz
      namespace: ''
    release_date: '2022-09-12'
  1.11.0:
    changes:
      bugfixes:
      - purefb_info - Fixed issue when more than 10 buckets have lifecycle rules.
      - purefb_s3user - Fix incorrect response when bad key/secret pair provided for
        new user
      minor_changes:
      - purefb_info - Added `encryption` and `support_keys` information.
      - purefb_info - Added bucket quota and safemode information per bucket
      - purefb_info - Added security update version for Purity//FB 4.0.2, or higher
      - purefb_info - Updated object store account information
      - purefb_inventory - Added `part_number` to hardware item information.
      - purefb_policy - Added support for multiple rules in snapshot policies
      - purefb_proxy - Added new boolean parameter `secure`. Default of true (for
        backwards compatability) sets the protocol to be `https://`. False sets `http://`
      - purefb_s3acc - Added support for default bucket quotas and hard limits
      - purefb_s3acc - Added support for object account quota and hard limit
    fragments:
    - 200_proxy.yaml
    - 202_multiple_snap_rules.yaml
    - 205_fix_multi_lifecycle.yaml
    - 211_change_booleans.yaml
    - 212_object_account_quota.yaml
    - 213_sec_update.yaml
    - 215_encrypt_sec_info.yaml
    - 216_extra_bucket_info.yaml
    - 217_inventory.yaml
    - 218_object_account_info.yaml
    - 220_s3user_key_fix.yaml
    modules:
    - description: Employ the internal FlashBlade ping and trace mechanisms
      name: purefb_pingtrace
      namespace: ''
    release_date: '2023-04-13'
  1.12.0:
    changes:
      bugfixes:
      - purefb_bucket - Fixed bucket type mode name typo
      - purefb_fs - Fixed issue with incorrect promotion state setting
      minor_changes:
      - purefb_fs - Added support for SMB client and share policies
      - purefb_fs_replica - Added support to delete filesystem replica links from
        REST 2.10
      - purefb_info - Add drive type in drives subset for //S and //E platforms. Only
        available from REST 2.9.
      - purefb_info - Added support for SMB client and share policies
      - purefb_policy - Added support for SMB client and share policies
      - purefb_s3acc - Allow human readable quota sizes; eg. 1T, 230K, etc
      - purefb_s3user - Add new boolean parameter I(multiple_keys) to limit access
        keys for a user to a single key.
    fragments:
    - 222_bucket_type_fix.yaml
    - 223_add_drive_type.yaml
    - 224_smb_policies.yaml
    - 225_delete_rl.yaml
    - 227_s3acc_human_quota.yaml
    - 230_prom_fix.yaml
    - 232_multiple_keys.yaml
    release_date: '2023-07-10'
  1.13.0:
    release_date: '2023-09-07'
  1.13.1:
    changes:
      bugfixes:
      - purefb_info - Fixed missing atributes for SMB client policy rules
      minor_changes:
      - purefb_policy - Add new and updated policy access rights
    fragments:
    - 237_info_policy.yaml
    - 239_access_rights.yaml
    release_date: '2023-09-07'
  1.14.0:
    changes:
      bugfixes:
      - purefb_userpolicy - Fixed `show` state for all user policies
      minor_changes:
      - purefb_bucket_replica - Added support for cascading replica links
      - purefb_info - New fields to display free space (remaining quota) for Accounts
        and Buckets. Space used by destroyed buckets is split out from virtual field
        to new destroyed_virtual field
      - purefb_info - Report encryption state in SMB client policy rules
      - purefb_info - Report more detailed space data from Purity//FB 4.3.0
      - purefb_policy - Add deny effect for object store policy rules. Requires Purity//FB
        4.3.0+
      - purefb_policy - Added parameter to define object store policy description
    fragments:
    - 238_user_policy.yaml
    - 242_cascade.yaml
    - 243_policy_desc.yaml
    - 244_add_deny.yaml
    - 245_quota_plus.yaml
    - 246_smb_encrypt.yaml
    - 247_space_consistency.yaml
    release_date: '2023-10-04'
  1.15.0:
    changes:
      bugfixes:
      - purefb_info - Added missing object lock retention details if enabledd
      minor_changes:
      - purefb_bucket - Add support for public buckets
      - purefb_bucket - From REST 2.12 the `mode` parameter default changes to `multi-site-writable`.
      - purefb_fs - Added SMB Continuous Availability parameter. Requires REST 2.12
        or higher.
      - purefb_info - Added enhanced information for buckets, filesystems and snapshots,
        based on new features in REST 2.12
      - purefb_s3acc - Add support for public buckets
      - purefb_s3acc - Remove default requirements for ``hard_limit`` and ``default_hard_limit``
    fragments:
    - 252_object_lock_info.yaml
    - 254_update_212_info.yaml
    - 255_smb_ca.yaml
    - 257_mode_change.yaml
    - 258_add_public_buckets.yaml
    modules:
    - description: Manage FlashBlade Hardware
      name: purefb_hardware
      namespace: ''
    release_date: '2024-01-12'
  1.16.0:
    changes:
      bugfixes:
      - purefb_bucket - Changed logic to allow complex buckets to be created in a
        single call, rather than having to split into two tasks.
      - purefb_lag - Enable LAG port configuration with multi-chassis
      - purefb_timeout - Fixed arithmetic error that resulted in module incorrectly
        reporting changed when no change was required.
      minor_changes:
      - purefb_ds - Add `force_bind_password` parameter to allow module to be idempotent.
    fragments:
    - 263_fix_multiple_modules_idempotency.yaml
    - 266_bucket_fix.yaml
    - 268_multi-chassis-lag.yaml
    release_date: '2024-02-27'
  1.17.0:
    changes:
      minor_changes:
      - purefb_bucket - Add support for strict 17a-4 WORM compliance.
      - purefb_connect - Increase Fan-In and Fan-Out maximums
      - purefb_fs - Add ``group_ownership`` parameter from Purity//FB 4.4.0.
      - purefb_info - Show array network access policy from Purity//FB 4.4.0
      - purefb_policy - Add support for network access policies from Purity//FB 4.4.0
    fragments:
    - 270_add_go.yaml
    - 271_add_worm.yaml
    - 273_add_nap.yaml
    - 274_fan_in.yaml
    release_date: '2024-04-01'
  1.18.0:
    changes:
      bugfixes:
      - purefb_fs - Fix conflict with SMB mode and ACL safeguarding
      - purefb_fs - Fix error checking for SMB parameter in non-SMB filesystem
      - purefb_info - Fix space reporting issue
      minor_changes:
      - all - add ``disable_warnings`` parameters
      - purefb_bucket - Add ``safemode`` option for ``retention_mode``
      - purefb_certs - Update module to use REST v2 code. This brings in new parameters
        for certificate management.
      - purefb_fs - Set default for group_ownership to be creator
      - purefb_ra - Add ``duration`` option from REST 2.14
      - purefb_ra - Update to REST2
    fragments:
    - 279_update_certs_v2.yaml
    - 281_update_ra.yaml
    - 285_fix_capacity_bug.yaml
    - 286_disable_warningns.yaml
    - 287_safemode.yaml
    - 289_fix_smb_ca.yaml
    - 291_smb.yaml
    release_date: '2024-07-25'
  1.19.0:
    changes:
      bugfixes:
      - purefb_certs - Fix issue with importing certificates
      - purefb_certs - Fix parameter mispelling of ``intermeadiate_cert`` to ``intermediate_cert``.
        Keep original mispelling as an alias.
      - purefb_ds - Initialize variable correctly
      - purefb_policy - Initialize variable correctly
      - purefb_ra - Fix incorrect import statement
      - purefb_snap - Fix issue with immeadiate remote snapshots not executing
      minor_changes:
      - multiple - YAML lint fixes based on updated ``ansible-lint`` version
      - purefb_info - Add ``time_remaining_status`` to bucket information from REST
        2.14
      - purefb_info - Expose SMTP encryption mode
      - purefb_policy - Add new policy type of ``worm`` which is availble from Purity//FB
        4.5.0
      - purefb_smtp - Add encryption mode support from Purity//FB 4.5.0
      - purefb_snap - Change ``targets`` to ``target` and from ``list`` to ``str``.
        ``targets`` added as alias and code to ensure existing list in playbooks is
        translated as a string.
      - purefb_syslog - Enable ``services`` parameter and also the ability update
        existing syslog servers from REST 2.14
    fragments:
    - 296_yaml_lint.yaml
    - 297_import_cert.yaml
    - 299_pylint.yaml
    - 302_import_fix.yaml
    - 304_immeadiate_snapshot.yaml
    - 306_bucket_status.yaml
    - 307_update_syslog.yaml
    - 309_param_typo.yaml
    - 314_worm_policies.yaml
    - 315_smtp_update.yaml
    modules:
    - description: Manage FlashBlade SAML2 service and identity providers
      name: purefb_saml
      namespace: ''
    release_date: '2024-11-01'
  1.19.1:
    changes:
      minor_changes:
      - purefb_bucket - Allow bucket quotas to be modified.
    fragments:
    - 317_quota_update.yaml
    release_date: '2024-11-03'
  1.19.2:
    changes:
      bugfixes:
      - purefb_bucket - Fixed issue with idempotency reported when ``hard_limit``
        not provided.
      - purefb_info - Fixed ``AttributeError`` for ``snapshot`` subset when snapshot
        had been created manually, rather than using a snapshot policy
      - purefb_info - Fixed issue with admin token creation time and bucket policies
      - purefb_policy - Fixed syntax error is account name.
      - purefb_smtp - Fix errors that occurred after adding support for smtp encrpytion
        and using the module on older FlashBlades.
      - purefb_snap - Fixed issue where ``target`` incorrectly required for a regular
        snapshot
    fragments:
    - 324_info_fix.yaml
    - 326_smtp_encryption_fix.yaml
    - 327_bucket_idempotency.yaml
    - 328_immeadiate_snap_fix.yaml
    - 329_no_policy_snap.yaml
    - 336_policy_fix.yaml
    release_date: '2024-12-05'
  1.20.0:
    changes:
      bugfixes:
      - purefb_bucket - Resolved issue with removing bucket quota
      - purefb_info - Fixed issue after SMD Directory Services no longer avaible from
        REST 2.16
      - purefb_policy - Fixed creation of snapshot policies with assigned filesystems
        and/or replica links
      - purefb_s3acc - Fixed issue with public access config settings not being correctly
        for an account
      minor_changes:
      - purefb_ad - Add support for Global Catalog Servers
      - purefb_dns - Added support for multiple DNS configurations.
      - purefb_ds - SMB directory services deprecated from Purity//FB 4.5.2
      - purefb_info - Add support for Active Directory Global Catalog Servers
      - purefb_info - Added snapshot creation date-time and time_remaining, if snapshot
        is not deleted, to the ``snapshots`` response.
      - purefb_info - Added support for multiple DNS configurations.
      - purefb_policy - Snapshot policies can now have specific filesystems and/or
        replica links added or deletred from the policy
      - purefb_proxy - Added support to update existing proxy
      - purefb_proxy - Updated to REST v2
      - purefb_s3user - Changed ``key_state`` state to be ``keystate`` as ``key_state``
        is reserved.
      - purefb_s3user - Changed ``remove_key`` parameter to ``key_name`` and add new
        ``state`` of ``key_state`` to allow a specificed key to be enabled/disabled
        using the new parameter ``enable_key``.
      - purefb_s3user - Updated failure messages for applying policies to an object
        user account.
      - purefb_subnet - ``prefix`` removed as a required parameter for updating an
        existing subnet
    fragments:
    - 331_multi_dns.yaml
    - 332_ad_update.yaml
    - 338_update_s3.yaml
    - 340_snap_creation.yaml
    - 342_no_smb_ds.yaml
    - 349_no_smb_info.yaml
    - 349_none_proxy.yaml
    - 353_s3user_enhanced_policy_reporting.yaml
    - 358_bucket_quota.yaml
    - 359_snap_policy_update.yaml
    - 360_subnet_prefix.yaml
    modules:
    - description: Manage FlashBlade bucket access policies
      name: purefb_bucket_access
      namespace: ''
    - description: Manage Fusion Fleet
      name: purefb_fleet
      namespace: ''
    - description: Manage FlashBlade servers
      name: purefb_server
      namespace: ''
    release_date: '2025-05-02'
  1.3.0:
    changes:
      bugfixes:
      - purefb_bucket - Add warning message if ``state`` is ``absent`` without ``eradicate:``
      - purefb_fs - Add graceful exist when ``state`` is ``absent`` and filesystem
        not eradicated
      - purefb_fs - Add warning message if ``state`` is ``absent`` without ``eradicate``
      major_changes:
      - purefb_alert - manage alert email settings on a FlashBlade
      - purefb_bladename - manage FlashBlade name
      - purefb_bucket_replica - manage bucket replica links on a FlashBlade
      - purefb_connect - manage connections between FlashBlades
      - purefb_dns - manage DNS settings on a FlashBlade
      - purefb_fs_replica - manage filesystem replica links on a FlashBlade
      - purefb_inventory - get information about the hardware inventory of a FlashBlade
      - purefb_ntp - manage the NTP settings for a FlashBlade
      - purefb_phonehome - manage the phone home settings for a FlashBlade
      - purefb_policy - manage the filesystem snapshot policies for a FlashBlade
      - purefb_proxy - manage the phone home HTTP proxy settings for a FlashBlade
      - purefb_remote_cred - manage the Object Store Remote Credentials on a FlashBlade
      - purefb_snmp_agent - modify the FlashBlade SNMP Agent
      - purefb_snmp_mgr - manage SNMP Managers on a FlashBlade
      - purefb_target - manage remote S3-capable targets for a FlashBlade
      - purefb_user - manage local ``pureuser`` account password on a FlashBlade
      minor_changes:
      - purefb_bucket - Versioning support added
      - purefb_info - new options added for information collection
      - purefb_network - Add replication service type
      - purefb_s3user - Limit ``access_key`` recreation to 3 times
      - purefb_s3user - return dict changed from ``ansible_facts`` to ``s3user_info``
      release_summary: '| Release Date: 2020-08-08

        | This changlelog describes all changes made to the modules and plugins included
        in this collection since Ansible 2.9.0

        '
    fragments:
    - v1.3.0_summary.yaml
    release_date: '2020-08-06'
  1.4.0:
    changes:
      bugfixes:
      - purefb_connect - Ensure changing encryption status on array connection is
        performed correctly
      - purefb_connect - Fix breaking change created in purity_fb SDK 1.9.2 for deletion
        of array connections
      - purefb_connect - Hide target array API token
      - purefb_ds - Ensure updating directory service configurations completes correctly
      - purefb_info - Fix issue getting array info when encrypted connection exists
      - purefb_policy - Resolve multiple issues related to incorrect use of timezones
      minor_changes:
      - purefb_banner - Module to manage the GUI and SSH login message
      - purefb_certgrp - Module to manage FlashBlade Certificate Groups
      - purefb_certs - Module to create and delete SSL certificates
      - purefb_connect - Support idempotency when exisitng connection is incoming
      - purefb_fs - Add new options for filesystem control (https://github.com/Pure-Storage-Ansible/FlashBlade-Collection/pull/81)
      - purefb_fs - Default filesystem size on creation changes from 32G to ``unlimited``
      - purefb_fs - Fix error in deletion and eradication of filesystem
      - purefb_fs_replica - Remove condition to attach/detach policies on unhealthy
        replica-link
      - purefb_info - Add support to list filesystem policies
      - purefb_lifecycle - Module to manage FlashBlade Bucket Lifecycle Rules
      - purefb_s3user - Add support for imported user access keys
      - purefb_syslog - Module to manage syslog server configuration
    fragments:
    - 101_fix_policy_and_timezone_error.yaml
    - 76_default_fs_size.yaml
    - 77_filesystem_policies_info.yaml
    - 78_update_filesystem_replica_link.yaml
    - 79_hide_connect_api.yaml
    - 80_support_reverse_replica_link.yaml
    - 81_purefb_fs_new_options.yaml
    - 83_add_certgrp.yml
    - 84_add_cert.yaml
    - 85_add_banner.yaml
    - 86_add_syslog.yaml
    - 88_add_lifecycle.yml
    - 90_delete_conn_fix.yaml
    - 90_imported_keys.yaml
    - 92_fix_ds_update.yaml
    - 96_fix_update_connection.yaml
    - 97_fix_encrpyted_array_connection_info.yaml
    modules:
    - description: Configure Pure Storage FlashBlade GUI and SSH MOTD message
      name: purefb_banner
      namespace: ''
    - description: Manage FlashBlade Certifcate Groups
      name: purefb_certgrp
      namespace: ''
    - description: Manage FlashBlade SSL Certifcates
      name: purefb_certs
      namespace: ''
    - description: Manage FlashBlade object lifecycles
      name: purefb_lifecycle
      namespace: ''
    - description: Configure Pure Storage FlashBlade syslog settings
      name: purefb_syslog
      namespace: ''
    release_date: '2020-10-14'
  1.5.0:
    changes:
      bugfixes:
      - purefb_* - Return a correct value for `changed` in all modules when in check
        mode
      - purefb_dns - Deprecate search paramerter
      - purefb_dsrole - Resolve idempotency issue
      - purefb_lifecycle - Fix error when creating new bucket lifecycle rule.
      - purefb_policy - Ensure undeclared variables are set correctly
      - purefb_s3user - Fix maximum access_key count logic
      minor_changes:
      - purefb_certs - Add update functionality for array cert
      - purefb_fs - Add multiprotocol ACL support
      - purefb_info - Add information regarding filesystem multiprotocol (where available)
      - purefb_info - Add new parameter to provide details on admin users
      - purefb_info - Add replication performace statistics
      - purefb_s3user - Add ability to remove an S3 users existing access key
    fragments:
    - 105_max_access_key.yaml
    - 107_add_remove_s3user_key.yaml
    - 108_dns_search_fix.yaml
    - 109_update_info.yaml
    - 111_dsrole_update_idempotency.yaml
    - 112_fix_check_mode.yaml
    - 113_policy_cleanup.yaml
    - 114_certificate_update.yaml
    - 115_multiprotocol.yaml
    - 121_replication_perf.yaml
    - 123_lifecycle_rule_fix.yaml
    release_date: '2021-03-30'
  1.6.0:
    changes:
      minor_changes:
      - purefb_ad - New module to manage Active Directory Account
      - purefb_eula - New module to sign EULA
      - purefb_info - Add Active Directory, Kerberos and Object Store Account information
      - purefb_info - Add extra info for Purity//FB 3.2+ systems
      - purefb_keytabs - New module to manage Kerberos Keytabs
      - purefb_s3user - Add access policy option to user creation
      - purefb_timeout - Add module to set GUI idle timeout
      - purefb_userpolicy - New module to manage object store user access policies
      - purefb_virtualhost - New module to manage API Clients
      - purefb_virtualhost - New module to manage Object Store Virtual Hosts
    fragments:
    - 127_add_eula.yaml
    - 128_add_32_to_info.yaml
    - 129-virtualhost.yaml
    - 131-apiclient.yaml
    - 132_add_timeout.yaml
    - 135_add_user_policies.yaml
    - 136_add_s3user_policy.yaml
    - 138_add_ad_module.yaml
    - 139_add_keytabs.yaml
    - 140_more_32_info.yaml
    modules:
    - description: Manage FlashBlade Active Directory Account
      name: purefb_ad
      namespace: ''
    - description: Manage FlashBlade API Clients
      name: purefb_apiclient
      namespace: ''
    - description: Sign Pure Storage FlashBlade EULA
      name: purefb_eula
      namespace: ''
    - description: Manage FlashBlade Kerberos Keytabs
      name: purefb_keytabs
      namespace: ''
    - description: Configure Pure Storage FlashBlade GUI idle timeout
      name: purefb_timeout
      namespace: ''
    - description: Manage FlashBlade Object Store User Access Policies
      name: purefb_userpolicy
      namespace: ''
    - description: Manage FlashBlade Object Store Virtual Hosts
      name: purefb_virtualhost
      namespace: ''
    release_date: '2021-04-21'
  1.7.0:
    changes:
      bugfixes:
      - purefb_fs - Fix bug where changing the state of both NFS v3 and v4.1 at the
        same time ignored one of these.
      - purefb_s3acc - Ensure S3 Account Name is always lowercase
      - purefb_s3user - Ensure S3 Account Name is always lowercase
      - purefb_subnet - Allow subnet creation with no gateway
      minor_changes:
      - purefb_groupquota - New module for manage individual filesystem group quotas
      - purefb_lag - Add support for LAG management
      - purefb_snap - Add support for immeadiate snapshot to remote connected FlashBlade
      - purefb_subnet - Add support for multiple LAGs.
      - purefb_userquota - New module for manage individual filesystem user quotas
    fragments:
    - 147_no_gateway.yaml
    - 150_fix_joint_nfs_version_change.yaml
    - 152_s3acc_lowercase.yaml
    - 153_add_quota.yaml
    - 154_add_snap_now.yaml
    - 158_support_lags.yaml
    - 159_add_lag.yaml
    modules:
    - description: Manage filesystem group quotas
      name: purefb_groupquota
      namespace: ''
    - description: Manage FlashBlade Link Aggregation Groups
      name: purefb_lag
      namespace: ''
    - description: Manage filesystem user quotas
      name: purefb_userquota
      namespace: ''
    release_date: '2021-09-27'
  1.8.0:
    changes:
      known_issues:
      - purefb_lag - The mac_address field in the response is not populated. This
        will be fixed in a future FlashBlade update.
      minor_changes:
      - purefb.py - Add check to ensure FlashBlade uses the latest REST version possible
        for Purity version installed
      - purefb_info - Add object lifecycles rules to bucket subset
      - purefb_lifecycle - Add support for updated object lifecycle rules. See documentation
        for details of new parameters.
      - purefb_lifecycle - Change `keep_for` parameter to be `keep_previous_for`.
        `keep_for` is deprecated and will be removed in a later version.
      - purefb_user - Add support for managing user public key and user unlock
    fragments:
    - 161_add_lifecycle_info.yaml
    - 162_new_lifecycle.yaml
    - 163_admin_key.yaml
    - 166_lag_mac_note.yaml
    - 167_fix_logins.yaml
    release_date: '2021-11-08'
  1.8.1:
    changes:
      minor_changes:
      - purefb.py - Use latest `pypureclient` SDK with fix for "best fit". No longer
        requires double login to negotiate best API version.
    fragments:
    - 169_pypureclient_fix.yaml
    release_date: '2021-11-11'
  1.9.0:
    changes:
      minor_changes:
      - purefb_admin - New module to manage global admin settings
      - purefb_connect - Add support for array connections to have bandwidth throttling
        defined
      - purefb_fs - Add support for NFS export policies
      - purefb_info - Add NFS export policies and rules
      - purefb_info - Show array connections bandwidth throttle information
      - purefb_policy - Add NFS export policies, with rules, as a new policy type
      - purefb_policy - Add support for Object Store Access Policies, associated rules
        and user grants
      - purefb_policy - New parameter `policy_type` added. For backwards compatability,
        default to `snapshot` if not provided.
    fragments:
    - 164_add_admin.yaml
    - 174_access_policies.yaml
    - 175_throttle_support.yaml
    - 176_nfs_export_policies.yaml
    release_date: '2021-12-17'
