FlashArray REST API (2.42)

Download OpenAPI specification:Download

Authorization

Pure Storage uses the OAuth 2.0 Token Exchange authorization grant and JSON Web Tokens (JWTs) to authenticate to the Pure Storage REST API. Before you can exchange the ID token for an access token, create and enable the API client to generate the key_id, id, and issuer values. These values will be used as JWT claims for the subject_token parameter.

Get access token

Exchanges an ID Token for an OAuth 2.0 access token.

header Parameters

X-Request-ID

string

Supplied by client during request or generated by server.

Request Body schema: application/x-www-form-urlencoded

grant_type required	string (OauthGrantType) Default: "urn:ietf:params:oauth:grant-type:token-exchange" The method by which the access token will be obtained. The Pure Storage REST API supports the OAuth 2.0 "token exchange" grant type, which indicates that a token exchange is being performed. Set `grant_type` to `urn:ietf:params:oauth:grant-type:token-exchange`.
subject_token required	string (OauthSubjectToken) An encoded security ID Token representing the identity of the party on behalf of whom the request is being made. The token must be issued by a trusted identity provider which must be either a registered application in Pure1 or an enabled API client on the array. The token must be a JSON Web Token and must contain the following claims: \| JWT claim \| Location \| API Client Field \| Description \| Required By \| \|-\|-\|-\|-\|-\| \| kid \| Header \| key_id \| Key ID of the API client that issues the identity token. \| FlashArray and FlashBlade only. \| \| aud \| Payload \| id \| Client ID of the API client that issues the identity token. \| FlashArray and FlashBlade only. \| \| sub \| Payload \| \| Login name of the array user for whom the token should be issued. This must be a valid user in the system. \| FlashArray and FlashBlade only. \| \| iss \| Payload \| issuer \| Application ID for the Pure1 or API client's trusted identity issuer on the array. \| All products. \| \| iat \| Payload \| \| Timestamp of when the identity token was issued. Measured in milliseconds since the UNIX epoch. \| All products. \| \| exp \| Payload \| \| Timestamp of when the identity token will expire. Measured in milliseconds since the UNIX epoch. \| All products. \| Each token must also be signed with the private key that is paired with the API client's public key.
subject_token_type required	string (OauthSubjectTokenType) Default: "urn:ietf:params:oauth:token-type:jwt" An identifier that indicates the type of security token specifed in the `subject_token` parameter. The Pure Storage REST API supports the JSON Web Token (JWT) as the means for requesting the access token. Set `subject_token_type` to `urn:ietf:params:oauth:token-type:jwt`.

Responses

Response samples

Content type

application/json

{"access_token": "eyJraWQiOiJqTlBzL1Ria2c4U2Vua3F3ZmkvbnI4bWxxQ3NPIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhdWQiOiI5NDcyMTkwOC1mNzkyLTcxMmUtYTYzOS0wODM5ZmE4MzA5MjIiLCJzdWIiOiJqb2UiLCJyb2xlIjoic3RvcmFnZV9hZG1pbiIsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3Q6OTAwMCIsImlhdCI6MTU0NDAzNjA1MiwiZXhwIjoxNTQ0MDcyMDUyLCJqdGkiOiJjOTg0MjgyNS1mNGM3LTRiNGUtODdkNy03OWFiZmIxYTUzNDgifQ.pnuYAx0CkmkIG0LDrMAQGRr5Ci4-t5yMto3A7BkmyKnAVHBXG5ZIWwvNkWDLhqbA4YjmG7LZmWHrCVehLy2zy2vRLahFURsd3GTnOaWSyWFIyrwpoO81jQRtOQATtseweuMT_-C8o3oa4MgBNBsuKrhwKQS3oDDpeRPaCRTGev1_xRDxh_K6CWJBTAeOP2pcR4LW6zIJkCLzzkMuyL4aTJWWUjSbl04mcFbyw8r8W1GURrmaDVOvvpT634Hk9-GGh9OMIRlS6OOq7cJKc-RRWn18IK2Gs53V_KYshXTBbnRr990Y_qOX8MaTWOJTqgzsojY02MSVuJ9XDJWoIU3TQytr4K1vM2EvwDZDgl7LuUYUn7vWhbKktFzpeZyyhOjq3eX-ViugYKpIjBcG2f_-fcTPceEWGV82rd6TyVNB5A-v9u2kxCdW198t_kesgVQfuupDeS02cZe0ABLCzEHPiVF17JfiVr6sjkciioxN7Wj_j18ga4U0mdSukauT8yhbgCW1ijTVTFu1VwWebW0s8z3BWMtXdTtZ3BhcZVAdKRF8bOq7nfEbUQGhTn9g7dK-yF050winjtp-VTL2oUtkF5j1v_N8vPNiN9ZdkGJZr7VVZ-qeOJZcjdaRbxL6YB__yT1wkTcKPh8RHz6GUq7Jbyw8VIlcBE2nvJ63d0tH9C4",
"expires_in": 35999,
"issued_token_type": "urn:ietf:params:oauth:token-type:access_token",
"token_type": "Bearer"
}

List available API versions

Returns a list of available API versions. No authentication is required to access this endpoint.

header Parameters

X-Request-ID

string

Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"version": ["1.0",
"1.1",
"1.2",
"1.3",
"1.4",
"1.5",
"1.6",
"1.7",
"1.8",
"1.9",
"1.10",
"1.11",
"1.12",
"1.13",
"1.14",
"1.15",
"1.16",
"1.17",
"2.0"
]
}

POST login (placeholder)

Exchange an API token for a session token.

header Parameters

api-token	string Example: 0f2e2884-9486-c6c2-438c-f50418f2aac3 API token for a user.
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"username": "pureuser"
}
]
}

POST logout (placeholder)

Invalidate a session token.

header Parameters

x-auth-token	string Example: 3be3d489-55c6-4643-90ac-a476dbc98812 Session token for a user.
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Active Directory

Active Directory configuration authenticates users for NFS using Kerberos or SMB using Kerberos or New Technology LAN Manager (NTLM). Active Directory is also used to authorize users by mapping identities across the NFS and SMB protocols by using LDAP queries.

List Active Directory accounts

Displays configured Active Directory accounts.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"computer_name": "FLASHARRAY01",
"directory_servers": ["ldap.my-corporation.com"
],
"domain": "my-corporation.com",
"kerberos_servers": ["kdc.my-corporation.com"
],
"tls": "required"
}
]
}

Create Active Directory account

Creates one or more Active Directory accounts. The user and password provided are used to join the array to the specified domain.

query Parameters

join_existing_account

boolean

If specified as true, the domain is searched for a pre-existing computer account to join to, and no new account will be created within the domain. The user specified when joining a pre-existing account must have permissions to 'read all properties from' and 'reset the password of' the pre-existing account. join_ou will be read from the pre-existing account and cannot be specified when joining to an existing account. If not specified, defaults to false.

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

computer_name	string The name of the computer account to be created in the Active Directory domain. If not specified, defaults to the name of the Active Directory configuration.
directory_servers	Array of strings A list of directory servers used for lookups related to user authorization. Servers must be specified in FQDN format. All specified servers must be registered to the domain appropriately in the configured DNS of the array and are only communicated with over the secure LDAP (LDAPS) protocol. If not specified, servers are resolved for the domain in DNS.
domain	string The Active Directory domain to join.
join_ou	string The distinguished name of the organizational unit in which the computer account should be created when joining the domain. The `DC=...` components of the distinguished name can be optionally omitted. If not specified, defaults to `CN=Computers`.
kerberos_servers	Array of strings A list of key distribution servers to use for Kerberos protocol. Servers must be specified in FQDN format. All specified servers must be registered to the domain appropriately in the configured DNS of the array. If not specified, servers are resolved for the domain in DNS.
password	string The login password of the user with privileges to create the computer account in the domain. This is not persisted on the array.
tls	string TLS mode for communication with domain controllers. Valid values are `required` and `optional`. `required` forces TLS communication with a domain controller. `optional` allows the use of non-TLS communication, TLS will still be preferred, if available. If not specified, defaults to `required`.
user	string The login name of the user with privileges to create the computer account in the domain. This is not persisted on the array.

Responses

Request samples

Payload

Content type

application/json

{"computer_name": "FLASHARRAY01",
"directory_servers": ["ldap.my-corporation.com"
],
"domain": "my-corporation.com",
"join_ou": "OU=Dev,OU=Sweden,DC=purestorage,DC=com",
"kerberos_servers": ["kdc.my-corporation.com"
],
"password": "password",
"tls": "required",
"user": "Administrator"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"computer_name": "FLASHARRAY01",
"directory_servers": ["ldap.my-corporation.com"
],
"domain": "my-corporation.com",
"kerberos_servers": ["kdc.my-corporation.com"
],
"tls": "required"
}
]
}

Delete Active Directory account

Deletes one or more specified Active Directory accounts.

query Parameters

local_only	boolean 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`.
names required	Array of strings Performs the operation on the unique name specified. For example, `name01`. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify Active Directory account

Modifies specified Active Directory account.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

tls

string

TLS mode for communication with domain controllers. Valid values are required and optional. required forces TLS communication with domain controller. optional allows the use of non-TLS communication, TLS will still be preferred, if available. If not specified, defaults to required.

Responses

Request samples

Payload

Content type

application/json

{"tls": "required"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"computer_name": "FLASHARRAY01",
"directory_servers": ["ldap.my-corporation.com"
],
"domain": "my-corporation.com",
"kerberos_servers": ["kdc.my-corporation.com"
],
"tls": "required"
}
]
}

Administrators

The FlashArray has a single default administrative account named pureuser. The administrator can add, delete, and modify administrators on the array. Administrators are assigned management access policies to give different levels of permissions.

List administrators

Displays a list of administrators.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
expose_api_token	boolean If `true`, exposes the API token of the current user.
expose_public_key	boolean If `true`, exposes the public key of the current user.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"api_token": {"created_at": 0,
"expires_at": 0,
"token": "string"
},
"is_local": true,
"locked": false,
"lockout_remaining": 0,
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"password": "string",
"public_key": "string",
"role": {"name": "string"
}
}
]
}

Create an administrator

Creates an administrator.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	Array of objects (_referenceWithType) List of management access policies to associate with the administrator. Policies can be specified by the `name` or `ID` parameter, but they cannot be set together.
password	string Password associated with the account.
	object (_adminRole) This field has been deprecated. Predecessor to management access policies.

Responses

Request samples

Payload

Content type

application/json

{"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"password": "string",
"role": {"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"api_token": {"created_at": 0,
"expires_at": 0,
"token": "string"
},
"is_local": true,
"locked": false,
"lockout_remaining": 0,
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"password": "string",
"public_key": "string",
"role": {"name": "string"
}
}
]
}

Delete an administrator

Deletes the specified administrator.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify an administrator

Modifies properties for the specified administrator.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_apiToken) API token
locked	boolean Returns a value of `true` if the user is currently locked out. otherwise `false`. Change to `false` to unlock a user. This field is only visible to `array_admin` roles. For all other users, the value is always `null`.
password	string Password associated with the account.
public_key	string Public key for SSH access. Multiple public keys can be specified, separated by newlines.
	object (_adminRole) This field has been deprecated. Predecessor to management access policies.
old_password	string The current password.

Responses

Request samples

Payload

Content type

application/json

{"api_token": { },
"locked": false,
"password": "string",
"public_key": "string",
"role": {"name": "string"
},
"old_password": "string"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"api_token": {"created_at": 0,
"expires_at": 0,
"token": "string"
},
"is_local": true,
"locked": false,
"lockout_remaining": 0,
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"password": "string",
"public_key": "string",
"role": {"name": "string"
}
}
]
}

List management access policies attached to administrators

Displays a list of management access policies that are attached to administrators.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between an administrator with one or more management access policies.

Creates a membership between an administrator with one or more management access policies. One of member_ids or member_names parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (PolicyAssignmentPostPolicy)

A list of policies to apply to the resource. One of id or name is required in each policy.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a membership between an administrator and one or more management access policies

Deletes a membership between an administrator with one or more management access policies. One of policy_ids or policy_names is required, and one of member_ids or member_names is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List API tokens

Displays API tokens for the specified administrators.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
expose_api_token	boolean If `true`, exposes the API token of the current user.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"api_token": {"created_at": 0,
"expires_at": 0,
"token": "string"
}
}
]
}

Create API tokens

Creates API tokens for the specified administrators.

query Parameters

names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
timeout	integer <int64> The duration of API token validity, in milliseconds.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"name": "string",
"api_token": {"created_at": 0,
"expires_at": 0,
"token": "string"
}
}
]
}

Delete API tokens

Deletes the API tokens of the specified administrators.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List administrator cache entries

Displays entries in the administrator cache.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"cached_at": 0,
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}
]
}

Update or refresh entries in the administrator cache

Updates entries in the cache for administrators who currently do not have a cache entry, otherwise refreshes the existing entry.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"name": "string",
"cached_at": 0,
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}
]
}

Delete cache entries

Deletes all entries from the administrator cache.

query Parameters

remove_all_entries

required

boolean

If set to true, removes all entries from the administrator cache.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List administrator settings

Displays the global administrator settings for the array.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"lockout_duration": 3600000,
"max_login_attempts": 10,
"min_password_length": 1,
"required_authentication_methods": {"ssh": ["password",
"key"
],
"web_ui": ["password",
"webauthn"
]
},
"single_sign_on_enabled": true
}
],
"more_items_remaining": false,
"total_item_count": 0
}

Modify administrator settings

Modifies the global administrator settings for the array.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

lockout_duration	integer <int64> [ 1000 .. 7776000000 ] The lockout duration, in milliseconds, if a user is locked out after reaching the maximum number of login attempts. Ranges from 1 second to 90 days.
max_login_attempts	integer <int32> [ 1 .. 20 ] Maximum number of failed login attempts allowed before the user is locked out.
min_password_length	integer <int32> Minimum password length. If not specified, defaults to 1.
	object (_adminSettingsRequiredAuthenticationMethods) Authentication methods that are required for the array on specific user interfaces.
single_sign_on_enabled	boolean If `true`, then single sign-on is enabled for the array.

Responses

Request samples

Payload

Content type

application/json

{"lockout_duration": 3600000,
"max_login_attempts": 10,
"min_password_length": 1,
"required_authentication_methods": {"ssh": ["password",
"key"
],
"web_ui": ["password",
"webauthn"
]
},
"single_sign_on_enabled": true
}

Response samples

Content type

application/json

{"items": [{"lockout_duration": 3600000,
"max_login_attempts": 10,
"min_password_length": 1,
"required_authentication_methods": {"ssh": ["password",
"key"
],
"web_ui": ["password",
"webauthn"
]
},
"single_sign_on_enabled": true
}
]
}

Alerts

Alerts indicate significant events that occur on an array, including whenever a component degrades or the capacity threshold of the component is reached.

List alerts

Displays a list of alerts.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
flagged	boolean If set to `true`, lists only flagged messages. If set to `false`, lists only unflagged messages. if not specified, lists all messages.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"actual": "95%",
"category": "array",
"closed": 1578440492342,
"code": 7,
"component_name": "vm-tom",
"component_type": "storage",
"created": 1576275532434,
"description": "boot drive overutilization",
"expected": "90%",
"flagged": true,
"issue": "boot drive overutilization",
"knowledge_base_url": "https://support.purestorage.com/?cid=Alert_0007",
"notified": 1578440491109,
"severity": "critical",
"state": "open",
"summary": "boot drive overutilization",
"updated": 1578440491109
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify flagged state

Modifies one or more alerts and display updated information about these alerts.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

object (FixedReference)

The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, context will always implicitly be set to the array that received the request.

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

flagged

boolean

If set to true, the message is flagged. Important messages can can be flagged and listed separately.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"flagged": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"actual": "95%",
"category": "array",
"closed": 1578440492342,
"code": 7,
"component_name": "vm-tom",
"component_type": "storage",
"created": 1576275532434,
"description": "boot drive overutilization",
"expected": "90%",
"flagged": true,
"issue": "boot drive overutilization",
"knowledge_base_url": "https://support.purestorage.com/?cid=Alert_0007",
"notified": 1578440491109,
"severity": "critical",
"state": "open",
"summary": "boot drive overutilization",
"updated": 1578440491109
}
]
}

List alert events

Displays a list of alert events.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
flagged	boolean If set to `true`, lists only flagged messages. If set to `false`, lists only unflagged messages. if not specified, lists all messages.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings 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 they cannot be set together.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"actual": "95%",
"alert": {"id": "string",
"name": "string"
},
"code": 7,
"component_name": "vm-tom",
"component_type": "storage",
"created": 1576275532434,
"expected": "90%",
"issue": "boot drive overutilization",
"knowledge_base_url": "https://support.purestorage.com/?cid=Alert_0007",
"severity": "critical",
"state": "open",
"summary": "boot drive overutilization",
"time": 1578440491109
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List custom alert rules

Displays a list of custom alert rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
code	integer <int32> The alert code to display.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"code": 25,
"parameter": "info",
"value": "85"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a custom alert rule

Creates an alert rule with a custom value.

query Parameters

code required	integer <int32> The alert code that the rule applies to. Available alert codes for customization can be found in the alert rules catalog.
parameter required	string The parameter of the custom alert rule to modify. Values include `info` and `warning`. Available parameter values can be found in the alert rules catalog.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

object (FixedReference)

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

value

string

The value to use for the custom alert rule. Valid values for an alert code and parameter combination can be found in the alert rules catalog.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"value": "85"
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"code": 25,
"parameter": "info",
"value": "85"
}
]
}

Delete a custom alert rule

Deletes a custom alert rule.

query Parameters

code required	integer <int32> The alert code that the rule applies to. Available alert codes for customization can be found in the alert rules catalog.
parameter required	string The parameter of the custom alert rule to modify. Values include `info` and `warning`. Available parameter values can be found in the alert rules catalog.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a custom alert rule

Modifies a custom alert rule to a new value.

query Parameters

code required	integer <int32> The alert code that the rule applies to. Available alert codes for customization can be found in the alert rules catalog.
parameter required	string The parameter of the custom alert rule to modify. Values include `info` and `warning`. Available parameter values can be found in the alert rules catalog.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

object (FixedReference)

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

value

string

The value to use for the custom alert rule. Valid values for an alert code and parameter combination can be found in the alert rules catalog.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"value": "85"
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"code": 25,
"parameter": "info",
"value": "85"
}
]
}

List available customizable alert codes

Displays a list of available customizable alert codes.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
code	integer <int32> The alert code to display.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"allowed_values": "Range 0-100 (must be equal to or lower than Warning Threshold)",
"code": 25,
"default_value": "80%",
"parameter": "info",
"subject": "Storage consumption has reached {percent_usage}% of usable capacity"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Alert Watchers

Alert watchers receive email notifications when alerts occur on an array.

List alert watchers

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"enabled": true
}
]
}

Create alert watcher

Creates one or more alert watcher email addresses, adding them to the list of alert watchers.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, email notifications will be sent to this watcher for alerts. If set to false, email notifications are disabled. If not specified, defaults to true.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true
}
]
}

Delete alert watcher

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

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify alert watcher

Modify alert watcher email address by enabling or disabling it.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, email notifications will be sent to this watcher for alerts. If set to false, email notifications are disabled.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true
}
]
}

List alert watcher test

Displays alert watcher email test results.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

API Clients

An API client represents an identity type. API clients are created on the array. To create an API client, register and then enable it on the array. After the API client has been created, the user name (sub) and identity tokens (kid and aud tokens) that are issued by the API client are used as claims for the JSON Web Token that you create to authenticate into the REST API.

List API clients

Displays a list of API clients.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"access_token_ttl_in_ms": 15000,
"enabled": true,
"id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"issuer": "https://purestorage.idp.okta.com",
"key_id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"max_role": "storage_admin",
"name": "NightlyStatsAggregationScript",
"public_key": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArSe6chh1JzME9svOKjU0\neKTm8S23Ok3Vr2bWuPri/YHfLrlnRwWoCt+st0/BebKSJ+fQUWOaLlqpZQKpI8oR\ngJ9sWmwGibVG8cTuz7XMkskx9bsm/bjIenuB4W+s3g0BCsi9930mfdKgJgFzY69O\nnLh7d7hAFcmhSJa945PryQZpvJ/U4Ue5F4d+WXgEJ0SoSRaZ6bbeMPhcbMHTzTum\n2ZrPBkK5cqPYitaso6BXeAlqNQPw4Kbu4Ugm0CTogrtImkwoonWDDP34XMOq+u7q\nsNTbJSvDKMTM1RPPrTWCaLiuZkdLVEVesZ9/8+XUMIgBTElwQJDCAQer03MJzqRr\n1eCZGgLfDuYqwMG2MFaAX7kgqBwwyqRTd6MxaQxt2nkdfwiXSY71llzEQ23g3T+1\n64zjwAL5f+dtu8PkGF7IdU2T8P2Qk9bG9pckwZHWYkBK77BAk5jbmSzsKGZgRb2R\n1E+TWDKIaveFhQp251j/C5wkZwMXgjOzN+BOPo+OiLBGUl+jRybWA9f7Vq1MEdf6\nSEdLiqYrXcZERkYBMieLXAfdtaztAIb96cUu+OKMSLDk+D0GHkUfm7lEbDK3ew1+\nD6z+BnxDyH6oqZzz4lS2kPLBLsc+6pdTGuKLf0S9YuLiqJe659AdwU8+X/3KtwNd\nFVJSaxdFbWx0nj3hJqFkIO8CAwEAAQ==\n-----END PUBLIC KEY-----\n"
}
]
}

Create an API client

Creates an API client. Newly created API clients are disabled by default. Enable an API client through the PATCH method. The names, issuer, and public_key parameters are required. The access_policies or max_role parameter is required, but they cannot be set together.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	Array of objects (_referenceWithType) The access policies allowed for ID Tokens issued by this API client. The bearer of an access token will be authorized to perform actions within the intersection of these policies and those of the array user specified as the JWT `sub` (subject) claim.
access_token_ttl_in_ms	integer <int64> The TTL (Time To Live) length of time for the exchanged access token. Measured in milliseconds. If not specified, defaults to `86400000`.
issuer	string The name of the identity provider that will be issuing ID Tokens for this API client. The `iss` claim in the JWT issued must match this string. If not specified, defaults to the API client name.
max_role	string Deprecated. The maximum Admin Access Policy (previously 'role') allowed for ID Tokens issued by this API client. The bearer of an access token will be authorized to perform actions within the intersection of this policy and that of the array user specified as the JWT `sub` (subject) claim. `max_role` is deprecated in favor of `access_policies`, but remains for backwards compatibility. If `max_role` is the name of a valid legacy role, it will be interpreted as the corresponding access policy of the same name. Otherwise, it's invalid.
public_key	string The API client's PEM formatted (Base64 encoded) RSA public key. Include the `-----BEGIN PUBLIC KEY-----` and `-----END PUBLIC KEY-----` lines.

Responses

Request samples

Payload

Content type

application/json

{"access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"access_token_ttl_in_ms": 15000,
"issuer": "https://purestorage.idp.okta.com",
"max_role": "storage_admin",
"public_key": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArSe6chh1JzME9svOKjU0\neKTm8S23Ok3Vr2bWuPri/YHfLrlnRwWoCt+st0/BebKSJ+fQUWOaLlqpZQKpI8oR\ngJ9sWmwGibVG8cTuz7XMkskx9bsm/bjIenuB4W+s3g0BCsi9930mfdKgJgFzY69O\nnLh7d7hAFcmhSJa945PryQZpvJ/U4Ue5F4d+WXgEJ0SoSRaZ6bbeMPhcbMHTzTum\n2ZrPBkK5cqPYitaso6BXeAlqNQPw4Kbu4Ugm0CTogrtImkwoonWDDP34XMOq+u7q\nsNTbJSvDKMTM1RPPrTWCaLiuZkdLVEVesZ9/8+XUMIgBTElwQJDCAQer03MJzqRr\n1eCZGgLfDuYqwMG2MFaAX7kgqBwwyqRTd6MxaQxt2nkdfwiXSY71llzEQ23g3T+1\n64zjwAL5f+dtu8PkGF7IdU2T8P2Qk9bG9pckwZHWYkBK77BAk5jbmSzsKGZgRb2R\n1E+TWDKIaveFhQp251j/C5wkZwMXgjOzN+BOPo+OiLBGUl+jRybWA9f7Vq1MEdf6\nSEdLiqYrXcZERkYBMieLXAfdtaztAIb96cUu+OKMSLDk+D0GHkUfm7lEbDK3ew1+\nD6z+BnxDyH6oqZzz4lS2kPLBLsc+6pdTGuKLf0S9YuLiqJe659AdwU8+X/3KtwNd\nFVJSaxdFbWx0nj3hJqFkIO8CAwEAAQ==\n-----END PUBLIC KEY-----\n"
}

Response samples

Content type

application/json

{"items": [{"access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"access_token_ttl_in_ms": 15000,
"enabled": true,
"id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"issuer": "https://purestorage.idp.okta.com",
"key_id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"max_role": "storage_admin",
"name": "NightlyStatsAggregationScript",
"public_key": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArSe6chh1JzME9svOKjU0\neKTm8S23Ok3Vr2bWuPri/YHfLrlnRwWoCt+st0/BebKSJ+fQUWOaLlqpZQKpI8oR\ngJ9sWmwGibVG8cTuz7XMkskx9bsm/bjIenuB4W+s3g0BCsi9930mfdKgJgFzY69O\nnLh7d7hAFcmhSJa945PryQZpvJ/U4Ue5F4d+WXgEJ0SoSRaZ6bbeMPhcbMHTzTum\n2ZrPBkK5cqPYitaso6BXeAlqNQPw4Kbu4Ugm0CTogrtImkwoonWDDP34XMOq+u7q\nsNTbJSvDKMTM1RPPrTWCaLiuZkdLVEVesZ9/8+XUMIgBTElwQJDCAQer03MJzqRr\n1eCZGgLfDuYqwMG2MFaAX7kgqBwwyqRTd6MxaQxt2nkdfwiXSY71llzEQ23g3T+1\n64zjwAL5f+dtu8PkGF7IdU2T8P2Qk9bG9pckwZHWYkBK77BAk5jbmSzsKGZgRb2R\n1E+TWDKIaveFhQp251j/C5wkZwMXgjOzN+BOPo+OiLBGUl+jRybWA9f7Vq1MEdf6\nSEdLiqYrXcZERkYBMieLXAfdtaztAIb96cUu+OKMSLDk+D0GHkUfm7lEbDK3ew1+\nD6z+BnxDyH6oqZzz4lS2kPLBLsc+6pdTGuKLf0S9YuLiqJe659AdwU8+X/3KtwNd\nFVJSaxdFbWx0nj3hJqFkIO8CAwEAAQ==\n-----END PUBLIC KEY-----\n"
}
]
}

Delete an API client

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

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Manage an API client

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

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

Returns a value of true if the API client is permitted to exchange ID tokens for access tokens. API clients are disabled by default.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"access_token_ttl_in_ms": 15000,
"enabled": true,
"id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"issuer": "https://purestorage.idp.okta.com",
"key_id": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"max_role": "storage_admin",
"name": "NightlyStatsAggregationScript",
"public_key": "-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArSe6chh1JzME9svOKjU0\neKTm8S23Ok3Vr2bWuPri/YHfLrlnRwWoCt+st0/BebKSJ+fQUWOaLlqpZQKpI8oR\ngJ9sWmwGibVG8cTuz7XMkskx9bsm/bjIenuB4W+s3g0BCsi9930mfdKgJgFzY69O\nnLh7d7hAFcmhSJa945PryQZpvJ/U4Ue5F4d+WXgEJ0SoSRaZ6bbeMPhcbMHTzTum\n2ZrPBkK5cqPYitaso6BXeAlqNQPw4Kbu4Ugm0CTogrtImkwoonWDDP34XMOq+u7q\nsNTbJSvDKMTM1RPPrTWCaLiuZkdLVEVesZ9/8+XUMIgBTElwQJDCAQer03MJzqRr\n1eCZGgLfDuYqwMG2MFaAX7kgqBwwyqRTd6MxaQxt2nkdfwiXSY71llzEQ23g3T+1\n64zjwAL5f+dtu8PkGF7IdU2T8P2Qk9bG9pckwZHWYkBK77BAk5jbmSzsKGZgRb2R\n1E+TWDKIaveFhQp251j/C5wkZwMXgjOzN+BOPo+OiLBGUl+jRybWA9f7Vq1MEdf6\nSEdLiqYrXcZERkYBMieLXAfdtaztAIb96cUu+OKMSLDk+D0GHkUfm7lEbDK3ew1+\nD6z+BnxDyH6oqZzz4lS2kPLBLsc+6pdTGuKLf0S9YuLiqJe659AdwU8+X/3KtwNd\nFVJSaxdFbWx0nj3hJqFkIO8CAwEAAQ==\n-----END PUBLIC KEY-----\n"
}
]
}

Apps

Apps that extend array functionality can be integrated into the Purity//FA operating system.

List apps

Displays a list of installed apps.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"description": "Snapshot offload to NFS or Amazon S3",
"details": "Insufficient resources to operate",
"enabled": true,
"status": "healthy",
"version": "1.0.0",
"vnc_enabled": true
}
]
}

Modify app

Modifies an installed app or modifies Virtual Network Computing (VNC) access for apps that are being patched.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean If set to `true`, the app is enabled. By default, apps are disabled.
vnc_enabled	boolean If set to `true`, VNC access is enabled. By default, VNC access is disabled.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"vnc_enabled": true
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"description": "Snapshot offload to NFS or Amazon S3",
"details": "Insufficient resources to operate",
"enabled": true,
"status": "healthy",
"version": "1.0.0",
"vnc_enabled": true
}
]
}

List app nodes

Displays a list of installed apps and their nodes.

query Parameters

app_names	Array of strings The name of the installed app. Enter multiple names in comma-separated format.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"app": {"id": "string",
"name": "string"
},
"index": 0,
"status": "healthy",
"version": "1.0.0",
"vnc": ["10.1.1.10:5900"
]
}
]
}

Arrays

Array features provide the ability to configure settings that affect the operation of the array as a whole and monitor array I/O performance.

List arrays

Displays general array properties including the array name, login banner, idle timeout for management sessions, and NTP servers.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"_as_of": 1684403432765,
"banner": "Restricted area. Authorized personnel only.",
"capacity": 10995116277760,
"console_lock_enabled": false,
"encryption": {"data_at_rest": {"algorithm": "AES-256-CTR",
"enabled": true
},
"module_version": "FA-1.3"
},
"eradication_config": {"disabled_delay": 86400000,
"enabled_delay": 86400000,
"eradication_delay": 86400000,
"manual_eradication": "all-disabled"
},
"idle_timeout": 300000,
"ntp_servers": ["time.acme.com"
],
"ntp_symmetric_key": "string",
"os": "Purity//FA",
"parity": 0.99,
"scsi_timeout": 60000,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"shared_effective": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_zone": "America/Los_Angeles",
"version": "5.0.0"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete an array

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.

query Parameters

eradicate_all_data	boolean Set to `true` to perform a factory reset.
factory_reset_token	integer <int64> A token required to perform a factory reset.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify an array

Modifies general array properties such as the array name, login banner, idle timeout for management sessions, and NTP servers.

query Parameters

context_names

Array of strings

Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request.

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
banner	string
console_lock_enabled	boolean If `true`, console lock is enabled for the array. If the user does not have sufficient access, this field will return `null`.
	object (ArrayEncryption) If the user does not have sufficient access, all fields will return `null`.
	object (Eradication_config) The configuration of eradication feature.
idle_timeout	integer <int32> The idle timeout in milliseconds. Valid values include `0` and any multiple of `60000` in the range of `300000` and `10800000`. Any other values are rounded down to the nearest multiple of `60000`.
ntp_servers	Array of strings NTP Servers. If the user does not have sufficient access, this field will return `null`.
ntp_symmetric_key	string The text of ntp symmetric authentication key. Supported formats include a hex-encoded string no longer than 64 characters, or an ASCII string no longer than 20 characters, excluding "#". Any configured key will be masked as "****" on return. If the user does not have sufficient access, this field will return `null`.
scsi_timeout	integer <int32> The SCSI timeout. If not specified, defaults to `60s`. If the user does not have sufficient access, this field will return `null`.
	object (Space) If the user does not have sufficient access, all fields will return `null`.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"banner": "Restricted area. Authorized personnel only.",
"console_lock_enabled": false,
"encryption": {"data_at_rest": {"algorithm": "AES-256-CTR",
"enabled": true
}
},
"eradication_config": {"disabled_delay": 86400000,
"enabled_delay": 86400000,
"eradication_delay": 86400000
},
"idle_timeout": 300000,
"ntp_servers": ["time.acme.com"
],
"ntp_symmetric_key": "string",
"scsi_timeout": 60000,
"space": { }
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"_as_of": 1684403432765,
"banner": "Restricted area. Authorized personnel only.",
"capacity": 10995116277760,
"console_lock_enabled": false,
"encryption": {"data_at_rest": {"algorithm": "AES-256-CTR",
"enabled": true
},
"module_version": "FA-1.3"
},
"eradication_config": {"disabled_delay": 86400000,
"enabled_delay": 86400000,
"eradication_delay": 86400000,
"manual_eradication": "all-disabled"
},
"idle_timeout": 300000,
"ntp_servers": ["time.acme.com"
],
"ntp_symmetric_key": "string",
"os": "Purity//FA",
"parity": 0.99,
"scsi_timeout": 60000,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"shared_effective": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_zone": "America/Los_Angeles",
"version": "5.0.0"
}
]
}

List CBS array configuration status

Displays the configuration status of the CBS array, including the progress of the configuration upgrade. Requests for non-CBS arrays will receive an error response.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "0f58952a-35e4-7457-b1dd-23454257a1f1",
"model": {"current": "CBS-V10MP2R2",
"details": "",
"override_checks": ["HostIOCheck",
"HostPathsCheck"
],
"requested": "CBS-V20MP2R2",
"status": "upgrading",
"step": "mid-upgrade-check"
},
"name": "string"
}
]
}

Modify CBS array configuration

Modifies the configuration of the CBS array. This should trigger a backend process that will upgrade the CBS array configuration. The array can be upgraded only to models defined by the supported configurations endpoint. When an existing array upgrade request is in progress, any new request to upgrade the array will receive an error response. For non-CBS arrays, this feature is not supported and requests will receive an error response.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

The requested configuration of the CBS array hardware.

object (CloudConfigModelPatch)

The requested model configuration of the CBS array.

Responses

Request samples

Payload

Content type

application/json

{"model": {"add_override_checks": ["HostIOCheck",
"HostPathsCheck"
],
"requested": "CBS-V20MP2R2"
}
}

Response samples

Content type

application/json

{"items": [{"id": "0f58952a-35e4-7457-b1dd-23454257a1f1",
"model": {"current": "CBS-V10MP2R2",
"details": "",
"override_checks": ["HostIOCheck",
"HostPathsCheck"
],
"requested": "CBS-V20MP2R2",
"status": "upgrading",
"step": "mid-upgrade-check"
},
"name": "string"
}
]
}

List CBS array supported upgrade target configs

Displays the list of supported configurations to which the CBS array can be upgraded. Requests for non-CBS arrays will receive an error response.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"supported_models": ["CBS-V20MP2R2"
]
}
]
}

List CBS array capacity status

Displays the capacity status of the CBS array including the progress of the capacity update. Requests for non-CBS arrays will receive an error response.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"current_capacity": 10995116277760,
"details": "string",
"requested_capacity": 10995116277760,
"status": "idle"
}
]
}

Modify CBS array capacity

Modifies the raw capacity of the CBS array. This should trigger a backend process that will update the CBS array capacity. The array capacity can be updated only to values defined by the capacity steps endpoint. When an existing capacity update request is in progress, any new request to update of the capacity will receive an error response. For non-CBS arrays, this feature is not supported and requests will receive an error response.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

The requested capacity of the CBS array.

requested_capacity

integer <int64>

The requested raw capacity of the CBS array in bytes. When the capacity update process finishes, it should be the same as current_capacity.

Responses

Request samples

Payload

Content type

application/json

{"requested_capacity": 10995116277760
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"current_capacity": 10995116277760,
"details": "string",
"requested_capacity": 10995116277760,
"status": "idle"
}
]
}

List CBS array capacity steps

Displays the list of supported raw capacity sizes in bytes the CBS array can be upgraded to. Requests for non-CBS arrays will receive an error response.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"supported_capacity": 10995116277760
}
]
}

List user tags on the cloud.

Displays the list of user tags on deployed cloud resources of a CBS array.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"details": "partially applied",
"key": "environment",
"value": "staging"
}
]
}

Delete user tags from the cloud.

Deletes user tags from deployed cloud resources of a CBS array.

query Parameters

keys	Array of strings A comma-separated list of tag keys.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update user tags on the cloud.

Updates users tags to deployed cloud resources of a CBS array.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if already existing, updated.

Array ()

key	string Key of the tag. Supports UTF-8 Unicode characters. Please refer to the offical document from cloud providers for limitations.
value	string Value of the tag. Supports UTF-8 Unicode characters. Please refer to the offical document from cloud providers for limitations.

Responses

Request samples

Payload

Content type

application/json

[{"key": "environment",
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"details": "partially applied",
"key": "environment",
"value": "staging"
}
]
}

List factory reset details

Displays a list of factory reset processes.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"details": "string",
"image_download_progress": 0.32,
"image_source": "auto",
"image_version": "6.6.6",
"sanitization_certificate": "string",
"status": "resetting"
}
]
}

Create a process for factory reset

Creates the initiation of the factory reset process

query Parameters

eradicate_all_data required	boolean Set to `true` to perform a factory reset.
preserve_configuration_data required	Array of strings A comma-separated list of configuration data types to preserve. A value of `all` will preserve all configuration data types. Valid values include `all`.
skip_phonehome_check	boolean A flag to skip phonehome connectivity check. If `skip_phonehome_check` is not set, the factory reset will fail if phonehome connectivity check fails. Arrays that intentionally disable phonehome or do not permit connectivity to Pure Storage's cloud servers must set this flag to `true` in order to start factory reset.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"details": "string",
"image_download_progress": 0.32,
"image_source": "auto",
"image_version": "6.6.6",
"sanitization_certificate": "string",
"status": "resetting"
}
]
}

Delete factory reset

Deletes the factory reset process when it is failed.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update factory reset

Modifies the factory reset process to finalize.

query Parameters

delete_sanitization_certificate required	boolean Set to `true` to finalize factory reset and acknowledge the deletion of sanitization certificate.
eradicate_all_data required	boolean Set to `true` to perform a factory reset.
finalize required	boolean Must be `true` to finalize factory reset.
reinstall_image required	boolean Set to `true` to reinstall image, or `false` to skip reinstalling image.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

image_source	string Source of the ISO image to download. Valid values include `auto` and URLs. `auto` means download the image from Pure1 cloud, and a URL means download the image from the specified URL. Default value is `auto`.
image_version	string Version of the image to download. `image_version` is optional, and the default value is the current running Purity version. If `image_source` is `auto`, the image with the specified version will be downloaded from Pure1 cloud. If `image_source` is a URL, `image_version` will be used to compare to the downloaded image version for the purpose of validation.

Responses

Request samples

Payload

Content type

application/json

{"image_source": "auto",
"image_version": "6.6.6"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"details": "string",
"image_download_progress": 0.32,
"image_source": "auto",
"image_version": "6.6.6",
"sanitization_certificate": "string",
"status": "resetting"
}
]
}

List End User Agreement and signature

Displays the End User Agreement and signature.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"agreement": "string",
"signature": {"accepted": 1577880000000,
"company": "Example Inc.",
"name": "John Doe",
"title": "Admin"
}
}
]
}

Modify signature on the End User Agreement

Modifies the signature on the End User Agreement.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

object (_eula_signature)

Responses

Request samples

Payload

Content type

application/json

{"signature": {"company": "Example Inc.",
"name": "John Doe",
"title": "Admin"
}
}

Response samples

Content type

application/json

{"items": [{"agreement": "string",
"signature": {"accepted": 1577880000000,
"company": "Example Inc.",
"name": "John Doe",
"title": "Admin"
}
}
]
}

List factory reset tokens

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

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"token": 4671919
}
]
}

Create a factory reset token

Creates a token that can be used to perform a factory reset on the array. Factory reset tokens can only be created after the array has been prepared for reset (e.g., all volumes and snapshots must first be eradicated). After a token has been created, operations that would take the array out of the prepared state are disabled (e.g., creating volumes) until all tokens have been deleted.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"token": 4671919
}
]
}

Delete a factory reset token

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

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List NTP test results

Displays test results for configured NTP servers.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome"
}
]
}

List array front-end performance data

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

query Parameters

end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol	string Protocol type. Valid values are `nfs`, `smb`, and `all`.
protocol_group	string Protocol group type. Valid values are `block`, `file`, and `all`.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"local_queue_usec_per_op": 0,
"others_per_sec": 0,
"queue_depth": 0,
"usec_per_other_op": 0
}
]
}

List array front-end IO performance data by link

Displays real-time and historical front-end performance data at the array level including latency, bandwidth, IOPS, average I/O size, and queue depth. Group output is shown by link. A link represents a set of arrays that an I/O operation depends on. For local-only I/Os, this is a local array. For mirrored I/Os, this is a set of synchronous replication peer arrays.

query Parameters

end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"local_queue_usec_per_op": 0,
"others_per_sec": 0,
"queue_depth": 0,
"usec_per_other_op": 0,
"link": [{"id": "string",
"name": "string"
}
]
}
]
}

List array space information

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"capacity": 10995116277760,
"capacity_installed": 46179488366592,
"parity": 0.99,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"shared_effective": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags on array objects.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags on array objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if they already exist, updated.

Array ()

key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Array Connections

Manages connections between arrays.

List the connected arrays

Displays a list of connected arrays.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"encryption": "encrypted",
"encryption_mode": "TLS-PSK-AES-256",
"management_address": "10.202.101.78",
"os": "string",
"remote": {"id": "string",
"name": "string",
"resource_type": "string"
},
"replication_addresses": ["10.202.101.70"
],
"replication_transport": "ip",
"status": "string",
"throttle": {"default_limit": 1073741824,
"window": {"end": 46800000,
"start": 3600000
},
"window_limit": 2097152
},
"type": "string",
"version": "5.0.0"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create an array connection

Creates a connection between this array and the specified array.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

connection_key	string The connection key of the target array.
encryption	string If `encrypted`, all traffic over this array connection will be encrypted. If `unencrypted`, all traffic over this array connection will be unencrypted. Defaults to `unencrypted`.
management_address	string Management IP address of the target array.
replication_addresses	Array of strings IP addresses and FQDNs of the target arrays. Configurable only when `replication_transport` is set to `ip`. If not configured, will be set to all the replication addresses available on the target array at the time of the POST.
replication_transport	string The protocol used to transport data between the local array and the remote array. Valid values are `ip` and `fc`. The default is `ip`.
type	string The type of replication. Valid values are `async-replication` and `sync-replication`.

Responses

Request samples

Payload

Content type

application/json

{"connection_key": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"encryption": "encrypted",
"management_address": "10.202.101.78",
"replication_addresses": ["10.202.101.70"
],
"replication_transport": "ip",
"type": "async-replication"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"encryption": "encrypted",
"encryption_mode": "TLS-PSK-AES-256",
"management_address": "10.202.101.78",
"os": "string",
"remote": {"id": "string",
"name": "string",
"resource_type": "string"
},
"replication_addresses": ["10.202.101.70"
],
"replication_transport": "ip",
"status": "string",
"throttle": {"default_limit": 1073741824,
"window": {"end": 46800000,
"start": 3600000
},
"window_limit": 2097152
},
"type": "string",
"version": "5.0.0"
}
]
}

Delete an array connection

Deletes the connection between this array and the specified array.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify an array connection

Modifies attributes for an array connection.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
refresh	boolean If set to `true`, the array will attempt to communicate with the connection peer in order to update the connection attributes on both arrays with any changes that have occurred. If set to `true`, other array connection attributes may not be modified in requests. Default value is `false`.
renew_encryption_key	boolean If set to `true`, update array connection with a new encryption key. If set to `true`, other array connection attributes may not be modified in requests. Defaults to `false`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

default_limit	integer <int64> Deprecated. Default maximum bandwidth threshold for outbound traffic in bytes. Once exceeded, bandwidth throttling occurs.
	object (TimeWindow) Deprecated. The time during which the `window_limit` threshold is in effect.
window_limit	integer <int64> Deprecated. Maximum bandwidth threshold for outbound traffic during the specified `window_limit` time range in bytes. Once exceeded, bandwidth throttling occurs.
connection_key	string The connection key of the target array. It is only required when `encryption` is changed from `unencrypted` to `encrypted`, or when `type` is changed from `async-replication` to `sync-replication`.
encryption	string If `encrypted`, encryption will be enabled for all traffic over this array connection. `connection_key` must be specified when encrypted is set to `true`. If `unencrypted`, encryption will be disabled for all traffic over this array connection. If not specified, the current encryption option for the array connection will remain unchanged.
management_address	string Management IP address of the target array.
replication_addresses	Array of strings IP addresses and FQDNs of the target arrays. Configurable only when `replication_transport` is set to `ip`.
	object (_throttle) The bandwidth throttling for an array connection. Configurable on PATCH only.
type	string The type of replication. Valid values are `async-replication` and `sync-replication`.

Responses

Request samples

Payload

Content type

application/json

{"default_limit": 1073741824,
"window": {"end": 46800000,
"start": 3600000
},
"window_limit": 2097152,
"connection_key": "6207d123-d123-0b5c-5fa1-95fabc5c7123",
"encryption": "encrypted",
"management_address": "10.202.101.78",
"replication_addresses": ["10.202.101.70"
],
"throttle": {"default_limit": 1073741824,
"window": {"end": 46800000,
"start": 3600000
},
"window_limit": 2097152
},
"type": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"encryption": "encrypted",
"encryption_mode": "TLS-PSK-AES-256",
"management_address": "10.202.101.78",
"os": "string",
"remote": {"id": "string",
"name": "string",
"resource_type": "string"
},
"replication_addresses": ["10.202.101.70"
],
"replication_transport": "ip",
"status": "string",
"throttle": {"default_limit": 1073741824,
"window": {"end": 46800000,
"start": 3600000
},
"window_limit": 2097152
},
"type": "string",
"version": "5.0.0"
}
]
}

List connection key

Displays the connection key for the array.

query Parameters

encrypted

boolean

If true, the returned array connection key will encode an encryption key used to establish trust and secure replication traffic. If false, the returned array connection key will not encode an encryption key. If not specified, defaults to false.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"connection_key": "6207d123-d123-0b5c-5fa1-95fabc5c7123"
}
]
}

List connection path

Displays the connection path from the array to which the connection was made.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"encryption": "encrypted",
"encryption_mode": "TLS-PSK-AES-256",
"id": "string",
"local_address": "10.202.101.70",
"local_port": "ct0.eth0",
"remote": {"id": "string",
"name": "string",
"resource_type": "string"
},
"remote_address": "10.202.101.78",
"remote_port": "ct1.eth0",
"replication_transport": "string",
"status": "string",
"status_details": "string",
"type": "string"
}
]
}

Audits

Audit trail records describe administrative actions performed by a user to modify the configuration of an array.

List audits

Displays a list of audits.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"arguments": "--size 1G vol2",
"command": "purevol",
"origin": {"id": "string",
"name": "string"
},
"subcommand": "create",
"time": 1577402821354,
"user": "pureuser",
"user_interface": "CLI"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Certificates

Purity//FA creates a self-signed certificate and private key when you start the system for the first time. You can use the default certificate, change the certificate attributes, create a new self-signed certificate, or import an SSL certificate signed by a certificate authority.

List certificate attributes

Displays certificate attributes.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"certificate": "string",
"certificate_type": "string",
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"intermediate_certificate": "string",
"issued_by": "Symantec, Inc.",
"issued_to": "Pure Storage, Inc.",
"key_algorithm": "rsa",
"key_size": 2048,
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"status": "string",
"subject_alternative_names": ["otherdnsname.mydomain.com"
],
"valid_from": 1491070899,
"valid_to": 1524248499
}
]
}

Create certificate

Creates a certificate object and specifies the valid time period and organization details of the certificate. A certificate can be imported or manually configured.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

certificate	string The text of the certificate.
common_name	string The common name field listed in the certificate.
country	string Two-letter country (ISO) code listed in the certificate.
email	string The email field listed in the certificate.
intermediate_certificate	string The text of the intermediate certificate chains.
key_algorithm	string The key algorithm used to generate the certificate. This field can only be specified when creating a new self-signed certificate. Defaults to rsa if not specified. Valid values when creating a new self-signed certificate only include `rsa`, `ec`, `ed448` and `ed25519`.
key_size	integer <int32> The size (in bits) of the private key for the certificate. Default is 2048 bits for `rsa` key_algorithm, 256 for `ec` and `ed25519`. The `ed448` default key size is 456. This field can only be specified when creating a new self-signed certificate.
locality	string The locality field listed in the certificate.
organization	string The organization field listed in the certificate.
organizational_unit	string The organizational unit field listed in the certificate.
state	string The state/province field listed in the certificate.
subject_alternative_names	Array of strings The alternative names that are secured by this certificate. Alternative names may be IP addresses, DNS names, or URIs.
days	integer <int32> The number of days that the self-signed certificate is valid. Defaults to 3650. This field can only be specified when creating a new self-signed certificate.
key	string The text of the private key. This field can only be specified when importing a certificate and key pair.
passphrase	string The passphrase used to encrypt `key`. This field can only be specified when importing a certificate and key pair.

Responses

Request samples

Payload

Content type

application/json

{"certificate": "string",
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"intermediate_certificate": "string",
"key_algorithm": "rsa",
"key_size": 2048,
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"subject_alternative_names": ["otherdnsname.mydomain.com"
],
"days": 3650,
"key": "string",
"passphrase": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"certificate": "string",
"certificate_type": "string",
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"intermediate_certificate": "string",
"issued_by": "Symantec, Inc.",
"issued_to": "Pure Storage, Inc.",
"key_algorithm": "rsa",
"key_size": 2048,
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"status": "string",
"subject_alternative_names": ["otherdnsname.mydomain.com"
],
"valid_from": 1491070899,
"valid_to": 1524248499
}
]
}

Delete certificate

Deletes a specific certificate object.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify certificates

Modifies certificate attributes. Modifying self-signed certificate attributes replaces the existing certificate with a new one, generated by Purity//FA, using the specified attributes.

query Parameters

generate_new_key	boolean If set to `true`, a new private key is generated when generating a new certificate with the specified attributes. This may not be set to `true` when importing a certificate and private key, and may not be set to `false` when generating a new self-signed certificate to replace a certificate that was imported. Default setting is `false`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

certificate	string The text of the certificate.
common_name	string The common name field listed in the certificate.
country	string Two-letter country (ISO) code listed in the certificate.
email	string The email field listed in the certificate.
intermediate_certificate	string The text of the intermediate certificate chains.
key_algorithm	string The key algorithm used to generate the certificate. This field can only be specified when creating a new self-signed certificate. Defaults to rsa if not specified. Valid values when creating a new self-signed certificate only include `rsa`, `ec`, `ed448` and `ed25519`.
key_size	integer <int32> The size (in bits) of the private key for the certificate. Default is 2048 bits for `rsa` key_algorithm, 256 for `ec` and `ed25519`. The `ed448` default key size is 456. This field can only be specified when creating a new self-signed certificate.
locality	string The locality field listed in the certificate.
organization	string The organization field listed in the certificate.
organizational_unit	string The organizational unit field listed in the certificate.
state	string The state/province field listed in the certificate.
subject_alternative_names	Array of strings The alternative names that are secured by this certificate. Alternative names may be IP addresses, DNS names, or URIs.
days	integer <int32> The number of days that the self-signed certificate is valid. Defaults to 3650. This field can only be specified when creating a new self-signed certificate.
key	string The text of the private key. This field can only be specified when importing a certificate and key pair.
passphrase	string The passphrase used to encrypt `key`. This field can only be specified when importing a certificate and key pair.

Responses

Request samples

Payload

Content type

application/json

{"certificate": "string",
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"intermediate_certificate": "string",
"key_algorithm": "rsa",
"key_size": 2048,
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"subject_alternative_names": ["otherdnsname.mydomain.com"
],
"days": 3650,
"key": "string",
"passphrase": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"certificate": "string",
"certificate_type": "string",
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"intermediate_certificate": "string",
"issued_by": "Symantec, Inc.",
"issued_to": "Pure Storage, Inc.",
"key_algorithm": "rsa",
"key_size": 2048,
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"status": "string",
"subject_alternative_names": ["otherdnsname.mydomain.com"
],
"valid_from": 1491070899,
"valid_to": 1524248499
}
]
}

List certificates and certificate-groups

Lists membership associations between groups and certificates.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Create certificates orcertificate-groups

Creates one or more certificates to one or more certificate groups.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Deletes certificates/certificate-groups

Deletes one or more certificates from one or more certificate groups.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List certificates uses

Displays the usage and associations of certificates.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"use": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Create certificate-signing-requests

Creates a certificate signing request using a specified certificate and parameters.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_referenceNoId)
common_name	string The common name field listed in the certificate.
country	string Two-letter country (ISO) code listed in the certificate.
email	string The email field listed in the certificate.
locality	string The locality field listed in the certificate.
organization	string The organization field listed in the certificate.
organizational_unit	string The organizational unit field listed in the certificate.
state	string The state/province field listed in the certificate.
subject_alternative_names	Array of strings The alternative names that are secured by this certificate. Alternative names include IP addresses, DNS names, or URIs.

Responses

Request samples

Payload

Content type

application/json

{"certificate": {"name": "string"
},
"common_name": "Pure Storage Inc.",
"country": "CA",
"email": "tcrisp@veridiandynamics.com",
"locality": "Toronto",
"organization": "Veridian Dynamics",
"organizational_unit": "Research & Development",
"state": "Ontario",
"subject_alternative_names": ["otherdnsname.mydomain.com"
]
}

Response samples

Content type

application/json

{"items": [{"certificate_signing_request": "string"
}
]
}

Certificate Groups

Certificate groups, also known as certificate bundles, are collections of digital certificates. Each certificate can belong to one or more groups in order to serve different purposes.

List certificate-groups

Display all array certificate groups.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string"
}
]
}

Create certificate-groups

Creates one or more certificate groups on the array.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string"
}
]
}

Delete certificate-groups

Deletes one or more certificate groups from the array.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List certificate-groups and certificates

Lists membership associations between groups and certificates on the array.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Create certificate-groups/certificates

Creates one or more certificates to one or more certificate groups on the array.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete certificate-groups or certificates

Deletes one or more certificate groups.

query Parameters

certificate_group_ids	Array of strings A comma-separated list of certificate group ids. If there is not at least one resource that matches each of the elements of `certificate_group_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_names` parameter.
certificate_group_names	Array of strings A comma-separated list of certificate group names. If no resource matches each of the elements of `certificate_group_names`, then an error is returned. This cannot be provided in conjunction with the `certificate_group_ids` parameter.
certificate_ids	Array of strings A comma-separated list of certificate ids. If there is not at least one resource that matches each of the elements of `certificate_ids`, then an error is returned. This cannot be provided in conjunction with the `certificate_names` parameter.
certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List certificate-groups/uses

Lists how certificate groups are being used and by what.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"use": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Connections

A connection gives hosts access to volumes on the array.

List volume connections

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
host_group_names	Array of strings 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	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol_endpoint_ids	Array of strings Performs the operation on the protocol endpoints specified. Enter multiple IDs in comma-separated format. For example, `peid01,peid02`. A request cannot include a mix of multiple objects with multiple IDs. For example, a request cannot include a mix of multiple protocol endpoint IDs and host names. Instead, at least one of the objects (e.g., `protocol_endpoint_ids`) must be set to one ID (e.g., `peid01`).
protocol_endpoint_names	Array of strings 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	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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_ids	Array of strings Performs the operation on the specified volume. Enter multiple ids in comma-separated format. For example, `vol01id,vol02id`. A request cannot include a mix of multiple objects with multiple IDs. For example, a request cannot include a mix of multiple volume IDs and host names; instead, at least one of the objects (e.g., `volume_ids`) must be set to only one name (e.g., `vol01id`). Only one of the two between `volume_names` and `volume_ids` may be used at a time.
volume_names	Array of strings 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`).

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"host": {"name": "string"
},
"host_group": {"name": "string"
},
"lun": 7,
"nsid": 3856,
"protocol_endpoint": {"id": "string",
"name": "string"
},
"volume": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a connection between a volume and host or host group

