Added FlashArray REST 2.33

• POST /volumes/batch now allows parameter allow_throttle
  • This parameter will preemptively fail the operation if array health is not deemed sufficient for the task of copying volumes
• /volumes now newly contain protocol_endpoint, which contains vcversion
  • GET /volumes?filter=subtype=protocol-endpoint
  • PATCH /volumes?names=PE1
  • POST also allows protocol-endpoint parameter in the body
• New endpoint /vchost-connections added to manage ACLs (Access Control Policy) relating to vchosts and protocol endpoints
  • POST /vchost-connections?protocol_endpoint_names=pe1&vchost_names=vchost1
  • GET /vchost-connections?vchost_names=vchost1&protocol_endpoint_names=pe1
  • DELETE /vchost-connections?vchost_names=vchost1&protocol_endpoint_ids=pe-id-1
• New endpoint /volumes/batch/test which attempts to copy multiple volumes without actually doing so
  • Usage is the same as /volumes/batch
• Array connections now support encryption of traffic using TLS 1.3. This feature is inactive unless explicitly turned on. 
  • GET /array-connections/path
  • GET /array-connections/connection-key
• Vchost endpoints and certificates now contain a new field is_local
  • GET/POST/PATCH/DELETE /vchosts/certificates
  • GET/POST/PATCH/DELETE /vchosts/endpoints
• Add ability to create "groups" of email addresses that can subscribe/unsubscribe to specific alert codes and/or categories.
  • GET /policies/alert-watcher
  • POST /policies/alert-watcher
    • Creates one or more alert-watcher policies
    • To copy a policy, set one of either source_names or source_ids
  • PATCH /policies/alert-watcher
    • To enable a policy, set enabled=true. To disable a policy, set enabled=false
    • To rename a policy, set name to the new name
  • DELETE /policies/alert-watcher
  • GET/POST/PATCH/DELETE /policies/alert-watcher/rules
  • GET /policies/alert-watcher/members
  • POST /policies/alert-watcher/members
    • Creates a membership between one or more resources and an alert-watcher policy. The only applicable option right now is array
  • PATCH /policies/alert-watcher/members
  • DELETE /policies/alert-watcher/members
  • GET /policies/alert-watcher/rules/test
    • Test an alert-watcher policy rule's contact information to verify alert notifications can be sent and received.
• /smtp-servers response now contains encryption_mode
  • Filled in in case server uses TLS, null otherwise

1.50.0

Added FlashArray REST 2.32

Changes for REST 2.32

• Creation of multiple volumes
  • New endpoint post_volumes_batch - Used for creating and copying multiple volumes in the same call.
• Authentication methods
  • management.ssh_public_key_attribute field in {get|patch}_directory_services responses.
  • required_authentication_methods in {get|patch}_admins_settings parameter and responses.
  • {post|patch}_admins can accept multiple public keys in public_key parameter.
• Policy replication - Mappings between policies and pod replica links
  • New endpoints {get|patch}_pod_replica_links_mappings_policies
  • New field policy_mapping in {get|post|patch}_policies_{smb|nfs} requests and responses
• Directory exports
  • New endpoint: patch_directory_exports - Used for manually renaming, enabling, and disabling directory exports.
  • New parameter export_enabled in post_directory_exports, post_policies_{nfs|smb}_members, post_directories_policies_{nfs|smb}.
  • New field status in {get|post|patch}_directory_exports, {get|post}_policies_{nfs|smb}_members, {get|post}_directory_policies_{nfs|smb} responses - Explains why enabled is false, or whether there is a name conflict with another export.
  • New parameters directory_names, directory_ids for delete_directory_exports.

1.49.0

New SDK Features:

Pod Creation:

• New attribute allow_throttle

New Endpoints:

• pods_test: Dry-run option for creation / cloning of pods. Will go through the entire process, but avoid making the final change (e.g. creating the pod).
• volumes_test: Dry-run option for creation / cloning of volumes. Will go through the entire process, but avoid making the final change (e.g. creating the volume).

1.48.0

Added FlashBlade REST 2.13

New SDK Features:

• FileSystem Group Ownership: Allow customers to ask for BSD-like semantics inheriting GIDs from directories to new files. Added group_ownership field to the filesystem's configuration.
  • (get|post|patch)_file_systems
