FlashArray Reference

Client

FlashArray REST Client Factory Method

pypureclient.flasharray.client.Client(target, version=None, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

Initialize a FlashArray Client.

Keyword Arguments:
 
  • target (str, required) – The target array’s IP or hostname.
  • version (str, optional) – REST API version to use. Defaults to the most recent version supported by both the client and the target array.
  • id_token (str, optional) – The security token that represents the identity of the party on behalf of whom the request is being made, issued by an enabled API client on the array. Overrides given private key.
  • private_key_file (str, optional) – The path of the private key to use. Defaults to None.
  • private_key_password (str, optional) – The password of the private key. Defaults to None.
  • username (str, optional) – Username of the user the token should be issued for. This must be a valid user in the system.
  • client_id (str, optional) – ID of API client that issued the identity token.
  • key_id (str, optional) – Key ID of API client that issued the identity token.
  • issuer (str, optional) – API client’s trusted identity issuer on the array.
  • api_token (str, optional) – API token for the user.
  • retries (int, optional) – The number of times to retry an API call if it fails for a non-blocking reason. Defaults to 5.
  • timeout (float or (float, float), optional) – The timeout duration in seconds, either in total time or (connect and read) times. Defaults to 15.0 total.
  • ssl_cert (str, optional) – SSL certificate to use. Defaults to None.
  • user_agent (str, optional) – User-Agent request header to use.
Raises:

PureError – If it could not create an ID or access token

Importable as

from pypureclient.flasharray import Client

FlashArray REST 2.0 Client

class pypureclient.flasharray.FA_2_0.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

FlashArray REST 2.1 Client

class pypureclient.flasharray.FA_2_1.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

FlashArray REST 2.2 Client

class pypureclient.flasharray.FA_2_2.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

FlashArray REST 2.3 Client

class pypureclient.flasharray.FA_2_3.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

FlashArray REST 2.4 Client

class pypureclient.flasharray.FA_2_4.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

FlashArray REST 2.5 Client

class pypureclient.flasharray.FA_2_5.client.Client(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)
__init__(target, id_token=None, private_key_file=None, private_key_password=None, username=None, client_id=None, key_id=None, issuer=None, api_token=None, retries=5, timeout=15.0, ssl_cert=None, user_agent=None)

Initialize a FlashArray Client. id_token is generated based on app ID and private key info. Either id_token or api_token could be used for authentication. Only one authentication option is allowed.

Keyword Arguments:
 
  • target (str, required) – The target array’s IP or hostname.
  • id_token (str, optional) – The security token that represents the identity of the party on behalf of whom the request is being made, issued by an enabled API client on the array. Overrides given private key.
  • private_key_file (str, optional) – The path of the private key to use. Defaults to None.
  • private_key_password (str, optional) – The password of the private key. Defaults to None.
  • username (str, optional) – Username of the user the token should be issued for. This must be a valid user in the system.
  • client_id (str, optional) – ID of API client that issued the identity token.
  • key_id (str, optional) – Key ID of API client that issued the identity token.
  • issuer (str, optional) – API client’s trusted identity issuer on the array.
  • api_token (str, optional) – API token for the user.
  • retries (int, optional) – The number of times to retry an API call if it fails for a non-blocking reason. Defaults to 5.
  • timeout (float or (float, float), optional) – The timeout duration in seconds, either in total time or (connect and read) times. Defaults to 15.0 total.
  • ssl_cert (str, optional) – SSL certificate to use. Defaults to None.
  • user_agent (str, optional) – User-Agent request header to use.
Raises:

PureError – If it could not create an ID or access token

delete_active_directory(references=None, names=None, authorization=None, x_request_id=None, local_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more Active Directory members.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • names (list[str], required) – Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • local_only (bool, optional) – If specified as true, only delete the Active Directory configuration on the local array, without deleting the computer account created in the Active Directory domain. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_admins(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes the specified administrator.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_admins_api_tokens(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes the API tokens of the specified administrators.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_admins_cache(remove_all_entries=None, authorization=None, x_request_id=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes all entries from the administrator cache.

Parameters:
  • remove_all_entries (bool, required) – If set to true, removes all entries from the administrator cache.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_alert_watchers(references=None, names=None, authorization=None, x_request_id=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Delete alert watcher email address from the list of alert watchers.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • names (list[str], required) – Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_api_clients(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an API client. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_array_connections(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes the connection to the current array from the specified array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_arrays(authorization=None, x_request_id=None, eradicate_all_data=None, factory_reset_token=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an array. For physical appliances, deleting an array restores the hardware to factory settings. This entails deleting all data, metadata, configuration, and logs; the array returns to the state it was in prior to any configuration changes being made. If the hardware is reused, it must be as a different array with a new ID. For virtual appliances, deleting an array puts it into an unusable state. Virtual resources (e.g., virtual machines) can later be freed, which deletes any remaining data, metadata, configuration, and logs. Prior to factory reset, an array must be manually prepared (e.g., all volumes and snapshots must be eradicated) and a factory reset token must be created.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • eradicate_all_data (bool, optional) – Set to true to perform a factory reset.
  • factory_reset_token (int, optional) – A token required to perform a factory reset.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_arrays_factory_reset_token(async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an existing token that could be used to perform a factory reset on the array.

Parameters:
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_certificates(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a specific certificate object.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_connections(host_groups=None, hosts=None, volumes=None, authorization=None, x_request_id=None, host_group_names=None, host_names=None, volume_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes the connection between a volume and its associated host or host group. The volume_names and host_names or host_group_names query parameters are required.

Parameters:
  • host_groups (list[FixedReference], optional) – A list of host_groups to query for. Overrides host_group_names keyword arguments.
  • hosts (list[FixedReference], optional) – A list of hosts to query for. Overrides host_names keyword arguments.
  • volumes (list[FixedReference], optional) – A list of volumes to query for. Overrides volume_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • host_group_names (list[str], optional) – Performs the operation on the host group specified. Enter multiple names in comma-separated format. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple host group names and volume names; instead, at least one of the objects (e.g., host_group_names) must be set to only one name (e.g., hgroup01).
  • host_names (list[str], optional) – Performs the operation on the hosts specified. Enter multiple names in comma- separated format. For example, host01,host02. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple host names and volume names; instead, at least one of the objects (e.g., host_names) must be set to only one name (e.g., host01).
  • volume_names (list[str], optional) – Performs the operation on the volume specified. Enter multiple names in comma- separated format. For example, vol01,vol02. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple volume names and host names; instead, at least one of the objects (e.g., volume_names) must be set to only one name (e.g., vol01).
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directories(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more managed directories. To be deleted, a managed directory must be empty and not attached to any enabled export policies. Deleted managed directories cannot be recovered. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directories_policies_nfs(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a membership between a directory with one or more NFS policies. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directories_policies_smb(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a membership between a directory with one or more SMB policies. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directories_policies_snapshot(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a membership between a directory with one or more snapshot policies. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directory_exports(exports=None, policies=None, authorization=None, x_request_id=None, export_names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more directory exports. If any of the export_names is not unique across the system, policy_ids or policy_names must be specified to determine the exports.

Parameters:
  • exports (list[FixedReference], optional) – A list of exports to query for. Overrides export_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • export_names (list[str], optional) – Performs the operation on the export names specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_directory_snapshots(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a directory snapshot that has been destroyed and is pending eradication. Eradicated directory snapshots cannot be recovered. Directory snapshots are destroyed by using the PATCH method. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_file_systems(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a file system that has been destroyed and is pending eradication. Eradicated file systems cannot be recovered. File systems are destroyed using the PATCH method.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_host_groups(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a host group. The names query parameter is required.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_host_groups_hosts(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a host from a host group. Removing a host from a host group automatically disconnects the host from all volumes associated with the group. Hosts can be removed from host groups at any time. The group_names and member_names parameters are required and must be set together, and only one host group can be specified at a time.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_host_groups_protection_groups(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a host group member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed are not affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the host group. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_hosts(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an existing host. All volumes that are connected to the host, either through private or shared connections, must be disconnected from the host before the host can be deleted. The names query parameter is required.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_hosts_host_groups(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a host from a host group. Removing a host from a host group automatically disconnects the host from all volumes associated with the group. Hosts can be removed from host groups at any time. The group_names and member_names parameters are required and must be set together, and only one host group can be specified at a time.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_hosts_protection_groups(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a host member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed are not affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the host. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_kmip(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes KMIP server objects.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_maintenance_windows(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an open maintenance window before its scheduled end (expire) time. The names parameter is required and must be set to environment.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_network_interfaces(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a network interface on a controller.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_offloads(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes an offload target.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.

Deletes pod replica links. The local_pod_names and remote_pod_names are required. Valid values are replicating, baselining, paused, unhealthy, quiescing, and quiesced. A status of replicating indicates that the source array is replicating to the target array. A status of baselining indicates that the the initial version of the dataset is being sent. During this phase, you cannot promote the target pod. In addition, changing the link direction might trigger the baselining status to recur. A status of paused ` indicates that data transfer between objects has stopped. A status of `unhealthy indicates that the link is currently unhealthy and customers must perform some health checks to determine the cause. A status of quiescing indicates that the source pod is not accepting new write requests but the most recent changes to the source have not arrived on the target. A status of quiesced indicates that the source pod has been demoted and all changes have been replicated to the target pod.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids keyword arguments.
  • local_pods (list[FixedReference], optional) – A list of local_pods to query for. Overrides local_pod_ids and local_pod_names keyword arguments.
  • remote_pods (list[FixedReference], optional) – A list of remote_pods to query for. Overrides remote_pod_ids and remote_pod_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • local_pod_ids (list[str], optional) – A list of local pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_names query parameter.
  • local_pod_names (list[str], optional) – A list of local pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_ids query parameter.
  • remote_pod_ids (list[str], optional) – A list of remote pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_names query parameter.
  • remote_pod_names (list[str], optional) – A list of remote pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_ids query parameter.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_pods(references=None, authorization=None, x_request_id=None, ids=None, names=None, eradicate_contents=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a pod that has been destroyed and is pending eradication. Eradicated pods cannot be recovered. Pods are destroyed using the PATCH method. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • eradicate_contents (bool, optional) – Set to true to eradicate contents (e.g., volumes, protection groups, snapshots) and containers (e.g., pods, volume groups). This enables you to eradicate containers with contents.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_pods_arrays(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, group_ids=None, member_names=None, member_ids=None, with_unknown=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Unstretches a pod from an array, collapsing the pod to a single array. Unstretch a pod from an array when the volumes within the stretched pod no longer need to be synchronously replicated between the two arrays. After a pod has been unstretched, synchronous replication stops. A destroyed version of the pod with “restretch” appended to the pod name is created on the array that no longer has the pod. The restretch pod represents a point-in-time snapshot of the pod, just before it was unstretched. The restretch pod enters an eradication pending period starting from the time that the pod was unstretched. A restretch can pod can be cloned or destroyed, but it cannot be explicitly recovered. The group_names parameter represents the name of the pod to be unstretched. The member_names parameter represents the name of the array from which the pod is to be unstretched. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names and group_ids keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names and member_ids keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • group_ids (list[str], optional) – A list of group IDs.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • with_unknown (bool, optional) – If set to true, unstretches the specified pod from the specified array by force. Use the with_unknown parameter in the following rare event: the local array goes offline while the pod is still stretched across two arrays, the status of the remote array becomes unknown, and there is no guarantee that the pod is online elsewhere.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_nfs(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more NFS policies. The ids or names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_nfs_client_rules(references=None, policies=None, authorization=None, x_request_id=None, names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Delete one or more NFS client policy rules. The policy_ids or policy_names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_nfs_members(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more NFS policies from resources. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_smb(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Delete one or more SMB policies. The ids or names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_smb_client_rules(references=None, policies=None, authorization=None, x_request_id=None, names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more SMB client policy rules. The policy_ids or policy_names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_smb_members(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more SMB policies from resources. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_snapshot(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more snapshot policies. The ids or names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_snapshot_members(members=None, policies=None, authorization=None, x_request_id=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more snapshot policies from resources. The policy_ids or policy_names parameter is required, but cannot be set together. The member_ids or member_names parameter is required, but cannot be set together.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_policies_snapshot_rules(references=None, policies=None, authorization=None, x_request_id=None, names=None, policy_ids=None, policy_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes one or more snapshot policy rules. The policy_ids or policy_names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_group_snapshots(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a protection group snapshot that has been destroyed and is pending eradication. Eradicating a protection group snapshot eradicates all of its protection group snapshots. Eradicated protection group snapshots cannot be recovered. Protection group snapshots are destroyed through the PATCH method. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_groups(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Eradicates a protection group that has been destroyed and is pending eradication. Eradicated protection groups cannot be recovered. Protection groups are destroyed through the PATCH method. The`ids` or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_groups_host_groups(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a host group member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed will not be affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the host group. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_groups_hosts(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a host member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed will not be affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the host. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_groups_targets(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes an array or offload target from a protection group. The group_names parameter represents the name of the protection group. The member_names parameter represents the name of the array or offload target that is being removed from the protection group. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_protection_groups_volumes(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a volume member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed will not be affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the volume. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_remote_protection_group_snapshots(references=None, authorization=None, x_request_id=None, names=None, on=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a remote protection group snapshot that has been destroyed and is pending eradication. Eradicated remote protection group snapshots cannot be recovered. Remote protection group snapshots are destroyed using the PATCH method. The names parameter represents the name of the protection group snapshot. The on parameter represents the name of the offload target. The names and on parameters are required and must be used together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • on (str, optional) – Performs the operation on the target name specified. For example, targetName01.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_remote_protection_groups(references=None, authorization=None, x_request_id=None, ids=None, names=None, on=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Eradicates a remote protection group that has been destroyed and is pending eradication. Eradicated remote protection groups cannot be recovered. Remote protection groups are destroyed through the PATCH method. The on parameter represents the name of the offload target. The ids or names parameter and the on parameter are required and must be used together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • on (str, optional) – Performs the operation on the target name specified. For example, targetName01.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_remote_volume_snapshots(references=None, authorization=None, x_request_id=None, names=None, on=None, replication_snapshot=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Eradicates a remote volume snapshot that has been destroyed and is pending eradication. Eradicated remote volume snapshots cannot be recovered. Remote volume snapshots are destroyed through the PATCH method. The names parameter represents the name of the volume snapshot. The on parameter represents the name of the offload target. The names and on parameters are required and must be used together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • on (str, optional) – Performs the operation on the target name specified. For example, targetName01.
  • replication_snapshot (bool, optional) – If set to true, allow destruction/eradication of snapshots in use by replication. If set to false, allow destruction/eradication of snapshots not in use by replication. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_snmp_managers(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes the SNMP manager object and stops communication with specified managers.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_subnets(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes subnets. A subnet can only be deleted if it has no interfaces. Interfaces must be removed by using the network-interfaces endpoint.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_syslog_servers(references=None, authorization=None, x_request_id=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a configured syslog server and stop forwarding syslog messages.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volume_groups(references=None, authorization=None, x_request_id=None, ids=None, names=None, eradicate_contents=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a volume group that has been destroyed and is pending eradication. Eradicated volume groups cannot be recovered. Volume groups are destroyed through the PATCH method. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • eradicate_contents (bool, optional) – Set to true to eradicate contents (e.g., volumes, protection groups, snapshots) and containers (e.g., pods, volume groups). This enables you to eradicate containers with contents.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volume_snapshots(references=None, authorization=None, x_request_id=None, ids=None, names=None, replication_snapshot=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Eradicate a volume snapshot that has been destroyed and is pending eradication. Eradicated volumes snapshots cannot be recovered. Volume snapshots are destroyed through the PATCH method. The ids or names parameter is required, but cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • replication_snapshot (bool, optional) – If set to true, allow destruction/eradication of snapshots in use by replication. If set to false, allow destruction/eradication of snapshots not in use by replication. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volume_snapshots_tags(resources=None, authorization=None, x_request_id=None, keys=None, namespaces=None, resource_ids=None, resource_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes specified tags on volume snapshot objects.

Parameters:
  • resources (list[FixedReference], optional) – A list of resources to query for. Overrides resource_ids and resource_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • keys (list[str], optional) – A list of tag keys.
  • namespaces (list[str], optional) – A list of namespaces.
  • resource_ids (list[str], optional) – A list of resource IDs. The resource_ids and resource_names parameters cannot be provided together.
  • resource_names (list[str], optional) – A list of resource names. The resource_ids and resource_names parameters cannot be provided together.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volumes(references=None, authorization=None, x_request_id=None, ids=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes a volume that has been destroyed and is pending eradication. Eradicated volumes cannot be recovered. Volumes are destroyed using the PATCH method. The ids or names parameter is required, but they cannot be set together.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volumes_protection_groups(groups=None, members=None, authorization=None, x_request_id=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Removes a volume member from a protection group. After the member has been removed, it is no longer protected by the group. Any protection group snapshots that were taken before the member was removed will not be affected. Removing a member from a protection group does not delete the member from the array, and the member can be added back to the protection group at any time. The group_names parameter represents the name of the protection group, and the member_names parameter represents the name of the volume. The group_names and member_names parameters are required and must be set together.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
delete_volumes_tags(resources=None, authorization=None, x_request_id=None, keys=None, namespaces=None, resource_ids=None, resource_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Deletes specified tags on volume objects.

Parameters:
  • resources (list[FixedReference], optional) – A list of resources to query for. Overrides resource_ids and resource_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • keys (list[str], optional) – A list of tag keys.
  • namespaces (list[str], optional) – A list of namespaces.
  • resource_ids (list[str], optional) – A list of resource IDs. The resource_ids and resource_names parameters cannot be provided together.
  • resource_names (list[str], optional) – A list of resource names. The resource_ids and resource_names parameters cannot be provided together.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_access_token(refresh=False)

Get the last used access token.

Parameters:refresh (bool, optional) – Whether to retrieve a new access token. Defaults to False.
Returns:str
Raises:PureError – If there was an error retrieving an access token.
get_active_directory(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of Active Directory accounts.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_admins(references=None, authorization=None, x_request_id=None, continuation_token=None, expose_api_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of administrators.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • expose_api_token (bool, optional) – If true, exposes the API token of the current user.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_admins_api_tokens(references=None, authorization=None, x_request_id=None, continuation_token=None, expose_api_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays API tokens for the specified administrators.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • expose_api_token (bool, optional) – If true, exposes the API token of the current user.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_admins_cache(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays entries in the administrator cache.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_admins_settings(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the global administrator settings for the array.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_alert_watchers(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays alert watcher email addressess and indicates whether they are enabled.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_alert_watchers_test(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays alert watcher email test results.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_alerts(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, flagged=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of alerts.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • flagged (bool, optional) – If set to true, lists only flagged messages. If set to false, lists only unflagged messages. if not specified, lists all messages.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_alerts_events(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, flagged=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of alert events.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • flagged (bool, optional) – If set to true, lists only flagged messages. If set to false, lists only unflagged messages. if not specified, lists all messages.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format. The ids or names parameter is required, but both cannot be set together.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_api_clients(references=None, authorization=None, x_request_id=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of API clients.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_apps(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of installed apps.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_apps_nodes(apps=None, authorization=None, x_request_id=None, continuation_token=None, app_names=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of installed apps and their nodes.

Parameters:
  • apps (list[FixedReference], optional) – A list of apps to query for. Overrides app_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • app_names (list[str], optional) – The name of the installed app. Enter multiple names in comma-separated format.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_array_connections(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Display a list of connected arrays.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_array_connections_connection_key(async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the connection key for the array.

Parameters:
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_array_connections_path(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the connection path from the array where the connection was made.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of connection paths to each of the connected arrays.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays_eula(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the End User Agreement and signature.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays_factory_reset_token(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of tokens used to perform a factory reset on the array.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays_ntp_test(authorization=None, x_request_id=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays test results for configured NTP servers.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays_performance(authorization=None, x_request_id=None, filter=None, end_time=None, resolution=None, start_time=None, protocol=None, protocol_group=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical front-end performance data at the array level including latency, bandwidth, IOPS, average I/O size, and queue depth.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • protocol (str, optional) – Protocol type. Valid values are nfs, smb, and all.
  • protocol_group (str, optional) – Protocol group type. Valid values are block, file, and all.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_arrays_space(authorization=None, x_request_id=None, filter=None, end_time=None, resolution=None, start_time=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical array space information including unique volume and snapshot space, shared space, data reduction, provisioned capacity, usable capacity, and parity.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_audits(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of audits.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_certificates(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays certificate attributes.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_connections(host_groups=None, hosts=None, protocol_endpoints=None, volumes=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, host_group_names=None, host_names=None, limit=None, offset=None, protocol_endpoint_names=None, sort=None, total_item_count=None, volume_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of connections between a volume and its hosts and host groups, and the logical unit numbers (LUNs) used by the associated hosts to address these volumes.

Parameters:
  • host_groups (list[FixedReference], optional) – A list of host_groups to query for. Overrides host_group_names keyword arguments.
  • hosts (list[FixedReference], optional) – A list of hosts to query for. Overrides host_names keyword arguments.
  • protocol_endpoints (list[FixedReference], optional) – A list of protocol_endpoints to query for. Overrides protocol_endpoint_names keyword arguments.
  • volumes (list[FixedReference], optional) – A list of volumes to query for. Overrides volume_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • host_group_names (list[str], optional) – Performs the operation on the host group specified. Enter multiple names in comma-separated format. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple host group names and volume names; instead, at least one of the objects (e.g., host_group_names) must be set to only one name (e.g., hgroup01).
  • host_names (list[str], optional) – Performs the operation on the hosts specified. Enter multiple names in comma- separated format. For example, host01,host02. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple host names and volume names; instead, at least one of the objects (e.g., host_names) must be set to only one name (e.g., host01).
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • protocol_endpoint_names (list[str], optional) – Performs the operation on the protocol endpoints specified. Enter multiple names in comma-separated format. For example, pe01,pe02. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple protocol endpoint names and host names; instead, at least one of the objects (e.g., protocol_endpoint_names) must be set to one name (e.g., pe01).
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • volume_names (list[str], optional) – Performs the operation on the volume specified. Enter multiple names in comma- separated format. For example, vol01,vol02. A request cannot include a mix of multiple objects with multiple names. For example, a request cannot include a mix of multiple volume names and host names; instead, at least one of the objects (e.g., volume_names) must be set to only one name (e.g., vol01).
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_controllers(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the name, mode, FlashArray model, Purity//FA software version, and status of each controller in the array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories(file_systems=None, references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, file_system_ids=None, file_system_names=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of directories, including those pending eradication.

Parameters:
  • file_systems (list[FixedReference], optional) – A list of file_systems to query for. Overrides file_system_ids and file_system_names keyword arguments.
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • file_system_ids (list[str], optional) – Performs the operation on the file system ID specified. Enter multiple file system IDs in comma-separated format. The file_system_ids and file_system_names parameters cannot be provided together.
  • file_system_names (list[str], optional) – Performs the operation on the file system name specified. Enter multiple file system names in comma-separated format. For example, filesystem01,filesystem02.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_performance(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, protocol=None, protocol_group=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical performance data, real-time latency data, and average I/O sizes for each directory and as a total of all directories across the entire array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • protocol (str, optional) – Protocol type. Valid values are nfs, smb, and all.
  • protocol_group (str, optional) – Protocol group type. Valid values are block, file, and all.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_policies(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of policies that are attached to directories.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_policies_nfs(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of NFS policies that are attached to directories.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_policies_smb(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of SMB policies that are attached to directories.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_policies_snapshot(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of snapshot policies that are attached to directories.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directories_space(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays physical storage consumption data for each directory.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directory_exports(directories=None, exports=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, directory_ids=None, directory_names=None, export_names=None, filter=None, limit=None, offset=None, policy_ids=None, policy_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of directory exports.

Parameters:
  • directories (list[FixedReference], optional) – A list of directories to query for. Overrides directory_ids and directory_names keyword arguments.
  • exports (list[FixedReference], optional) – A list of exports to query for. Overrides export_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • directory_ids (list[str], optional) – Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The directory_ids and directory_names parameters cannot be provided together.
  • directory_names (list[str], optional) – Performs the operation on the managed directory names specified. Enter multiple full managed directory names in comma-separated format. For example, fs:dir01,fs:dir02.
  • export_names (list[str], optional) – Performs the operation on the export names specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directory_services(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the role-based access control (RBAC) group configuration settings for manageability.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directory_services_roles(roles=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, offset=None, role_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the role-based access control (RBAC) group role settings.

Parameters:
  • roles (list[FixedReference], optional) – A list of roles to query for. Overrides role_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • role_names (list[str], optional) – Performs the operation on the unique roles specified. For example, array_admin. Enter multiple roles in comma-separated format.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directory_services_test(references=None, names=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the directory services test and displays the results. The test verifies that URIs can be resolved and that the array can bind and query the tree using the bind user credentials. The test also verifies that the array can find all configured groups to ensure the common names and group base are correctly configured.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • names (list[str], required) – Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_directory_snapshots(references=None, sources=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, source_ids=None, source_names=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of directory snapshots, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_ids and source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_ids (list[str], optional) – Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_dns(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the current DNS parameters of the array, including domain suffix and name servers.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_drives(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of flash, NVRAM, and cache modules that are installed in the array along with their attributes and status.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_file_systems(references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of file systems, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hardware(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of hardware slots and bays and status of installed components.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of host groups.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups_hosts(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of host groups that are associated with hosts.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups_performance(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical performance data, real-time latency data, and average I/O sizes across all volumes, displayed both by host group and as a total across all host groups.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups_performance_by_array(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical performance data, real-time latency data, and average I/O size data. The displayed data is for each volume that is connected to a host group on the current array and for each volume that is connected to a host group on any remote arrays that are visible to the current array. The data is displayed as a total across all host groups on each array and by individual host group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups_protection_groups(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of host group members that belong to one or more protection groups.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_host_groups_space(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns provisioned (virtual) size and physical storage consumption data for each host group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of hosts.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_host_groups(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of hosts that are associated with host groups.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_performance(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical performance data, real-time latency data, and average I/O sizes across all volumes, displayed both by host and as a total across all hosts.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_performance_balance(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the I/O balance statistics for host paths.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_performance_by_array(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays real-time and historical performance data, real-time latency data, and average I/O size data. The data returned is for each volume that is connected to a host on the current array and for each volume that is connected to a host on any remote arrays that are visible to the current array. The data is displayed as a total across all hosts on each array and by individual host.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_protection_groups(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of host members that belong to one or more protection groups.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_hosts_space(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns provisioned (virtual) size and physical storage consumption data for each host.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_kmip(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the list of KMIP server objects.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_kmip_test(references=None, names=None, authorization=None, x_request_id=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays communication data between a FlashArray and KMIP server.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • names (list[str], required) – Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_maintenance_windows(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays maintenance window details, including start time, end time, and maintenance type.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_network_interfaces(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays all network interfaces for all controllers on the array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_network_interfaces_performance(references=None, authorization=None, x_request_id=None, filter=None, end_time=None, resolution=None, start_time=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays network statistics, historical bandwidth, and error reporting for all specified network interfaces.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_offloads(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, protocol=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of offload targets that are connected to the array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • protocol (str, optional) – Protocol type. Valid values are azure, google-cloud, nfs, and s3.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.

Displays the list of pod replica links that are configured between arrays.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids keyword arguments.
  • local_pods (list[FixedReference], optional) – A list of local_pods to query for. Overrides local_pod_ids and local_pod_names keyword arguments.
  • remotes (list[FixedReference], optional) – A list of remotes to query for. Overrides remote_ids and remote_names keyword arguments.
  • remote_pods (list[FixedReference], optional) – A list of remote_pods to query for. Overrides remote_pod_ids and remote_pod_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • local_pod_ids (list[str], optional) – A list of local pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_names query parameter.
  • local_pod_names (list[str], optional) – A list of local pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_ids query parameter.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • remote_ids (list[str], optional) – A list of remote array IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_names query parameter.
  • remote_names (list[str], optional) – A list of remote array names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_ids query parameter.
  • remote_pod_ids (list[str], optional) – A list of remote pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_names query parameter.
  • remote_pod_names (list[str], optional) – A list of remote pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_ids query parameter.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids keyword arguments.
  • local_pods (list[FixedReference], optional) – A list of local_pods to query for. Overrides local_pod_ids and local_pod_names keyword arguments.
  • remotes (list[FixedReference], optional) – A list of remotes to query for. Overrides remote_ids and remote_names keyword arguments.
  • remote_pods (list[FixedReference], optional) – A list of remote_pods to query for. Overrides remote_pod_ids and remote_pod_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • local_pod_ids (list[str], optional) – A list of local pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_names query parameter.
  • local_pod_names (list[str], optional) – A list of local pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_ids query parameter.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • remote_ids (list[str], optional) – A list of remote array IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_names query parameter.
  • remote_names (list[str], optional) – A list of remote array names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_ids query parameter.
  • remote_pod_ids (list[str], optional) – A list of remote pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_names query parameter.
  • remote_pod_names (list[str], optional) – A list of remote pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_ids query parameter.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids keyword arguments.
  • local_pods (list[FixedReference], optional) – A list of local_pods to query for. Overrides local_pod_ids and local_pod_names keyword arguments.
  • remotes (list[FixedReference], optional) – A list of remotes to query for. Overrides remote_ids and remote_names keyword arguments.
  • remote_pods (list[FixedReference], optional) – A list of remote_pods to query for. Overrides remote_pod_ids and remote_pod_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • local_pod_ids (list[str], optional) – A list of local pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_names query parameter.
  • local_pod_names (list[str], optional) – A list of local pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the local_pod_ids query parameter.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • remote_ids (list[str], optional) – A list of remote array IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_names query parameter.
  • remote_names (list[str], optional) – A list of remote array names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_ids query parameter.
  • remote_pod_ids (list[str], optional) – A list of remote pod IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_names query parameter.
  • remote_pod_names (list[str], optional) – A list of remote pod names. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned. This cannot be provided together with the remote_pod_ids query parameter.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, only return the aggregate value of all items after filtering. For real-time performance, the values are aggregated for the latest timestamp. For historical performance, the values are aggregated for each timestamp from start_time to end_time. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods(references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of pods that are stretched to this array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_arrays(groups=None, members=None, authorization=None, x_request_id=None, filter=None, group_names=None, group_ids=None, limit=None, member_names=None, member_ids=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of pods and the local and remote arrays over which the pods are stretched. The optional group_names parameter represents the name of the pod. The optional member_names parameter represents the name of the array over which the pod is stretched.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names and group_ids keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names and member_ids keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • group_ids (list[str], optional) – A list of group IDs.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_performance(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns real-time and historical performance data, real-time latency data, and average I/O sizes across all pods, displayed both by pod and as a total across all pods.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_performance_by_array(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns real-time and historical performance data, real-time latency data, and average I/O size data. The data is displayed as a total across all pods on the local array and by individual pod.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_performance_replication(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays pod replication performance data. The data returned is the real-time and historical performance data for each replication type at the pod level. Values include continuous, periodic, resync, and sync.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, only return the aggregate value of all items after filtering. For real-time performance, the values are aggregated for the latest timestamp. For historical performance, the values are aggregated for each timestamp from start_time to end_time. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_performance_replication_by_array(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays pod replication performance data, organized by array. The data returned is the real-time and historical performance data for each replication type at the pod level. Values include continuous, periodic, resync, and sync.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_pods_space(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, offset=None, sort=None, total_item_count=None, total_only=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays provisioned (virtual) size and physical storage consumption data for each pod on the local array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of policies.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_members(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of policy members.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_nfs(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of NFS policies.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_nfs_client_rules(references=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, policy_ids=None, policy_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of NFS client policy rules.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_nfs_members(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of NFS policy members.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_smb(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Return a list of SMB policies.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_smb_client_rules(references=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, policy_ids=None, policy_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of SMB client policy rules.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_smb_members(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of SMB policy members.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_snapshot(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of snapshot policies.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_snapshot_members(members=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, member_ids=None, member_names=None, member_types=None, policy_ids=None, policy_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of snapshot policy members.

Parameters:
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • member_types (list[str], optional) – Performs the operation on the member types specified. The type of member is the full name of the resource endpoint. Valid values include directories. Enter multiple member types in comma-separated format. For example, type01,type02.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_policies_snapshot_rules(references=None, policies=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, policy_ids=None, policy_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of snapshot policy rules.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • policies (list[FixedReference], optional) – A list of policies to query for. Overrides policy_ids and policy_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • policy_ids (list[str], optional) – Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The policy_ids and policy_names parameters cannot be provided together.
  • policy_names (list[str], optional) – Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, name01,name02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_ports(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays host name, iSCSI Qualified Names (IQNs), NVMe Qualified Names (NQNs), IPv4 address of the portal, Fibre Channel World Wide Names (WWNs), and failover ports, including those that were discovered by Purity//FA and those that have been manually assigned by system administrators.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_ports_initiators(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays host iSCSI Qualified Names (IQNs), NVMe Qualified Names (NQNs), and Fibre Channel World Wide Names (WWNs), including those that were discovered by Purity//FA and those that have been manually assigned by system administrators, along with the array ports (targets) on which they are eligible to communicate.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_group_snapshots(references=None, sources=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, names=None, offset=None, sort=None, source_names=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of protection group snapshots, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_group_snapshots_transfer(references=None, sources=None, authorization=None, x_request_id=None, destroyed=None, filter=None, limit=None, names=None, offset=None, sort=None, source_names=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection group snapshots and their transfer statistics.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups(references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection groups, including their associated source arrays, replication targets, hosts, host groups, and volumes. The list includes protection groups that were created on the local array to replicate snapshot data to other arrays or offload targets, created on a remote array and replicated asynchronously to this array, or created inside a pod on a remote array and stretched to the local array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_host_groups(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection groups that have host group members.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_hosts(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection groups that have host members.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_performance_replication(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, limit=None, offset=None, sort=None, total_item_count=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns the total number of bytes of replication data transmitted and received per second. The data is grouped by protection group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_performance_replication_by_array(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, limit=None, offset=None, sort=None, total_item_count=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns the total number of bytes of replication data transmitted and received per second. The data is grouped by protection group and includes the names of the source array and targets for each protection group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_space(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns provisioned (virtual) size and physical storage consumption data for each protection group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_targets(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection groups that have target arrays or offload targets.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_protection_groups_volumes(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_names=None, limit=None, member_names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of protection groups that have volume members.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_pods(references=None, authorization=None, x_request_id=None, filter=None, ids=None, limit=None, names=None, offset=None, on=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of pods that that are on connected arrays but not stretched to this array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_protection_group_snapshots(references=None, sources=None, authorization=None, x_request_id=None, destroyed=None, filter=None, limit=None, names=None, offset=None, on=None, sort=None, source_names=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of remote protection group snapshots.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_protection_group_snapshots_transfer(sources=None, references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, limit=None, offset=None, on=None, sort=None, source_names=None, total_item_count=None, total_only=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of remote protection groups and their transfer statistics.

Parameters:
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_names keyword arguments.
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_protection_groups(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, on=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of remote protection groups.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_volume_snapshots(references=None, sources=None, authorization=None, x_request_id=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, on=None, sort=None, source_ids=None, source_names=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of remote volume snapshots.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_ids and source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_ids (list[str], optional) – Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_remote_volume_snapshots_transfer(references=None, sources=None, authorization=None, x_request_id=None, destroyed=None, filter=None, ids=None, limit=None, offset=None, on=None, sort=None, source_ids=None, source_names=None, total_item_count=None, total_only=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of remote volume snapshots and their transfer statistics.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_ids and source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • on (list[str], optional) – Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, targetName01,targetName02.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_ids (list[str], optional) – Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_rest_version()

Get the REST API version being used by this client.

Returns:str
get_sessions(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays session data for user login events performed in the Purity//FA GUI, CLI, and REST API.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_smi_s(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the SMI-S settings, including the name of the array and whether SLP and WBEM-HTTPS are enabled.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_smtp_servers(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays SMTP server attributes. Values include user_name, password, relay_host, sender_domain, and name.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_snmp_agents(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the SNMP agent name and protocol attributes.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_snmp_agents_mib(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the SNMP MIB text.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_snmp_managers(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays designated SNMP managers and their communication and security attributes.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_snmp_managers_test(references=None, authorization=None, x_request_id=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays SNMP manager test results (traps or informs).

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_software(references=None, authorization=None, x_request_id=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, versions=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of software versions available for update and the installation status of each software version.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • versions (list[str], optional) – A list of versions.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_software_bundle(references=None, filter=None, ids=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of software bundles.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids keyword arguments.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_software_installation_steps(references=None, software_installations=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, software_installation_ids=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of currently running and completed software upgrade steps.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • software_installations (list[FixedReference], optional) – A list of software_installations to query for. Overrides software_installation_ids keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • software_installation_ids (list[str], optional) – A list of software installation IDs.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_software_installations(references=None, softwares=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, ids=None, limit=None, names=None, offset=None, software_ids=None, software_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of software upgrades. This returns both currently running and past upgrades.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • softwares (list[FixedReference], optional) – A list of softwares to query for. Overrides software_ids and software_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • software_ids (list[str], optional) – A list of software IDs.
  • software_names (list[str], optional) – A list of software names.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_subnets(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of subnets with statuses and attributes.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_support(authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays connection paths between the current array and each connected array.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_support_test(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, test_type=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays information about whether the array can connect to Pure Storage Support by establishing a secure shell or secure HTTP connection and verifies that messages can be exchanged.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • test_type (str, optional) – Specifies the type of test. Valid values are all, phonehome, and remote- assist. If not specified, defaults to all.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_syslog_servers(references=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of configured syslog servers.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_syslog_servers_settings(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays syslog settings. Values include continuation_token, items, more_items_remaining, and total_item_count.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_syslog_servers_test(authorization=None, x_request_id=None, filter=None, limit=None, offset=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays syslog server test results, which indicate whether the syslog is working and configured correctly.

Parameters:
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_groups(references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of volume groups, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_groups_performance(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns real-time and historical performance data, real-time latency data, and average I/O sizes for each volume group and and as a total of all volume groups across the entire array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_groups_space(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, offset=None, sort=None, total_item_count=None, total_only=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns the provisioned (virtual) size and physical storage consumption data for each volume group.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_groups_volumes(groups=None, members=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, group_ids=None, limit=None, member_ids=None, offset=None, sort=None, total_item_count=None, group_names=None, member_names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of volume groups that contain volumes.

Parameters:
  • groups (list[FixedReference], optional) – A list of groups to query for. Overrides group_ids and group_names keyword arguments.
  • members (list[FixedReference], optional) – A list of members to query for. Overrides member_ids and member_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • group_ids (list[str], optional) – A list of group IDs.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • member_ids (list[str], optional) – Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The member_ids and member_names parameters cannot be provided together.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • group_names (list[str], optional) – Performs the operation on the unique group name specified. Examples of groups include host groups, pods, protection groups, and volume groups. Enter multiple names in comma-separated format. For example, hgroup01,hgroup02.
  • member_names (list[str], optional) – Performs the operation on the unique member name specified. Examples of members include volumes, hosts, host groups, and directories. Enter multiple names in comma-separated format. For example, vol01,vol02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_snapshots(references=None, sources=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, source_ids=None, source_names=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Return a list of volume snapshots, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_ids and source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_ids (list[str], optional) – Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_snapshots_tags(resources=None, authorization=None, x_request_id=None, continuation_token=None, filter=None, limit=None, namespaces=None, offset=None, resource_destroyed=None, resource_ids=None, resource_names=None, sort=None, total_item_count=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays the list of tags on volume snapshot objects.

Parameters:
  • resources (list[FixedReference], optional) – A list of resources to query for. Overrides resource_ids and resource_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • namespaces (list[str], optional) – A list of namespaces.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • resource_destroyed (bool, optional) – If set to true, returns only objects from destroyed resources. Returns an error if the name of a live resource is specified in the resource_names query parameter. If set to false, returns only objects from live resources. Returns an error if the name of a destroyed resource is specified in the resource_names query parameter.
  • resource_ids (list[str], optional) – A list of resource IDs. The resource_ids and resource_names parameters cannot be provided together.
  • resource_names (list[str], optional) – A list of resource names. The resource_ids and resource_names parameters cannot be provided together.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volume_snapshots_transfer(references=None, sources=None, authorization=None, x_request_id=None, destroyed=None, filter=None, ids=None, limit=None, offset=None, sort=None, source_ids=None, source_names=None, total_item_count=None, total_only=None, names=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns a list of volume snapshots and their transfer statistics.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • sources (list[FixedReference], optional) – A list of sources to query for. Overrides source_ids and source_names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • source_ids (list[str], optional) – Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
  • source_names (list[str], optional) – Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, name01,name02.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volumes(references=None, authorization=None, x_request_id=None, continuation_token=None, destroyed=None, filter=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Displays a list of volumes, including those pending eradication.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • continuation_token (str, optional) – An opaque token to iterate over a collection of resources.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volumes_performance(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Returns real-time and historical performance data, real-time latency data, and average I/O sizes for each volume and and as a total of all volumes across the entire array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • ids (list[str], optional) – Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The ids and names parameters cannot be provided together.
  • limit (int, optional) – Limit the number of resources in the response. If not specified, defaults to 1000.
  • names (list[str], optional) – Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.
  • offset (int, optional) – The starting position based on the results of the query in relation to the full set of response objects returned.
  • sort (list[Property], optional) – Sort the response by the specified Properties. Can also be a single element.
  • total_item_count (bool, optional) – If set to true, the total_item_count matching the specified query parameters is calculated and returned in the response. If set to false, the total_item_count is null in the response. This may speed up queries where the total_item_count is large. If not specified, defaults to false.
  • total_only (bool, optional) – If set to true, returns the aggregate value of all items after filtering. Where it makes more sense, the average value is displayed instead. The values are displayed for each name where meaningful. If total_only=true, the items list will be empty.
  • async_req (bool, optional) – Request runs in separate thread and method returns multiprocessing.pool.ApplyResult.
  • _return_http_data_only (bool, optional) – Returns only data field.
  • _preload_content (bool, optional) – Response is converted into objects.
  • _request_timeout (int, optional) – Total request timeout in seconds.
Returns:

If the call was successful. ErrorResponse: If the call was not successful.

Return type:

ValidResponse

Raises:
  • PureError – If calling the API fails.
  • ValueError – If a parameter is of an invalid type.
  • TypeError – If invalid or missing parameters are used.
get_volumes_performance_by_array(references=None, authorization=None, x_request_id=None, destroyed=None, filter=None, end_time=None, resolution=None, start_time=None, ids=None, limit=None, names=None, offset=None, sort=None, total_item_count=None, total_only=None, async_req=False, _return_http_data_only=False, _preload_content=True, _request_timeout=None)

Return real-time and historical performance data, real-time latency data, and average I/O size data. The data returned is for each volume on the current array and for each volume on any remote arrays that are visible to the current array. The data is grouped by individual volumes and as a total across all volumes on each array.

Parameters:
  • references (list[FixedReference], optional) – A list of references to query for. Overrides ids and names keyword arguments.
  • x_request_id (str, optional) – A header to provide to track the API call. Generated by the server if not provided.
  • destroyed (bool, optional) – If set to true, lists only destroyed objects that are in the eradication pending state. If set to false, lists only objects that are not destroyed. For destroyed objects, the time remaining is displayed in milliseconds.
  • filter (Filter, optional) – A filter to include only resources that match the specified criteria.
  • end_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resolution parameter to display the performance data at the specified resolution. If not specified, resolution defaults to the lowest valid resolution.
  • resolution (int, optional) – The number of milliseconds between samples of historical data. For array-wide performance metrics (/arrays/performance endpoint), valid values are 1000 (1 second), 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For performance metrics on storage objects (<object name>/performance endpoint), such as volumes, valid values are 30000 (30 seconds), 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). For space metrics, (<object name>/space endpoint), valid values are 300000 (5 minutes), 1800000 (30 minutes), 7200000 (2 hours), 28800000 (8 hours), and 86400000 (24 hours). Include the start_time parameter to display the performance data starting at the specified start time. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. Include the end_time parameter to display the performance data until the specified end time. If end_time`is not specified, the end time will default to the current time. If the `resolution parameter is not specified but either the start_time or end_time parameter is, then resolution will default to the lowest valid resolution.
  • start_time (int, optional) – Displays historical performance data for the specified time window, where start_time is the beginning of the time window, and end_time is the end of the time window. The start_time and end_time parameters are specified in milliseconds since the UNIX epoch. If start_time is not specified, the start time will default to one resolution before the end time, meaning that the most recent sample of performance data will be displayed. If end_time`is not specified, the end time will default to the current time. Include the `resol