Creates a connection between a volume and a host or host group. One of volume_names or volume_ids and one of host_names or host_group_names query parameters are required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
host_group_names	Array of strings 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	Array of strings 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_ids	Array of strings Performs the operation on the specified volume. Enter multiple ids in comma-separated format. For example, `vol01id,vol02id`. A request cannot include a mix of multiple objects with multiple IDs. For example, a request cannot include a mix of multiple volume IDs and host names; instead, at least one of the objects (e.g., `volume_ids`) must be set to only one name (e.g., `vol01id`). Only one of the two between `volume_names` and `volume_ids` may be used at a time.
volume_names	Array of strings 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`).

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

lun

integer <int32> [ 1 .. 4095 ]

The logical unit number (LUN) by which the specified hosts are to address the specified volume. If the LUN is not specified, the system automatically assigns a LUN to the connection. To automatically assign a LUN to a private connection, the system starts at LUN 1 and counts up to the maximum LUN 4095, assigning the first available LUN to the connection. For shared connections, the system starts at LUN 254 and counts down to the minimum LUN 1, assigning the first available LUN to the connection. If all LUNs in the [1...254] range are taken, the system starts at LUN 255 and counts up to the maximum LUN 4095, assigning the first available LUN to the connection. Should not be used together with an NVMe host or host group.

object (Reference)

A protocol endpoint (also known as a conglomerate volume) which acts as a proxy through which virtual volumes are created and then connected to VMware ESXi hosts or host groups. The protocol endpoint itself does not serve I/Os; instead, its job is to form connections between FlashArray volumes and ESXi hosts and host groups.

Responses

Request samples

Payload

Content type

application/json

{"lun": 7,
"protocol_endpoint": {"id": "string",
"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"host": {"name": "string"
},
"host_group": {"name": "string"
},
"lun": 7,
"nsid": 3856,
"protocol_endpoint": {"id": "string",
"name": "string"
},
"volume": {"id": "string",
"name": "string"
}
}
]
}

Delete a connection between a volume and its host or host group

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
host_group_names	Array of strings 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	Array of strings 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_ids	Array of strings Performs the operation on the specified volume. Enter multiple ids in comma-separated format. For example, `vol01id,vol02id`. A request cannot include a mix of multiple objects with multiple IDs. For example, a request cannot include a mix of multiple volume IDs and host names; instead, at least one of the objects (e.g., `volume_ids`) must be set to only one name (e.g., `vol01id`). Only one of the two between `volume_names` and `volume_ids` may be used at a time.
volume_names	Array of strings 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`).

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Container Default Protections

Default protection is a list of protection groups that are applied to newly created volumes. Volumes can opt out of the default protection at creation. The pod's default_protections defaults to the array's default_protections at pod creation. Default protection can be configured on the array and the pod.

List container default protections

Displays a list of containers with its default protections.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the container ID specified. Enter multiple source IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together. Specifying `ids` or `names` with no value will perform the operation on local array.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique container name specified. Enter multiple names in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together. Specifying `ids` or `names` with no value will perform the operation on local array.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"default_protections": [{"id": "string",
"name": "string",
"type": "protection_group"
}
],
"id": "string",
"name": "string",
"type": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify a container's default protections

Modifies a container's default protections. To modify, set default_protections to the new list.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the container ID specified. Enter multiple source IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together. Specifying `ids` or `names` with no value will perform the operation on local array.
names	Array of strings Performs the operation on the unique container name specified. Enter multiple names in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together. Specifying `ids` or `names` with no value will perform the operation on local array.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

object (FixedReference)

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

Array of objects (_default_protection_reference)

The default protection that is applied to newly created volumes. Volumes can opt out of the default protection at creation. The pod's default_protections defaults to the array's default_protections at pod creation. To clear the list of default protections, set to an empty list [].

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"default_protections": [{"id": "string",
"name": "string",
"type": "protection_group"
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"default_protections": [{"id": "string",
"name": "string",
"type": "protection_group"
}
],
"id": "string",
"name": "string",
"type": "string"
}
]
}

Controllers

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

List controller information and status

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"mode": "primary",
"mode_since": 1687086901996,
"model": "FA-m50",
"status": "ready",
"type": "string",
"version": "5.0.0"
}
]
}

Directories

Important file system directories should be set up as managed directories. Managed directories can have policies attached to them. Managed directories differ from standard directories in that they provide space reporting and metrics.

List directories

Displays a list of directories, including those pending eradication.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	Array of strings Performs the operation on the file system ID specified. Enter multiple file system IDs in comma-separated format. The `file_system_ids` or `file_system_names` parameter is required, but they cannot be set together.
file_system_names	Array of strings Performs the operation on the file system name specified. Enter multiple file system names in comma-separated format. For example, `filesystem01,filesystem02`.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"directory_name": "string",
"file_system": {"id": "string",
"name": "string"
},
"limited_by": {"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"path": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"directory_name": "string",
"file_system": {"id": "string",
"name": "string"
},
"limited_by": {"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"path": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

Create directory

Creates a managed directory at the specified path. The managed directory name must consist of a file system name prefix and a managed directory name suffix (separated with ':'). The suffix must be between 1 and 63 characters (alphanumeric and '-') in length and begin and end with a letter or number. The suffix must include at least one letter or '-'. Set names to create a managed directory with the specified full managed directory name, or set file_system_names or file_system_ids in the query parameters and suffix in the body parameters to create a managed directory in the specified file system with the specified suffix. These two options are exclusive.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
file_system_ids	Array of strings Performs the operation on the file system ID specified. Enter multiple file system IDs in comma-separated format. The `file_system_ids` or `file_system_names` parameter is required, but they cannot be set together.
file_system_names	Array of strings Performs the operation on the file system name specified. Enter multiple file system names in comma-separated format. For example, `filesystem01,filesystem02`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

directory_name	string The managed directory name without the file system name prefix. A full managed directory name is constructed in the form of `FILE_SYSTEM:DIR` where `FILE_SYSTEM` is the file system name and `DIR` is the value of this field. `directory_name` is required if `file_system_names` or `file_system_ids` is set. `directory_name` cannot be set if `names` is set.
path	string Path of the managed directory in the file system.

Responses

Request samples

Payload

Content type

application/json

{"directory_name": "string",
"path": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"directory_name": "string",
"file_system": {"id": "string",
"name": "string"
},
"limited_by": {"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"path": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

Delete managed directories

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a managed directory

Modifies a managed directory. To rename a managed directory, set name to the new name. The ids or names parameter is required, but cannot be set together. The name or directory_name parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
directory_name	string The managed directory name without the file system name prefix. A full managed directory name is constructed in the form of `FILE_SYSTEM:DIR` where `FILE_SYSTEM` is the file system name and `DIR` is the value of this field.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"directory_name": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"directory_name": "string",
"file_system": {"id": "string",
"name": "string"
},
"limited_by": {"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"path": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

List directory performance data

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol	string Protocol type. Valid values are `nfs`, `smb`, and `all`.
protocol_group	string Protocol group type. Valid values are `block`, `file`, and `all`.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"others_per_sec": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"time": 0,
"usec_per_other_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"others_per_sec": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"time": 0,
"usec_per_other_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0
}
]
}

List policies

Displays a list of policies that are attached to directories.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List audit policies attached to a directory

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory and one or more audit policies

Creates a membership between a directory and one or more audit policies. Either the member_ids or member_names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicypostPolicies)

A list of policies to apply to the resource. The id or name field in each policy parameter is required, but they cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete a membership between a directory and one or more audit policies

Deletes a membership between a directory and one or more audit policies. Either the policy_ids or policy_names parameter is required, but they cannot be set together. Either the member_ids or member_names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List auto managed directory policies attached to a directory

Displays a list of auto managed directory policies that are attached to directories.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory with one or more auto managed directory policies

Creates a membership between a directory with one or more auto managed directory policies. The member_ids or member_names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicypostPolicies)

A list of policies to apply to the resource. The id or name field in each policy parameter is required, but they cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete a membership between a directory and one or more auto managed directory policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List NFS policies attached to a directory

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory and one or more NFS policies

Creates a membership between a directory and one or more NFS policies. The member_ids or member_names parameter is required but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicyexportpostPolicies)

A list of export policies to apply to the directory. The id and name fields in each policy parameter are required, but cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"export_enabled": false,
"export_name": "string",
"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
]
}

Delete a membership between a directory and one or more NFS policies

Deletes a membership between a directory and 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List quota policies attached to a directory

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory and one or more quota policies

Creates a membership between a directory and one or more quota policies. The member_ids or member_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ignore_usage	boolean Flag used to override checks for quota management operations. If set to `true`, directory usage is not checked against the `quota_limits` that are set. If set to `false`, the actual logical bytes in use are prevented from exceeding the limits set on the directory. Client operations might be impacted. If the limit exceeds the quota, the client operation is not allowed. If not specified, defaults to `false`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicypostPolicies)

A list of policies to apply to the resource. The id or name field in each policy parameter is required, but they cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete a membership between a directory and one or more quota policies

Deletes a membership between a directory and one or more quota 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List SMB policies attached to a directory

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory and one or more SMB policies

Creates a membership between a directory and one or more SMB policies. The member_ids or member_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicyexportpostPolicies)

A list of export policies to apply to the directory. The id and name fields in each policy parameter are required, but cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"export_enabled": false,
"export_name": "string",
"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
]
}

Delete a membership between a directory and one or more SMB policies