• Permanent Retention Lock for Object: FB Object supports permanent retention lock for strict 17a-4 WORM compliance. Added a new configuration object eradication_config to the bucket's configuration.
  • (get|post|patch)_buckets
• Network Access Policies: Added support for managing network access security policies:
  • new methods:
    • (get|patch)_network_access_policies
    • (get|post|patch|delete)_network_access_policies_rules
    • get_network-access-policies_members
  • enhanced methods:
    • get_arrays

1.47.0

Added FlashArray REST 2.30

Changes for REST 2.30

• EULA - The name, title and company properties will be ignored when accepting the EULA and will be null in the response of a GET request.
  • {get|patch}_arrays_eula - No changes in the client code, but the behavior is changed.
• Directory Service Roles - Multiple groups can be mapped to a single purity role.
  • New endpoints: {post|delete}_directory_services_roles
  • Changes in {get|patch}_directory_services_roles:
    • The response field role is now a ReferenceNoId type (previously was a FixedReferenceNoId).
    • New response field: name
    • New parameters: names, references
• Controller information and status
  • get_controllers - new response field mode_since (The time at which the current mode of the controller was last updated).

Client enhancements

• APITokenManager now closes the session on disposal or script exit.

1.46.0

Added FlashBlade REST 2.12

New SDK Features:

• FS Fan-out Replication Granular policies: Multiple policies can now be associated with one snapshots. Added polices field to the response which lists all the associated ones.
  • get_file_system_snapshots
• FileSystem SMB Continuous Availability: Added a new field "Continuous Availability" ( continuous_availability_enabled) to the filesystem's SMB configuration.
  • (get|post|patch)_file_systems
• Public Buckets: Added support for publicly accessible buckets.
  • new methods:
    • (get|post|delete)_buckets_bucket_access_policies
    • (get|post|delete)_buckets_bucket_access_policies_rules
    • (get|post|delete)_buckets_cross_origin_resource_sharing_policies
    • (get|post|delete)_buckets_cross_origin_resource_sharing_policies_rules
  • enhanced methods:
    • get_buckets, get_object_store_accounts - returns public_status field that describes current bucket's public status
    • patch_buckets, patch_object_store_accounts - added a new field public_access_config that configures settings related to public access
• MDTV2: Added a new field global_catalog_servers that lists the global catalog servers that will be used for lookups related to user authorization. directory_servers and global_catalog_servers now accept @ domain suffix for each server.
  • (get|post|patch)_active_directory
• Make multisite bucket default: When creating a bucket, if no bucket_type specified, the default value changed to multi-site-writable.
  • {post}_buckets
• XFMv2: XFMv2 Downlink QSFP-DD 2x100G Support. Changed the set of possible values for port_count field.
  • get_hardware_connectors

1.45.0

2.29 FlashArray REST API Release

Kerberos security options for NFS v4.1 in FA File now supported: "krb5", "krb5i", "krb5p"

Endpoints enhancements

• Continuation token support for:
  • get_volume_snapshots_transfer
  • get_protection_group_snapshot_transfer
• CBS Capacity Expansion endpoints now publicly available to users for both PAZ and PAWS
  • listing supported capacity values
  • setting desired capacity
  • getting the status of capacity update
• Expand GET /software-patches with fields:
  • ha_reduction_required
• Expand POST /software-patches with fields:
  • allow_ha_reduction

Client enhancements

• Dynamic import of versioned clients
• Updated urllib3 >= 1.26.17
• Removed upper limit for python-dateutil

1.44.0

2.28 FlashArray REST API Release

Endpoints enhancements

• new 'suffix' parameter in post_remote_volume_snapshots:
  • The suffix that is appended to the source_name value to generate the full volume snapshot name in the form VOL.SUFFIX.

1.43.1

Bug fix for models

Fixes an issue with null-valued parameters being send.

1.43.0

2.27 FlashArray REST API Release

Endpoints enhancements

• new 'nsid' field in {get|post}_connections response:
  • nsid (int64) is namespace identifier allocated for the NVMe namespace backing the volume. NSID is set for NVMe connections only.

Client enhancements

• Improved integration with read-the-docs service