Deletes a membership between a directory and 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List snapshot policies attached to a directory

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a directory with one or more snapshot policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_directorypolicypostPolicies)

A list of policies to apply to the resource. The id or name field in each policy parameter is required, but they cannot be set together.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete a membership between a directory and one or more snapshot policies

Deletes a membership between a directory and 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List directory space information

Displays physical storage consumption data for each directory.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

Create NLM reclamation

Creates an NLM reclamation, which is a system-wide operation that affects all clients, so only one may be in progress at a time. Attempting to initiate reclamation while one is in progress will result in an error. When NLM reclamation is initiated, all NLM locks are deleted and client applications are notified that they can reacquire their locks within a grace period.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

X-Request-ID

string

Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"end": 0,
"start": 0
}
]
}

Directory Exports

Managed directory exports are created by adding NFS or SMB export policies to managed directories.

List directory exports

Displays a list of directory exports.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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	Array of strings Performs the operation on the export names specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"enabled": true,
"export_name": "string",
"status": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"path": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create directory exports

Creates an export of a managed directory. The directory_ids or directory_names parameter is required, but cannot be set together. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
directory_ids	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

export_enabled	boolean If set to `true`, the export is enabled. If not specified, defaults to `true`.
export_name	string The name of the export to create. Export names must be unique within the same protocol.

Responses

Request samples

Payload

Content type

application/json

{"export_enabled": false,
"export_name": "string"
}

Response samples

Content type

application/json

{"items": [{"enabled": true,
"export_name": "string",
"status": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"path": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete directory exports

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
directory_ids	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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	Array of strings Performs the operation on the export names specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify directory exports

Modifies a directory export. Used for manually renaming, enabling, and disabling directory exports. To rename a directory export, set 'export_name' to the new name.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
directory_ids	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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	Array of strings Performs the operation on the export names specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

export_enabled	boolean If set to `true`, the export is enabled. If not specified, defaults to `true`.
export_name	string The new name of the export. Export names must be unique within the same protocol.

Responses

Request samples

Payload

Content type

application/json

{"export_enabled": false,
"export_name": "string"
}

Response samples

Content type

application/json

{"items": [{"enabled": true,
"export_name": "string",
"status": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"path": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Directory Quotas

Directory quotas provide the ability to set capacity limits on managed directories.

List directories with attached quota policies

Displays a list of directories and the quota policies attached to them. Directories with multiple policies are listed repeatedly (once per policy). The directories without a policy attached are not listed.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
directory_ids	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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`.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"enabled": true,
"enforced": true,
"path": "string",
"percentage_used": 0,
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"quota_limit": 0,
"rule_name": "string",
"usage": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Directory Services

Manages directory service configurations for integration with LDAP servers (e.g. Active Directory and OpenLDAP) in order to support various array services.

List directory services configuration

Displays the directory services configuration settings for manageability.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"base_dn": "DC=mycompany,DC=com",
"bind_password": "****",
"bind_user": "CN=John,OU=Users,DC=example,DC=com",
"ca_certificate": "string",
"check_peer": false,
"enabled": true,
"management": {"ssh_public_key_attribute": "sshPublicKey",
"user_login_attribute": "email",
"user_object_class": "inetOrgPerson"
},
"services": ["data",
"management"
],
"uris": ["ldaps://ad1.mycompany.com"
]
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify directory services configuration

Modifies the directory service configuration.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
base_dn	string Base of the Distinguished Name (DN) of the directory service groups.
bind_password	string Masked password used to query the directory.
bind_user	string Username used to query the directory.
ca_certificate	string The certificate of the Certificate Authority (CA) that signed the certificates of the directory servers, which is used to validate the authenticity of the configured servers.
check_peer	boolean Whether or not server authenticity is enforced when a certificate is provided.
enabled	boolean Whether or not the directory service is enabled.
	object (_directoryServiceManagement) Properties specific to the management service.
uris	Array of strings List of URIs for the configured directory servers.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"base_dn": "DC=mycompany,DC=com",
"bind_password": "****",
"bind_user": "CN=John,OU=Users,DC=example,DC=com",
"ca_certificate": "string",
"check_peer": false,
"enabled": true,
"management": {"ssh_public_key_attribute": "sshPublicKey",
"user_login_attribute": "email",
"user_object_class": "inetOrgPerson"
},
"uris": ["ldaps://ad1.mycompany.com"
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"base_dn": "DC=mycompany,DC=com",
"bind_password": "****",
"bind_user": "CN=John,OU=Users,DC=example,DC=com",
"ca_certificate": "string",
"check_peer": false,
"enabled": true,
"management": {"ssh_public_key_attribute": "sshPublicKey",
"user_login_attribute": "email",
"user_object_class": "inetOrgPerson"
},
"services": ["data",
"management"
],
"uris": ["ldaps://ad1.mycompany.com"
]
}
]
}

List group to management access policy mappings

Displays access control settings for remote groups.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique names specified. For example, `GroupRoleMappingName`. Enter multiple names in comma-separated format.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
role_names	Array of strings This field has been deprecated.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"group": "groupOfUsers",
"group_base": "OU=PureGroups,OU=SANManagers",
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a group in management access policy mappings

Creates one or more groups in management access policy mappings.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

required

Array of strings

Performs the operation on the unique names specified. For example, GroupRoleMappingName. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

group	string Group name that contains users with the abilities granted by the associated policies.
group_base	string Specifies where the configured group is located in the directory tree.
	Array of objects (_referenceWithType) List of management access policies to associate with the group.
	object (ReferenceNoId) This field has been deprecated. Predecessor to management access policies. Can be set to the premade policy of the same name. Cannot be set with management_access_policies.

Responses

Request samples

Payload

Content type

application/json

{"group": "groupOfUsers",
"group_base": "OU=PureGroups,OU=SANManagers",
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"group": "groupOfUsers",
"group_base": "OU=PureGroups,OU=SANManagers",
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}
]
}

Delete group to management access policy mappings

Deletes one or more group to management access policy mappings.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

required

Array of strings

Performs the operation on the unique names specified. For example, GroupRoleMappingName. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify group to management access policy mappings

Modifies properties of one or more group to management access policy mappings. Modifying management access policies is done at /directory-services/roles/policies/management-access instead.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names required	Array of strings Performs the operation on the unique names specified. For example, `GroupRoleMappingName`. Enter multiple names in comma-separated format.
role_names	Array of strings This field has been deprecated.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group	string Group name that contains users with the abilities granted by the associated policies.
group_base	string Specifies where the configured group is located in the directory tree.
	object (ReferenceNoId) This field has been deprecated. Predecessor to management access policies.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"group": "groupOfUsers",
"group_base": "OU=PureGroups,OU=SANManagers",
"role": {"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"group": "groupOfUsers",
"group_base": "OU=PureGroups,OU=SANManagers",
"management_access_policies": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"role": {"name": "string"
}
}
]
}

List management access policies attached to a group to management access policy mapping

Displays a list of management access policies that are attached to a group to management access policy mappings.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a group to management access policy mapping with one or more management access policies

Creates a membership between a group to management access policy mapping with one or more management access policies. One of member_ids or member_names parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (PolicyAssignmentPostPolicy)

A list of policies to apply to the resource. One of id or name is required in each policy.

Responses

Request samples

Payload

Content type

application/json

{"policies": [{"policy": {"id": "string",
"name": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a membership between a group to management access policy mapping and one or more management access policies

Deletes a membership between a group to management access policy mapping with one or more management access policies. One of policy_ids or policy_names is required, and one of member_ids or member_names is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List directory services test results

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names required	Array of strings Performs the operation on the unique name specified. For example, `name01`. Enter multiple names in comma-separated format.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

List local groups

Displays a list of local groups.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"built_in": true,
"email": "string",
"gid": 0,
"name": "string",
"sid": "string"
}
]
}

Create local group

Creates a local group.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

email	string Optional field to set the email address of the local group.
gid	integer <int32> Optional field to set the GID of the local group.

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"gid": 0
}

Response samples

Content type

application/json

{"items": [{"built_in": true,
"email": "string",
"gid": 0,
"name": "string",
"sid": "string"
}
]
}

Delete local groups

Deletes one or more local groups. The gids, names, or sids parameter is required, but cannot be set together.

query Parameters

gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify local groups

Modifies local groups.

query Parameters

gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

email	string The email address of the local group.
gid	integer <int32> The POSIX user ID of this object (group ID).
name	string The local group name.

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"gid": 0,
"name": "string"
}

Response samples

Content type

application/json

{"items": [{"built_in": true,
"email": "string",
"gid": 0,
"name": "string",
"sid": "string"
}
]
}

List local group memberships

Displays a list of local group memberships.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
group_names	Array of strings Performs the operation on the group names specified. Enter multiple group names in comma-separated format. For example, `group1,group2`.
group_sids	Array of strings Performs the operation on the specified group SID. Enter multiple group SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of integers <int32> Performs the operation on the unique local member IDs specified. Enter multiple member IDs in comma-separated format. For local group IDs refer to group IDs (GID). For local user IDs refer to user IDs (UID). The `member_ids` and `member_names` parameters cannot be provided together.
member_names	Array of strings 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_sids	Array of strings Performs the operation on the specified member SID. Enter multiple member SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
member_types	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"group_gid": 0,
"is_primary_group": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member_id": 0
}
]
}

Create local group membership

Creates a local group membership with a group. The group_names, group_sids, or group_ids parameter is required, but cannot be set together.

query Parameters

group_gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
group_names	Array of strings Performs the operation on the group names specified. Enter multiple group names in comma-separated format. For example, `group1,group2`.
group_sids	Array of strings Performs the operation on the specified group SID. Enter multiple group SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

The member_names, member_sids, or member_gids parameter is required, but cannot be set together.

Array of objects (_localgroupmembershippostMembers)

A list of resources to be a member of the group.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member_id": 0
}
]
}

Response samples

Content type

application/json

{"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"group_gid": 0,
"is_primary_group": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member_id": 0
}
]
}

Delete local group membership

Deletes one or more local group memberships. The group_names, group_sids, or group_ids parameter is required, but cannot be set together.

query Parameters

group_gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
group_names	Array of strings Performs the operation on the group names specified. Enter multiple group names in comma-separated format. For example, `group1,group2`.
group_sids	Array of strings Performs the operation on the specified group SID. Enter multiple group SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
member_ids	Array of integers <int32> Performs the operation on the unique local member IDs specified. Enter multiple member IDs in comma-separated format. For local group IDs refer to group IDs (GID). For local user IDs refer to user IDs (UID). The `member_ids` and `member_names` parameters cannot be provided together.
member_names	Array of strings 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_sids	Array of strings Performs the operation on the specified member SID. Enter multiple member SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
member_types	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List local users

Displays a list of local users.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
uids	Array of integers <int32> A comma-separated list of local user IDs (UIDs). Enter multiple local user IDs in comma-separated format. For example, `423,51234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"built_in": true,
"email": "string",
"enabled": true,
"name": "string",
"primary_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"sid": "string",
"uid": 0
}
]
}

Create local user

Creates a local user.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

email	string Optional field to set the email of the local user.
enabled	boolean If this field is `false`, the local user will be disabled on creation. Otherwise, the local user will be enabled and functional.
password	string The password of the local user. This field is only required if the `enabled` field is `true`.
	object (ReferenceWithType) Local group that would be assigned as the primary group of the local user.
uid	integer <int32> Optional field to set the UID of the local user.

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"enabled": true,
"password": "string",
"primary_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"uid": 0
}

Response samples

Content type

application/json

{"items": [{"built_in": true,
"email": "string",
"enabled": true,
"name": "string",
"primary_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"sid": "string",
"uid": 0
}
]
}

Delete local users

Deletes one or more local users. The uids, names, or sids parameter is required, but cannot be set together.

query Parameters

names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
uids	Array of integers <int32> A comma-separated list of local user IDs (UIDs). Enter multiple local user IDs in comma-separated format. For example, `423,51234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify local user

Modifies a local user.

query Parameters

keep_open_sessions	boolean If set to `true`, the session does not expire. If set to `false`, when the user is disabled or password is changed, the session expires. If not specified, defaults to `false`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
sids	Array of strings Performs the operation on the object SID specified. Enter multiple SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
uids	Array of integers <int32> A comma-separated list of local user IDs (UIDs). Enter multiple local user IDs in comma-separated format. For example, `423,51234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

email	string Optional field to set the email of the local user.
enabled	boolean If this field is `false`, the local user will be disabled on creation. Otherwise, the local user will be enabled and functional from the beginning.
name	string The local user name.
password	string The password of the local user. This field is only required if the `enabled` field is true.
	object (ReferenceWithType) Local group that would be assigned as the primary group of the local user.
uid	integer <int32> Optional field to set the UID of the local user.

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"enabled": true,
"name": "string",
"password": "string",
"primary_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"uid": 0
}

Response samples

Content type

application/json

{"items": [{"built_in": true,
"email": "string",
"enabled": true,
"name": "string",
"primary_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"sid": "string",
"uid": 0
}
]
}

List local user memberships

Displays a list of local user memberships.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
group_names	Array of strings Performs the operation on the group names specified. Enter multiple group names in comma-separated format. For example, `group1,group2`.
group_sids	Array of strings Performs the operation on the specified group SID. Enter multiple group SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of integers <int32> Performs the operation on the unique local member IDs specified. Enter multiple member IDs in comma-separated format. For local group IDs refer to group IDs (GID). For local user IDs refer to user IDs (UID). The `member_ids` and `member_names` parameters cannot be provided together.
member_names	Array of strings 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_sids	Array of strings Performs the operation on the specified member SID. Enter multiple member SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"group_gid": 0,
"is_primary_group": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member_id": 0
}
]
}

Create local user membership

Creates a local user membership with a group. The member_names or member_sids or member_ids parameter is required, but cannot be set together.

query Parameters

member_ids	Array of integers <int32> Performs the operation on the unique local member IDs specified. Enter multiple member IDs in comma-separated format. For local group IDs refer to group IDs (GID). For local user IDs refer to user IDs (UID). The `member_ids` and `member_names` parameters cannot be provided together.
member_names	Array of strings 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_sids	Array of strings Performs the operation on the specified member SID. Enter multiple member SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

The group_names, group_sids, or group_gids parameter is required, but cannot be set together.

	Array of objects (_localusermembershippostGroups) A list of groups of which the user is a member.
is_primary	boolean Default: false Determines whether memberships are primary group memberships or not.

Responses

Request samples

Payload

Content type

application/json

{"groups": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"group_gid": 0
}
],
"is_primary": false
}

Response samples

Content type

application/json

{"items": [{"group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"group_gid": 0,
"is_primary_group": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"member_id": 0
}
]
}

Delete local user membership

Deletes one or more local user memberships. The member_names, member_sids, or member_ids parameter is required, but cannot be set together.

query Parameters

group_gids	Array of integers <int32> Performs the operation on the specified GIDs. Enter multiple GIDs in comma-separated format. For example, `4234235,9681923`.
group_names	Array of strings Performs the operation on the group names specified. Enter multiple group names in comma-separated format. For example, `group1,group2`.
group_sids	Array of strings Performs the operation on the specified group SID. Enter multiple group SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
member_ids	Array of integers <int32> Performs the operation on the unique local member IDs specified. Enter multiple member IDs in comma-separated format. For local group IDs refer to group IDs (GID). For local user IDs refer to user IDs (UID). The `member_ids` and `member_names` parameters cannot be provided together.
member_names	Array of strings 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_sids	Array of strings Performs the operation on the specified member SID. Enter multiple member SIDs in comma-separated format. For example, `S-1-2-532-582374278-329482934,S-1-2-532-234235245-423425234`.
member_types	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Directory Snapshots

Directory snapshots are created manually or by adding snapshot policies to managed directories. Each snapshot policy can be re-used for multiple directories.

List directory snapshots

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"client_name": "string",
"created": 0,
"destroyed": true,
"policy": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": 0,
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"client_name": "string",
"created": 0,
"destroyed": true,
"policy": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": 0,
"time_remaining": 0
}
]
}

Create directory snapshot

Creates a snapshot of the contents of a directory. The source_ids or source_names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

client_name	string The client name portion of the client visible snapshot name. A full snapshot name is constructed in the form of `DIR.CLIENT_NAME.SUFFIX` where `DIR` is the managed directory name, `CLIENT_NAME` is the value of this field, and `SUFFIX` is the suffix. The client visible snapshot name is `CLIENT_NAME.SUFFIX`.
keep_for	integer <int64> The time to keep the snapshots for, in milliseconds.
suffix	string The suffix portion of the client visible snapshot name. A full snapshot name is constructed in the form of `DIR.CLIENT_NAME.SUFFIX` where `DIR` is the managed directory name, `CLIENT_NAME` is the client name, and `SUFFIX` is the value of this field. The client visible snapshot name is `CLIENT_NAME.SUFFIX`. If not specified, defaults to a monotonically increasing number generated by the system.

Responses

Request samples

Payload

Content type

application/json

{"client_name": "string",
"keep_for": 0,
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"client_name": "string",
"created": 0,
"destroyed": true,
"policy": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": 0,
"time_remaining": 0
}
]
}

Delete directory snapshot

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 they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify directory snapshot

Modifies a directory snapshot. You can destroy, recover, or update the policy or time remaining of a directory snapshot. To destroy a directory snapshot, set destroyed=true. To recover a directory snapshot that has been destroyed and is pending eradication, set destroyed=false. To rename a directory snapshot, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
client_name	string The client name portion of the client-visible snapshot name. A full snapshot name is constructed in the form of `DIR.CLIENT_NAME.SUFFIX` where `DIR` is the managed directory name, `CLIENT_NAME` is the value of this field, and `SUFFIX` is the suffix. The client-visible snapshot name is `CLIENT_NAME.SUFFIX`. The client name of a directory snapshot managed by a snapshot policy is not changeable. If the `name` and `client_name` parameters are both specified, `client_name` must match the client name portion of `name`.
keep_for	integer <int64> The amount of time to keep the snapshots, in milliseconds. Can only be set on snapshots that are not managed by any snapshot policy. Set to `""` to clear the keep_for value.
name	string The new name of a directory snapshot. The name of a directory snapshot managed by a snapshot policy is not changeable.
	object (Reference) The snapshot policy that manages this snapshot. Set to `name` or `id` to `""` to clear the policy.
suffix	string The suffix portion of the client-visible snapshot name. A full snapshot name is constructed in the form of `DIR.CLIENT_NAME.SUFFIX` where `DIR` is the managed directory name, `CLIENT_NAME` is the client name, and `SUFFIX` is the value of this field. The client-visible snapshot name is `CLIENT_NAME.SUFFIX`. The suffix of a directory snapshot managed by a snapshot policy is not changeable. If the `name` and `suffix` parameters are both specified, `suffix` must match the suffix portion of `name`.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"client_name": "string",
"keep_for": 0,
"name": "string",
"policy": {"id": "string",
"name": "string"
},
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"client_name": "string",
"created": 0,
"destroyed": true,
"policy": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": 0,
"time_remaining": 0
}
]
}

DNS

DNS attributes include the domain suffix, static name servers, mode (static or DHCP), and search domain. The configured attributes can be listed.

List DNS parameters

Displays the current DNS configurations and their parameters including domain suffix, the list of DNS name server IP addresses, and the list of services that DNS parameters apply to.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"ca_certificate": {"id": "string",
"name": "string",
"resource_type": "string"
},
"ca_certificate_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"domain": "example.com",
"nameservers": ["192.168.0.125"
],
"services": ["string"
],
"source": {"name": "string"
}
}
]
}

Create DNS configuration

Creates new DNS configuration with parameters including the domain suffix, the list of DNS name server IP addresses, and the list of services that DNS parameters apply to.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (ReferenceWithType) A reference to the `certificate` to use for validating nameservers with HTTPS connections. This property is mutually exclusive with `ca_certificate_group` property and may only be configured when nameservers begin with HTTPS.
	object (ReferenceWithType) A reference to the `certificate group` to use for validating nameservers with HTTPS connections. This property is mutually exclusive with `ca_certificate` property and may only be configured when nameservers begin with HTTPS.
domain	string The domain suffix to be appended by the appliance when performing DNS lookups.
nameservers	Array of strings The list of DNS servers either in the form of IP addresses or HTTPS endpoints. Domain names in HTTPS endpoints are not supported. IP addresses must be used instead. If nameservers begin with `https://`, then DNS queries will be performed over HTTPS. Otherwise, unencrypted DNS queries will be performed. Using a combination of nameservers that begin with `https://` and that do not begin with `https://` is not supported. If servers are specified with `https://` one of `ca_certificate` and `ca_certificate_group` parameters must be set.
services	Array of strings The list of services utilizing the DNS configuration.
	object (ReferenceNoId) The network interface used for communication with the DNS server.

Responses

Request samples

Payload

Content type

application/json

{"ca_certificate": {"id": "string",
"name": "string",
"resource_type": "string"
},
"ca_certificate_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"domain": "example.com",
"nameservers": ["192.168.0.125"
],
"services": ["string"
],
"source": {"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"ca_certificate": {"id": "string",
"name": "string",
"resource_type": "string"
},
"ca_certificate_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"domain": "example.com",
"nameservers": ["192.168.0.125"
],
"services": ["string"
],
"source": {"name": "string"
}
}
]
}

Delete DNS configuration

Deletes DNS configuration identified by configuration name.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify DNS parameters

Modifies the DNS parameters of an array, including the domain suffix, the list of DNS name server IP addresses, and the list of services that DNS parameters apply to. If there is no DNS configuration beforehand new DNS configuration with 'default' name is created. If more than one DNS configuration exists, name has to be specified to identify the DNS configuration to be modified.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
	object (ReferenceWithType) A reference to the `certificate` to use for validating nameservers with HTTPS connections. This property is mutually exclusive with `ca_certificate_group` property and may only be configured when nameservers begin with HTTPS.
	object (ReferenceWithType) A reference to the `certificate group` to use for validating nameservers with HTTPS connections. This property is mutually exclusive with `ca_certificate` property and may only be configured when nameservers begin with HTTPS.
domain	string The domain suffix to be appended by the appliance when performing DNS lookups.
nameservers	Array of strings The list of DNS servers either in the form of IP addresses or HTTPS endpoints. Domain names in HTTPS endpoints are not supported. IP addresses must be used instead. If nameservers begin with `https://`, then DNS queries will be performed over HTTPS. Otherwise, unencrypted DNS queries will be performed. Using a combination of nameservers that begin with `https://` and that do not begin with `https://` is not supported. If servers are specified with `https://` one of `ca_certificate` and `ca_certificate_group` parameters must be set.
services	Array of strings The list of services utilizing the DNS configuration.
	object (ReferenceNoId) The network interface used for communication with the DNS server.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"ca_certificate": {"id": "string",
"name": "string",
"resource_type": "string"
},
"ca_certificate_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"domain": "example.com",
"nameservers": ["192.168.0.125"
],
"services": ["string"
],
"source": {"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"ca_certificate": {"id": "string",
"name": "string",
"resource_type": "string"
},
"ca_certificate_group": {"id": "string",
"name": "string",
"resource_type": "string"
},
"domain": "example.com",
"nameservers": ["192.168.0.125"
],
"services": ["string"
],
"source": {"name": "string"
}
}
]
}

Drives

Drive data includes the name, type, status, capacity, protocol and other information for all flash, NVRAM, and cache modules in an array.

List flash, NVRAM, and cache modules

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"capacity": 10000000000000,
"capacity_installed": 42000000000000,
"details": "Cache module in wrong bay.",
"protocol": "SAS",
"status": "healthy",
"type": "SSD"
}
]
}

Modify flash and NVRAM modules

Modifies flash and NVRAM modules that have been added or connected but not yet admitted to the array.

query Parameters

admit

boolean

If true, admits any unadmitted drives into the system.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"name": "string",
"capacity": 10000000000000,
"capacity_installed": 42000000000000,
"details": "Cache module in wrong bay.",
"protocol": "SAS",
"status": "healthy",
"type": "SSD"
}
]
}

File Systems

A FlashArray can contain up to 24 separate file systems, each with a number of directories that can be exported via supported protocols. Clients, using Active Directory or LDAP, can connect and access these exports using SMB or NFS.

List file systems

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create file system

Creates one or more file systems.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"time_remaining": 0
}
]
}

Delete file system

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a file system

Modifies a file system. You can rename, destroy, move, or recover a file system. To rename a file system, set name to the new name. To destroy a file system, set destroyed=true. To move a file system, set 'pod' to the destination pod reference. To recover a file system that has been destroyed and is pending eradication, set destroyed=false.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
name	string The new name for the resource.
	object (Reference) The pod to move existing file systems into.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"name": "string",
"pod": {"id": "string",
"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"time_remaining": 0
}
]
}

Fleets

A fleet is a collection of Arrays.

List fleets

Displays information about the fleets known to the array.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"is_local": true
}
]
}

Create a fleet

Creates a fleet and adds the current array as its first member. Additional arrays can be added to the fleet with POST /fleets/members.

query Parameters

names

Array of strings

Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"is_local": true
}
]
}

Delete a fleet

Deletes a fleet, permanently. A fleet can only be deleted if the current array is the only array in the fleet.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a fleet

Modifies a fleet, changing its name by passing the old name in name query parameter, and the new name in the name parameter in the request body.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.

Responses

Request samples

Payload

Content type

application/json

{"name": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"is_local": true
}
]
}

Get fleet key information

Displays the time remaining on the fleet key. Note, fleet key itself is not displayed, since that is only available at time of fleet key creation.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"created": 1706850977,
"expires": 1706854577,
"fleet_key": "CAUSJDljMGM3MGY3LWFhZDEtNDRkZC05ZDQ2LTZlOTA3YzY3Yzg1YxokOWMwYzcwZjctYWFkMS00NGRkLTlkND"
}
]
}

Create a fleet key

Creates a fleet key allowing an array to be added to a fleet. This is the only time the fleet key is displayed, it cannot be retrieved subsequently. Note, creation of a subsequent key invalidates all keys created earlier.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"created": 1706850977,
"expires": 1706854577,
"fleet_key": "CAUSJDljMGM3MGY3LWFhZDEtNDRkZC05ZDQ2LTZlOTA3YzY3Yzg1YxokOWMwYzcwZjctYWFkMS00NGRkLTlkND"
}
]
}

List fleet members

Displays the members in the current fleet.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
fleet_ids	Array of strings Performs the operation on the unique Fleet IDs specified. This query currently accepts only 1 ID.
fleet_names	Array of strings Performs the operation on the unique Fleet names specified. Enter multiple names in comma-separated format. For example, `name01,name02`. This query currently accepts only 1 name.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"fleet": {"id": "string",
"name": "string",
"is_local": true,
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"is_local": true,
"resource_type": "string"
},
"status": "string",
"status_details": "cannot reach array"
}
]
}

Add members to a fleet

Adds arrays to an existing fleet. This API needs to be run from the array that's joining the fleet.

To add the current array to the fleet, specify its own array id or name, as well as the fleet key generated on any array already in the fleet. resource_type is remote-arrays. The array's ID and name can be retrieved with a call to GET /arrays on the array.

query Parameters

fleet_ids	Array of strings Performs the operation on the unique Fleet IDs specified. This query currently accepts only 1 ID.
fleet_names	Array of strings Performs the operation on the unique Fleet names specified. Enter multiple names in comma-separated format. For example, `name01,name02`. This query currently accepts only 1 name.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Info about the members being added to fleet.

Array of objects (_fleetmemberpostMembers)

Details about the members being added to fleet.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"key": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"fleet": {"id": "string",
"name": "string",
"is_local": true,
"resource_type": "string"
},
"member": {"id": "string",
"name": "string",
"is_local": true,
"resource_type": "string"
},
"status": "string",
"status_details": "cannot reach array"
}
]
}

Delete fleet members

Deletes the specified array(s) from the fleet. Note that this will only succeed if the array(s) to be removed are not making use of any fleet resources.

query Parameters

member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.
unreachable	boolean If set to `true`, allows a one-sided disconnect when the connection status is `connecting` instead of `connected` or `partially connected`. If set to `false`, it works just like normal coordinated disconnect. If not specified, defaults to `false`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Hardware

Operational status is reported by most of the hardware components in an array, including the chassis, controller, and storage shelf.

List hardware component information

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

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"details": "Temperature too high",
"identify_enabled": true,
"index": 1,
"model": "DFSC1",
"serial": "PSMFL1717009B",
"slot": 16,
"speed": 24000000000,
"status": "critical",
"temperature": 25,
"type": "ct",
"voltage": 206
}
]
}

Modify visual identification

Modifies the visual identification of a specified hardware component, and causing the ID LED to turn on or off.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

identify_enabled	boolean State of an LED used to visually identify the component.
index	integer <int32> Number that identifies the relative position of a hardware component within the array.

Responses

Request samples

Payload

Content type

application/json

{"identify_enabled": true,
"index": 1
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"details": "Temperature too high",
"identify_enabled": true,
"index": 1,
"model": "DFSC1",
"serial": "PSMFL1717009B",
"slot": 16,
"speed": 24000000000,
"status": "critical",
"temperature": 25,
"type": "ct",
"voltage": 206
}
]
}

Host Groups

Host groups implement consistent connections between a set of hosts and one or more volumes. Connections are consistent in the sense that all hosts associated with a host group address a volume connected to the group by the same LUN. Host groups are typically used to provide a common view of storage volumes to the hosts in a clustered application.

List host groups

Displays a list of host groups.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"connection_count": 3,
"destroyed": true,
"host_count": 3,
"is_local": true,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a host group and upsert tags

Creates a host group in which the names query parameter is required.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (NonCopyableTag)

The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"tags": [{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"connection_count": 3,
"destroyed": true,
"host_count": 3,
"is_local": true,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

Delete a host group

Deletes a host group in which the names query parameter is required.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a host group

Modifies a host group in which the names query parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
from_member_ids	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays from which the resource should be removed. Enter multiple IDs in a comma-separated format.
from_member_names	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays to be removed from the specified resource. Enter multiple names in a comma-separated format.
modify_resource_access	string Describes how to modify a resource accesses of a resource when that resource is moved. Possible values are: `none`, `create`, and `delete`. The `none` value indicates that no resource access should be modified. The `create` value is used when a resource is moving out of a realm into the array and it needs to create a resource access of the moved resource to the realm from which it is moving. The `delete` value is used when a resource that is moving from an array into a realm already has a resource access into that realm. This is a required parameter when a resource is being moved to another member.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
to_member_ids	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple IDs in a comma-separated format.
to_member_names	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple names in a comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.

Responses

Request samples

Payload

Content type

application/json

{"name": "string"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"connection_count": 3,
"destroyed": true,
"host_count": 3,
"is_local": true,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

List host groups that are associated with hosts

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership to a host group

Create a membership between a host and a host group. Adding a membership to a host group automatically connects the host to all volumes associated with the group. Multiple hosts can be belong to a host group, but a host can only belong to one host group. Hosts can be added to 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a membership from a host group

Deletes a membership from a host group. Removing a membership 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List host group performance data

Displays real-time and historical performance data, real-time latency data, and average I/O sizes of all host groups, displayed both by host group and by total size across all host groups. This data represents volumes that are connected to the host groups on the local array and stretched volumes connected to the host groups on arrays that are connected by synchronous replication.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
]
}

List host group performance data by array

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
]
}

List host groups that are members of protection groups

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a host group

Creates a host group member and assigns to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a host group from a protection group

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List host group space information

Displays provisioned size and physical storage consumption data for each host group.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags on host group objects.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags on host group objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if one already exists, updated.

Array ()

key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Hosts

Hosts organize the storage network addresses (iSCSI Qualified Names, NVMe qualified names, or Fibre Channel world wide names) of client computers to identify the host's intiators. Hosts also control communications between clients and volumes. After a volume has been created, establish a host-volume connection so that the host can read data from and write data to the volume.

List hosts

Displays a list of hosts.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"chap": {"host_password": "string",
"host_user": "string",
"target_password": "string",
"target_user": "string"
},
"connection_count": 3,
"destroyed": true,
"host_group": {"name": "string"
},
"iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"is_local": true,
"nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"personality": "string",
"port_connectivity": {"details": "Redundant",
"status": "healthy"
},
"preferred_arrays": [{"id": "string",
"name": "string"
}
],
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"vlan": "1",
"wwns": ["52:4A:93:70:4E:E5:68:00"
]
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a host and upsert tags

Creates a host for which the names query parameter is required.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_chap) Challenge-Handshake Authentication Protocol (CHAP).
iqns	Array of strings The iSCSI qualified name (IQN) associated with the host.
nqns	Array of strings The NVMe Qualified Name (NQN) associated with the host.
personality	string Determines how the system tunes the array to ensure that it works optimally with the host. Set `personality` to the name of the host operating system or virtual memory system. Valid values are `aix`, `esxi`, `hitachi-vsp`, `hpux`, `oracle-vm-server`, `solaris`, and `vms`. If your system is not listed as one of the valid host personalities, do not set the option. By default, the personality is not set.
	Array of objects (_reference) For synchronous replication configurations, sets a host's preferred array to specify which array exposes active/optimized paths to that host. Enter multiple preferred arrays in comma-separated format. If a preferred array is set for a host, then the other arrays in the same pod will expose active/non-optimized paths to that host. If the host is in a host group, `preferred_arrays` cannot be set because host groups have their own preferred arrays. On a preferred array of a certain host, all the paths on all the ports (for both the primary and secondary controllers) are set up as A/O (active/optimized) paths, while on a non-preferred array, all the paths are A/N (Active/Non-optimized) paths.
	Array of objects (NonCopyableTag) The list of tags to be upserted with the object.
vlan	string The VLAN ID that the host is associated with. If not set or set to `any`, the host can access any VLAN. If set to `untagged`, the host can only access untagged VLANs. If set to a number between `1` and `4094`, the host can only access the specified VLAN with that number.
wwns	Array of strings The Fibre Channel World Wide Name (WWN) associated with the host.

Responses

Request samples

Payload

Content type

application/json

{"chap": {"host_password": "string",
"host_user": "string",
"target_password": "string",
"target_user": "string"
},
"iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"personality": "string",
"preferred_arrays": [{"id": "string",
"name": "string"
}
],
"tags": [{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
],
"vlan": "1",
"wwns": ["52:4A:93:70:4E:E5:68:00"
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"chap": {"host_password": "string",
"host_user": "string",
"target_password": "string",
"target_user": "string"
},
"connection_count": 3,
"destroyed": true,
"host_group": {"name": "string"
},
"iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"is_local": true,
"nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"personality": "string",
"port_connectivity": {"details": "Redundant",
"status": "healthy"
},
"preferred_arrays": [{"id": "string",
"name": "string"
}
],
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"vlan": "1",
"wwns": ["52:4A:93:70:4E:E5:68:00"
]
}
]
}

Delete a host

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.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a host

Modifies an existing host, including its storage network addresses, CHAP, host personality, and preferred arrays, or associate a host to a host group. The names query parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
from_member_ids	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays from which the resource should be removed. Enter multiple IDs in a comma-separated format.
from_member_names	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays to be removed from the specified resource. Enter multiple names in a comma-separated format.
modify_resource_access	string Describes how to modify a resource accesses of a resource when that resource is moved. Possible values are: `none`, `create`, and `delete`. The `none` value indicates that no resource access should be modified. The `create` value is used when a resource is moving out of a realm into the array and it needs to create a resource access of the moved resource to the realm from which it is moving. The `delete` value is used when a resource that is moving from an array into a realm already has a resource access into that realm. This is a required parameter when a resource is being moved to another member.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
to_member_ids	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple IDs in a comma-separated format.
to_member_names	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple names in a comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
add_iqns	Array of strings Adds the specified iSCSI Qualified Names (IQNs) to those already associated with the specified host.
add_nqns	Array of strings Adds the specified NVMe Qualified Names (NQNs) to those already associated with the specified host.
add_wwns	Array of strings Adds the specified Fibre Channel World Wide Names (WWNs) to those already associated with the specified host.
	object (_chap) Challenge-Handshake Authentication Protocol (CHAP).
	object (ReferenceNoId) The host group to which the host should be associated.
iqns	Array of strings The iSCSI qualified name (IQN) associated with the host.
nqns	Array of strings The NVMe Qualified Name (NQN) associated with the host.
personality	string Determines how the system tunes the array to ensure that it works optimally with the host. Set `personality` to the name of the host operating system or virtual memory system. Valid values are `aix`, `esxi`, `hitachi-vsp`, `hpux`, `oracle-vm-server`, `solaris`, and `vms`. If your system is not listed as one of the valid host personalities, do not set the option. By default, the personality is not set.
	Array of objects (_reference) For synchronous replication configurations, sets a host's preferred array to specify which array exposes active/optimized paths to that host. Enter multiple preferred arrays in comma-separated format. If a preferred array is set for a host, then the other arrays in the same pod will expose active/non-optimized paths to that host. If the host is in a host group, `preferred_arrays` cannot be set because host groups have their own preferred arrays. On a preferred array of a certain host, all the paths on all the ports (for both the primary and secondary controllers) are set up as A/O (active/optimized) paths, while on a non-preferred array, all the paths are A/N (Active/Non-optimized) paths.
remove_iqns	Array of strings Disassociates the specified iSCSI Qualified Names (IQNs) from the specified host.
remove_nqns	Array of strings Disassociates the specified NVMe Qualified Names (NQNs) from the specified host.
remove_wwns	Array of strings Disassociates the specified Fibre Channel World Wide Names (WWNs) from the specified host.
vlan	string The VLAN ID that the host is associated with. If not set, there is no change in VLAN. If set to `any`, the host can access any VLAN. If set to `untagged`, the host can only access untagged VLANs. If set to a number between `1` and `4094`, the host can only access the specified VLAN with that number.
wwns	Array of strings The Fibre Channel World Wide Name (WWN) associated with the host.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"add_iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"add_nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"add_wwns": ["52:4A:93:70:4E:E5:68:00"
],
"chap": {"host_password": "string",
"host_user": "string",
"target_password": "string",
"target_user": "string"
},
"host_group": {"name": "string"
},
"iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"personality": "string",
"preferred_arrays": [{"id": "string",
"name": "string"
}
],
"remove_iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"remove_nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"remove_wwns": ["52:4A:93:70:4E:E5:68:00"
],
"vlan": "1",
"wwns": ["52:4A:93:70:4E:E5:68:00"
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"chap": {"host_password": "string",
"host_user": "string",
"target_password": "string",
"target_user": "string"
},
"connection_count": 3,
"destroyed": true,
"host_group": {"name": "string"
},
"iqns": ["iqn.2010-06.com.purestorage:linux.393d930077be2977"
],
"is_local": true,
"nqns": ["nqn.2010-06.com.purestorage:flasharray.512f7bb185978505"
],
"personality": "string",
"port_connectivity": {"details": "Redundant",
"status": "healthy"
},
"preferred_arrays": [{"id": "string",
"name": "string"
}
],
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"vlan": "1",
"wwns": ["52:4A:93:70:4E:E5:68:00"
]
}
]
}

List hosts that are associated with host groups

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership to a host group

Creates a membership to a host group. Creating a membership to a host group automatically connects the host to all volumes associated with the group. Multiple hosts can be belong to a host group, but a host can only belong to one host group. Hosts can be added to 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a membership from a host group

Deletes a membership from a host group. Deleting a membership from a host group automatically disconnects the host from all volumes associated with the group. Hosts can be deleted 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List host performance data

Displays real-time and historical performance data, real-time latency data, and average I/O sizes across all hosts, displayed by host and by total size across all hosts. This data represents volumes that are connected to the hosts on the local array and stretched volumes connected to the hosts on any arrays that are connected by synchronous replication.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
]
}

List host performance balance

Displays the I/O balance statistics for host paths.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"fraction_relative_to_max": 0.14,
"initiator": {"iqn": "iqn.2010-06.com.purestorage:flasharray.393d930077be2977",
"nqn": "nqn.2010-06.com.purestorage:flasharray.512f7bb185978505",
"portal": "10.16.200.27:3260",
"wwn": "52:4A:93:70:4E:E5:68:00"
},
"op_count": 0,
"target": {"name": "string",
"iqn": "iqn.2010-06.com.purestorage:flasharray.393d930077be2977",
"nqn": "nqn.2010-06.com.purestorage:flasharray.512f7bb185978505",
"portal": "10.16.200.27:3260",
"wwn": "52:4A:93:70:4E:E5:68:00",
"failover": "CT0.ETH2"
},
"time": 0
}
]
}

List host performance data by array

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
]
}

List hosts that are members of protection groups

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a host

Creates a host member and adds it to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a host from a protection group

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List host space information

Displays provisioned size and physical storage consumption data for each host.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags on host objects.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags on host objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if one already exists, updated.

Array ()

key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

KMIP

The Key Management Interoperability Protocol (KMIP) server is used in combination with the Pure Storage Rapid Data Locking (RDL) feature and EncryptReduce feature to further secure the encrypted data on a FlashArray.

List KMIP server objects

Displays the list of KMIP server objects.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"ca_certificate": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"certificate": {"name": "string"
},
"kmip_objects": [{"name": "string",
"uid": "string"
}
],
"name": "string",
"uris": ["1.1.1.1:8888",
"2.2.2.2:9999"
]
}
]
}

Create KMIP server object

Creates KMIP server objects.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

ca_certificate	string <= 3000 characters The text of the CA certificate for the KMIP server.
	object (ReferenceNoId) The certificate used to verify FlashArray authenticity to the KMIP servers.
uris	Array of strings List of URIs for the configured KMIP servers.

Responses

Request samples

Payload

Content type

application/json

{"ca_certificate": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"certificate": {"name": "string"
},
"uris": ["1.1.1.1:8888",
"2.2.2.2:9999"
]
}

Response samples

Content type

application/json

{"items": [{"ca_certificate": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"certificate": {"name": "string"
},
"kmip_objects": [{"name": "string",
"uid": "string"
}
],
"name": "string",
"uris": ["1.1.1.1:8888",
"2.2.2.2:9999"
]
}
]
}

Delete KMIP server object

Deletes KMIP server objects.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify KMIP attributes

Modifies one or more attributes of KMIP server objects.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

ca_certificate	string <= 3000 characters The text of the CA certificate for the KMIP server.
	object (ReferenceNoId) The certificate used to verify FlashArray authenticity to the KMIP servers.
uris	Array of strings List of URIs for the configured KMIP servers.

Responses

Request samples

Payload

Content type

application/json

{"ca_certificate": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"certificate": {"name": "string"
},
"uris": ["1.1.1.1:8888",
"2.2.2.2:9999"
]
}

Response samples

Content type

application/json

{"items": [{"ca_certificate": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"certificate": {"name": "string"
},
"kmip_objects": [{"name": "string",
"uid": "string"
}
],
"name": "string",
"uris": ["1.1.1.1:8888",
"2.2.2.2:9999"
]
}
]
}

Lists KMIP connection tests

Displays communication data between a FlashArray and KMIP server.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"component_address": "10.230.94.21",
"component_name": "kmip-test1",
"description": "Testing kmip connectivity.",
"destination": "kmip-test-server.dev.purestorage.com",
"enabled": true,
"result_details": "KMIP test failed",
"success": true,
"test_type": "kmip"
}
]
}

Log Targets

Log Targets to be used to send management or data audit logs.

List log targets

Displays a list of configured log targets.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List file log targets

Displays a list of configured file log targets.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"keep_for": 86400000,
"keep_size": 1000000
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create file log target

Creates a new file log target.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (ReferenceWithType) Directory name to be used as log target.
keep_for	integer <int64> >= 86400000 Specifies the period that audit logs are retained before they are deleted, in milliseconds. Default value is `null` which means size based retention does not apply. Use 0 to reset the value to `null`. At least one of the `keep_for` or `keep_size` parameters is required, and they can be set together.
keep_size	integer <int64> >= 1000000 Specifies the maximum size of audit logs to be retained. Measured in bytes. When exceeded, older logs will be deleted. Default value is `null` which means size-based retention does not apply. Use 0 to reset the value to `null`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"keep_for": 86400000,
"keep_size": 1000000
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"keep_for": 86400000,
"keep_size": 1000000
}
]
}

Delete file log target

Deletes a configured file log target.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify file log target

Modifies the URI of a configured file log target.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (ReferenceWithType) Directory name to be used as log target.
keep_for	integer <int64> >= 86400000 Specifies the period that audit logs are retained before they are deleted, in milliseconds. Default value is `null` which means size based retention does not apply. Use 0 to reset the value to `null`. At least one of the `keep_for` or `keep_size` parameters is required, and they can be set together.
keep_size	integer <int64> >= 1000000 Specifies the maximum size of audit logs to be retained. Measured in bytes. When exceeded, older logs will be deleted. Default value is `null` which means size-based retention does not apply. Use 0 to reset the value to `null`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"keep_for": 86400000,
"keep_size": 1000000
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"directory": {"id": "string",
"name": "string",
"resource_type": "string"
},
"keep_for": 86400000,
"keep_size": 1000000
}
]
}

List syslog servers

Displays a list of configured syslog servers.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create syslog server

Creates a new syslog server.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
services	Array of strings Valid values are `data-audit` and `management`. If not specified, defaults to `management`.
uri	string The URI of the syslog server in the format `PROTOCOL://HOSTNAME:PORT`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
]
}

Delete syslog server

Deletes a configured syslog server and stop forwarding syslog messages.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify syslog server

Modifies the URI and services of a configured syslog server.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
services	Array of strings Valid values are `data-audit` and `management`. If not specified, defaults to `management`.
uri	string The URI of the syslog server in the format `PROTOCOL://HOSTNAME:PORT`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
]
}

List syslog settings

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify syslog settings

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

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ca_certificate	string The certificate of the certificate authority (CA) that signed the directory servers' certificate(s), which is used to validate the authenticity of the configured servers.
logging_severity	string Returns the configured logging severity threshold for which events will be forwarded to the configured syslog servers. Default configuration is info level severity. Valid values are `debug`, `info`, and `notice`.
tls_audit_enabled	boolean Returns a value of `true` if messages that are necessary in order to audit TLS negotiations performed by the array are forwarded to the configured syslog servers.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}
]
}

List syslog server test results

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Maintenance Windows

During a maintenance window, alerts are suppressed that are related to connections, paths, ports, and other resources that are down during maintenance.

List maintenance window details

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"created": 0,
"expires": 0
}
]
}

Create a maintenance window

Creates a maintenance window that suppresses alerts for a specified period of time. A maintenance window can be manually closed at any time. The names and timeout parameters are required. Set the names parameter to environment.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

timeout

integer <int32>

The specified length of time that alerts are suppressed during a maintenance window, measured in milliseconds. The maintenance window timeout value must be between 60000 (1 minute) and 86400000 (24 hours). The value entered is rounded down to the nearest minute. The names and timeout parameters must be set together, and the names parameter must be set to environment.

Responses

Request samples

Payload

Content type

application/json

{"timeout": 3600000
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"created": 0,
"expires": 0
}
]
}

Delete maintenance window

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

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Network Interfaces

Manages the interfaces and the network connection attributes of the array.

List network interfaces

Displays all network interfaces for all controllers on the array.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"enabled": true,
"eth": {"address": "string",
"gateway": "string",
"mac_address": "string",
"mtu": 0,
"netmask": "string",
"subinterfaces": [{"name": "string"
}
],
"subnet": {"name": "string"
},
"subtype": "string",
"vlan": 0
},
"fc": {"wwn": "string"
},
"interface_type": "string",
"services": ["string"
],
"speed": 0
}
]
}

Create network interface

Creates a network interface on a controller on the array.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_networkinterfacepostEth) Ethernet network interface properties.
services	Array of strings The services provided by the specified network interface or Fibre Channel port.

Responses

Request samples

Payload

Content type

application/json

{"eth": {"address": "string",
"subinterfaces": [{"name": "string"
}
],
"subnet": {"name": "string"
},
"subtype": "string"
},
"services": ["string"
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true,
"eth": {"address": "string",
"gateway": "string",
"mac_address": "string",
"mtu": 0,
"netmask": "string",
"subinterfaces": [{"name": "string"
}
],
"subnet": {"name": "string"
},
"subtype": "string",
"vlan": 0
},
"fc": {"wwn": "string"
},
"interface_type": "string",
"services": ["string"
],
"speed": 0
}
]
}

Delete network interface

Deletes a network interface on a controller.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify network interface

Modifies a network interface on a controller.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean Returns a value of `true` if the specified network interface or Fibre Channel port is enabled. Returns a value of `false` if the specified network interface or Fibre Channel port is disabled.
	object (_networkinterfacepatchEth) Ethernet network interface properties.
override_npiv_check	boolean N-Port ID Virtualization (NPIV) requires a balanced configuration of Fibre Channel ports configured for SCSI on both controllers. Enabling or Disabling a Fibre Channel port configured for SCSI might cause the NPIV status to change from enabled to disabled or vice versa. Set this option to proceed with enabling or disabling the port.
services	Array of strings The services provided by the specified network interface or Fibre Channel port.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"eth": {"add_subinterfaces": [{"name": "string"
}
],
"address": "string",
"gateway": "string",
"mtu": 0,
"netmask": "string",
"remove_subinterfaces": [{"name": "string"
}
],
"subinterfaces": [{"name": "string"
}
],
"subnet": {"name": "string"
}
},
"override_npiv_check": true,
"services": ["string"
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true,
"eth": {"address": "string",
"gateway": "string",
"mac_address": "string",
"mtu": 0,
"netmask": "string",
"subinterfaces": [{"name": "string"
}
],
"subnet": {"name": "string"
},
"subtype": "string",
"vlan": 0
},
"fc": {"wwn": "string"
},
"interface_type": "string",
"services": ["string"
],
"speed": 0
}
]
}

List network interface neighbors

Displays all neighbors for all network interfaces on the array.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
local_port_names	Array of strings Performs the operation on the unique local port name specified. Enter multiple names in comma-separated format. For example, `ct0.eth0,ct1.eth0`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"initial_ttl_in_sec": 120,
"local_port": {"name": "string"
},
"neighbor_chassis": {"addresses": ["10.202.101.70"
],
"bridge": {"enabled": false,
"supported": false
},
"description": "Example Switch iscsi-sw-100-b version 1.0",
"docsis_cable_device": {"enabled": false,
"supported": false
},
"id": {"type": "mac",
"value": "00:12:ab:cd:ab:cd"
},
"name": "iscsi-sw-100-b.example.com",
"repeater": {"enabled": false,
"supported": false
},
"router": {"enabled": false,
"supported": false
},
"station_only": {"enabled": false,
"supported": false
},
"telephone": {"enabled": false,
"supported": false
},
"wlan_access_point": {"enabled": false,
"supported": false
}
},
"neighbor_port": {"description": "eth7",
"id": {"type": "ifname",
"value": "Ethernet7"
}
}
}
]
}

List network performance statistics

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

query Parameters

end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"eth": {"flow_control_received_congestion_packets_per_sec": 0,
"flow_control_received_discarded_packets_per_sec": 0,
"flow_control_received_lossless_bytes_per_sec": 0,
"flow_control_received_pause_frames_per_sec": 0,
"flow_control_transmitted_congestion_packets_per_sec": 0,
"flow_control_transmitted_discarded_packets_per_sec": 0,
"flow_control_transmitted_lossless_bytes_per_sec": 0,
"flow_control_transmitted_pause_frames_per_sec": 0,
"other_errors_per_sec": 0,
"rdma_received_req_cqe_errors_per_sec": 0,
"rdma_received_sequence_errors_per_sec": 0,
"rdma_transmitted_local_ack_timeout_errors_per_sec": 0,
"received_bytes_per_sec": 0,
"received_crc_errors_per_sec": 0,
"received_frame_errors_per_sec": 0,
"received_packets_per_sec": 0,
"total_errors_per_sec": 0,
"transmitted_bytes_per_sec": 0,
"transmitted_carrier_errors_per_sec": 0,
"transmitted_dropped_errors_per_sec": 0,
"transmitted_packets_per_sec": 0
},
"fc": {"received_bytes_per_sec": 0,
"received_crc_errors_per_sec": 0,
"received_frames_per_sec": 0,
"received_link_failures_per_sec": 0,
"received_loss_of_signal_per_sec": 0,
"received_loss_of_sync_per_sec": 0,
"total_errors_per_sec": 0,
"transmitted_bytes_per_sec": 0,
"transmitted_frames_per_sec": 0,
"transmitted_invalid_words_per_sec": 0
},
"interface_type": "string",
"time": 0
}
],
"total": [{"name": "string",
"eth": {"flow_control_received_congestion_packets_per_sec": 0,
"flow_control_received_discarded_packets_per_sec": 0,
"flow_control_received_lossless_bytes_per_sec": 0,
"flow_control_received_pause_frames_per_sec": 0,
"flow_control_transmitted_congestion_packets_per_sec": 0,
"flow_control_transmitted_discarded_packets_per_sec": 0,
"flow_control_transmitted_lossless_bytes_per_sec": 0,
"flow_control_transmitted_pause_frames_per_sec": 0,
"other_errors_per_sec": 0,
"rdma_received_req_cqe_errors_per_sec": 0,
"rdma_received_sequence_errors_per_sec": 0,
"rdma_transmitted_local_ack_timeout_errors_per_sec": 0,
"received_bytes_per_sec": 0,
"received_crc_errors_per_sec": 0,
"received_frame_errors_per_sec": 0,
"received_packets_per_sec": 0,
"total_errors_per_sec": 0,
"transmitted_bytes_per_sec": 0,
"transmitted_carrier_errors_per_sec": 0,
"transmitted_dropped_errors_per_sec": 0,
"transmitted_packets_per_sec": 0
},
"fc": {"received_bytes_per_sec": 0,
"received_crc_errors_per_sec": 0,
"received_frames_per_sec": 0,
"received_link_failures_per_sec": 0,
"received_loss_of_signal_per_sec": 0,
"received_loss_of_sync_per_sec": 0,
"total_errors_per_sec": 0,
"transmitted_bytes_per_sec": 0,
"transmitted_frames_per_sec": 0,
"transmitted_invalid_words_per_sec": 0
},
"interface_type": "string",
"time": 0
}
]
}

List SFP port details

Displays Ethernet and Fibre Channel SFP details.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"interface_type": "string",
"rx_los": [{"channel": 0,
"flag": true
}
],
"rx_power": [{"channel": 0,
"measurement": 0,
"status": "ok"
}
],
"static": {"cable_technology": ["Active Cable"
],
"connector_type": "LC",
"encoding": "64B/66B",
"extended_identifier": "GBIC/SFP function is defined by 2-wire interface ID only",
"fc_link_lengths": ["short distance (S)"
],
"fc_speeds": "16|32|64 Gb/s",
"fc_technology": ["Electrical intra-enclosure (EL)"
],
"fc_transmission_media": ["Multimode, 62.5um (M6)"
],
"identifier": "SFP or SFP+",
"link_length": "OM2: 40 m, OM1: 20 m, OM3: 100 m",
"rate_identifier": "FC-PI-5 (16/8/4G Independent Rx, Tx Rate_select)",
"rx_power_thresholds": {"alarm_high": 0,
"alarm_low": 0,
"warn_high": 0,
"warn_low": 0
},
"signaling_rate": "14000 MBd",
"signaling_rate_max": "1%",
"signaling_rate_min": "1%",
"specifications": ["1000BASE-T"
],
"temperature_thresholds": {"alarm_high": 0,
"alarm_low": 0,
"warn_high": 0,
"warn_low": 0
},
"tx_bias_thresholds": {"alarm_high": 0,
"alarm_low": 0,
"warn_high": 0,
"warn_low": 0
},
"tx_power_thresholds": {"alarm_high": 0,
"alarm_low": 0,
"warn_high": 0,
"warn_low": 0
},
"vendor_date_code": "190221",
"vendor_name": "EMULEX",
"vendor_oui": "00-17-6A",
"vendor_part_number": "ABCD-12E3FG-ELX",
"vendor_revision": "stri",
"vendor_serial_number": "AB1234C56DE",
"voltage_thresholds": {"alarm_high": 0,
"alarm_low": 0,
"warn_high": 0,
"warn_low": 0
},
"wavelength": "850 nm"
},
"temperature": [{"channel": 0,
"measurement": 0,
"status": "ok"
}
],
"tx_bias": [{"channel": 0,
"measurement": 0,
"status": "ok"
}
],
"tx_fault": [{"channel": 0,
"flag": true
}
],
"tx_power": [{"channel": 0,
"measurement": 0,
"status": "ok"
}
],
"voltage": [{"channel": 0,
"measurement": 0,
"status": "ok"
}
]
}
]
}

Offloads

The offload feature enables system administrators to replicate point-in-time volume snapshots from the array to an external storage system for long-term retention. Each offload target represents an external storage system, such as an Azure Blob container, NFS device, or S3 bucket, to where Purity//FA volume snapshots can be replicated.

List offload targets

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol	string Protocol type. Valid values are `azure`, `google-cloud`, `nfs`, and `s3`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"azure": {"account_name": "string",
"container_name": "string",
"profile": "string",
"secret_access_key": "string"
},
"google-cloud": {"access_key_id": "string",
"bucket": "string",
"profile": "string",
"secret_access_key": "string"
},
"nfs": {"address": "string",
"mount_options": "string",
"mount_point": "string",
"profile": "string"
},
"s3": {"access_key_id": "string",
"auth_region": "string",
"bucket": "string",
"placement_strategy": "string",
"profile": "string",
"secret_access_key": "string",
"uri": "string"
},
"name": "string",
"context": {"id": "string",
"name": "string"
},
"protocol": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"status": "string",
"target_id": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"azure": {"account_name": "string",
"container_name": "string",
"profile": "string",
"secret_access_key": "string"
},
"google-cloud": {"access_key_id": "string",
"bucket": "string",
"profile": "string",
"secret_access_key": "string"
},
"nfs": {"address": "string",
"mount_options": "string",
"mount_point": "string",
"profile": "string"
},
"s3": {"access_key_id": "string",
"auth_region": "string",
"bucket": "string",
"placement_strategy": "string",
"profile": "string",
"secret_access_key": "string",
"uri": "string"
},
"name": "string",
"context": {"id": "string",
"name": "string"
},
"protocol": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"status": "string",
"target_id": "string"
}
]
}

Create offload target

Creates an offload target, connecting it to an array. Before you can connect to, manage, and replicate to an offload target, the Purity Run app must be installed.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
initialize	boolean If set to `true`, initializes the Amazon S3/Azure Blob container/Google Cloud Storage in preparation for offloading. The parameter must be set to `true` if this is the first time the array is connecting to the offload target.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (OffloadAzure) Microsoft Azure Blob storage settings.
	object (OffloadGoogleCloud) Google Cloud Storage settings.
	object (OffloadNfs) NFS settings. Deprecated from version 6.6.0 onwards - Contact support for additional information.
	object (OffloadS3) S3 settings.

Responses

Request samples

Payload

Content type

application/json

{"azure": {"account_name": "string",
"container_name": "string",
"profile": "string",
"secret_access_key": "string"
},
"google-cloud": {"access_key_id": "string",
"bucket": "string",
"profile": "string",
"secret_access_key": "string"
},
"nfs": {"address": "string",
"mount_options": "string",
"mount_point": "string",
"profile": "string"
},
"s3": {"access_key_id": "string",
"auth_region": "string",
"bucket": "string",
"placement_strategy": "string",
"profile": "string",
"secret_access_key": "string",
"uri": "string"
}
}

Response samples

Content type

application/json

{"items": [{"azure": {"account_name": "string",
"container_name": "string",
"profile": "string",
"secret_access_key": "string"
},
"google-cloud": {"access_key_id": "string",
"bucket": "string",
"profile": "string",
"secret_access_key": "string"
},
"nfs": {"address": "string",
"mount_options": "string",
"mount_point": "string",
"profile": "string"
},
"s3": {"access_key_id": "string",
"auth_region": "string",
"bucket": "string",
"placement_strategy": "string",
"profile": "string",
"secret_access_key": "string",
"uri": "string"
},
"name": "string",
"context": {"id": "string",
"name": "string"
},
"protocol": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"status": "string",
"target_id": "string"
}
]
}

Delete offload target

Deletes an offload target.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Presets

Presets are reusable templates that provision resources.

List workload presets

Displays a list of workload presets.

query Parameters

context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"revision": 0,
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Update a workload preset

Updates a workload preset by replacing it with the new contents in preset. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
description	string A brief description of the workload the preset will configure. Supports up to 1KB of unicode characters.
	Array of objects (_presetWorkloadParameter) The parameters to prompt the user when they deploy workloads from the preset.
	Array of objects (_presetWorkloadPeriodicReplicationConfiguration) <= 2 items The periodic replication configurations that can be applied to storage resources (such as volumes) within the preset.
required	Array of objects (_presetWorkloadPlacementConfiguration) 1 items The placement configurations that can be applied to storage resources (such as volumes) within the preset. All storage resources associated with the same placement will be colocated on the same array.
	Array of objects (_presetWorkloadQosConfiguration) <= 5 items The QoS configurations that can be applied to storage resources (such as volumes) within the preset.
	Array of objects (_presetWorkloadSnapshotConfiguration) <= 2 items The snapshot configurations that can be applied to storage resources (such as volumes) within the preset.
required	Array of objects (_presetWorkloadVolumeConfiguration) [ 1 .. 5 ] items The volumes that will be provisioned by the preset.
	Array of objects (_presetWorkloadWorkloadTag) The tags that will be associated with workloads provisioned by the preset.
workload_type required	string The type of workload the preset will configure. Valid values include `VDI`, `File`, `MySQL` etc.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"revision": 0,
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}
]
}

Create a workload preset

Creates one workload preset.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

required

Array of strings

Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

description	string A brief description of the workload the preset will configure. Supports up to 1KB of unicode characters.
	Array of objects (_presetWorkloadParameter) The parameters to prompt the user when they deploy workloads from the preset.
	Array of objects (_presetWorkloadPeriodicReplicationConfiguration) <= 2 items The periodic replication configurations that can be applied to storage resources (such as volumes) within the preset.
required	Array of objects (_presetWorkloadPlacementConfiguration) 1 items The placement configurations that can be applied to storage resources (such as volumes) within the preset. All storage resources associated with the same placement will be colocated on the same array.
	Array of objects (_presetWorkloadQosConfiguration) <= 5 items The QoS configurations that can be applied to storage resources (such as volumes) within the preset.
	Array of objects (_presetWorkloadSnapshotConfiguration) <= 2 items The snapshot configurations that can be applied to storage resources (such as volumes) within the preset.
required	Array of objects (_presetWorkloadVolumeConfiguration) [ 1 .. 5 ] items The volumes that will be provisioned by the preset.
	Array of objects (_presetWorkloadWorkloadTag) The tags that will be associated with workloads provisioned by the preset.
workload_type required	string The type of workload the preset will configure. Valid values include `VDI`, `File`, `MySQL` etc.

Responses

Request samples

Payload

Content type

application/json

{"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"revision": 0,
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}
]
}

Delete a workload preset

Deletes a workload preset permanently. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a workload preset

Modifies a workload preset by overriding the fields specified in preset. To rename a workload preset, set name to the new name.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.

Responses

Request samples

Payload

Content type

application/json

{"name": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"description": "string",
"parameters": [{"constraints": {"boolean": {"default": true
},
"integer": {"allowed_values": [0
],
"default": 0,
"maximum": 0,
"minimum": 0
},
"resource_reference": {"allowed_values": [{"resource_type": "string"
}
],
"default": {"id": "string",
"name": "string",
"resource_type": "string"
}
},
"string": {"allowed_values": ["string"
],
"default": "string"
}
},
"metadata": {"description": "string",
"display_name": "Billing ID",
"subtype": "string"
},
"name": "billing-id",
"type": "string"
}
],
"periodic_replication_configurations": [{"name": "string",
"remote_targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"placement_configurations": [{"name": "string",
"qos_configurations": ["string"
],
"storage_class": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"qos_configurations": [{"bandwidth_limit": "string",
"iops_limit": "string",
"name": "string"
}
],
"revision": 0,
"snapshot_configurations": [{"name": "string",
"rules": [{"at": "string",
"every": "string",
"keep_for": "string"
}
]
}
],
"volume_configurations": [{"count": "string",
"name": "string",
"periodic_replication_configurations": ["string"
],
"placement_configurations": ["string"
],
"provisioned_size": "string",
"snapshot_configurations": ["string"
]
}
],
"workload_tags": [{"copyable": "true",
"key": "environment",
"namespace": "default",
"value": "staging"
}
],
"workload_type": "string"
}
]
}

Pods

Synchronous replication is managed through pods. A pod representing a collection of protection groups and volumes is created on one array and stretched to another array, resulting in fully synchronized writes between the two arrays. A pod can contain a mix of volumes, and protection groups with member volumes. Writes to the pod coming into either array are immediately synchronized and seen on both arrays.

List pods

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array_count": 1,
"arrays": [{"id": "string",
"name": "string",
"frozen_at": 1492662000,
"mediator_status": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pre_elected": true,
"progress": 0.66,
"status": "resyncing"
}
],
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"failover_preferences": [{"id": "string",
"name": "string"
}
],
"footprint": 0,
"link_source_count": 1,
"link_target_count": 1,
"mediator": "https://mediator.cloud-support.purestorage.com",
"mediator_version": "1.0.0",
"members": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"promotion_status": "string",
"quota_limit": 0,
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array_count": 1,
"arrays": [{"id": "string",
"name": "string",
"frozen_at": 1492662000,
"mediator_status": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pre_elected": true,
"progress": 0.66,
"status": "resyncing"
}
],
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"failover_preferences": [{"id": "string",
"name": "string"
}
],
"footprint": 0,
"link_source_count": 1,
"link_target_count": 1,
"mediator": "https://mediator.cloud-support.purestorage.com",
"mediator_version": "1.0.0",
"members": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"promotion_status": "string",
"quota_limit": 0,
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time_remaining": 0
}
]
}

Create a pod

Creates a pod on the local array. Each pod must be given a unique name across the arrays to which they are stretched. A pod cannot be stretched to an array that already contains a pod with the same name. After a pod has been created, add volumes and protection groups, and then stretch the pod to another connected array.

query Parameters

allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	Array of objects (_reference) Determines which array within a stretched pod should be given priority to stay online should the arrays ever lose contact with each other. The current array and any peer arrays that are connected to the current array for synchronous replication can be added to a pod for failover preference. By default, `failover_preferences=null`, meaning no arrays have been configured for failover preference. Enter multiple arrays in comma-separated format. To clear the list of failover preferences, set to an empty list `[]`.
quota_limit	integer <int64> [ 1048576 .. 4503599627370496 ] The logical quota limit of the pod, measured in bytes. Must be a multiple of 512.
	object (Reference) The source pod from where data is cloned to create the new pod.
	Array of objects (Tag) The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"failover_preferences": [{"id": "string",
"name": "string"
}
],
"quota_limit": 1048576,
"source": {"id": "string",
"name": "string"
},
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array_count": 1,
"arrays": [{"id": "string",
"name": "string",
"frozen_at": 1492662000,
"mediator_status": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pre_elected": true,
"progress": 0.66,
"status": "resyncing"
}
],
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"failover_preferences": [{"id": "string",
"name": "string"
}
],
"footprint": 0,
"link_source_count": 1,
"link_target_count": 1,
"mediator": "https://mediator.cloud-support.purestorage.com",
"mediator_version": "1.0.0",
"members": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"promotion_status": "string",
"quota_limit": 0,
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time_remaining": 0
}
]
}

Delete a pod

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 they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
eradicate_contents	boolean Set to `true` to eradicate contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups). This enables you to eradicate containers with contents.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a pod

Modifies pod details.

query Parameters

abort_quiesce	boolean Set to `true` to promote the pod when the `pod-replica-link` is in the `quiescing` state and abort when waiting for the `pod-replica-link` to complete the quiescing operation.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
destroy_contents	boolean Set to `true` to destroy contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups), including eradicating containers with content.
from_member_ids	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays from which the resource should be removed. Enter multiple IDs in a comma-separated format.
from_member_names	Array of strings Move the resource from the specified local member realm or array. This should be a union of all local realms and arrays to be removed from the specified resource. Enter multiple names in a comma-separated format.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
move_with_host_group_names	Array of strings The host groups to be moved together with the pods to the specified local member realm or array. All the hosts in the host groups will also be moved. Enter multiple names in a comma-separated format.
move_with_host_names	Array of strings The hosts to be moved together with the pods to the specified local member realm or array. Enter multiple names in a comma-separated format.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
promote_from	string The `undo-demote` pod that should be used to promote the pod. After the pod has been promoted, it will have the same data as the `undo-demote` pod and the `undo-demote` pod will be eradicated.
quiesce	boolean Set to `true` to demote the pod after the `pod-replica-link` goes into `quiesced` state and allow the pod to become a target of the remote pod. This ensures that all local data has been replicated to the remote pod before the pod is demoted.
skip_quiesce	boolean Set to `true` to demote the pod without quiescing the `pod-replica-link` and allow the pod to become a target of the remote pod. This stops all pending replication to the remote pod.
to_member_ids	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple IDs in a comma-separated format.
to_member_names	Array of strings The resource will be moved to the specified local member realm or array. Enter multiple names in a comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
destroyed	boolean If set to `true`, the pod has been destroyed and is pending eradication. The `time_remaining` value displays the amount of time left until the destroyed pod is permanently eradicated. A pod can only be destroyed if it is empty, so before destroying a pod, ensure all volumes and protection groups inside the pod have been either moved out of the pod or destroyed. A stretched pod cannot be destroyed unless you unstretch it first. Before the `time_remaining` period has elapsed, the destroyed pod can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the pod is permanently eradicated and can no longer be recovered.
	Array of objects (_reference) Determines which array within a stretched pod should be given priority to stay online should the arrays ever lose contact with each other. The current array and any peer arrays that are connected to the current array for synchronous replication can be added to a pod for failover preference. By default, `failover_preferences=null`, meaning no arrays have been configured for failover preference. Enter multiple arrays in comma-separated format.
ignore_usage	boolean Set to `true` to set a `quota_limit` that is lower than the existing usage. This ensures that no new volumes can be created until the existing usage drops below the `quota_limit`. If not specified, defaults to `false`.
mediator	string Sets the URL of the mediator for this pod, replacing the URL of the current mediator. By default, the Pure1 Cloud Mediator (`purestorage`) serves as the mediator.
quota_limit	integer <int64> [ 1048576 .. 4503599627370496 ] The logical quota limit of the pod, measured in bytes. Must be a multiple of 512.
requested_promotion_state	string Patch `requested_promotion_state` to `demoted` to demote the pod so that it can be used as a link target for continuous replication between pods. Demoted pods do not accept write requests, and a destroyed version of the pod with `undo-demote` appended to the pod name is created on the array with the state of the pod when it was in the promoted state. Patch `requested_promotion_state` to `promoted` to start the process of promoting the pod. The `promotion_status` indicates when the pod has been successfully promoted. Promoted pods stop incorporating replicated data from the source pod and start accepting write requests. The replication process does not stop when the source pod continues replicating data to the pod. The space consumed by the unique replicated data is tracked by the `space.journal` field of the pod.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"destroyed": true,
"failover_preferences": [{"id": "string",
"name": "string"
}
],
"ignore_usage": true,
"mediator": "https://mediator.cloud-support.purestorage.com",
"quota_limit": 1048576,
"requested_promotion_state": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array_count": 1,
"arrays": [{"id": "string",
"name": "string",
"frozen_at": 1492662000,
"mediator_status": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pre_elected": true,
"progress": 0.66,
"status": "resyncing"
}
],
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"failover_preferences": [{"id": "string",
"name": "string"
}
],
"footprint": 0,
"link_source_count": 1,
"link_target_count": 1,
"mediator": "https://mediator.cloud-support.purestorage.com",
"mediator_version": "1.0.0",
"members": [{"id": "string",
"name": "string",
"resource_type": "string"
}
],
"promotion_status": "string",
"quota_limit": 0,
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time_remaining": 0
}
]
}

List pods and their the array members

Displays a list of pods and the local and remote arrays over which the pods are stretched. Pods with realm members will not be returned. 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. (Deprecated) Use pods/members instead.)

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Creates a pod to be stretched to an array

Creates a pod to be stretched to an array. When a pod is stretched to an array, the data in the arrays over which the pod is stretched is synchronously replicated. The group_names parameter represents the name of the pod to be stretched. The member_names parameter represents the name of the array over which the pod is to be stretched. The group_names and member_names parameters are required and must be set together. (Deprecated) Use pods/members instead.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string"
}
}
]
}

Delete a pod that was stretched to an array

Deletes a pod that was stretchd to 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 restretched 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 restretched 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. (Deprecated) Use pods/members instead.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.
with_unknown	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List pods and their members

Displays a list of pods and the local and remote members over which the pods are stretched. Currently either array or realm is supported as member.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
pod_ids	Array of strings A comma-separated list of pod IDs.
pod_names	Array of strings Performs the operation on the unique pod name specified. Enter multiple names in comma-separated format. For example, `pod01,pod02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pod": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Creates a pod to be stretched to a member

Creates a pod to be stretched to a member. When a pod is stretched to an array, the data in the arrays over which the pod is stretched is synchronously replicated. The member_names or member_ids parameter represents the array over which the pod is to be stretched. Both pod and member must be specified by name or ID.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.
pod_ids	Array of strings A comma-separated list of pod IDs.
pod_names	Array of strings Performs the operation on the unique pod name specified. Enter multiple names in comma-separated format. For example, `pod01,pod02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"pod": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a member from a pod

Deletes a stretched pod from an array, collapsing the pod to a member array. Unstretch a pod from an array when the volumes within the stretched pod no longer need to be synchronously replicated between the two members. 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 member that no longer has the pod. The restretched pod represents a point-in-time snapshot of the pod, just before it was unstretched. The restretched pod enters an eradication pending period starting from the time that the pod was unstretched. A restretched pod can be cloned or destroyed, but it cannot be explicitly recovered. The member_names parameter represents the name of the array from which the pod is to be unstretched. Both pod and member must be specified by name or ID.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.
pod_ids	Array of strings A comma-separated list of pod IDs.
pod_names	Array of strings Performs the operation on the unique pod name specified. Enter multiple names in comma-separated format. For example, `pod01,pod02`.
with_unknown	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List pod performance data

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol	string Protocol type. Valid values are `nfs`, `smb`, and `all`.
protocol_group	string Protocol group type. Valid values are `block`, `file`, and `all`.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0
}
]
}

List pod performance data by array

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol	string Protocol type. Valid values are `nfs`, `smb`, and `all`.
protocol_group	string Protocol group type. Valid values are `block`, `file`, and `all`.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0,
"array": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0,
"array": {"id": "string",
"name": "string"
}
}
]
}

List pod replication performance data

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"continuous_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"periodic_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"pod": {"id": "string",
"name": "string"
},
"resync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"sync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"time": 0,
"total_bytes_per_sec": 0
}
],
"total": [{"context": {"id": "string",
"name": "string"
},
"continuous_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"periodic_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"pod": {"id": "string",
"name": "string"
},
"resync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"sync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"time": 0,
"total_bytes_per_sec": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List pod replication performance data by array

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"continuous_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"periodic_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"pod": {"id": "string",
"name": "string"
},
"resync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"sync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"time": 0,
"total_bytes_per_sec": 0,
"array": {"id": "string",
"name": "string"
}
}
],
"total": [{"context": {"id": "string",
"name": "string"
},
"continuous_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"periodic_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"pod": {"id": "string",
"name": "string"
},
"resync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"sync_bytes_per_sec": {"from_remote_bytes_per_sec": 0,
"to_remote_bytes_per_sec": 0,
"total_bytes_per_sec": 0
},
"time": 0,
"total_bytes_per_sec": 0,
"array": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List pod space information

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"replication": 0,
"replication_effective": 0,
"shared_effective": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags for all specified objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if already existing, updated.

Array ()

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Create an attempt to clone a pod

Creates an attempt to clone a pod on the local array without actually cloning it to test whether the pod can be successfully cloned. This action does not suppport pod creation.

query Parameters

allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	Array of objects (_reference) Determines which array within a stretched pod should be given priority to stay online should the arrays ever lose contact with each other. The current array and any peer arrays that are connected to the current array for synchronous replication can be added to a pod for failover preference. By default, `failover_preferences=null`, meaning no arrays have been configured for failover preference. Enter multiple arrays in comma-separated format. To clear the list of failover preferences, set to an empty list `[]`.
quota_limit	integer <int64> [ 1048576 .. 4503599627370496 ] The logical quota limit of the pod, measured in bytes. Must be a multiple of 512.
	object (Reference) The source pod from where data is cloned to create the new pod.
	Array of objects (Tag) The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"failover_preferences": [{"id": "string",
"name": "string"
}
],
"quota_limit": 1048576,
"source": {"id": "string",
"name": "string"
},
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"id": "string",
"name": "string"
}
}
]
}

Pod Replica Links

Pod replica links are created by associating a source pod with a demoted pod, making the demoted pod the target pod of the source pod. The direction of the replica link is from the promoted source pod to the demoted target pod. Replica links can be created in either direction between the same two FlashArrays. The target pod of a replica link cannot be on the same FlashArray as the source pod.

List pod replica links

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"lag": 0,
"local_pod": {"id": "string",
"name": "string"
},
"paused": true,
"recovery_point": 1565034592494,
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"status": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create pod replica links

Creates pod replica links between two arrays. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"lag": 0,
"local_pod": {"id": "string",
"name": "string"
},
"paused": true,
"recovery_point": 1565034592494,
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"status": "string"
}
]
}

Delete pod replica links

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify pod replica links

Modifies 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

paused

boolean

Returns a value of true if the replica link is to be created in a paused state. Returns a value of false if the replica link is to be created not in a paused state. If not specified, defaults to false.

Responses

Request samples

Payload

Content type

application/json

{"paused": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"lag": 0,
"local_pod": {"id": "string",
"name": "string"
},
"paused": true,
"recovery_point": 1565034592494,
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"status": "string"
}
]
}

List pod replica link lag

Displays the lag in milliseconds that the replication target is behind the source. This is the time difference between the current time and the recovery point.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"lag": {"avg": 0,
"max": 0
},
"local_pod": {"id": "string",
"name": "string"
},
"recovery_point": 1565034592494,
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"status": "string",
"time": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

<no summary>

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"bytes_per_sec_from_remote": 0,
"bytes_per_sec_to_remote": 0,
"bytes_per_sec_total": 0,
"direction": "string",
"local_pod": {"id": "string",
"name": "string"
},
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"time": 0,
"context": {"id": "string",
"name": "string"
}
}
],
"total": [{"id": "string",
"bytes_per_sec_from_remote": 0,
"bytes_per_sec_to_remote": 0,
"bytes_per_sec_total": 0,
"direction": "string",
"local_pod": {"id": "string",
"name": "string"
},
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
],
"time": 0,
"context": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List policy mappings

Displays a list of policy mappings.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
pod_replica_link_ids	Array of strings A comma-separated list of pod replica link IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"local_policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"mapping": "string",
"pod_replica_link": {"id": "string",
"local_pod": {"id": "string",
"name": "string"
},
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
]
},
"policy_type": "string",
"remote_policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify policy mappings

Modifies policy mappings of a replica link. Valid mapping values are connected and disconnected. connected indicates that the source policy and its attachments will be mirrored on the target pod. disconnected indicates that the associated policy and its attachments are independent from any policy on the remote. This operation can only be performed on the target side of a pod replica link.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
local_pod_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
pod_replica_link_ids	Array of strings A comma-separated list of pod replica link IDs. If, after filtering, there is not at least one resource that matches each of the elements, then an error is returned.
remote_ids	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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	Array of strings A comma-separated 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.
remote_policy_ids	Array of strings A comma-separated list of remote policy 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_policy_names` query parameter.
remote_policy_names	Array of strings A comma-separated list of remote policy 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_policy_ids` query parameter.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

mapping

string

The mapping to set on this policy mapping. Valid values are connected and disconnected.

Responses

Request samples

Payload

Content type

application/json

{"mapping": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"context": {"id": "string",
"name": "string"
},
"direction": "string",
"local_policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"mapping": "string",
"pod_replica_link": {"id": "string",
"local_pod": {"id": "string",
"name": "string"
},
"remote_pod": {"id": "string",
"name": "string"
},
"remotes": [{"id": "string",
"name": "string"
}
]
},
"policy_type": "string",
"remote_policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Policies

Policies are used to create exports (i.e., shares) and schedule snapshots. NFS and SMB policies can be created and have one or more rules applied to them. Each policy can be reused, creating exports for a number of managed directories.

List policies

Displays a list of policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List management access policies

Displays a list of management access policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"aggregation_strategy": "string",
"enabled": true,
"policy_type": "string",
"rules": [{"role": {"name": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create management access policies

Creates one or more management access policies. To copy a policy, one of source_names or source_ids is required. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names required	Array of strings Performs the operation on the unique name specified. For example, `name01`. Enter multiple names in comma-separated format.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
aggregation_strategy	string When set to `least-common-permissions`, any users to whom this policy applies can receive no access rights exceeding those defined in this policy's capability and resource. When this is set to `all-permissions`, any users to whom this policy applies are capable of receiving additional access rights from other policies that apply to them. If not specified, defaults to `all-permissions`.
	Array of objects (_policyrulemanagementaccessRules) List the rules that defines the scoped roles.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"aggregation_strategy": "string",
"rules": [{"role": {"name": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"aggregation_strategy": "string",
"enabled": true,
"policy_type": "string",
"rules": [{"role": {"name": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}
]
}

Delete management access policies

Deletes one or more management access policies. One of ids or names is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify management access policies

Modifies one or more management access policies. One of ids or names is required. For renames, can only specify one old policy in ids or names.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
aggregation_strategy	string When this is set to `least-common-permissions`, any users to whom this policy applies can receive no access rights exceeding those defined in this policy's capability and resource. When this is set to `all-permissions`, any users to whom this policy applies are capable of receiving additional access rights from other policies that apply to them.
enabled	boolean Sets whether the policy is enabled and grants the permissions specified.
	Array of objects (_policyrulemanagementaccessRules) List the rules that defines the scoped roles.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"aggregation_strategy": "string",
"enabled": true,
"rules": [{"role": {"name": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"aggregation_strategy": "string",
"enabled": true,
"policy_type": "string",
"rules": [{"role": {"name": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}
]
}

List management access policy members

Displays a list of management access policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in a comma-separated format.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in a comma-separated format.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between an object and a management access policy

Creates a membership between one or more objects and a management access policy.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in a comma-separated format.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete membership between management access policies and attached object

Deletes a membership between one or more management access policies and attached object. One of policy_ids or policy_names is required, as well as one of member_ids or member_names. member_types is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in a comma-separated format.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List alert-watcher policies

Displays a list of alert-watcher policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create alert-watcher policies

Creates one or more alert-watcher policies. To copy a policy, the source_names or source_ids parameter is required, but they cannot be set together. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, enables the policy. If set to false, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

Delete alert-watcher policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify alert-watcher policies

Modifies one or more alert-watcher policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

List alert-watcher policy members

Displays a list of alert-watcher policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between an object and an alert-watcher policy

Creates a membership between one or more objects and an alert-watcher policy. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete membership between alert-watcher policies and attached object

Deletes a membership between one or more alert-watcher policies and attached object. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List alert-watcher policy rules

Displays a list of alert-watcher policy rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"email": "string",
"excluded_codes": [101
],
"included_codes": [101
],
"minimum_notification_severity": "string",
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create alert-watcher policy rules

Creates one or more alert-watcher policy rules. Either the 'policy_ids' or 'policy_names' parameter is required, but both parameters cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulealertwatcherpostRules)

A list of alert-watcher policy rules to create.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"email": "string",
"excluded_codes": [101
],
"included_codes": [101
],
"minimum_notification_severity": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"email": "string",
"excluded_codes": [101
],
"included_codes": [101
],
"minimum_notification_severity": "string",
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete alert-watcher policy rules

Deletes one or more alert-watcher policy rules. Either the 'policy_ids' or 'policy_names' parameter is required, but both parameters cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify alert-watcher policy rules

Modifies alert-watcher policy rules.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulealertwatcherpatchRules) <= 1 items

Updates an alert-watcher rule in a policy. Only one update object will be accepted.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"email": "string",
"excluded_codes": [101
],
"included_codes": [101
],
"minimum_notification_severity": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"email": "string",
"excluded_codes": [101
],
"included_codes": [101
],
"minimum_notification_severity": "string",
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

List rules of alert-watcher policy rule test

Displays alert-watcher policy rule email test results.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

List audit policies

Displays a list of audit policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"log_targets": [{"name": "string",
"resource_type": "string"
}
]
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create audit policies

Creates one or more audit policies. To copy a policy, the source_names or source_ids parameter is required, but they cannot be set together. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
	Array of objects (_referenceNoIdWithType) A list of targets to which audit logs will be sent.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"log_targets": [{"name": "string",
"resource_type": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"log_targets": [{"name": "string",
"resource_type": "string"
}
]
}
]
}

Delete audit policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify audit policies

Modifies one or more audit policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
	Array of objects (_referenceNoIdWithType) A list of targets to which audit logs will be sent. This list, if sent, overrides existing target list.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true,
"log_targets": [{"name": "string",
"resource_type": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"log_targets": [{"name": "string",
"resource_type": "string"
}
]
}
]
}

List audit policy members

Displays a list of audit policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a managed directory and a audit policy

Creates a membership between one or more managed directories and a audit policy. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete membership between audit policies and managed directories

Deletes a membership between one or more audit policies and managed directories. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List auto managed directory policies

Displays a list of auto managed directory policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create auto managed directory policies

Creates one or more auto managed directory policies. To copy a policy, set one of either source_names or source_ids. Each policy can only have one entry. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, enables the policy. If set to false, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

Delete auto managed directory policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify auto managed directory policies

Modifies one or more auto managed directory policies. To enable a policy, set enabled=true. To disable a policy, set enabled=true. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

List auto managed directories policy members

Displays a list of auto managed directory policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create auto managed directory policies

Creates a membership between one or more resources with an auto managed directory policy. Applicable resources are directories. The policy_ids or policy_names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete auto managed directory policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List policy members

Displays a list of policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List NFS policies

Displays a list of NFS policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"nfs_version": ["nfsv3-partial"
],
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
},
"security": ["auth_sys-partial"
],
"user_mapping_enabled": true
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create NFS policies

Creates one or more NFS policies or copies an existing policy. To copy a policy, the source_names or source_ids parameter is required, but they cannot be set together. To create a policy, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
	object (_policynfspostPolicyMapping) If set specifies the initial mapping of the policy upon its creation across a pod replica link. Policy being created must be in a source pod of a replica-link.
user_mapping_enabled	boolean If set to `true`, FlashArray queries the joined AD/OpenLDAP server to find the user corresponding to the incoming UID. If set to `false`, users are defined by UID/GID pair. If not specified, defaults to `true`.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"policy_mapping": {"mapping": "string"
},
"user_mapping_enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"nfs_version": ["nfsv3-partial"
],
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
},
"security": ["auth_sys-partial"
],
"user_mapping_enabled": true
}
]
}

Delete NFS policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify NFS policies

Modifies one or more NFS policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
nfs_version	Array of strings NFS protocol version allowed for the export to set for the policy. This operation updates all rules of the specified policy. Valid values are `nfsv3` and `nfsv4`.
security	Array of strings The security flavors to use for accessing files on this mount point. Values include `auth_sys`, `krb5`, `krb5i`, and `krb5p`. If the server does not support the requested flavor, the mount operation fails. This operation updates all rules of the specified policy. If `auth_sys`, the client is trusted to specify the identity of the user. If `krb5`, cryptographic proof of the identity of the user is provided in each RPC request. This provides strong verification of the identity of users accessing data on the server. Note that additional configuration besides adding this mount option is required to enable Kerberos security. If `krb5i`, integrity checking is added to krb5. This ensures the data has not been tampered with. If `krb5p`, integrity checking and encryption is added to `krb5`. This is the most secure setting, but it also involves the most performance overhead.
user_mapping_enabled	boolean If set to `true`, FlashArray queries the joined AD/OpenLDAP server to find the user corresponding to the incoming UID. If set to `false`, users are defined by UID/GID pair.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true,
"nfs_version": ["nfsv3"
],
"security": ["auth_sys"
],
"user_mapping_enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"nfs_version": ["nfsv3-partial"
],
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
},
"security": ["auth_sys-partial"
],
"user_mapping_enabled": true
}
]
}

List NFS client policy rules

Displays a list of NFS client policy rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"access": "string",
"anongid": "65530",
"anonuid": "65530",
"client": "string",
"destroyed": true,
"name": "string",
"nfs_version": ["nfsv3"
],
"permission": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"security": ["auth_sys"
],
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create NFS client policy rules

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulenfsclientpostRules)

A list of NFS policy rules to create.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"access": "string",
"anongid": "65530",
"anonuid": "65530",
"client": "string",
"nfs_version": ["nfsv3"
],
"permission": "string",
"security": ["auth_sys"
]
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"access": "string",
"anongid": "65530",
"anonuid": "65530",
"client": "string",
"destroyed": true,
"name": "string",
"nfs_version": ["nfsv3"
],
"permission": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"security": ["auth_sys"
],
"time_remaining": 0
}
]
}

Delete NFS client policy rules.

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List NFS policy members

Displays a list of NFS policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create NFS policies

Creates a membership between one or more resources and an NFS policy. Applicable resources are directories. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberexportpostMembers)

A list of directories to which the export policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"export_enabled": false,
"export_name": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
]
}

Delete NFS policies

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List password policies

Displays a list of password policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"enabled": true,
"enforce_dictionary_check": true,
"enforce_username_check": true,
"lockout_duration": 3600000,
"max_login_attempts": 10,
"max_password_age": 86400000,
"min_character_groups": 3,
"min_characters_per_group": 1,
"min_password_age": 86400000,
"min_password_length": 1,
"password_history": 5,
"policy_type": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify password policies

Modifies one or more password policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
enabled	boolean Returns a value of `true` if the policy is enabled.
enforce_dictionary_check	boolean If `true`, test password against dictionary of known leaked passwords. Only applies to passwords longer than 6 characters.
enforce_username_check	boolean If `true`, the username cannot be a substring of the password. It only applies to usernames of 3 characters and longer.
lockout_duration	integer <int64> [ 1000 .. 7776000000 ] The lockout duration, in milliseconds, if a user is locked out after reaching the maximum number of login attempts. Ranges from 1 second to 90 days.
max_login_attempts	integer <int32> [ 1 .. 100 ] Maximum number of failed login attempts allowed before the user is locked out.
max_password_age	integer <int64> [ 0 .. 8639913600000 ] The maximum age of password before password change is required. Ranges from 1 day to 99999 days, with 0 meaning password expiration is disabled.
min_character_groups	integer <int32> [ 0 .. 4 ] The minimum number of character groups ([a-z], [A-Z], [0-9], other) required to be present in a password.
min_characters_per_group	integer <int32> >= 1 The minimum number of characters per group to count the group as present. Maximum is limited by the minimum password length divided by the number of character groups (e.g. min_password_length = 9, min_character_groups = 4, then maximum is 2).
min_password_age	integer <int64> [ 0 .. 604800000 ] The minimum age, in milliseconds, of password before password change is allowed. Ranges from 0 ms to 7 days
min_password_length	integer <int32> [ 1 .. 100 ] Minimum password length. If not specified, defaults to 1.
password_history	integer <int32> [ 0 .. 64 ] The number of passwords tracked to prevent reuse of passwords.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"enabled": true,
"enforce_dictionary_check": true,
"enforce_username_check": true,
"lockout_duration": 3600000,
"max_login_attempts": 10,
"max_password_age": 86400000,
"min_character_groups": 3,
"min_characters_per_group": 1,
"min_password_age": 86400000,
"min_password_length": 1,
"password_history": 5
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"enabled": true,
"enforce_dictionary_check": true,
"enforce_username_check": true,
"lockout_duration": 3600000,
"max_login_attempts": 10,
"max_password_age": 86400000,
"min_character_groups": 3,
"min_characters_per_group": 1,
"min_password_age": 86400000,
"min_password_length": 1,
"password_history": 5,
"policy_type": "string"
}
]
}

List quota policies

Displays a list of quota policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create quota policies

Creates one or more quota policies. To copy a policy, the source_names or source_ids parameter is required, but they cannot be set together. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, enables the policy. If set to false, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

Delete quota policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify quota policies

Modifies one or more quota policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
ignore_usage	boolean Flag used to override checks for quota management operations. If set to `true`, directory usage is not checked against the `quota_limits` that are set. If set to `false`, the actual logical bytes in use are prevented from exceeding the limits set on the directory. Client operations might be impacted. If the limit exceeds the quota, the client operation is not allowed. If not specified, defaults to `false`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

List quota policy members

Displays a list of quota policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a membership between a managed directory and a quota policy

Creates a membership between one or more managed directories and a quota policy. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ignore_usage	boolean Flag used to override checks for quota management operations. If set to `true`, directory usage is not checked against the `quota_limits` that are set. If set to `false`, the actual logical bytes in use are prevented from exceeding the limits set on the directory. Client operations might be impacted. If the limit exceeds the quota, the client operation is not allowed. If not specified, defaults to `false`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete membership between quota policies and managed directories

Deletes a membership between one or more quota policies and managed directories. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List quota policy rules

Displays a list of quota policy rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enforced": true,
"name": "string",
"notifications": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"quota_limit": 0,
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create quota policy rules

Creates one or more quota policy rules. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ignore_usage	boolean Flag used to override checks for quota management operations. If set to `true`, directory usage is not checked against the `quota_limits` that are set. If set to `false`, the actual logical bytes in use are prevented from exceeding the limits set on the directory. Client operations might be impacted. If the limit exceeds the quota, the client operation is not allowed. If not specified, defaults to `false`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulequotapostRules)

A list of quota policy rules to create.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"enforced": true,
"notifications": "string",
"quota_limit": 0
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enforced": true,
"name": "string",
"notifications": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"quota_limit": 0,
"time_remaining": 0
}
]
}

Delete quota policy rules

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify quota policy rules

Modifies quota policy rules.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ignore_usage	boolean Flag used to override checks for quota management operations. If set to `true`, directory usage is not checked against the `quota_limits` that are set. If set to `false`, the actual logical bytes in use are prevented from exceeding the limits set on the directory. Client operations might be impacted. If the limit exceeds the quota, the client operation is not allowed. If not specified, defaults to `false`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulequotapatchRules) <= 1 items

Updates rules in a policy and accepts a single-rule update object. The list can contain only one item that will update all the specified rules.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"enforced": true,
"notifications": "string",
"quota_limit": 0
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enforced": true,
"name": "string",
"notifications": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"quota_limit": 0,
"time_remaining": 0
}
]
}

List SMB policies

Displays a list of SMB policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"access_based_enumeration_enabled": true,
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create SMB policies

Creates one or more SMB policies. To copy a policy, set one of either source_names or source_ids. Each policy can only have one entry. To create a policy from scratch, policy body is required. To create an SMB policy with access based enumeration enabled, set access_based_enumeration_enabled=true.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
access_based_enumeration_enabled	boolean If set to `true`, enables access based enumeration on the policy. When access based enumeration is enabled on a policy, files and folders within exports that are attached to the policy will be hidden from users who do not have permission to view them. If not specified, defaults to `false`.
	object (_policynfspostPolicyMapping) If set specifies the initial mapping of the policy upon its creation across a pod replica link. Policy being created must be in a source pod of a replica-link.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"access_based_enumeration_enabled": true,
"policy_mapping": {"mapping": "string"
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"access_based_enumeration_enabled": true,
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
}
}
]
}

Delete SMB policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify SMB policies

Modifies one or more SMB policies. To enable a policy, set enabled=true. To disable a policy, set enabled=false. To enable access based enumeration, set access_based_enumeration_enabled=true. To disable access based enumeration, set access_based_enumeration_enabled=false. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.
access_based_enumeration_enabled	boolean If set to `true`, enables access based enumeration on the policy. When access based enumeration is enabled on a policy, files and folders within exports that are attached to the policy will be hidden from users who do not have permission to view them.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true,
"access_based_enumeration_enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0,
"access_based_enumeration_enabled": true,
"policy_mapping": {"mapping": "string",
"remote_policy": "string"
}
}
]
}

List SMB client policy rules

Displays a list of SMB client policy rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"anonymous_access_allowed": true,
"client": "string",
"destroyed": true,
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"smb_encryption_required": true,
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create SMB client policy rules

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulesmbclientpostRules)

A list of SMB policy rules to create.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"anonymous_access_allowed": true,
"client": "string",
"smb_encryption_required": true
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"anonymous_access_allowed": true,
"client": "string",
"destroyed": true,
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"smb_encryption_required": true,
"time_remaining": 0
}
]
}

Delete SMB client policy rules.

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List SMB policy members

Displays a list of SMB policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create SMB policies

Creates a membership between one or more resources and an SMB policy. Applicable resources are directories. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberexportpostMembers)

A list of directories to which the export policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"export_enabled": false,
"export_name": "string",
"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0,
"export_name": "string",
"status": "string"
}
]
}

Delete SMB policies

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List snapshot policies

Displays a list of snapshot policies.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create snapshot policies

Creates one or more snapshot policies. To copy a policy, set one of either source_names or source_ids. Each policy can only have one entry. To create a policy from scratch, policy body is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled

boolean

If set to true, enables the policy. If set to false, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

Delete snapshot policies

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify snapshot policies

Modifies one or more snapshot policies. To enable a policy, set enabled=true. To disable a policy, set enabled=true. To rename a policy, set name to the new name. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
enabled	boolean If set to `true`, enables the policy. If set to `false`, disables the policy.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"pod": {"id": "string",
"name": "string"
},
"policy_type": "string",
"time_remaining": 0
}
]
}

List snapshot policy members

Displays a list of snapshot policy members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create snapshot policies

Creates a membership between one or more resources and a snapshot policy. Applicable resources are directories. The policy_ids or policy_names parameter is required, but cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policymemberpostMembers)

A list of resources to which the policy may be applied.

Responses

Request samples

Payload

Content type

application/json

{"members": [{"member": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"enabled": true,
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"time_remaining": 0
}
]
}

Delete snapshot policies

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	Array of strings 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	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List snapshot policy rules

Displays a list of snapshot policy rules.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"at": 0,
"client_name": "string",
"destroyed": true,
"every": 0,
"keep_for": 0,
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"suffix": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create snapshot policy rules

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_policyrulesnapshotpostRules)

A list of snapshot policy rules to create.

Responses

Request samples

Payload

Content type

application/json

{"rules": [{"at": 0,
"client_name": "string",
"every": 0,
"keep_for": 0,
"suffix": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"at": 0,
"client_name": "string",
"destroyed": true,
"every": 0,
"keep_for": 0,
"name": "string",
"policy": {"id": "string",
"name": "string",
"resource_type": "string"
},
"suffix": "string",
"time_remaining": 0
}
]
}

Delete snapshot policy rules

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
policy_ids	Array of strings Performs the operation on the unique policy IDs specified. Enter multiple policy IDs in comma-separated format. The `policy_ids` or `policy_names` parameter is required, but they cannot be set together.
policy_names	Array of strings Performs the operation on the policy names specified. Enter multiple policy names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Ports

The ports on a FlashArray are assigned iSCSI Qualified Names (IQNs), NVMe Qualified Names (NQNs), and Fibre Channel World Wide Names (WWNs).

List ports

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"name": "string",
"iqn": "iqn.2010-06.com.purestorage:flasharray.393d930077be2977",
"nqn": "nqn.2010-06.com.purestorage:flasharray.512f7bb185978505",
"portal": "10.16.200.27:3260",
"wwn": "52:4A:93:70:4E:E5:68:00",
"failover": "CT0.ETH2",
"context": {"id": "string",
"name": "string"
}
}
]
}

List port initiators

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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"context": {"id": "string",
"name": "string"
},
"initiator": {"iqn": "iqn.2010-06.com.purestorage:flasharray.393d930077be2977",
"nqn": "nqn.2010-06.com.purestorage:flasharray.512f7bb185978505",
"portal": "10.16.200.27:3260",
"wwn": "52:4A:93:70:4E:E5:68:00"
},
"target": {"name": "string",
"iqn": "iqn.2010-06.com.purestorage:flasharray.393d930077be2977",
"nqn": "nqn.2010-06.com.purestorage:flasharray.512f7bb185978505",
"portal": "10.16.200.27:3260",
"wwn": "52:4A:93:70:4E:E5:68:00",
"failover": "CT0.ETH2"
}
}
]
}

Protection Groups

A protection group defines a set of volumes, hosts, or host groups (called members) that are protected together through snapshots with point-in-time consistency across the member volumes. The members within the protection group have common data protection requirements and the same snapshot, replication, and retention schedules.

List protection groups

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"host_count": 3,
"host_group_count": 3,
"is_local": true,
"pod": {"id": "string",
"name": "string"
},
"replication_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000,
"blackout": {"end": 46800000,
"start": 3600000
}
},
"retention_lock": "unlocked",
"snapshot_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000
},
"source": {"id": "string",
"name": "string"
},
"source_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"target_count": 3,
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0,
"volume_count": 3
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"host_count": 3,
"host_group_count": 3,
"is_local": true,
"pod": {"id": "string",
"name": "string"
},
"replication_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000,
"blackout": {"end": 46800000,
"start": 3600000
}
},
"retention_lock": "unlocked",
"snapshot_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000
},
"source": {"id": "string",
"name": "string"
},
"source_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"target_count": 3,
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0,
"volume_count": 3
}
]
}

Create a protection group and upsert tags

Creates a protection group on the local array for asynchronous replication.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
source_ids	Array of strings The id of the protection group or protection group snapshot to be copied into a new or existing protection group. If the destination protection group and all of its volumes already exist, include the `overwrite` parameter to overwrite all of the existing volumes with the snapshot contents. If including the `overwrite` parameter, the names of the volumes that are being overwritten must match the names of the volumes that are being restored. If the source is a protection group, the latest snapshot of the protection group will be used as the source during the copy operation.
source_names	Array of strings The name of the protection group or protection group snapshot to be copied into a new or existing protection group. If the destination protection group and all of its volumes already exist, include the `overwrite` parameter to overwrite all of the existing volumes with the snapshot contents. If including the `overwrite` parameter, the names of the volumes that are being overwritten must match the names of the volumes that are being restored. If the source is a protection group, the latest snapshot of the protection group will be used as the source during the copy operation.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (Tag)

The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"host_count": 3,
"host_group_count": 3,
"is_local": true,
"pod": {"id": "string",
"name": "string"
},
"replication_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000,
"blackout": {"end": 46800000,
"start": 3600000
}
},
"retention_lock": "unlocked",
"snapshot_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000
},
"source": {"id": "string",
"name": "string"
},
"source_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"target_count": 3,
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0,
"volume_count": 3
}
]
}

Delete a protection group

Deletes 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 names parameter is required.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a protection group

Modifies the protection group schedules to generate and replicate snapshots to another array or to an external storage system. Renames or destroys a protection group.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (WorkloadConfigurationFixedReferenceWorkload) A reference to the workload that is managing this resource. The `name` parameter might show as an empty string briefly after controller failover.
destroyed	boolean Has this protection group been destroyed? To destroy a protection group, patch to `true`. To recover a destroyed protection group, patch to `false`. If not specified, defaults to `false`.
	object (ProtectionGroupEradicationConfig) The configuration of the eradication feature.
	object (FixedReference) The pod in which the protection group resides.
	object (ReplicationSchedule) The schedule settings for asynchronous replication.
retention_lock	string The valid values are `ratcheted` and `unlocked`. The default value for a newly created protection group is `unlocked`. Set `retention_lock` to `ratcheted` to enable SafeMode restrictions on the protection group. Contact Pure Technical Services to change `retention_lock` to `unlocked`.
	object (SnapshotSchedule) The schedule settings for protection group snapshots.
	object (FixedReference) The array or pod on which the protection group was created.
	object (RetentionPolicy) The retention policy for the source array of the protection group.
	object (Space) Displays provisioned size and physical storage consumption data for each protection group.
	object (RetentionPolicy) The retention policy for the target(s) of the protection group.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"workload": { },
"destroyed": true,
"eradication_config": { },
"pod": { },
"replication_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000,
"blackout": {"end": 46800000,
"start": 3600000
}
},
"retention_lock": "unlocked",
"snapshot_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000
},
"source": { },
"source_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"space": { },
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
}
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"host_count": 3,
"host_group_count": 3,
"is_local": true,
"pod": {"id": "string",
"name": "string"
},
"replication_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000,
"blackout": {"end": 46800000,
"start": 3600000
}
},
"retention_lock": "unlocked",
"snapshot_schedule": {"at": 7200,
"enabled": false,
"frequency": 259200000
},
"source": {"id": "string",
"name": "string"
},
"source_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"target_count": 3,
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0,
"volume_count": 3
}
]
}

List protection groups with host members

Displays a list of protection groups that have host members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create an action to add a host to a protection group

Creates an action to add a host member to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a host from a protection group

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 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List protection groups with host group members

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Creates an action to add a host group to a protection group

Creates an action to add a host group member to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"name": "string"
}
}
]
}

Delete a host group from a protection group

Deletes a host group member from a protection group. After the member has been removed, it is no longer protected by the group. Protection group snapshots 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List protection group replication performance data

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"bytes_per_sec": 0,
"context": {"id": "string",
"name": "string"
},
"time": 0
}
]
}

List protection group replication performance data with array details

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"bytes_per_sec": 0,
"context": {"id": "string",
"name": "string"
},
"source": "string",
"target": "string",
"time": 0
}
]
}

List protection group space information

Displays provisioned size and physical storage consumption data for each protection group.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags for all specified objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if one already exists, updated.

Array ()

copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (Reference) A reference to the parent object.
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

List protection groups with targets

Displays a list of protection groups that have target arrays, pods, or offload targets.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"allowed": true,
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"status": "suspended"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create an action to add a target to a protection group

Creates an action to add an array, pod, or offload target to a protection group. The group_names parameter represents the name of the protection group. The member_names parameter represents the name of the array, pod, or offload target that is being added to the protection group. The group_names and member_names parameters are required and must be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"allowed": true,
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"status": "suspended"
}
]
}

Delete a target from a protection group

Deletes an array, pod, 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, pod, 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a protection group target

Modifies the source array to replicate protection group data to the target, or disallows the source array from replicating protection group data to the target. The allowed parameter must be set from the target array. The group_names parameter represents the name of the protection group. The allowed and group_names parameters are required and must be set together. Offload targets do not support the allowed parameter.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

allowed	boolean If set to `true`, the target array has allowed the source array to replicate protection group data to the target array. If set to `false`, the target array has not allowed the source array to replicate protection group data to the target.
	object (_fixedReference)
	object (_fixedReferenceNoId)

Responses

Request samples

Payload

Content type

application/json

{"allowed": true,
"protection_group": { },
"target": { }
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"allowed": true,
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"resource_type": "string"
},
"status": "suspended"
}
]
}

List protection groups with volume members

Displays a list of protection groups that have volume members.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings Performs the operation on the unique group id specified. Provide multiple resource IDs in comma-separated format. The group_ids or names parameter is required, but they cannot be set together.
group_names	Array of strings 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`.
include_remote	boolean If set to `true` the response will include remote membership for protection groups that belong to the remote arrays as well as local volumes. Defaults to `false`.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_destroyed	boolean If true, returns only destroyed member objects. Returns an error if a name of a live member object is specified in the member_names query param. If false, returns only live member objects. Returns an error if a name of a destroyed member object is specified in the member_names query param.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"destroyed": true
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a volume to add it to a protection group

Creates a volume member and adds it to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. The group_names parameter represents the name of the protection group, and the member_names and member_ids parameters represent the names or IDs of the volume. The group_names parameter, and either the member_names or member_ids parameters are required and must be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"destroyed": true
}
}
]
}

Delete a volume from a protection group

Deletes a volume member from a protection group. After the member has been deleted, it is no longer protected by the group. Any protection group snapshots that were taken before the member was deleted are not affected. Deleting 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 and member_ids parameters represent the names or IDs of the volume. The group_names parameter, and either the member_names or member_ids parameters are required and must be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Protection Group Snapshots

Protection group snapshots capture the content of all volumes on the source array for the specified protection group at a single point in time.

List protection group snapshots

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"pod": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"pod": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": "string",
"time_remaining": 0
}
]
}

Create a protection group snapshot

Creates a point-in-time snapshot of the contents of a protection group. The source_ids or source_names parameter is required, but they cannot be set together.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
apply_retention	boolean If `true`, applies the local and remote retention policy to the snapshots.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
for_replication	boolean If `true`, destroys and eradicates the snapshot after 1 hour.
replicate	boolean If set to `true`, queues up and begins replicating to each allowed target after all earlier replication sessions for the same protection group have been completed to that target. The `replicate` and `replicate_now` parameters cannot be used together.
replicate_now	boolean If set to `true`, replicates the snapshots to each allowed target. The `replicate` and `replicate_now` parameters cannot be used together.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (ProtectionGroupEradicationConfig) The configuration of the eradication feature.
	object (FixedReference) The pod in which the protection group of the protection group snapshot resides.
	object (FixedReference) The original protection group from which this snapshot was taken. For a replicated protection group snapshot being viewed on the target side, the `source` is the replica protection group.
	object (Space) Displays provisioned size and physical storage consumption data for each protection group.
suffix	string The name suffix appended to the protection group name to make up the full protection group snapshot name in the form `PGROUP.SUFFIX`. If `suffix` is not specified, the protection group name is in the form `PGROUP.NNN`, where `NNN` is a unique monotonically increasing number. If multiple protection group snapshots are created at a time, the suffix name is appended to those snapshots.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"destroyed": true,
"eradication_config": { },
"pod": { },
"source": { },
"space": { },
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"pod": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": "string",
"time_remaining": 0
}
]
}

Delete a protection group snapshot

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 and cannot be recovered. Protection group snapshots are destroyed through the PATCH method. The names or ids parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a protection group snapshot

Modifies a protection group snapshot so that it can be destroyed. To destroy a volume, set destroyed=true. To recover a volume that has been destroyed and is pending eradication, set destroyed=false. The names or ids parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
destroyed	boolean Returns a value of `true` if the protection group snapshot has been destroyed and is pending eradication. The `time_remaining` value displays the amount of time left until the destroyed snapshot is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed snapshot can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the snapshot is permanently eradicated and can no longer be recovered.
	object (ProtectionGroupEradicationConfig) The configuration of the eradication feature.
	object (FixedReference) The pod in which the protection group of the protection group snapshot resides.
	object (FixedReference) The original protection group from which this snapshot was taken. For a replicated protection group snapshot being viewed on the target side, the `source` is the replica protection group.
	object (Space) Displays provisioned size and physical storage consumption data for each protection group.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"destroyed": true,
"eradication_config": { },
"pod": { },
"source": { },
"space": { },
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"id": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"pod": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": "string",
"time_remaining": 0
}
]
}

Create an action to send protection group snapshots

Creates an action to send protection group snapshots to protection pgroup targets. When the on option is used, only specified targets will recieve the protection group snapshots.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
convert_source_to_baseline	boolean Set to `true` to have the snapshot be eradicated when it is no longer baseline on source.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	Array of strings Performs the operation locally with the target names specified as the destinations of the operation. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"eradication_config": {"manual_eradication": "enabled"
},
"pod": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"suffix": "string",
"time_remaining": 0
}
]
}

List protection group snapshots with transfer statistics

Displays a list of protection group snapshots and corresponding transfer statistics.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
]
}

Create an attempt to take protection group snapshot

Creates an attempt to take the protection group snapshot, without actually taking it, to test if the snapshot can be successfully taken.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
apply_retention	boolean If `true`, applies the local and remote retention policy to the snapshots.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
for_replication	boolean If `true`, destroys and eradicates the snapshot after 1 hour.
replicate	boolean If set to `true`, queues up and begins replicating to each allowed target after all earlier replication sessions for the same protection group have been completed to that target. The `replicate` and `replicate_now` parameters cannot be used together.
replicate_now	boolean If set to `true`, replicates the snapshots to each allowed target. The `replicate` and `replicate_now` parameters cannot be used together.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (ProtectionGroupEradicationConfig) The configuration of the eradication feature.
	object (FixedReference) The pod in which the protection group of the protection group snapshot resides.
	object (FixedReference) The original protection group from which this snapshot was taken. For a replicated protection group snapshot being viewed on the target side, the `source` is the replica protection group.
	object (Space) Displays provisioned size and physical storage consumption data for each protection group.
suffix	string The name suffix appended to the protection group name to make up the full protection group snapshot name in the form `PGROUP.SUFFIX`. If `suffix` is not specified, the protection group name is in the form `PGROUP.NNN`, where `NNN` is a unique monotonically increasing number. If multiple protection group snapshots are created at a time, the suffix name is appended to those snapshots.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"context": { },
"destroyed": true,
"eradication_config": { },
"pod": { },
"source": { },
"space": { },
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"id": "string",
"name": "string"
}
}
]
}

Realms

A realm is an administrative domain, a data container, and a namespace for pods, hosts, and host groups.

List realms

Displays a list of realms.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 0,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
],
"total": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 0,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

Create realms

Creates realms on the local array. Each realm must be given a name that is unique across the connected arrays.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (ContainerQos) Sets QoS limits.
quota_limit	integer <int64> [ 1048576 .. 4503599627370496 ] The logical quota limit of the realm, measured in bytes. Must be a multiple of 512.
	Array of objects (NonCopyableTag) The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 1048576,
"tags": [{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 0,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

Delete realms

Deletes realms that have been destroyed and are pending eradication. Eradicated realms cannot be recovered. Realms are destroyed using the PATCH method.

query Parameters

eradicate_contents	boolean Set to `true` to eradicate contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups). This enables you to eradicate containers with contents.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify realms

Modifies realm details.

query Parameters

destroy_contents	boolean Set to `true` to destroy contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups), including eradicating containers with content.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
ignore_usage	boolean Set to `true` to set a `quota_limit` that is lower than the existing usage. This ensures that no new volumes can be created until the existing usage drops below the `quota_limit`. If not specified, defaults to `false`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name for the resource.
destroyed	boolean If set to `true`, the realm will be destroyed and pending eradication. The `time_remaining` value displays the amount of time left until the destroyed realm is permanently eradicated. A realm can only be destroyed if it is empty or destroy_contents is set to true. Before the `time_remaining` period has elapsed, the destroyed realm can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the realm is permanently eradicated and can no longer be recovered.
	object (ContainerQos) Sets QoS limits.
quota_limit	integer <int64> [ 1048576 .. 4503599627370496 ] The logical quota limit of the realm, measured in bytes.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"destroyed": true,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 1048576
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"eradication_config": {"manual_eradication": "all-enabled"
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"quota_limit": 0,
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0
}
]
}

List realm performance data

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"others_per_sec": 0,
"usec_per_other_op": 0
}
]
}

List realm space information

Displays provisioned size and storage consumption data for each realm on the local array.

query Parameters

destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates or creates tags for all specified objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if already existing, updated.

Array ()

key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Remote Arrays

Remote arrays provide the ability to list and manage all the remote arrays known to an array.

List remote arrays

Dispalys arrays in the current fleet, as well as arrays that the current array has existing replication connections to.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
current_fleet_only	boolean If current_fleet_only is specified, then results will only show arrays from the same fleet to which the current array is a member of.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"fleet": {"id": "string",
"name": "string",
"is_local": false
},
"is_local": false,
"model": "FA//X",
"os": "Purity//FA",
"version": "6.8.0"
}
]
}

Remote Pods

A remote pod represents a pod that is on a connected array but not stretched to this array.

List remote pods

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"arrays": [{"id": "string",
"name": "string"
}
]
}
]
}

Remote Protection Groups

A remote protection group represents a protection group that resides on an offload target with the source side of the remote protection group being another array that is connected to the local array. The local array can only see the remote protection groups of other arrays if the two arrays are connected.

List remote protection groups

Returns a list of remote protection groups.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"is_local": true,
"remote": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete a remote protection group

Deletes 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a remote protection group

Modifies the snapshot retention schedule of a remote protection group. Also destroys a remote protection group from the offload target. Before the remote protection group can be destroyed, the offload target must first be removed from the protection group via the source array. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
destroyed	boolean Returns a value of `true` if the remote protection group has been destroyed and is pending eradication. The `time_remaining` value displays the amount of time left until the destroyed remote protection group is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed remote protection group can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the remote protection group is permanently eradicated and can no longer be recovered.
	object (FixedReference) The offload target that the remote protection group is on.
	object (FixedReference) The array where the remote protection group is replicated from.
	object (RetentionPolicy) The retention policy for the remote protection group.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"destroyed": true,
"remote": { },
"source": { },
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"destroyed": true,
"is_local": true,
"remote": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"target_retention": {"all_for_sec": 86400,
"days": 7,
"per_day": 3
},
"time_remaining": 0
}
]
}

Remote Protection Group Snapshots

A remote protection group snapshot represents a protection group snapshot that resides on an offload target with the source side of the remote protection group snapshot being another array that is connected to the local array. The local array can only see the remote protection group snapshots of other arrays if the two arrays are connected.

List remote protection group snapshots

Displays a list of remote protection group snapshots.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"is_local": true,
"remote": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create remote protection group snapshot

Creates remote protection group snapshots.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
apply_retention	boolean If `true`, applies the local and remote retention policy to the snapshots.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
convert_source_to_baseline	boolean Set to `true` to have the snapshot be eradicated when it is no longer baseline on source.
for_replication	boolean If `true`, destroys and eradicates the snapshot after 1 hour.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
replicate	boolean If set to `true`, queues up and begins replicating to each allowed target after all earlier replication sessions for the same protection group have been completed to that target. The `replicate` and `replicate_now` parameters cannot be used together.
replicate_now	boolean If set to `true`, replicates the snapshots to each allowed target. The `replicate` and `replicate_now` parameters cannot be used together.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (FixedReference) The offload target where the remote protection group snapshot is located.
	object (FixedReference) The original protection group from which this snapshot was taken.
suffix	string The suffix that is appended to the `source_name` value to generate the full remote protection group snapshot name in the form `PGROUP.SUFFIX`. If the suffix is not specified, the system constructs the snapshot name in the form `PGROUP.NNN`, where `PGROUP` is the protection group name, and `NNN` is a monotonically increasing number.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"destroyed": true,
"remote": { },
"source": { },
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"is_local": true,
"remote": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0
}
]
}

Delete a remote protection group snapshot

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a remote protection group snapshot

Modifies a remote protection group snapshot, removing it from the offload target and destroying the snapshot. 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

If set to true, destroys a resource. Once set to true, the time_remaining value will display the amount of time left until the destroyed resource is permanently eradicated. Before the time_remaining period has elapsed, the destroyed resource can be recovered by setting destroyed=false. Once the time_remaining period has elapsed, the resource is permanently eradicated and can no longer be recovered.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 1503520993,
"destroyed": true,
"is_local": true,
"remote": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0
}
]
}

List remote protection groups with transfer statistics

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
},
"source": {"id": "string",
"name": "string"
}
}
]
}

Create an attempt to take remote protection group snapshot

Creates an attempt to take a remote protection group snapshot without actually taking it, to test if the snapshot can be successfully taken.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
apply_retention	boolean If `true`, applies the local and remote retention policy to the snapshots.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
convert_source_to_baseline	boolean Set to `true` to have the snapshot be eradicated when it is no longer baseline on source.
for_replication	boolean If `true`, destroys and eradicates the snapshot after 1 hour.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
replicate	boolean If set to `true`, queues up and begins replicating to each allowed target after all earlier replication sessions for the same protection group have been completed to that target. The `replicate` and `replicate_now` parameters cannot be used together.
replicate_now	boolean If set to `true`, replicates the snapshots to each allowed target. The `replicate` and `replicate_now` parameters cannot be used together.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (FixedReference) The offload target where the remote protection group snapshot is located.
	object (FixedReference) The original protection group from which this snapshot was taken.
suffix	string The suffix that is appended to the `source_name` value to generate the full remote protection group snapshot name in the form `PGROUP.SUFFIX`. If the suffix is not specified, the system constructs the snapshot name in the form `PGROUP.NNN`, where `PGROUP` is the protection group name, and `NNN` is a monotonically increasing number.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"destroyed": true,
"remote": { },
"source": { },
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"id": "string",
"name": "string"
}
}
]
}

Remote Volume Snapshots

A remote volume snapshot represents a volume snapshot that resides on an offload target with the source side of the remote volume snapshot being another array that is connected to the local array. The local array can only see the remote volume snapshots of other arrays if the two arrays are connected.

List remote volume snapshots

Displays a list of remote volume snapshots.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"remote": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a volume snapshot on a connected remote target or offload target

Creates a volume snapshot on the specified connected remote target or offload target.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

suffix

string

The suffix that is appended to the source_name value to generate the full volume snapshot name in the form VOL.SUFFIX. If the suffix is not specified, the system constructs the snapshot name in the form VOL.NNN, where VOL is the volume name, and NNN is a monotonically increasing number.

Responses

Request samples

Payload

Content type

application/json

{"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"remote": {"id": "string",
"name": "string"
}
}
]
}

Delete a remote volume snapshot

Deletes 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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
replication_snapshot	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a remote volume snapshot

Modifies a remote volume snapshot by destroying or recovering it from the offload target. The on parameter represents the name of the offload target. The names parameter and the on parameter are required and must be used together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
replication_snapshot	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"remote": {"id": "string",
"name": "string"
}
}
]
}

List remote volume snapshots with transfer statistics

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
on	Array of strings Performs the operation on the target name specified. Enter multiple target names in comma-separated format. For example, `targetName01,targetName02`.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
]
}

SAML2 SSO

SAML2 SSO allows customers to configure settings of SAML2 service provider and identity provider. It provides a multi-factor authentication (MFA) mechanism for customers to log in to FlashArray.

List SAML2 SSO configurations

Displays the SAML2 SSO service provider and identity provider configuration settings in the array.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"array_url": "https://myarray.mycompany.com",
"enabled": true,
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
},
"assertion_consumer_url": "https://myarray.mycompany.com/login/saml2/sso/myidp",
"entity_id": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp",
"metadata_url": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp"
}
}
]
}

Create SAML2 SSO configurations

Creates SAML2 SSO configurations.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

array_url	string The URL of the array.
	object (_saml2SsoIdp) Properties specific to the identity provider.
	object (Saml2SsoSpCredential) Properties specific to the service provider.

Responses

Request samples

Payload

Content type

application/json

{"array_url": "https://myarray.mycompany.com",
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
}
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"array_url": "https://myarray.mycompany.com",
"enabled": true,
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
},
"assertion_consumer_url": "https://myarray.mycompany.com/login/saml2/sso/myidp",
"entity_id": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp",
"metadata_url": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp"
}
}
]
}

Delete SAML2 SSO configurations

Deletes SAML2 SSO configurations.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify SAML2 SSO configurations

Modifies one or more attributes of SAML2 SSO configurations.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

array_url	string The URL of the array.
	object (_saml2SsoIdp) Properties specific to the identity provider.
	object (Saml2SsoSpCredential) Properties specific to the service provider.
enabled	boolean If set to `true`, the SAML2 SSO configuration is enabled.

Responses

Request samples

Payload

Content type

application/json

{"array_url": "https://myarray.mycompany.com",
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
}
},
"enabled": true
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"array_url": "https://myarray.mycompany.com",
"enabled": true,
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
},
"assertion_consumer_url": "https://myarray.mycompany.com/login/saml2/sso/myidp",
"entity_id": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp",
"metadata_url": "https://myarray.mycompany.com/saml2/service-provider-metadata/myidp"
}
}
]
}

List existing SAML2 SSO configurations

Displays the existing SAML2 SSO configurations in the array.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Modify provided SAML2 SSO configurations

Modifies the provided SAML2 SSO configurations. If the configurations with the specified ids or names exist, the provided configurations will overwrite the existing configurations, but will not be persisted in the array.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

array_url	string The URL of the array.
	object (_saml2SsoIdp) Properties specific to the identity provider.
	object (Saml2SsoSpCredential) Properties specific to the service provider.

Responses

Request samples

Payload

Content type

application/json

{"array_url": "https://myarray.mycompany.com",
"idp": {"encrypt_assertion_enabled": true,
"entity_id": "http://myidp.mycompany.com/adfs/services/trust",
"metadata_url": "https://myidp.mycompany.com/federationmetadata/2007-06/federationmetadata.xml",
"sign_request_enabled": true,
"url": "https://myidp.mycompany.com/adfs/ls",
"verification_certificate": "string"
},
"sp": {"decryption_credential": {"name": "string"
},
"signing_credential": {"name": "string"
}
}
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Sessions

Manages Purity//FA login and user session data.

List session data

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"end_time": 1502234638,
"event": "user session",
"event_count": 3,
"location": "10.202.101.11",
"method": "public key",
"start_time": 1502234212,
"user": "pureuser",
"user_interface": "CLI"
}
]
}

SMI-S

Manages the Pure Storage Storage Management Initiative Specification (SMI-S).

List SMI-S settings

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

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"slp_enabled": true,
"wbem_https_enabled": true
}
]
}

Modify SLP and SMI-S

Modifies the Service Location Protocol (SLP) and the SMI-S provider, enabling or disabling them.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

slp_enabled	boolean If set to `true`, the Service Location Protocol (SLP) and its ports, TCP 427 and UDP 427, are enabled.
wbem_https_enabled	boolean If set to `true`, the SMI-S provider and its port, TCP 5989 is enabled.

Responses

Request samples

Payload

Content type

application/json

{"slp_enabled": true,
"wbem_https_enabled": true
}

Response samples

Content type

application/json

{"items": [{"slp_enabled": true,
"wbem_https_enabled": true
}
]
}

SMTP

Manages connections to Simple Network Management Protocol (SMTP) managers.

List SMTP server attributes

Displays SMTP server attributes. Values include user_name, password, relay_host, sender_domain, sender_username, subject_prefix, body_prefix, encryption_mode, and name.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"body_prefix": "Classifaction is UNCLASSIFIED",
"encryption_mode": "starttls",
"password": "string",
"relay_host": "string",
"sender_domain": "string",
"sender_username": "string",
"subject_prefix": "DC:45 RM:23 RACK:12",
"user_name": "string"
}
]
}

Modify SMTP server attributes

Modifies SMTP server attributes. Values include user_name, password, relay_host, sender_domain, sender_username, subject_prefix, body_prefix, encryption_mode, and name.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

body_prefix	string <= 256 characters Optional string added to the beginning of the email body when sending alert email messages. HTML tags are not allowed.
encryption_mode	string Enforces an encryption mode when sending alert email messages. Valid values are `starttls`. Use "" to clear.
password	string Password for the relay host, if needed.
relay_host	string Relay server used as a forwarding point for email sent from the array. Can be set as a hostname, IPv4 address, or IPv6 address, with optional port numbers. The expected format for IPv4 is `ddd.ddd.ddd.ddd:PORT`. The expected format for IPv6 is `xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx` or, if a port number is specified, `[xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx]:PORT`.
sender_domain	string Domain name appended to alert email messages.
sender_username	string The local-part of the email address used when sending alert email messages.
subject_prefix	string <= 64 characters Optional string added to the beginning of the subject when sending alert email messages. HTML tags are not allowed.
user_name	string User name for the relay host, if needed.

Responses

Request samples

Payload

Content type

application/json

{"body_prefix": "Classifaction is UNCLASSIFIED",
"encryption_mode": "starttls",
"password": "string",
"relay_host": "string",
"sender_domain": "string",
"sender_username": "string",
"subject_prefix": "DC:45 RM:23 RACK:12",
"user_name": "string"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"body_prefix": "Classifaction is UNCLASSIFIED",
"encryption_mode": "starttls",
"password": "string",
"relay_host": "string",
"sender_domain": "string",
"sender_username": "string",
"subject_prefix": "DC:45 RM:23 RACK:12",
"user_name": "string"
}
]
}

SNMP Agents

Manages connections to Simple Network Management Protocol (SNMP) agents.

List SNMP agent

Displays the SNMP agent name and protocol attributes.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"engine_id": "80009e2205d7c0bd31fef5b87f4f44da",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "****",
"auth_protocol": "MD5",
"privacy_passphrase": "****",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}
]
}

Modify SNMP agent

Modifies the name or the protocol attributes of the SNMP agent.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_snmp_v2c) The v2c configurations of SNMP.
	object (_snmp_v3_patch) The v3 configurations of SNMP.
version	string Version of the SNMP protocol to be used by Purity//FA in communications with the specified manager. Valid values are `v2c` and `v3`.

Responses

Request samples

Payload

Content type

application/json

{"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "********",
"auth_protocol": "MD5",
"privacy_passphrase": "********",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"engine_id": "80009e2205d7c0bd31fef5b87f4f44da",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "****",
"auth_protocol": "MD5",
"privacy_passphrase": "****",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}
]
}

List SNMP agent MIB text

Displays the SNMP MIB text.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"mib": "string"
}
]
}

SNMP Managers

Manages connections to Simple Network Management Protocol (SNMP) managers.

List SNMP managers

Displays designated SNMP managers and their communication and security attributes.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"host": "snmp.purestorage.com",
"notification": "trap",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "****",
"auth_protocol": "MD5",
"privacy_passphrase": "****",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}
]
}

Create SNMP manager

Creates a Purity SNMP manager object that identifies a host (SNMP manager) and specifies the protocol attributes for communicating with it. Once a manager object is created, the transmission of SNMP traps is immediately enabled.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

host	string DNS hostname or IP address of a computer that hosts an SNMP manager to which Purity//FA is to send trap messages when it generates alerts.
notification	string The type of notification the agent will send. Valid values are `inform` and `trap`.
	object (_snmp_v2c) The v2c configurations of SNMP.
	object (_snmp_v3_post) The v3 configurations of SNMP.
version	string Version of the SNMP protocol to be used by Purity//FA to communicate with the specified manager. Valid values are `v2c` and `v3`.

Responses

Request samples

Payload

Content type

application/json

{"host": "snmp.purestorage.com",
"notification": "trap",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "********",
"auth_protocol": "MD5",
"privacy_passphrase": "********",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"host": "snmp.purestorage.com",
"notification": "trap",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "****",
"auth_protocol": "MD5",
"privacy_passphrase": "****",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}
]
}

Delete SNMP manager

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

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify SNMP manager

Modifies the name or the protocol attributes of the specified SNMP manager.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
host	string DNS hostname or IP address of a computer that hosts an SNMP manager to which Purity//FA is to send trap messages when it generates alerts.
notification	string The type of notification the agent will send. Valid values are `inform` and `trap`.
	object (_snmp_v2c) The v2c configurations of SNMP.
	object (_snmp_v3_patch) The v3 configurations of SNMP.
version	string Version of the SNMP protocol to be used by Purity//FA to communicate with the specified manager. Valid values are `v2c` and `v3`.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"host": "snmp.purestorage.com",
"notification": "trap",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "********",
"auth_protocol": "MD5",
"privacy_passphrase": "********",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"host": "snmp.purestorage.com",
"notification": "trap",
"v2c": {"community": "****"
},
"v3": {"auth_passphrase": "****",
"auth_protocol": "MD5",
"privacy_passphrase": "****",
"privacy_protocol": "DES",
"user": "User1"
},
"version": "v3"
}
]
}

List SNMP manager test results

Displays SNMP manager test results (traps or informs).

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Software

Software to be installed on the array.

List software packages

Displays a list of available software packages.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	Array of strings A comma-separated list of versions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"details": "string",
"payload_id": "4f7b319106401d072ff94808535cb3ce",
"progress": 0,
"status": "Available",
"upgrade_hops": ["5.0.0",
"5.1.6",
"5.2.3"
],
"upgrade_plan": [{"description": "string",
"hop_version": "99.9.9",
"step_name": "Pre-upgrade check"
}
],
"version": "5.2.3"
}
]
}

Create a software package

Creates a software package download.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The name of the software.
version	string The version of the software.

Responses

Request samples

Payload

Content type

application/json

{"name": "Purity//FA",
"version": "5.2.3"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"details": "string",
"payload_id": "4f7b319106401d072ff94808535cb3ce",
"progress": 0,
"status": "Available",
"upgrade_hops": ["5.0.0",
"5.1.6",
"5.2.3"
],
"upgrade_plan": [{"description": "string",
"hop_version": "99.9.9",
"step_name": "Pre-upgrade check"
}
],
"version": "5.2.3"
}
]
}

Delete a software package

Deletes a software package specified by software name and version. A software package being used for an installation can be deleted if the installation is downloading, downloaded, aborted, or finished. If the software package is currently downloading, the download will be cancelled.

query Parameters

names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
software_versions	Array of strings A comma-separated list of target software versions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List software-bundle

Displays a list of software bundles.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

X-Request-ID

string

Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"created": 0,
"details": "string",
"download_progress": 0,
"source": "ftp://local/upgrade_bundle.sh",
"status": "downloading"
}
]
}

Create software-bundle

Creates and initiates a software bundle download.

header Parameters

X-Request-ID

string

Supplied by client during request or generated by server.

Request Body schema: application/json

source

string

The source of the software bundle. Accepts HTTP, HTTPS or FTP, and paths.

Responses

Request samples

Payload

Content type

application/json

{"source": "ftp://local/upgrade_bundle.sh"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"created": 0,
"details": "string",
"download_progress": 0,
"source": "ftp://local/upgrade_bundle.sh",
"status": "downloading"
}
]
}

List software check tasks

Displays a list of software check tasks.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
software_names	Array of strings A comma-separated list of software names.
software_versions	Array of strings A comma-separated list of target software versions.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"checks": [{"details": "string",
"name": "HostIOCheck",
"status": "string"
}
],
"details": "string",
"software_name": "string",
"software_upgrade_hops": ["6.1.3",
"6.2.0"
],
"software_version": "6.2.0",
"status": "running"
}
]
}

Create a software check task

Creates a software check task. If there are no previously queued or running software check tasks, the new task immediately starts. Otherwise, it is queued and starts once all previously queued or running software check tasks finish. To create a task, use a software name and version.

query Parameters

software_names	Array of strings A comma-separated list of software names.
software_versions	Array of strings A comma-separated list of target software versions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"checks": [{"details": "string",
"name": "HostIOCheck",
"status": "string"
}
],
"details": "string",
"software_name": "string",
"software_upgrade_hops": ["6.1.3",
"6.2.0"
],
"software_version": "6.2.0",
"status": "running"
}
]
}

Delete a software check task

Deletes a software check task specified by software name and version. The check task must be queued. If the check task is running or passed/failed then the task cannot be deleted.

query Parameters

software_names	Array of strings A comma-separated list of software names.
software_versions	Array of strings A comma-separated list of target software versions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List software upgrades

Displays a list of software upgrades, including currently running and past upgrades.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
software_ids	Array of strings A comma-separated list of software IDs.
software_names	Array of strings A comma-separated list of software names.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"current_step_id": "string",
"details": "string",
"mode": "interactive",
"override_checks": [{"args": "host1,host2,host3",
"name": "HostIOCheck",
"persistent": true
}
],
"software": {"id": "string",
"name": "string"
},
"status": "Installing",
"upgrade_parameters": [{"name": "string",
"value": "string"
}
]
}
]
}

Create a software upgrade

Creates and initiates a software upgrade.

query Parameters

software_ids

required

Array of strings

A comma-separated list of software IDs.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

mode	string Mode that the upgrade is in. Valid values are `check-only`, `interactive`, `semi-interactive`, and `one-click`. The `check_only` mode is deprecated. Use `/software-checks`. In this mode, the upgrade only runs pre-upgrade checks and returns. In `interactive` mode, the upgrade pauses at several points, at which users must enter certain commands to proceed. In `semi-interactive` mode, the upgrade pauses if there are any upgrade check failures and functions like `one-click` mode otherwise. In `one-click` mode, the upgrade proceeds automatically without pausing.
	Array of objects (_override_check) A list of upgrade checks whose failures are overridden during the upgrade. If any optional `args` are provided, they are validated later when the corresponding check script runs.
	Array of objects (_upgrade_parameters) A list of parameters to be sent to the upgrade process. These parameters can be used to change the behavior of the upgrade process in specific ways such as enabling or disabling features in the target version or changing the attributes of the appliance at upgrade time. When there is a need or option to set an upgrade parameter, Pure Storage will provide documentation for the specific parameter. If you have been provided documentation related to a specific upgrade parameter, follow the instructions in the documentation. Otherwise, do not set any upgrade parameters.

Responses

Request samples

Payload

Content type

application/json

{"mode": "interactive",
"override_checks": [{"args": "host1,host2,host3",
"name": "HostIOCheck",
"persistent": true
}
],
"upgrade_parameters": [{"name": "string",
"value": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"current_step_id": "string",
"details": "string",
"mode": "interactive",
"override_checks": [{"args": "host1,host2,host3",
"name": "HostIOCheck",
"persistent": true
}
],
"software": {"id": "string",
"name": "string"
},
"status": "Installing",
"upgrade_parameters": [{"name": "string",
"value": "string"
}
]
}
]
}

Modify software upgrade

Modifies a software upgrade by continuing, retrying, or aborting it. All override_checks are updated before the command is issued if add_override_checks is present. The override_checks parameter is valid when command is set to continue or retry.

query Parameters

command required	string A user command that interacts with the upgrade. Commands may only be issued when the upgrade is paused. Valid values are `continue`, `retry`, and `abort`. The `continue` command continues a `paused` upgrade. The `retry` command retries the previous step. The `abort` command aborts the upgrade.
current_step_id required	string The current step `id` of the installation.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_override_check)

Adds the specified checks to the current list of override checks.

Responses

Request samples

Payload

Content type

application/json

{"add_override_checks": [{"args": "host1,host2,host3",
"name": "HostIOCheck",
"persistent": true
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"current_step_id": "string",
"details": "string",
"mode": "interactive",
"override_checks": [{"args": "host1,host2,host3",
"name": "HostIOCheck",
"persistent": true
}
],
"software": {"id": "string",
"name": "string"
},
"status": "Installing",
"upgrade_parameters": [{"name": "string",
"value": "string"
}
]
}
]
}

List software upgrade steps

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
software_installation_ids	Array of strings A comma-separated list of software installation IDs.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"end_time": 1567026888000,
"start_time": 1567026779000,
"checks": [{"details": "string",
"name": "HostIOCheck",
"overridable": true,
"status": "string"
}
],
"description": "string",
"details": "string",
"hop_version": "99.9.9",
"installation": {"id": "string",
"name": "string"
},
"status": "string"
}
]
}

List software patches

Displays a list of software patches.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"alert_code": 5200,
"description": "string",
"details": "string",
"ha_reduction_required": false,
"progress": 0,
"status": "installed"
}
]
}

Create a software patch

Creates software patch download and installation.

query Parameters

allow_ha_reduction	boolean If Software Patch has ha_reduction_required set to true, `allow_ha_reduction` must be set to `true` for Software Patch installation.
name required	string Name of software patch to install

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"alert_code": 5200,
"description": "string",
"details": "string",
"ha_reduction_required": false,
"progress": 0,
"status": "installed"
}
]
}

List available software patches

Displays a list of available software patches.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"alert_code": 5200,
"description": "string",
"details": "string",
"ha_reduction_required": false,
"progress": 0,
"status": "installed"
}
]
}

List software versions

Displays a list of software versions.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"details": "string",
"name": "Purity//FA",
"release_family": "6.2.0",
"upgrade_hops": ["6.1.3",
"6.2.0"
],
"version": "6.2.0"
}
]
}

Subnets

Manages the subnets and VLANs used to organize the network interfaces.

List subnets

Displays a list of subnets with statuses and attributes.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"enabled": true,
"gateway": "string",
"mtu": 1280,
"prefix": "string",
"vlan": 0,
"interfaces": [{"name": "string"
}
],
"services": ["string"
]
}
]
}

Create subnet

Creates a subnet with the specified parameters.

query Parameters

names

required

Array of strings

Performs the operation on the unique name specified. For example, name01. Enter multiple names in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

enabled	boolean Returns a value of `true` if subnet is enabled. Returns a value of `false` if subnet is disabled. If not specified, defaults to `true`.
gateway	string The IPv4 or IPv6 address of the gateway through which the specified subnet is to communicate with the network.
mtu	integer <int32> [ 1280 .. 9216 ] Maximum message transfer unit (packet) size for the subnet in bytes. MTU setting cannot exceed the MTU of the corresponding physical interface. If not specified, defaults to `1500`.
prefix	string The IPv4 or IPv6 address to be associated with the specified subnet.
vlan	integer <int32> VLAN ID number.

Responses

Request samples

Payload

Content type

application/json

{"enabled": true,
"gateway": "string",
"mtu": 1280,
"prefix": "string",
"vlan": 0
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true,
"gateway": "string",
"mtu": 1280,
"prefix": "string",
"vlan": 0,
"interfaces": [{"name": "string"
}
],
"services": ["string"
]
}
]
}

Delete subnet

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

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify subnet

Modifies one or more specified subnet properties.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
enabled	boolean Returns a value of `true` if subnet is enabled. Returns a value of `false` if subnet is disabled. If not specified, defaults to `true`.
gateway	string The IPv4 or IPv6 address of the gateway through which the specified subnet is to communicate with the network.
mtu	integer <int32> [ 1280 .. 9216 ] Maximum message transfer unit (packet) size for the subnet in bytes. MTU setting cannot exceed the MTU of the corresponding physical interface. If not specified, defaults to `1500`.
prefix	string The IPv4 or IPv6 address to be associated with the specified subnet.
vlan	integer <int32> VLAN ID number.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"enabled": true,
"gateway": "string",
"mtu": 1280,
"prefix": "string",
"vlan": 0
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"enabled": true,
"gateway": "string",
"mtu": 1280,
"prefix": "string",
"vlan": 0,
"interfaces": [{"name": "string"
}
],
"services": ["string"
]
}
]
}

Subscriptions

Provides information about subscription offerings.

List subscriptions

Displays information about subscriptions.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"service": "Evergreen//One"
}
]
}

Subscription Assets

Provides information about subscription assets.

List subscription assets

Displays information about subscription assets.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"subscription": {"id": "string"
}
}
]
}

Support

Enables Support to fix bugs and help customers solve problems. Support tools include proxy, phonehome, and remote assist.

List connection paths

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

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"phonehome_enabled": true,
"proxy": "http://proxy.example.com:8080",
"remote_assist_active": true,
"remote_assist_duration": 86400000,
"remote_assist_expires": 1574633337678,
"remote_assist_opened": 1574460534674,
"remote_assist_paths": [{"component_name": "CT0",
"status": "connected"
}
],
"remote_assist_status": "connected"
}
]
}

Create connection path

Creates a connection path from the array to another array.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

phonehome_enabled	boolean The status of phonehome. If set to `true`, enable phonehome. If set to `false`, disable phonehome.
proxy	string The value of the current proxy, which is used for connecting to cloud services such as phonehome, remote assist, etc. Specify the server name, including the scheme and proxy port number.
remote_assist_active	boolean The status of a remote assist session. If set to `true`, enable the remote assist session. If set to `false`, disable the remote assist session.
remote_assist_duration	integer <int64> Specifies the duration of the remote assist session in milliseconds. This parameter should only be provided when establishing a new session. This parameter determines the length of time the session will remain active after it is initiated.

Responses

Request samples

Payload

Content type

application/json

{"phonehome_enabled": true,
"proxy": "http://proxy.example.com:8080",
"remote_assist_active": true,
"remote_assist_duration": 86400000
}

Response samples

Content type

application/json

{"items": [{"phonehome_enabled": true,
"proxy": "http://proxy.example.com:8080",
"remote_assist_active": true,
"remote_assist_duration": 86400000,
"remote_assist_expires": 1574633337678,
"remote_assist_opened": 1574460534674,
"remote_assist_paths": [{"component_name": "CT0",
"status": "connected"
}
],
"remote_assist_status": "connected"
}
]
}

List remote assist session

Displays settings for remote assist sessions.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"access_level": "string",
"active": true,
"duration": 86400000,
"expires": 1574633337678,
"opened": 1574460534674,
"paths": [{"component_name": "CT0",
"status": "connected"
}
],
"status": "connected"
}
]
}

Modify remote assist session

Modifies settings for remote assist sessions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

access_level_override	string Overrides the default access level for the remote assist session only. Values include `restricted` and `elevated`. If not provided, the remote assist session will use the default_access_level setting.
active	boolean The status of a remote assist session. If set to `true`, enables the remote assist session. If set to `false`, disables the remote assist session.
duration	integer <int64> Specifies the duration of the remote assist session in milliseconds. This parameter should only be provided when establishing a new session. This parameter determines the length of time the session will remain active after initiation. Defaults to 86400000 (24h) with a min of 14400000 (4h) and a max of 172800000 (48h).

Responses

Request samples

Payload

Content type

application/json

{"access_level_override": "string",
"active": true,
"duration": 86400000
}

Response samples

Content type

application/json

{"items": [{"access_level": "string",
"active": true,
"duration": 86400000,
"expires": 1574633337678,
"opened": 1574460534674,
"paths": [{"component_name": "CT0",
"status": "connected"
}
],
"status": "connected"
}
]
}

List remote assist session global settings

Displays global settings for remote assist sessions.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"default_access_level": "string"
}
]
}

Update remote assist session global settings

Updates global settings for remote assist sessions.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

default_access_level

string

The default access level that support will have when connecting to the array. Values include restricted and elevated.

Responses

Request samples

Payload

Content type

application/json

{"default_access_level": "string"
}

Response samples

Content type

application/json

{"items": [{"default_access_level": "string"
}
]
}

List Pure Storage Support connection data

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.

query Parameters

filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
test_type	string Specifies the type of test. Valid values are `all`, `phonehome`, and `remote-assist`. If not specified, defaults to `all`.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome"
}
]
}

List diagnostics details

Displays the diagnostics tests details.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"result_details": "enabled",
"severity": "string",
"test_name": "string",
"test_type": "generic"
}
]
}

List diagnostics tools version and last updated date

Displays diagnostics tools version and last updated date.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"last_updated": 1672531200000,
"version": "1.0.0"
}
]
}

Update diagnostics tools

Update diagnostics tools from downloaded bundle.

query Parameters

purity_default

boolean

Set diagnostics tool to default version.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"last_updated": 1672531200000,
"version": "1.0.0"
}
]
}

Syslog

Copied to Log Targets/Syslog for more organized way to handle all log targets. Both endpoints are identical. We encourage our users to use Log Targets/Syslog.

List syslog servers

Displays a list of configured syslog servers.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create syslog server

Creates a new syslog server.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
services	Array of strings Valid values are `data-audit` and `management`. If not specified, defaults to `management`.
uri	string The URI of the syslog server in the format `PROTOCOL://HOSTNAME:PORT`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
]
}

Delete syslog server

Deletes a configured syslog server and stops forwarding syslog messages.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify syslog server

Modifies the URI and services of a configured syslog server.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
services	Array of strings Valid values are `data-audit` and `management`. If not specified, defaults to `management`.
uri	string The URI of the syslog server in the format `PROTOCOL://HOSTNAME:PORT`.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}

Response samples

Content type

application/json

{"items": [{"name": "string",
"context": {"id": "string",
"name": "string"
},
"target_type": "syslog",
"services": ["string"
],
"uri": "tcp://my.syslogserver.com"
}
]
}

List syslog settings

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Modify syslog settings

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

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ca_certificate	string The certificate of the certificate authority (CA) that signed the directory servers' certificate(s), which is used to validate the authenticity of the configured servers.
logging_severity	string Returns the configured logging severity threshold for which events will be forwarded to the configured syslog servers. Default configuration is info level severity. Valid values are `debug`, `info`, and `notice`.
tls_audit_enabled	boolean Returns a value of `true` if messages that are necessary in order to audit TLS negotiations performed by the array are forwarded to the configured syslog servers.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"ca_certificate": "string",
"logging_severity": "string",
"tls_audit_enabled": true
}
]
}

List syslog server test results

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Vchost Connections

A vchost connection is between a protocol endpoint and vchost. In the context of vchost-connection, the vchost represents a vCenter, and the protocol endpoint is used to represent a storage container. Creating a vchost connection gives the vCenter access to the storage container. If all_vchosts is set to true, the container will be accessible to all vchosts.

List the vchost-connections between protocol endpoint and vchost.

Displays a list of vchost-connections between the protocol endpoint and vchost.

query Parameters

all_vchosts	boolean Default: false If set to `true`, the storage container represented by the protocol endpoint is accessible to all vchosts. Users should not specify `vchost_ids` or `vchost_names` in the request. If set to `false`, the storage container represented by the protocol endpoint is only accessible to the vchosts that have explicit vchost-connections with the protocol endpoint. Users need to specify `vchost_ids` or `vchost_names` in the request.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
protocol_endpoint_ids	Array of strings A comma-separated list of protocol endpoint IDs. Performs the operation on the protocol endpoints specified. For example, `peid01,peid02`. Cannot be used in conjunction with `protocol_endpoint_names`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
protocol_endpoint_names	Array of strings A comma-separated list of protocol endpoint names. Performs the operation on the protocol endpoints specified. For example, `pe01,pe02`. Cannot be used in conjunction with `protocol_endpoint_ids`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vchost_ids	Array of strings A comma-separated list of vchost IDs. Performs the operation on the vchosts specified. For example, `vchostid01,vchostid02`. Cannot be used in conjunction with `vchost_names`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.
vchost_names	Array of strings A comma-separated list of vchost names. Performs the operation on the vchosts specified. For example, `vchost01,vchost02`. Cannot be used in conjunction with `vchost_ids`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"all_vchosts": false,
"protocol_endpoint": {"id": "string",
"name": "string"
},
"vchost": {"id": "string",
"name": "string"
}
}
]
}

Create a vchost-connection between protocol endpoint and vchost.

Creates a vchost-connection between protocol endpoint and vchost. Each vchost is associated with a vCenter. Each protocol endpoint is associated with a storage container. A vchost-connection makes the storage container accessible to the vCenter when the vCenter attempts to mount the container. One of protocol_endpoint_names or protocol_endpoint_ids query parameters and one of vchost_names or vchost_ids query parameters are required. But if all_vchosts is set to true, vchost_names and vchost_ids should not be specified.

query Parameters

all_vchosts	boolean Default: false If set to `true`, the storage container represented by the protocol endpoint is accessible to all vchosts. Users should not specify `vchost_ids` or `vchost_names` in the request. If set to `false`, the storage container represented by the protocol endpoint is only accessible to the vchosts that have explicit vchost-connections with the protocol endpoint. Users need to specify `vchost_ids` or `vchost_names` in the request.
allow_stretched_multi_vchost	boolean Default: false If set to `true`, users are allowed to create a new vchost-connection to a stretched container that already has a vchost-connection. In principle, a stretched container can only have one vchost-connection at a time.
protocol_endpoint_ids	Array of strings A comma-separated list of protocol endpoint IDs. Performs the operation on the protocol endpoints specified. For example, `peid01,peid02`. Cannot be used in conjunction with `protocol_endpoint_names`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
protocol_endpoint_names	Array of strings A comma-separated list of protocol endpoint names. Performs the operation on the protocol endpoints specified. For example, `pe01,pe02`. Cannot be used in conjunction with `protocol_endpoint_ids`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
vchost_ids	Array of strings A comma-separated list of vchost IDs. Performs the operation on the vchosts specified. For example, `vchostid01,vchostid02`. Cannot be used in conjunction with `vchost_names`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.
vchost_names	Array of strings A comma-separated list of vchost names. Performs the operation on the vchosts specified. For example, `vchost01,vchost02`. Cannot be used in conjunction with `vchost_ids`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"all_vchosts": false,
"protocol_endpoint": {"id": "string",
"name": "string"
},
"vchost": {"id": "string",
"name": "string"
}
}
]
}

Delete the vchost-connection between a protocol endpoint and its vchost

Deletes the vchost-connection between a protocol endpoint and its vchost. The storage container represented by the protocol endpoint will no longer be visible to the vCenter represented by the vchost. One of the protocol_endpoint_names or protocol_endpoint_ids query parameters, and one of the vchost_names or vchost_ids query parameters are required. But if all_vchosts is set to true, vchost_names and vchost_ids should not be specified.

query Parameters

all_vchosts	boolean Default: false If set to `true`, the storage container represented by the protocol endpoint is accessible to all vchosts. Users should not specify `vchost_ids` or `vchost_names` in the request. If set to `false`, the storage container represented by the protocol endpoint is only accessible to the vchosts that have explicit vchost-connections with the protocol endpoint. Users need to specify `vchost_ids` or `vchost_names` in the request.
protocol_endpoint_ids	Array of strings A comma-separated list of protocol endpoint IDs. Performs the operation on the protocol endpoints specified. For example, `peid01,peid02`. Cannot be used in conjunction with `protocol_endpoint_names`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
protocol_endpoint_names	Array of strings A comma-separated list of protocol endpoint names. Performs the operation on the protocol endpoints specified. For example, `pe01,pe02`. Cannot be used in conjunction with `protocol_endpoint_ids`. If the list contains more than one value, then `vchost_ids` or `vchost_names` must have exactly one value.
vchost_ids	Array of strings A comma-separated list of vchost IDs. Performs the operation on the vchosts specified. For example, `vchostid01,vchostid02`. Cannot be used in conjunction with `vchost_names`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.
vchost_names	Array of strings A comma-separated list of vchost names. Performs the operation on the vchosts specified. For example, `vchost01,vchost02`. Cannot be used in conjunction with `vchost_ids`. If the list contains more than one value, then `protocol_endpoint_ids` or `protocol_endpoint_names` must have exactly one value.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Volumes

A volume represents a container that manages the storage space on the array. After a volume has been created, host-volume connections must be established so that the host can read data from and write data to the volume. Volume data should be protected using asynchronous replication to a remote array, synchronous replication between remote arrays, and replication to external storage systems.

List volumes

Displays a list of volumes, including those pending eradication.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"connection_count": 0,
"created": 0,
"destroyed": true,
"host_encryption_key_status": "detected",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"pod": {"id": "string",
"name": "string"
},
"priority": 0,
"promotion_status": "string",
"protocol_endpoint": {"container_version": "1"
},
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"connection_count": 0,
"created": 0,
"destroyed": true,
"host_encryption_key_status": "detected",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"pod": {"id": "string",
"name": "string"
},
"priority": 0,
"promotion_status": "string",
"protocol_endpoint": {"container_version": "1"
},
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
}
}
]
}

Create or copy a volume and upsert tags

Creates one or more virtual storage volumes of the specified size. If provisioned is not specified, the size of the new volume defaults to 1 MB. The names query parameter is required. The add_to_protection_group_names query parameter specifies a list of protection group names that will compose the initial protection for the volume. The with_default_protection query parameter specifies whether to use the container default protection configuration for the volume. The add_to_protection_group_names and with_default_protection query parameters cannot be provided when overwrite is true.

query Parameters

add_to_protection_group_ids	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple ids in comma-separated format.
add_to_protection_group_names	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple names in a comma-separated format.
allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
with_default_protection	boolean If specified as `true`, the initial protection of the newly created volumes will be the union of the container default protection configuration and `add_to_protection_group_names`. If specified as `false`, the default protection of the container will not be applied automatically. The initial protection of the newly created volumes will be configured by `add_to_protection_group_names`. If not specified, defaults to `true`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
	object (PriorityAdjustment) Adjusts volume priority.
	object (ProtocolEndpoint) Sets the properties that are specific to protocol endpoints. This can only be used in conjunction to `subtype=protocol_endpoint`.
provisioned	integer <int64> <= 4503599627370496 Sets the virtual size of the volume, measured in bytes.
	object (Qos) Sets QoS limits.
	object (Reference) The source volume of a volume copy.
subtype	string The type of volume. Valid values are `protocol_endpoint` and `regular`.
	Array of objects (Tag) The list of tags to be upserted with the object.
	object (WorkloadConfigurationReference) The workload to which the volume is added. Set one of `id` or `name`, and `configuration` to add the volume to the workload and configure it based on the `configuration` from the preset the workload was originally provisioned from.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"protocol_endpoint": {"container_version": "1"
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
],
"workload": {"id": "string",
"name": "string",
"configuration": "string"
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"connection_count": 0,
"created": 0,
"destroyed": true,
"host_encryption_key_status": "detected",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"pod": {"id": "string",
"name": "string"
},
"priority": 0,
"promotion_status": "string",
"protocol_endpoint": {"container_version": "1"
},
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
}
}
]
}

Delete a volume

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.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a volume

Modifies a volume by renaming, destroying, or resizing it. To rename a volume, set name to the new name. To destroy a volume, set destroyed=true. To recover a volume that has been destroyed and is pending eradication, set destroyed=false. Set the bandwidth and IOPS limits of a volume through the respective bandwidth_limit and iops_limit parameter. This moves the volume into a pod or volume group through the respective pod or volume_group parameter. The ids or names parameter is required, but they cannot be set together.

query Parameters

add_to_protection_group_ids	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple ids in comma-separated format.
add_to_protection_group_names	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple names in a comma-separated format.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
remove_from_protection_group_ids	Array of strings The volumes will be removed from the specified protection groups in the source pod or array along with the move. This can only be used when moving volumes across pods and arrays and must include all protection groups that the volumes are members of before the move. Enter multiple ids in a comma-separated format.
remove_from_protection_group_names	Array of strings The volumes will be removed from the specified protection groups in the source pod or array along with the move. This can only be used when moving volumes across pods and arrays and must include all protection groups that the volumes are members of before the move. Enter multiple names in a comma-separated format.
truncate	boolean If set to `true`, reduces the size of a volume during a volume resize operation. When a volume is truncated, Purity automatically takes an undo snapshot, providing a 24-hour window during which the previous contents can be retrieved. After truncating a volume, its provisioned size can be subsequently increased, but the data in truncated sectors cannot be retrieved. If set to `false` or not set at all and the volume is being reduced in size, the volume copy operation fails. Required if the `provisioned` parameter is set to a volume size that is smaller than the original size.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
name	string The new name for the resource.
	object (Reference) Moves the volume into the specified pod.
	object (PriorityAdjustment) Adjusts volume priority.
	object (ProtocolEndpoint) Sets the properties that are specific to protocol endpoints. This can only be used in conjunction to `subtype=protocol_endpoint`.
provisioned	integer <int64> <= 4503599627370496 Updates the virtual size of the volume, measured in bytes.
	object (Qos) Sets QoS limits.
requested_promotion_state	string Valid values are `promoted` and `demoted`. Patch `requested_promotion_state` to `demoted` to demote the volume so that the volume stops accepting write requests. Patch `requested_promotion_state` to `promoted` to promote the volume so that the volume starts accepting write requests.
	object (Reference) Adds the volume to the specified volume group.
	object (ReferenceWithFixedType) Set the `id` or `name` of the workload to an empty string to remove the volume from the workload.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"name": "string",
"pod": {"id": "string",
"name": "string"
},
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"protocol_endpoint": {"container_version": "1"
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"requested_promotion_state": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string"
}
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"connection_count": 0,
"created": 0,
"destroyed": true,
"host_encryption_key_status": "detected",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"pod": {"id": "string",
"name": "string"
},
"priority": 0,
"promotion_status": "string",
"protocol_endpoint": {"container_version": "1"
},
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
}
}
]
}

Create or copy volumes and upsert tags

Creates or copies a list of virtual storage volumes. Volumes of different sizes, vgroups, and tag upsertions can be copied this way.

query Parameters

allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
with_default_protection	boolean If specified as `true`, the initial protection of the newly created volumes will be the union of the container default protection configuration and `add_to_protection_group_names`. If specified as `false`, the default protection of the container will not be applied automatically. The initial protection of the newly created volumes will be configured by `add_to_protection_group_names`. If not specified, defaults to `true`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of volumes to be created or copied.

Array ()

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
	object (PriorityAdjustment) Adjusts volume priority.
	object (ProtocolEndpoint) Sets the properties that are specific to protocol endpoints. This can only be used in conjunction to `subtype=protocol_endpoint`.
provisioned	integer <int64> <= 4503599627370496 Sets the virtual size of the volume, measured in bytes.
	object (Qos) Sets QoS limits.
	object (Reference) The source volume of a volume copy.
subtype	string The type of volume. Valid values are `protocol_endpoint` and `regular`.
	Array of objects (Tag) The list of tags to be upserted with the object.
	Array of objects (_reference) Specifies a list of protection groups that will compose the initial protection for the volume.
name	string Specifies the name of the volume.

Responses

Request samples

Payload

Content type

application/json

[{"destroyed": true,
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"protocol_endpoint": {"container_version": "1"
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
],
"add_to_protection_groups": [{"id": "string",
"name": "string"
}
],
"name": "string"
}
]

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"connection_count": 0,
"created": 0,
"destroyed": true,
"host_encryption_key_status": "detected",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"pod": {"id": "string",
"name": "string"
},
"priority": 0,
"promotion_status": "string",
"protocol_endpoint": {"container_version": "1"
},
"requested_promotion_state": "string",
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"volume_group": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
}
}
]
}

List volume diffs

Displays block differences for the specified volumes.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
base_id	string ID of the volume or volume snapshot that the diff comparison is based on. If a base volume or volume snapshot is not specified, all mapped blocks for the volume or volume snapshot are displayed. The `base_name` or `base_id` parameter is required, but they cannot be set together.
base_name	string Name of the volume or volume snapshot that the diff comparison is based on. If a base volume or volume snapshot is not specified, all mapped blocks for the volume or volume snapshot are displayed. The `base_name` or `base_id` parameter is required, but they cannot be set together.
block_size required	integer <int64> Granularity at which to compare, in bytes. Must be a multiple of 512.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
next_allocated_block_hint	boolean If set to `true`, appends offset of the next allocated block in bytes for the volume specified in `names` or `ids` to the output `items`. `base_name` or `base_id` must not be specified if this is set to `true`. If not specified, defaults to `false`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
segment_length required	integer <int64> Length of the segment, in bytes, to compare.
segment_offset	integer <int64> Absolute offset, in bytes, of the segment to compare. Must be a multiple of block_size.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"length": 0,
"offset": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create an attempt to copy volumes and upsert tags

Creates an attempt to copy virtual storage volumes of different sizes in different vgroups and also upserts tags, without actually creating them, to test if they can be successfully created. Only available for creating volumes via a copy, not direct volume creation.

query Parameters

allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
with_default_protection	boolean If specified as `true`, the initial protection of the newly created volumes will be the union of the container default protection configuration and `add_to_protection_group_names`. If specified as `false`, the default protection of the container will not be applied automatically. The initial protection of the newly created volumes will be configured by `add_to_protection_group_names`. If not specified, defaults to `true`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of volumes to be copied.

Array ()

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
	object (PriorityAdjustment) Adjusts volume priority.
	object (ProtocolEndpoint) Sets the properties that are specific to protocol endpoints. This can only be used in conjunction to `subtype=protocol_endpoint`.
provisioned	integer <int64> <= 4503599627370496 Sets the virtual size of the volume, measured in bytes.
	object (Qos) Sets QoS limits.
	object (Reference) The source volume of a volume copy.
subtype	string The type of volume. Valid values are `protocol_endpoint` and `regular`.
	Array of objects (Tag) The list of tags to be upserted with the object.
	Array of objects (_reference) Specifies a list of protection groups that will compose the initial protection for the volume.
name	string Specifies the name of the volume.

Responses

Request samples

Payload

Content type

application/json

[{"destroyed": true,
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"protocol_endpoint": {"container_version": "1"
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
],
"add_to_protection_groups": [{"id": "string",
"name": "string"
}
],
"name": "string"
}
]

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"id": "string",
"name": "string"
}
}
]
}

List volume performance data

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
]
}

List volume performance data by array

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"array": {"id": "string",
"name": "string"
}
}
]
}

List volumes that are members of protection groups

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_destroyed	boolean If true, returns only destroyed member objects. Returns an error if a name of a live member object is specified in the member_names query param. If false, returns only live member objects. Returns an error if a name of a destroyed member object is specified in the member_names query param.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"destroyed": true
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a volume and add it to a protection group

Creates a volume member and adds it to a protection group. Members that are already in the protection group are not affected. For asynchronous replication, only members of the same type can belong to a protection group. The group_names parameter represents the name of the protection group, and the member_names and member_ids parameters represent the names or IDs of the volume. The group_names and only one of member_names or member_ids parameters are required and must be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string",
"destroyed": true
}
}
]
}

Delete a volume from a protection group

Deletes a volume member from a protection group. After the member has been deleted, it is no longer protected by the group. Any protection group snapshots that were taken before the member was deleted are not affected. Deleting 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 and member_ids parameters represent the names or IDs of the volume. The group_names and only one of member_names or member_ids parameters are required and must be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

List volume space information

Displays the provisioned size and physical storage consumption data for each volume.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0,
"total_effective": 0,
"unique_effective": 0
},
"time": 0
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if one already exists, updated.

Array ()

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Create a dry run attempt to copy a volume

Creates a dry run attempt to see if copying a volume would succeed. No virtual volumes are actually copied or created in this process.

query Parameters

add_to_protection_group_ids	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple ids in comma-separated format.
add_to_protection_group_names	Array of strings The volumes will be added to the specified protection groups along with creation or movement across pods and array. When a volume is moved, the specified protection groups must be in the target pod or array. Enter multiple names in a comma-separated format.
allow_throttle	boolean If set to `true`, allows operation to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
with_default_protection	boolean If specified as `true`, the initial protection of the newly created volumes will be the union of the container default protection configuration and `add_to_protection_group_names`. If specified as `false`, the default protection of the container will not be applied automatically. The initial protection of the newly created volumes will be configured by `add_to_protection_group_names`. If not specified, defaults to `true`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed	boolean If set to `true`, destroys a resource. Once set to `true`, the `time_remaining` value will display the amount of time left until the destroyed resource is permanently eradicated. Before the `time_remaining` period has elapsed, the destroyed resource can be recovered by setting `destroyed=false`. Once the `time_remaining` period has elapsed, the resource is permanently eradicated and can no longer be recovered.
	object (PriorityAdjustment) Adjusts volume priority.
	object (ProtocolEndpoint) Sets the properties that are specific to protocol endpoints. This can only be used in conjunction to `subtype=protocol_endpoint`.
provisioned	integer <int64> <= 4503599627370496 Sets the virtual size of the volume, measured in bytes.
	object (Qos) Sets QoS limits.
	object (Reference) The source volume of a volume copy.
subtype	string The type of volume. Valid values are `protocol_endpoint` and `regular`.
	Array of objects (Tag) The list of tags to be upserted with the object.
	object (WorkloadConfigurationReference) The workload to which the volume is added. Set one of `id` or `name`, and `configuration` to add the volume to the workload and configure it based on the `configuration` from the preset the workload was originally provisioned from.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"protocol_endpoint": {"container_version": "1"
},
"provisioned": 0,
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"source": {"id": "string",
"name": "string"
},
"subtype": "string",
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
],
"workload": {"id": "string",
"name": "string",
"configuration": "string"
}
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"id": "string",
"name": "string"
}
}
]
}

List volumes that are in volume groups

Displays a list of volumes that are in a volume group.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Volume Groups

Volume groups organize volumes into logical groupings. If virtual volumes are configured, each volume group on the FlashArray array represents its associated virtual machine, and inside each of those volumes groups are the FlashArray volumes that are assigned to the virtual machine. Volume groups that are associated with virtual machines have names that begin with vvol- and end with the virtual machine name.

List volume groups

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"volume_count": 3
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"volume_count": 3
}
]
}

Create a volume group and upsert tags.

Creates a volume group. The volume group itself does not contain any meaningful content; instead, it acts as a container that is used to organize volumes. Once a volume group has been created, volumes can be created inside the volume group or moved into and out of the volume group.

query Parameters

context_names

Array of strings

Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided context.

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (_priorityAdjustment)
	object (_qos)
	object (Space)
	Array of objects (Tag) The list of tags to be upserted with the object.

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": { },
"tags": [{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"volume_count": 3
}
]
}

Delete a volume group

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 they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
eradicate_contents	boolean Set to `true` to eradicate contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups). This enables you to eradicate containers with contents.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a volume group

Modifies a volume group. You can rename, destroy, recover, or set QoS limits for a volume group. To rename a volume group, set name to the new name. To destroy a volume group, set destroyed=true. To recover a volume group that has been destroyed and is pending eradication, set destroyed=false. Sets the bandwidth and IOPS limits of a volume group through the respective bandwidth_limit and iops_limit parameter. The ids or names parameter is required, but they cannot be set together. Sets the priority adjustment for a volume group using the priority_adjustment_operator and priority_adjustment_value fields.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
destroy_contents	boolean Set to `true` to destroy contents (e.g., volumes, protection groups, snapshots) and containers (e.g., realms, pods, volume groups), including eradicating containers with content.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string A user-specified name. The name must be locally unique and can be changed.
destroyed	boolean Returns a value of `true` if the volume group has been destroyed and is pending eradication. Before the `time_remaining` period has elapsed, the destroyed volume group can be recovered by setting `destroyed=false`. After the `time_remaining` period has elapsed, the volume group is permanently eradicated and cannot be recovered.
	object (_priorityAdjustment)
	object (_qos)
	object (Space)

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"destroyed": true,
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": { }
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"workload": {"id": "string",
"name": "string",
"resource_type": "string",
"configuration": "string"
},
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"priority_adjustment": {"priority_adjustment_operator": "string",
"priority_adjustment_value": 0
},
"qos": {"bandwidth_limit": 1048576,
"iops_limit": 100
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time_remaining": 0,
"volume_count": 3
}
]
}

List volume group performance data

Displays 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.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
],
"total": [{"bytes_per_mirrored_write": 0,
"bytes_per_op": 0,
"bytes_per_read": 0,
"bytes_per_write": 0,
"mirrored_write_bytes_per_sec": 0,
"mirrored_writes_per_sec": 0,
"qos_rate_limit_usec_per_mirrored_write_op": 0,
"qos_rate_limit_usec_per_read_op": 0,
"qos_rate_limit_usec_per_write_op": 0,
"queue_usec_per_mirrored_write_op": 0,
"queue_usec_per_read_op": 0,
"queue_usec_per_write_op": 0,
"read_bytes_per_sec": 0,
"reads_per_sec": 0,
"san_usec_per_mirrored_write_op": 0,
"san_usec_per_read_op": 0,
"san_usec_per_write_op": 0,
"service_usec_per_mirrored_write_op": 0,
"service_usec_per_read_op": 0,
"service_usec_per_read_op_cache_reduction": 0,
"service_usec_per_write_op": 0,
"time": 0,
"usec_per_mirrored_write_op": 0,
"usec_per_read_op": 0,
"usec_per_write_op": 0,
"write_bytes_per_sec": 0,
"writes_per_sec": 0,
"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
}
}
]
}

List volume group space information

Displays the provisioned size and physical storage consumption data for each volume group.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
end_time	integer <int64> 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.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resolution	integer <int64> >= 0 Example: resolution=30000 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.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
start_time	integer <int64> 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.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
],
"total": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0
},
"time": 0
}
]
}

List volume groups with volumes

Displays a list of volume groups that contain volumes.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
group_ids	Array of strings A comma-separated list of group IDs.
group_names	Array of strings 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	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
member_ids	Array of strings Performs the operation on the unique member IDs specified. Enter multiple member IDs in comma-separated format. The `member_ids` or `member_names` parameter is required, but they cannot be set together.
member_names	Array of strings 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	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"group": {"id": "string",
"name": "string"
},
"member": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags for all specified objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if one already exists, updated.

Array ()

copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (Reference) A reference to the parent object.
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Volume Snapshots

Volume snapshots are immutable, point-in-time images of the contents of one or more volumes. There are two types of volume snapshots: volume snapshots and protection group volume snapshots. A volume snapshot is a snapshot that captures the contents of a single volume. A protection group volume snapshot is a volume snapshot that is created from a group of volumes that are part of the same protection group. All of the volume snapshots created from a protection group snapshot are point-in-time consistent with each other.

List volume snapshots

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

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0
},
"volume_group": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0
},
"volume_group": {"id": "string",
"name": "string"
}
}
]
}

Create a volume snapshot

Creates a point-in-time snapshot of the contents of a volume. The source_ids or source_names parameter is required, but they cannot be set together.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

suffix

string

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0
},
"volume_group": {"id": "string",
"name": "string"
}
}
]
}

Delete a volume snapshot

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
replication_snapshot	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a volume snapshot

Modifies a volume snapshot by renaming, destroying, or recovering it. To rename the suffix of a volume snapshot, set name to the new suffix name. To recover a volume snapshot that has been destroyed and is pending eradication, set destroyed=true. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
replication_snapshot	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

name

string

The new name for the resource.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"name": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"created": 0,
"destroyed": true,
"pod": {"id": "string",
"name": "string"
},
"provisioned": 0,
"source": {"id": "string",
"name": "string"
},
"suffix": "string",
"time_remaining": 0,
"context": {"id": "string",
"name": "string"
},
"serial": "string",
"space": {"data_reduction": 0,
"footprint": 0,
"shared": 111863360624,
"snapshots": 0,
"system": 0,
"thin_provisioning": 0,
"total_physical": 0,
"total_provisioned": 19937690345472,
"total_reduction": 0,
"total_used": 0,
"unique": 0,
"used_provisioned": 19937690345472,
"virtual": 0,
"snapshots_effective": 0
},
"volume_group": {"id": "string",
"name": "string"
}
}
]
}

List volume snapshots with transfer statistics

Displays a list of volume snapshots and their transfer statistics.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.
total_item_count	boolean 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	boolean 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.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
],
"total": [{"id": "string",
"name": "string",
"completed": 0,
"data_transferred": 0,
"destroyed": true,
"physical_bytes_written": 0,
"progress": 0.66,
"started": 0,
"context": {"id": "string",
"name": "string"
}
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
namespaces	Array of strings A comma-separated list of namespaces.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
resource_destroyed	boolean 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	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or modified.

Array ()

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (_fixedReference)
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"context": { },
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": { },
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Create the volume snapshot path

Creates the volume snapshot path without actually taking a volume snapshot.

query Parameters

allow_throttle	boolean If set to `true`, allows snapshot to fail if array health is not optimal.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
on	string Performs the operation on the target name specified. For example, `targetName01`.
source_ids	Array of strings Performs the operation on the source ID specified. Enter multiple source IDs in comma-separated format.
source_names	Array of strings Performs the operation on the source name specified. Enter multiple source names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

suffix

string

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"suffix": "string"
}

Response samples

Content type

application/json

{"items": [{"component_address": "10.230.94.21",
"component_name": "CT0",
"description": "Testing phonehome connectivity",
"destination": "ra.cloud-support.purestorage.com",
"enabled": true,
"result_details": "Timeout connecting to phonehome endpoint",
"success": true,
"test_type": "phonehome",
"context": {"id": "string",
"name": "string"
},
"resource": {"name": "string"
}
}
]
}

Workloads

Workloads organize storage resources (such as volumes) and their related configuration and policy objects into logical groupings. Workloads can be deployed from workload presets.

List workload placement recommendations

Displays a list of placement recommendations for workloads.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"additional_constraints": {"required_resource_references": [{"allowed_values": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
}
],
"targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
},
"created": 0,
"expires": 0,
"id": "string",
"more_results_available": true,
"name": "string",
"parameters": [{"name": "string",
"value": {"boolean": true,
"integer": 0,
"resource_reference": {"id": "string",
"name": "string",
"resource_type": "string"
},
"string": "string"
}
}
],
"placement_names": ["string"
],
"preset": {"id": "string",
"name": "string"
},
"progress": 0.77,
"projection_months": 0,
"results": [{"placements": [{"name": "string",
"targets": [{"id": "string",
"name": "string",
"resource_type": "string",
"capacity": 10995116277760,
"capacity_used_projections": {"days_until_full": null,
"projection": null
},
"load_projections": {"projection_avg": null,
"projection_blended_max": null
},
"model": "string",
"warnings": [null
]
}
]
}
],
"score": "string"
}
],
"results_limit": 0,
"status": "string"
}
]
}

Create a request for a workload placement recommendation.

Creates a recommendation for the placement of the specified workload. The computation might take a few minutes.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
placement_names	Array of strings Placements from the preset which should be used to compute recommendation. Optional parameter if preset has just one placement.
preset_ids	Array of strings Creates the workload placement recommendations using the presets specified by ids. Only one preset can be specified. One of the `preset_ids` or `preset_names` parameters are required, but they cannot be set together.
preset_names	Array of strings Creates the workload placement recommendations using the presets specified by names. Only one preset can be specified. One of the `preset_ids` or `preset_names` parameters are required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (FixedReference) The context in which the operation was performed. Valid values include a reference to any array which is a member of the same fleet. If the array is not a member of a fleet, `context` will always implicitly be set to the array that received the request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
	object (_workloadPlacementRecommendationAdditionalConstraints) The list of targets considered for workload placement must satisfy the requirements imposed by the preset. It is also possible to specify additional constraints to further restrict the list of targets for consideration.
	Array of objects (_workloadParameter) The parameter values to pass to the preset. Value must be supplied for all parameters that do not have a default defined in the preset.
	object (FixedReference)
projection_months	integer <int32> The number of months to compute the projections. If not specified, defaults to 1 month.
results_limit	integer <int32> The maximum number of results to return. If not specified, defaults to 10 results.

Responses

Request samples

Payload

Content type

application/json

{"context": { },
"additional_constraints": {"required_resource_references": [{"allowed_values": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
}
],
"targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
},
"parameters": [{"name": "string",
"value": {"boolean": true,
"integer": 0,
"resource_reference": {"id": "string",
"name": "string",
"resource_type": "string"
},
"string": "string"
}
}
],
"preset": { },
"projection_months": 0,
"results_limit": 0
}

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"additional_constraints": {"required_resource_references": [{"allowed_values": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
}
],
"targets": [{"id": "string",
"name": "string",
"resource_type": "string"
}
]
},
"created": 0,
"expires": 0,
"id": "string",
"more_results_available": true,
"name": "string",
"parameters": [{"name": "string",
"value": {"boolean": true,
"integer": 0,
"resource_reference": {"id": "string",
"name": "string",
"resource_type": "string"
},
"string": "string"
}
}
],
"placement_names": ["string"
],
"preset": {"id": "string",
"name": "string"
},
"progress": 0.77,
"projection_months": 0,
"results": [{"placements": [{"name": "string",
"targets": [{"id": "string",
"name": "string",
"resource_type": "string",
"capacity": 10995116277760,
"capacity_used_projections": {"days_until_full": null,
"projection": null
},
"load_projections": {"projection_avg": null,
"projection_blended_max": null
},
"model": "string",
"warnings": [null
]
}
]
}
],
"score": "string"
}
],
"results_limit": 0,
"status": "string"
}
]
}

List workloads

Displays a list of workloads.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"preset": {"id": "string",
"name": "string",
"resource_type": "string",
"revision": 0
},
"status": "ready",
"status_details": ["string"
],
"time_remaining": 0
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Create a workload

Creates one workload.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
names required	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.
preset_ids	Array of strings Create the resource using the preset specified by the ID. Only one preset can be specified. One of the `preset_ids` or `preset_names` parameters are required, but they cannot be set together.
preset_names	Array of strings Create the resource using the preset specified by name. Only one preset can be specified. One of the `preset_ids` or `preset_names` parameters are required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_workloadParameter)

The parameter values to pass to the preset when creating the workload. Value must be supplied for all parameters that do not have a default defined in the preset.

Responses

Request samples

Payload

Content type

application/json

{"parameters": [{"name": "string",
"value": {"boolean": true,
"integer": 0,
"resource_reference": {"id": "string",
"name": "string",
"resource_type": "string"
},
"string": "string"
}
}
]
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"preset": {"id": "string",
"name": "string",
"resource_type": "string",
"revision": 0
},
"status": "ready",
"status_details": ["string"
],
"time_remaining": 0
}
]
}

Delete a workload

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

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a workload

Modifies a workload by renaming or destroying it. To rename a workload, set name to the new name. To destroy a workload, set destroyed=true. To recover a workload that has been destroyed and is pending eradication, set destroyed=false. The ids or names parameter is required, but they cannot be set together.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Only one value is supported.
names	Array of strings Performs the operation on the unique resource names specified. Only one value is supported.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

destroyed

boolean

name

string

The new name for the resource.

Responses

Request samples

Payload

Content type

application/json

{"destroyed": true,
"name": "string"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"context": {"id": "string",
"name": "string"
},
"created": 0,
"destroyed": true,
"preset": {"id": "string",
"name": "string",
"resource_type": "string",
"revision": 0
},
"status": "ready",
"status_details": ["string"
],
"time_remaining": 0
}
]
}

List tags

Displays the list of tags.

query Parameters

allow_errors	boolean Default: false If set to `true`, the API will allow the operation to continue even if there are errors. Any errors will be returned in the `errors` field of the response. If set to `false`, the operation will fail if there are any errors.
context_names	Array of strings Performs the operation on the unique contexts specified. If specified, each context name must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`. Enter multiple names in comma-separated format. For example, `name01,name02`.
namespaces	Array of strings A comma-separated list of namespaces.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
],
"errors": [{"context": "<object_name>",
"location_context": {"id": "string",
"name": "string",
"resource_type": "string"
},
"message": "Object does not exist."
}
]
}

Delete tags

Deletes specified tags.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
keys	Array of strings A comma-separated list of tag keys.
namespaces	Array of strings A comma-separated list of namespaces. Only one namespace is allowed per delete request.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Update tags

Updates or creates tags for all specified objects.

query Parameters

context_names	Array of strings Performs the operation on the context specified. If specified, the context names must be an array of size 1, and the single element must be the name of an array in the same fleet. If not specified, the context will default to the array that received this request. Other parameters provided with the request, such as names of volumes or snapshots, are resolved relative to the provided `context`.
resource_ids	Array of strings A comma-separated list of resource IDs. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.
resource_names	Array of strings A comma-separated list of resource names. The `resource_ids` or `resource_names` parameter is required, but they cannot be set together.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

A list of tags to be created or, if they already exist, updated.

Array ()

copyable	boolean Specifies whether or not to include the tag when copying the parent resource. If set to `true`, the tag is included in resource copying. If set to `false`, the tag is not included. If not specified, defaults to `true`.
key	string Key of the tag. Supports up to 64 Unicode characters.
namespace	string Optional namespace of the tag. Namespace identifies the category of the tag. Omitting the namespace defaults to the namespace `default`. The `pure*` namespaces are reserved for plugins and integration partners. It is recommended that customers avoid using reserved namespaces.
	object (Reference) A reference to the parent object.
value	string Value of the tag. Supports up to 256 Unicode characters.

Responses

Request samples

Payload

Content type

application/json

[{"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]

Response samples

Content type

application/json

{"items": [{"context": {"id": "string",
"name": "string"
},
"copyable": true,
"key": "environment",
"namespace": "default",
"resource": {"id": "string",
"name": "string"
},
"value": "staging"
}
]
}

Files

Create a file copy

Creates a file copy from one path to another path. The directory_ids, directory_names or paths value must be specified. If the directory_ids or directory_names value is not specified, the file is copied to the source directory specified in the body params. The paths value refers to the path of the target file relative to the target directory. If paths value is not specified, the file will be copied to the relative path specified in source_path under the target directory. The source_path value refers to the path of the source file relative to the source directory. To overwrite an existing file, set the overwrite flag to true.

query Parameters

directory_ids	Array of strings Performs the operation on the unique managed directory IDs specified. Enter multiple managed directory IDs in comma-separated format. The `directory_ids` or `directory_names` parameter is required, but they cannot be set together.
directory_names	Array of strings 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`.
overwrite	boolean If set to `true`, overwrites an existing object during an object copy operation. If set to `false` or not set at all and the target name is an existing object, the copy operation fails. Required if the `source` body parameter is set and the source overwrites an existing object during the copy operation.
paths	Array of strings Target file path relative to the target directory. Enter multiple target file path in a comma-separated format. For example, `/dir1/dir2/file1,/dir3/dir4/file2`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (ReferenceWithType) The source information of a file copy.
source_path	string The source file path relative to the source directory.

Responses

Request samples

Payload

Content type

application/json

{"source": {"id": "string",
"name": "string",
"resource_type": "string"
},
"source_path": "string"
}

Resource Accesses

List resource access configurations

Displays a list of configured resource accesses.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"resource": {"id": "string",
"name": "string",
"resource_type": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a resource access configuration

Deletes a resource access object.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Create a resource access configuration

Creates resource access objects.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array ()

	object (ReferenceWithType) Resource to which the scope has access.
	object (ReferenceWithType) Scope which has access to the resource.

Responses

Request samples

Payload

Content type

application/json

[{"resource": {"id": "string",
"name": "string",
"resource_type": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]

Response samples

Content type

application/json

{"items": [{"id": "string",
"resource": {"id": "string",
"name": "string",
"resource_type": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

List status of resource accesses as specified by resource access configuration

Displays a list of effective resource accesses.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"created_by": [{"id": "string",
"implicit": true
}
],
"resource": {"id": "string",
"name": "string",
"resource_type": "string"
},
"scope": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Vchosts

List vchosts

Displays a list of vchosts.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"id": "string",
"name": "string",
"vcuuid": "ddf43502-4e00-405e-b341-e87e7eaa13f6"
}
]
}

Create a vchost

Creates a vchost. The names query parameter is required.

query Parameters

names

Array of strings

Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, name01,name02.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

vcuuid

string

The vCenter Server uuid of the vchost.

Responses

Request samples

Payload

Content type

application/json

{"vcuuid": "ddf43502-4e00-405e-b341-e87e7eaa13f6"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"vcuuid": "ddf43502-4e00-405e-b341-e87e7eaa13f6"
}
]
}

Delete a vchost

Deletes an existing vchost. The names or ids query parameter is required.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a vchost

Modifies an existing vchost. The names or ids query parameter is required.

query Parameters

ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
names	Array of strings Performs the operation on the unique name specified. Enter multiple names in comma-separated format. For example, `name01,name02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

name	string The new name of the vchost.

Responses

Request samples

Payload

Content type

application/json

{"name": "vchost-b"
}

Response samples

Content type

application/json

{"items": [{"id": "string",
"name": "string",
"vcuuid": "ddf43502-4e00-405e-b341-e87e7eaa13f6"
}
]
}

List vchost certificates

Displays certificates that are attached to configured vchosts on at least one endpoint.

query Parameters

certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.
continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"certificate": {"name": "string",
"resource_type": "string"
},
"endpoints": ["1.2.3.4"
],
"id": "uuid-of-association",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Create a vchost certificate

Creates an association between a certificate and vchost on one or more endpoints. The vchost_names or vchost_ids query parameter is required.

query Parameters

vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	object (ReferenceNoIdWithType) The certificate to be presented by the vchost over the configured endpoints.
endpoints	Array of strings The IPv4 or IPv6 addresses of the endpoints to configure for the vchost, over which the configured certificate will be presented.

Responses

Request samples

Payload

Content type

application/json

{"certificate": {"name": "string",
"resource_type": "string"
},
"endpoints": ["1.2.3.4"
]
}

Response samples

Content type

application/json

{"items": [{"certificate": {"name": "string",
"resource_type": "string"
},
"endpoints": ["1.2.3.4"
],
"id": "uuid-of-association",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a vchost certificate

Deletes an existing vchost certificate. The ids query parameter alone, or the certificate_names query parameter together with one of vchost_names or vchost_ids, is required.

query Parameters

certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a vchost certificate

Modifies an existing vchost certificate. The ids query parameter alone, or the certificate_names query parameter together with one of vchost_names or vchost_ids, is required.

query Parameters

certificate_names	Array of strings The names of one or more certificates. Enter multiple names in comma-separated format. For example, `cert01,cert02`.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

endpoints

Array of strings

The IPv4 or IPv6 addresses of the endpoints to configure for the vchost, over which the configured certificate will be presented.

Responses

Request samples

Payload

Content type

application/json

{"endpoints": ["1.2.3.4"
]
}

Response samples

Content type

application/json

{"items": [{"certificate": {"name": "string",
"resource_type": "string"
},
"endpoints": ["1.2.3.4"
],
"id": "uuid-of-association",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

List vchost endpoints

Displays a list of vchost endpoints with their associated vchosts and certificates.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
endpoints	Array of strings Performs the operation on the unique endpoints specified. Enter multiple endpoints in a comma-separated format.
filter	string Narrows down the results to only the response objects that satisfy the filter criteria.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"certificates": [{"name": "string",
"resource_type": "string"
}
],
"endpoint": "1.2.3.4",
"id": "3a668af2-f63a-0110-bf4a-39e911ac6f07",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Create a vchost endpoint

Creates a vchost endpoint. Either the vchost_names or vchost_ids query parameter is required.

query Parameters

vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

	Array of objects (_referenceNoIdWithType) The certificate to be presented by the vchost over the configured endpoints.
endpoint	string The IPv4 or IPv6 address of the endpoint.

Responses

Request samples

Payload

Content type

application/json

{"certificates": [{"name": "string",
"resource_type": "string"
}
],
"endpoint": "1.2.3.4"
}

Response samples

Content type

application/json

{"items": [{"certificates": [{"name": "string",
"resource_type": "string"
}
],
"endpoint": "1.2.3.4",
"id": "3a668af2-f63a-0110-bf4a-39e911ac6f07",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Delete a vchost endpoint

Deletes an existing vchost endpoint The ids query parameter alone, or the endpoints query parameter together with one of vchost_names or vchost_ids, is required.

query Parameters

endpoints	Array of strings Performs the operation on the unique endpoints specified. Enter multiple endpoints in a comma-separated format.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Modify a vchost endpoint

Modifies an existing vchost endpoint. The ids query parameter alone, or the endpoints query parameter together with one of vchost_names or vchost_ids, is required.

query Parameters

endpoints	Array of strings Performs the operation on the unique endpoints specified. Enter multiple endpoints in a comma-separated format.
ids	Array of strings Performs the operation on the unique resource IDs specified. Enter multiple resource IDs in comma-separated format. The `ids` or `names` parameter is required, but they cannot be set together.
vchost_ids	Array of strings Performs the operation on the unique vchost IDs specified. Enter multiple vchost IDs in a comma-separated format. For example, `vchostid01,vchostid02`.
vchost_names	Array of strings Performs the operation on the unique vchost name specified. Enter multiple names in a comma-separated format. For example, `vchost01,vchost02`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

Array of objects (_referenceNoIdWithType)

The certificate to be presented by the vchost over the configured endpoints.

Responses

Request samples

Payload

Content type

application/json

{"certificates": [{"name": "string",
"resource_type": "string"
}
]
}

Response samples

Content type

application/json

{"items": [{"certificates": [{"name": "string",
"resource_type": "string"
}
],
"endpoint": "1.2.3.4",
"id": "3a668af2-f63a-0110-bf4a-39e911ac6f07",
"is_local": true,
"vchost": {"id": "string",
"name": "string",
"resource_type": "string"
}
}
]
}

Virtual Machines

List Virtual Machines

Displays a list of virtual machines, including those pending eradication. If vm_type is vvol, the recovery_context in the response will represent the most recent snapshot of the config vVol. This must be used as the source in the PATCH method when recovering a virtual machine from the destroyed state.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vm_ids	Array of strings Performs the operation on the unique virtual machine IDs specified. Enter multiple virtual machine IDs in a comma-separated format.
vm_type	string The type of virtual machine. The only valid value is `vvol`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"created": 0,
"destroyed": true,
"id": "string",
"name": "string",
"recover_context": {"id": "string",
"name": "string"
},
"time_remaining": 0,
"vm_id": "string",
"vm_type": "vvol"
}
]
}

Create a virtual machine

Creates one or more virtual machines from a protection group snapshot. If the virtual machine is of type vvol, the source property of the request body must be a recovery_context value retrieved from the GET /virtual-machine-snapshots endpoint. If overwrite is specified, an existing virtual machine will have its volumes overwritten by the snapshot. Otherwise, a new virtual machine will be created from the snapshot. If creating the new virtual machine will cause a conflict with an existing virtual machine, the operation will fail.

query Parameters

overwrite

boolean

If set to true, overwrites an existing object during an object copy operation. If set to false or not set at all and the target name is an existing object, the copy operation fails. Required if the source body parameter is set and the source overwrites an existing object during the copy operation.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

id	string The ID of the virtual machine to create or modify, as assigned by the external system. `id` is deprecated. Use `vm_id` instead.
	object (Reference) The recovery context for the virtual machine or virtual machine snapshot being modified.
vm_id	string The ID of the virtual machine to create or modify, as assigned by the external system.
vm_type	string The type of virtual machine. The only valid value is `vvol`.

Responses

Request samples

Payload

Content type

application/json

{"id": "string",
"source": {"id": "string",
"name": "string"
},
"vm_id": "string",
"vm_type": "vvol"
}

Response samples

Content type

application/json

{"items": [{"created": 0,
"destroyed": true,
"id": "string",
"name": "string",
"recover_context": {"id": "string",
"name": "string"
},
"time_remaining": 0,
"vm_id": "string",
"vm_type": "vvol"
}
]
}

Update a virtual machine

Updates a virtual machine, recovering it from the destroyed state. If the virtual machine is of type vvol, the source property of the request body must be a recovery_context value retrieved from the GET /virtual-machines endpoint. If recovering the virtual machine will cause a conflict with an existing virtual machine, the operation will fail.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Request Body schema: application/json

id	string The ID of the virtual machine to create or modify, as assigned by the external system. `id` is deprecated. Use `vm_id` instead.
	object (Reference) The recovery context for the virtual machine or virtual machine snapshot being modified.
vm_id	string The ID of the virtual machine to create or modify, as assigned by the external system.
vm_type	string The type of virtual machine. The only valid value is `vvol`.

Responses

Request samples

Payload

Content type

application/json

{"id": "string",
"source": {"id": "string",
"name": "string"
},
"vm_id": "string",
"vm_type": "vvol"
}

Response samples

Content type

application/json

{"items": [{"created": 0,
"destroyed": true,
"id": "string",
"name": "string",
"recover_context": {"id": "string",
"name": "string"
},
"time_remaining": 0,
"vm_id": "string",
"vm_type": "vvol"
}
]
}

List Virtual Machine Volume Snapshots

Displays a list of virtual machine volume snapshots, including those pending eradication. If vm_type is vvol, the recover_context in the response will represent a protection group snapshot containing the virtual machine volume.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vm_ids required	Array of strings Performs the operation on the unique virtual machine IDs specified. Enter multiple resource IDs in a comma-separated format.
vm_type	string The type of virtual machine. The only valid value is `vvol`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"created": 0,
"destroyed": true,
"id": "string",
"name": "string",
"recover_context": {"id": "string",
"name": "string"
},
"time_remaining": 0,
"vm_id": "string",
"vm_type": "vvol",
"vvol_name": "string",
"vvol_type": "config"
}
]
}

List Virtual Machine Snapshots

Displays a list of virtual machine snapshots, including those pending eradication. If vm_type is vvol, the recovery_context in the response will represent a protection group snapshot containing the virtual machine. This must be used as the source in the POST /virtual-machine method when recovering or overwriting a virtual machine from a snapshot.

query Parameters

continuation_token	string A token used to retrieve the next page of data with some consistency guaranteed. The token is a Base64 encoded value. Set `continuation_token` to the system-generated token taken from the `x-next-token` header field of the response. A query has reached its last page when the response does not include a token. Pagination requires the `limit` and `continuation_token` query parameters.
destroyed	boolean 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	string Narrows down the results to only the response objects that satisfy the filter criteria.
limit	integer <int32> >= 0 Example: limit=10 Limits the size of the response to the specified number of objects on each page. To return the total number of resources, set `limit=0`. The total number of resources is returned as a `total_item_count` value. If the page size requested is larger than the system maximum limit, the server returns the maximum limit, disregarding the requested page size.
offset	integer <int32> >= 0 Example: offset=10 The starting position based on the results of the query in relation to the full set of response objects returned.
sort	Array of strings Returns the response objects in the order specified. Set `sort` to the name in the response by which to sort. Sorting can be performed on any of the names in the response, and the objects can be sorted in ascending or descending order. By default, the response objects are sorted in ascending order. To sort in descending order, append the minus sign (`-`) to the name. A single request can be sorted on multiple objects. For example, you can sort all volumes from largest to smallest volume size, and then sort volumes of the same size in ascending order by volume name. To sort on multiple names, list the names as comma-separated values.
total_item_count	boolean 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`.
vm_ids	Array of strings Performs the operation on the unique virtual machine IDs specified. Enter multiple resource IDs in a comma-separated format.
vm_type	string The type of virtual machine. The only valid value is `vvol`.

header Parameters

Authorization	string Access token (in JWT format) required to use any API endpoint (except `/oauth2`, `/login`, and `/logout`)
X-Request-ID	string Supplied by client during request or generated by server.

Responses

Response samples

Content type

application/json

{"continuation_token": "string",
"more_items_remaining": false,
"total_item_count": 0,
"items": [{"created": 0,
"destroyed": true,
"id": "string",
"name": "string",
"recover_context": {"id": "string",
"name": "string"
},
"time_remaining": 0,
"vm_id": "string",
"vm_type": "vvol"
}
]
}