Retrieve applications

Expensive properties

There is an added cost to retrieving values for these properties. They are not included by default in GET results and must be explicitly requested using the fields query parameter. See DOC Requesting specific fields to learn more.

<template> the property corresponding to the template.name of the application

Query examples

Numerous queries are available for classifying and sorting applications:

Return a list of applications sorted by name.

  GET /application/applications?order_by=name

Return a list of applications for a specific SVM.

  GET /application/applications?svm.name=<name>

Return a list of all SQL applications.

  GET /application/applications?template.name=sql*

Return a list of all applications that can be accessed via SAN.
```
  GET /application/applications?template.protocol=san
```

Return the top five applications consuming the most IOPS.

  GET /application/applications?order_by=statistics.iops.total desc&max_records=5

The above examples are not comprehensive. There are many more properties available for queries. Also, multiple queries can be mixed and matched with other query parameters for a large variety of requests. See the per-property documentation below for the full list of supported query parameters.

Learn more

DOC /application

Parameters

Name	Type	In	Required	Description
uuid	string	query	False	Filter by UUID
name	string	query	False	Filter by name
svm.name	string	query	False	Filter by svm.name
svm.uuid	string	query	False	Filter by svm.uuid
template.name	string	query	False	Filter by template.name
template.version	string	query	False	Filter by template.version
template.protocol	string	query	False	Filter by template.protocol
generation	string	query	False	Filter by generation
state	string	query	False	Filter by state
protection_granularity	string	query	False	Filter by protection granularity
rpo.is_supported	string	query	False	Filter by rpo.is_supported
rpo.local.name	string	query	False	Filter by rpo.local.name
rpo.local.description	string	query	False	Filter by rpo.local.description
rpo.remote.name	string	query	False	Filter by rpo.remote.name
rpo.remote.description	string	query	False	Filter by rpo.remote.description
rpo.components.name	string	query	False	Filter by rpo.components.name
rpo.components.uuid	string	query	False	Filter by rpo.components.uuid
rpo.components.rpo.local.name	string	query	False	Filter by rpo.components.rpo.local.name
rpo.components.rpo.local.description	string	query	False	Filter by rpo.components.rpo.local.description
rpo.components.rpo.remote.name	string	query	False	Filter by rpo.components.rpo.remote.name
rpo.components.rpo.remote.description	string	query	False	Filter by rpo.components.rpo.remote.description
statistics.space.provisioned	string	query	False	Filter by statistics.space.provisioned
statistics.space.used	string	query	False	Filter by statistics.space.used
statistics.space.used_percent	string	query	False	Filter by statistics.space.used_percent
statistics.space.used_excluding_reserves	string	query	False	Filter by statistics.space.used_excluding_reserves
statistics.space.logical_used	string	query	False	Filter by statistics.space.logical_used
statistics.space.reserved_unused	string	query	False	Filter by statistics.space.reserved_unused
statistics.space.available	string	query	False	Filter by statistics.space.available
statistics.space.savings	string	query	False	Filter by statistics.space.savings
statistics.iops.total	string	query	False	Filter by statistics.iops.total
statistics.iops.per_tb	string	query	False	Filter by statistics.iops.per_tb
statistics.snapshot.reserve	string	query	False	Filter by statistics.snapshot.reserve
statistics.snapshot.used	string	query	False	Filter by statistics.snapshot.used
statistics.latency.raw	string	query	False	Filter by statistics.latency.raw
statistics.latency.average	string	query	False	Filter by statistics.latency.average
statistics.statistics_incomplete	string	query	False	Filter by statistics.statistics_incomplete
statistics.shared_storage_pool	string	query	False	Filter by statistics.shared_storage_pool
statistics.components.name	string	query	False	Filter by statistics.components.name
statistics.components.uuid	string	query	False	Filter by statistics.components.uuid
statistics.components.storage_service.name	string	query	False	Filter by statistics.components.storage_service.name
statistics.components.space.provisioned	string	query	False	Filter by statistics.components.space.provisioned
statistics.components.space.used	string	query	False	Filter by statistics.components.space.used
statistics.components.space.used_percent	string	query	False	Filter by statistics.components.space.used_percent
statistics.components.space.used_excluding_reserves	string	query	False	Filter by statistics.components.space.used_excluding_reserves
statistics.components.space.logical_used	string	query	False	Filter by statistics.components.space.logical_used
statistics.components.space.reserved_unused	string	query	False	Filter by statistics.components.space.reserved_unused
statistics.components.space.available	string	query	False	Filter by statistics.components.space.available
statistics.components.space.savings	string	query	False	Filter by statistics.components.space.savings
statistics.components.iops.total	string	query	False	Filter by statistics.components.iops.total
statistics.components.iops.per_tb	string	query	False	Filter by statistics.components.iops.per_tb
statistics.components.snapshot.reserve	string	query	False	Filter by statistics.components.snapshot.reserve
statistics.components.snapshot.used	string	query	False	Filter by statistics.components.snapshot.used
statistics.components.latency.raw	string	query	False	Filter by statistics.components.latency.raw
statistics.components.latency.average	string	query	False	Filter by statistics.components.latency.average
statistics.components.statistics_incomplete	string	query	False	Filter by statistics.components.statistics_incomplete
statistics.components.shared_storage_pool	string	query	False	Filter by statistics.components.shared_storage_pool
smart_container	string	query	False	Filter by smart_container
fields	array[string]	query	False	Specify the fields to return.
max_records	integer	query	False	Limit the number of records returned.
return_timeout	integer	query	False	The number of seconds to allow the call to execute before returning. When iterating over a collection, the default is 15 seconds. ONTAP returns earlier if either max records or the end of the collection is reached.
return_records	boolean	query	False	The default is true for GET calls. When set to false, only the number of records is returned.
order_by	array[string]	query	False	Order results by specified fields and optional [asc

Name

Type

In

Required

Description

uuid

string

query

False

Filter by UUID

name

string

query

False

Filter by name

svm.name

string

query

False

Filter by svm.name

svm.uuid

string

query

False

Filter by svm.uuid

template.name

string

query

False

Filter by template.name

template.version

string

query

False

Filter by template.version

template.protocol

string

query

False

Filter by template.protocol

generation

string

query

False

Filter by generation

state

string

query

False

Filter by state

protection_granularity

string

query

False

Filter by protection granularity

rpo.is_supported

string

query

False

Filter by rpo.is_supported

rpo.local.name

string

query

False

Filter by rpo.local.name

rpo.local.description

string

query

False

Filter by rpo.local.description

rpo.remote.name

string

query

False

Filter by rpo.remote.name

rpo.remote.description

string

query

False

Filter by rpo.remote.description

rpo.components.name

string

query

False

Filter by rpo.components.name

rpo.components.uuid

string

query

False

Filter by rpo.components.uuid

rpo.components.rpo.local.name

string

query

False

Filter by rpo.components.rpo.local.name

rpo.components.rpo.local.description

string

query

False

Filter by rpo.components.rpo.local.description

rpo.components.rpo.remote.name

string

query

False

Filter by rpo.components.rpo.remote.name

rpo.components.rpo.remote.description

string

query

False

Filter by rpo.components.rpo.remote.description

statistics.space.provisioned

string

query

False

Filter by statistics.space.provisioned

statistics.space.used

string

query

False

Filter by statistics.space.used

statistics.space.used_percent

string

query

False

Filter by statistics.space.used_percent

statistics.space.used_excluding_reserves

string

query

False

Filter by statistics.space.used_excluding_reserves

statistics.space.logical_used

string

query

False

Filter by statistics.space.logical_used

statistics.space.reserved_unused

string

query

False

Filter by statistics.space.reserved_unused

statistics.space.available

string

query

False

Filter by statistics.space.available

statistics.space.savings

string

query

False

Filter by statistics.space.savings

statistics.iops.total

string

query

False

Filter by statistics.iops.total

statistics.iops.per_tb

string

query

False

Filter by statistics.iops.per_tb

statistics.snapshot.reserve

string

query

False

Filter by statistics.snapshot.reserve

statistics.snapshot.used

string

query

False

Filter by statistics.snapshot.used

statistics.latency.raw

string

query

False

Filter by statistics.latency.raw

statistics.latency.average

string

query

False

Filter by statistics.latency.average

statistics.statistics_incomplete

string

query

False

Filter by statistics.statistics_incomplete

statistics.shared_storage_pool

string

query

False

Filter by statistics.shared_storage_pool

statistics.components.name

string

query

False

Filter by statistics.components.name

statistics.components.uuid

string

query

False

Filter by statistics.components.uuid

statistics.components.storage_service.name

string

query

False

Filter by statistics.components.storage_service.name

statistics.components.space.provisioned

string

query

False

Filter by statistics.components.space.provisioned

statistics.components.space.used

string

query

False

Filter by statistics.components.space.used

statistics.components.space.used_percent

string

query

False

Filter by statistics.components.space.used_percent

statistics.components.space.used_excluding_reserves

string

query

False

Filter by statistics.components.space.used_excluding_reserves

statistics.components.space.logical_used

string

query

False

Filter by statistics.components.space.logical_used

statistics.components.space.reserved_unused

string

query

False

Filter by statistics.components.space.reserved_unused

statistics.components.space.available

string

query

False

Filter by statistics.components.space.available

statistics.components.space.savings

string

query

False

Filter by statistics.components.space.savings

statistics.components.iops.total

string

query

False

Filter by statistics.components.iops.total

statistics.components.iops.per_tb

string

query

False

Filter by statistics.components.iops.per_tb

statistics.components.snapshot.reserve

string

query

False

Filter by statistics.components.snapshot.reserve

statistics.components.snapshot.used

string

query

False

Filter by statistics.components.snapshot.used

statistics.components.latency.raw

string

query

False

Filter by statistics.components.latency.raw

statistics.components.latency.average

string

query

False

Filter by statistics.components.latency.average

statistics.components.statistics_incomplete

string

query

False

Filter by statistics.components.statistics_incomplete

statistics.components.shared_storage_pool

string

query

False

Filter by statistics.components.shared_storage_pool

smart_container

string

query

False

Filter by smart_container

fields

array[string]

query

False

Specify the fields to return.

max_records

integer

query

False

Limit the number of records returned.

return_timeout

integer

query

False

The number of seconds to allow the call to execute before returning. When iterating over a collection, the default is 15 seconds. ONTAP returns earlier if either max records or the end of the collection is reached.

return_records

boolean

query

False

The default is true for GET calls. When set to false, only the number of records is returned.

order_by

array[string]

query

False

Order results by specified fields and optional [asc

Response

Status: 200, Ok

Name	Type	Description
_links	_links
num_records	integer	Number of records
records	array[application]

Name

Type

Description

_links

num_records

integer

Number of records

records

array[application]

Example response

{
  "_links": {
    "next": {
      "href": "/api/resourcelink"
    },
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "records": {
  }
}

Error

Status: Default, Error

Name	Type	Description
error	error

Name

Type

Description

error

Example error

{
  "error": {
    "arguments": {
      "code": "string",
      "message": "string"
    },
    "code": "4",
    "message": "entry doesn't exist",
    "target": "uuid"
  }
}

Definitions

See Definitions

href

Name	Type	Description
href	string

Name

Type

Description

href

string

_links

Name	Type	Description
next	href
self	href

Name

Type

Description

self

href

_links

Name	Type	Description
self	href
snapshots	href

Name

Type

Description

self

href

snapshots

href

metadata

Name	Type	Description
key	string	Key to look up metadata associated with an application component.
value	string	Value associated with the key.

Name

Type

Description

key

string

Key to look up metadata associated with an application component.

value

string

Value associated with the key.

protection_type

Name	Type	Description
local_rpo	string	The local rpo of the application component.
remote_rpo	string	The remote rpo of the application component.

Name

Type

Description

local_rpo

string

The local rpo of the application component.

remote_rpo

string

The remote rpo of the application component.

storage_service

Name	Type	Description
name	string	The storage service of the application component.

Name

Type

Description

name

string

The storage service of the application component.

maxdata_on_san_application_components

The list of application components to be created.

Name	Type	Description
file_system	string	Defines the type of file system that will be installed on this application component.
host_management_url	string	The host management URL for this application component.
host_name	string	FQDN of the L2 host that contains the hot tier of this application component.
igroup_name	string	The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.
lun_count	integer	The number of LUNs in the application component.
metadata	array[metadata]
name	string	The name of the application component.
protection_type	protection_type
storage_service	storage_service
total_size	integer	The total size of the application component, split across the member LUNs. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}

Name

Type

Description

file_system

string

Defines the type of file system that will be installed on this application component.

host_management_url

string

The host management URL for this application component.

host_name

string

FQDN of the L2 host that contains the hot tier of this application component.

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

lun_count

integer

The number of LUNs in the application component.

metadata

array[metadata]

name

string

The name of the application component.

protection_type

storage_service

total_size

integer

The total size of the application component, split across the member LUNs. Usage: {<integer>[KB|MB|GB|TB|PB]}

metadata

Name	Type	Description
key	string	Key to look up metadata associated with an application.
value	string	Value associated with the key.

Name

Type

Description

key

string

Key to look up metadata associated with an application.

value

string

Value associated with the key.

maxdata_on_san_new_igroups

The list of initiator groups to create.

Name	Type	Description
initiators	array[string]
name	string	The name of the new initiator group.
os_type	string	The name of the host OS accessing the application. The default value is the host OS that is running the application.
protocol	string	The protocol of the new initiator group.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

maxdata_on_san

MAX Data application using SAN.

Name	Type	Description
app_type	string	Type of the application that is being deployed on the L2.
application_components	array[maxdata_on_san_application_components]	The list of application components to be created.
metadata	array[metadata]
new_igroups	array[maxdata_on_san_new_igroups]	The list of initiator groups to create.
ocsm_url	string	The OnCommand System Manager URL for this application.
os_type	string	The name of the host OS running the application.

Name

Type

Description

app_type

string

Type of the application that is being deployed on the L2.

application_components

array[maxdata_on_san_application_components]

The list of application components to be created.

metadata

array[metadata]

new_igroups

array[maxdata_on_san_new_igroups]

The list of initiator groups to create.

ocsm_url

string

The OnCommand System Manager URL for this application.

os_type

string

The name of the host OS running the application.

storage_service

Name	Type	Description
name	string	The storage service of the database.

Name

Type

Description

name

string

The storage service of the database.

dataset

Name	Type	Description
element_count	integer	The number of storage elements (LUNs for SAN) of the database to maintain. Must be an even number between 2 and 16. Odd numbers will be rounded up to the next even number within range.
replication_factor	integer	The number of data bearing members of the replicaset, including 1 primary and at least 1 secondary.
size	integer	The size of the database. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

element_count

integer

The number of storage elements (LUNs for SAN) of the database to maintain. Must be an even number between 2 and 16. Odd numbers will be rounded up to the next even number within range.

replication_factor

integer

The number of data bearing members of the replicaset, including 1 primary and at least 1 secondary.

size

integer

The size of the database. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

mongo_db_on_san_new_igroups

The list of initiator groups to create.

Name	Type	Description
initiators	array[string]
name	string	The name of the new initiator group.
os_type	string	The name of the host OS accessing the application. The default value is the host OS that is running the application.
protocol	string	The protocol of the new initiator group.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

protection_type

Name	Type	Description
local_rpo	string	The local rpo of the application.
remote_rpo	string	The remote rpo of the application.

Name

Type

Description

local_rpo

string

The local rpo of the application.

remote_rpo

string

The remote rpo of the application.

secondary_igroups

Name	Type	Description
name	string	The name of the initiator group for each secondary.

Name

Type

Description

name

string

The name of the initiator group for each secondary.

mongo_db_on_san

MongoDB using SAN.

Name	Type	Description
dataset	dataset
new_igroups	array[mongo_db_on_san_new_igroups]	The list of initiator groups to create.
os_type	string	The name of the host OS running the application.
primary_igroup_name	string	The initiator group for the primary.
protection_type	protection_type
secondary_igroups	array[secondary_igroups]

Name

Type

Description

dataset

new_igroups

array[mongo_db_on_san_new_igroups]

The list of initiator groups to create.

os_type

string

The name of the host OS running the application.

primary_igroup_name

string

The initiator group for the primary.

protection_type

secondary_igroups

array[secondary_igroups]

component

Name	Type	Description
name	string	Name of the source component.

Name

Type

Description

name

string

Name of the source component.

svm

Name	Type	Description
name	string	Name of the source SVM.

Name

Type

Description

name

string

Name of the source SVM.

origin

Name	Type	Description
component	component
svm	svm

Name

Type

Description

component

svm

flexcache

Name	Type	Description
origin	origin

Name

Type

Description

origin

object_stores

Name	Type	Description
name	string	The name of the object-store to use. Usage: <(size 1..512)>

Name

Type

Description

name

string

The name of the object-store to use. Usage: <(size 1..512)>

nas_application_components_tiering

application-components.tiering

Name	Type	Description
control	string	Storage tiering placement rules for the container(s)
object_stores	array[object_stores]
policy	string	The storage tiering type of the application component.

Name

Type

Description

control

string

Storage tiering placement rules for the container(s)

object_stores

array[object_stores]

policy

string

The storage tiering type of the application component.

application_components

Name	Type	Description
flexcache	flexcache
name	string	The name of the application component.
scale_out	boolean	Denotes a Flexgroup.
share_count	integer	The number of shares in the application component.
storage_service	storage_service
tiering	nas_application_components_tiering	application-components.tiering
total_size	integer	The total size of the application component, split across the member shares. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}

Name

Type

Description

flexcache

name

string

The name of the application component.

scale_out

boolean

Denotes a Flexgroup.

share_count

integer

The number of shares in the application component.

storage_service

tiering

nas_application_components_tiering

application-components.tiering

total_size

integer

The total size of the application component, split across the member shares. Usage: {<integer>[KB|MB|GB|TB|PB]}

app_cifs_access

The list of CIFS access controls.

Name	Type	Description
access	string	The CIFS access granted to the user or group.
user_or_group	string	The name of the CIFS user or group that will be granted access.

Name

Type

Description

access

string

The CIFS access granted to the user or group.

user_or_group

string

The name of the CIFS user or group that will be granted access.

app_nfs_access

The list of NFS access controls.

Name	Type	Description
access	string	The NFS access granted.
host	string	The name of the NFS entity granted access.

Name

Type

Description

access

string

The NFS access granted.

host

string

The name of the NFS entity granted access.

protection_type

Name	Type	Description
local_policy	string	The snapshot policy to apply to each volume in the smart container. This property is only supported for smart containers. Usage: <snapshot policy>
local_rpo	string	The local rpo of the application.
remote_rpo	string	The remote rpo of the application.

Name

Type

Description

local_policy

string

The snapshot policy to apply to each volume in the smart container. This property is only supported for smart containers. Usage: <snapshot policy>

local_rpo

string

The local rpo of the application.

remote_rpo

string

The remote rpo of the application.

nas

A generic NAS application.

Name	Type	Description
application_components	array[application_components]
cifs_access	array[app_cifs_access]	The list of CIFS access controls.
nfs_access	array[app_nfs_access]	The list of NFS access controls.
protection_type	protection_type

Name

Type

Description

application_components

array[application_components]

cifs_access

array[app_cifs_access]

The list of CIFS access controls.

nfs_access

array[app_nfs_access]

The list of NFS access controls.

protection_type

performance

Name	Type	Description
storage_service	storage_service

Name

Type

Description

storage_service

hosts

Name	Type	Description
nqn	string	The host NQN.

Name

Type

Description

nqn

string

The host NQN.

zapp_nvme_components_subsystem

components.subsystem

Name	Type	Description
hosts	array[hosts]
name	string	The name of the subsystem accessing the component. If neither the name nor the UUID is provided, the name defaults to <application-name>_<component-name>, whether that subsystem already exists or not.
os_type	string	The name of the host OS accessing the component. The default value is the host OS that is running the application.
uuid	string	The UUID of an existing subsystem to be granted access to the component. Usage: <UUID>

Name

Type

Description

hosts

array[hosts]

name

string

The name of the subsystem accessing the component. If neither the name nor the UUID is provided, the name defaults to <application-name>_<component-name>, whether that subsystem already exists or not.

os_type

string

The name of the host OS accessing the component. The default value is the host OS that is running the application.

uuid

string

The UUID of an existing subsystem to be granted access to the component. Usage: <UUID>

zapp_nvme_components_tiering

application-components.tiering

Name	Type	Description
control	string	Storage tiering placement rules for the container(s)
object_stores	array[object_stores]
policy	string	The storage tiering type of the application component.

Name

Type

Description

control

string

Storage tiering placement rules for the container(s)

object_stores

array[object_stores]

policy

string

The storage tiering type of the application component.

components

Name	Type	Description
name	string	The name of the application component.
namespace_count	integer	The number of namespaces in the component
performance	performance
subsystem	zapp_nvme_components_subsystem	components.subsystem
tiering	zapp_nvme_components_tiering	application-components.tiering
total_size	integer	The total size of the component, spread across member namespaces. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}

Name

Type

Description

name

string

The name of the application component.

namespace_count

integer

The number of namespaces in the component

performance

subsystem

zapp_nvme_components_subsystem

components.subsystem

tiering

zapp_nvme_components_tiering

application-components.tiering

total_size

integer

The total size of the component, spread across member namespaces. Usage: {<integer>[KB|MB|GB|TB|PB]}

local

Name	Type	Description
name	string	The local rpo of the application.
policy	string	The snapshot policy to apply to each volume in the smart container. This property is only supported for smart containers. Usage: <snapshot policy>

Name

Type

Description

name

string

The local rpo of the application.

policy

string

The snapshot policy to apply to each volume in the smart container. This property is only supported for smart containers. Usage: <snapshot policy>

rpo

Name	Type	Description
local	local

Name

Type

Description

local

zapp_nvme

An NVME application.

Name	Type	Description
components	array[components]
os_type	string	The name of the host OS running the application.
rpo	rpo

Name

Type

Description

components

array[components]

os_type

string

The name of the host OS running the application.

rpo

storage_service

Name	Type	Description
name	string	The storage service of the archive log.

Name

Type

Description

name

string

The storage service of the archive log.

archive_log

Name	Type	Description
size	integer	The size of the archive log. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

size

integer

The size of the archive log. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

db

Name	Type	Description
size	integer	The size of the database. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

size

integer

The size of the database. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

Name	Type	Description
name	string	The storage service of the ORACLE_HOME storage volume.

Name

Type

Description

name

string

The storage service of the ORACLE_HOME storage volume.

ora_home

Name	Type	Description
size	integer	The size of the ORACLE_HOME storage volume. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

size

integer

The size of the ORACLE_HOME storage volume. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

Name	Type	Description
name	string	The storage service of the redo log group.

Name

Type

Description

name

string

The storage service of the redo log group.

redo_log

Name	Type	Description
mirrored	boolean	Specifies whether the redo log group should be mirrored.
size	integer	The size of the redo log group. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

mirrored

boolean

Specifies whether the redo log group should be mirrored.

size

integer

The size of the redo log group. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

oracle_on_nfs

Oracle using NFS.

Name	Type	Description
archive_log	archive_log
db	db
nfs_access	array[app_nfs_access]	The list of NFS access controls.
ora_home	ora_home
protection_type	protection_type
redo_log	redo_log

Name

Type

Description

archive_log

db

nfs_access

array[app_nfs_access]

The list of NFS access controls.

ora_home

protection_type

redo_log

oracle_on_san_new_igroups

The list of initiator groups to create.

Name	Type	Description
initiators	array[string]
name	string	The name of the new initiator group.
os_type	string	The name of the host OS accessing the application. The default value is the host OS that is running the application.
protocol	string	The protocol of the new initiator group.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

oracle_on_san

Oracle using SAN.

Name	Type	Description
archive_log	archive_log
db	db
igroup_name	string	The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.
new_igroups	array[oracle_on_san_new_igroups]	The list of initiator groups to create.
ora_home	ora_home
os_type	string	The name of the host OS running the application.
protection_type	protection_type
redo_log	redo_log

Name

Type

Description

archive_log

db

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

new_igroups

array[oracle_on_san_new_igroups]

The list of initiator groups to create.

ora_home

os_type

string

The name of the host OS running the application.

protection_type

redo_log

storage_service

Name	Type	Description
name	string	The storage service of the Oracle grid binary storage volume.

Name

Type

Description

name

string

The storage service of the Oracle grid binary storage volume.

grid_binary

Name	Type	Description
size	integer	The size of the Oracle grid binary storage volume. Usage: {<integer>[KB\|MB\|GB\|TB\|PB]}
storage_service	storage_service

Name

Type

Description

size

integer

The size of the Oracle grid binary storage volume. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

Name

Type

Description

name

string

The storage service of the Oracle CRS volume.

oracle_crs

Name

Type

Description

copies

integer

The number of CRS volumes.

size

integer

The size of the Oracle CRS/voting storage volume. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

oracle_rac_on_nfs

Oracle RAC using NFS.

Name

Type

Description

archive_log

db

grid_binary

nfs_access

array[app_nfs_access]

The list of NFS access controls.

ora_home

oracle_crs

protection_type

redo_log

db_sids

Name

Type

Description

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

oracle_rac_on_san_new_igroups

The list of initiator groups to create.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

oracle_rac_on_san

Oracle RAC using SAN.

Name

Type

Description

archive_log

db

db_sids

array[db_sids]

grid_binary

new_igroups

array[oracle_rac_on_san_new_igroups]

The list of initiator groups to create.

ora_home

oracle_crs

os_type

string

The name of the host OS running the application.

protection_type

redo_log

local

Name

Type

Description

description

string

A detailed description of the local RPO. This will include details about the Snapshot copy schedule.

name

string

The local RPO of the component. This indicates how often component Snapshot copies are automatically created.

remote

Name

Type

Description

description

string

A detailed description of the remote RPO.

name

string

The remote RPO of the component. A remote RPO of zero indicates that the component is synchronously replicated to another cluster.

rpo

Name

Type

Description

local

remote

components

Name

Type

Description

name

string

Component Name.

rpo

uuid

string

Component UUID.

local

Name

Type

Description

description

string

A detailed description of the local RPO. This will include details about the Snapshot copy schedule.

name

string

The local RPO of the application. This indicates how often application Snapshot copies are automatically created.

remote

Name

Type

Description

description

string

A detailed description of the remote RPO.

name

string

The remote RPO of the application. A remote RPO of zero indicates that the application is synchronously replicated to another cluster.

rpo

Name

Type

Description

components

array[components]

is_supported

boolean

Is RPO supported for this application? Generation 1 applications did not support Snapshot copies or MetroCluster.

local

remote

san_application_components_tiering

application-components.tiering

Name

Type

Description

control

string

Storage tiering placement rules for the container(s)

object_stores

array[object_stores]

policy

string

The storage tiering type of the application component.

application_components

Name

Type

Description

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

lun_count

integer

The number of LUNs in the application component.

name

string

The name of the application component.

storage_service

tiering

san_application_components_tiering

application-components.tiering

total_size

integer

The total size of the application component, split across the member LUNs. Usage: {<integer>[KB|MB|GB|TB|PB]}

san_new_igroups

The list of initiator groups to create.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

san

A generic SAN application.

Name

Type

Description

application_components

array[application_components]

new_igroups

array[san_new_igroups]

The list of initiator groups to create.

os_type

string

The name of the host OS running the application.

protection_type

storage_service

Name

Type

Description

name

string

The storage service of the DB.

db

Name

Type

Description

size

integer

The size of the DB. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

Name

Type

Description

name

string

The storage service of the log DB.

log

Name

Type

Description

size

integer

The size of the log DB. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

sql_on_san_new_igroups

The list of initiator groups to create.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

os_type

string

The name of the host OS accessing the application. The default value is the host OS that is running the application.

protocol

string

The protocol of the new initiator group.

storage_service

Name

Type

Description

name

string

The storage service of the temp DB.

temp_db

Name

Type

Description

size

integer

The size of the temp DB. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

sql_on_san

Microsoft SQL using SAN.

Name

Type

Description

db

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

log

new_igroups

array[sql_on_san_new_igroups]

The list of initiator groups to create.

os_type

string

The name of the host OS running the application.

protection_type

server_cores_count

integer

The number of server cores for the DB.

temp_db

access

Name

Type

Description

installer

string

SQL installer admin user name.

service_account

string

SQL service account user name.

sql_on_smb

Microsoft SQL using SMB.

Name

Type

Description

access

db

log

protection_type

server_cores_count

integer

The number of server cores for the DB.

temp_db

iops

Name

Type

Description

per_tb

integer

The number of IOPS per terabyte of logical space currently being used by the application component.

total

integer

The total number of IOPS being used by the application component.

latency

Name

Type

Description

average

integer

The cumulative average response time in microseconds for this component.

raw

integer

The cumulative response time in microseconds for this component.

snapshot

Name

Type

Description

reserve

integer

The amount of space reserved by the system for Snapshot copies.

used

integer

The amount of spacing currently in use by the system to store Snapshot copies.

space

Name

Type

Description

available

integer

The available amount of space left in the application component. Note that this field has limited meaning for SAN applications. Space may be considered used from ONTAP's perspective while the host filesystem still considers it available.

readOnly: 1

logical_used

integer

The amount of space that would currently be used if no space saving features were enabled. For example, if compression were the only space saving feature enabled, this field would represent the uncompressed amount of space used.

provisioned

integer

The originally requested amount of space that was provisioned for the application component.

reserved_unused

integer

The amount of space reserved for system features such as Snapshot copies that has not yet been used.

savings

integer

The amount of space saved by all enabled space saving features.

used

integer

The amount of space that is currently being used by the application component. Note that this includes any space reserved by the system for features such as Snapshot copies.

used_excluding_reserves

integer

The amount of space that is currently being used, excluding any space that is reserved by the system for features such as Snapshot copies.

used_percent

integer

The percentage of the originally provisioned space that is currently being used by the application component.

storage_service

Name

Type

Description

name

string

The storage service name. AFF systems support the extreme storage service. All other systems only support value.

uuid

string

The storage service UUID.

components

Name

Type

Description

iops

latency

name

string

Component Name.

shared_storage_pool

boolean

An application component is considered to use a shared storage pool if storage elements for for other components reside on the same aggregate as storage elements for this component.

snapshot

space

statistics_incomplete

boolean

If not all storage elements of the application component are currently available, the returned statistics might only include data from those elements that were available.

storage_service

uuid

string

Component UUID.

iops

Name

Type

Description

per_tb

integer

The number of IOPS per terabyte of logical space currently being used by the application.

total

integer

The total number of IOPS being used by the application.

latency

Name

Type

Description

average

integer

The cumulative average response time in microseconds for this application.

raw

integer

The cumulative response time in microseconds for this application.

space

Name

Type

Description

available

integer

The available amount of space left in the application. Note that this field has limited meaning for SAN applications. Space may be considered used from ONTAP's perspective while the host filesystem still considers it available.

readOnly: 1

logical_used

integer

The amount of space that would currently be used if no space saving features were enabled. For example, if compression were the only space saving feature enabled, this field would represent the uncompressed amount of space used.

provisioned

integer

The originally requested amount of space that was provisioned for the application.

reserved_unused

integer

The amount of space reserved for system features such as Snapshot copies that has not yet been used.

savings

integer

The amount of space saved by all enabled space saving features.

used

integer

The amount of space that is currently being used by the application. Note that this includes any space reserved by the system for features such as Snapshot copies.

used_excluding_reserves

integer

The amount of space that is currently being used, excluding any space that is reserved by the system for features such as Snapshot copies.

used_percent

integer

The percentage of the originally provisioned space that is currently being used by the application.

statistics

Name

Type

Description

components

array[components]

iops

latency

shared_storage_pool

boolean

An application is considered to use a shared storage pool if storage elements for multiple components reside on the same aggregate.

snapshot

space

statistics_incomplete

boolean

If not all storage elements of the application are currently available, the returned statistics might only include data from those elements that were available.

svm

Name

Type

Description

name

string

SVM Name. Either the SVM name or UUID must be provided to create an application.

uuid

string

SVM UUID. Either the SVM name or UUID must be provided to create an application.

self_link

Name

Type

Description

self

href

template

Name

Type

Description

_links

self_link

name

string

The name of the template that was used to provision this application.

protocol

string

The protocol access of the template that was used to provision this application.

version

integer

The version of the template that was used to provision this application. The template version changes only if the layout of the application changes over time. For example, redo logs in Oracle RAC templates were updated and provisioned differently in DATA ONTAP 9.3.0 compared to prior releases, so the version number was increased. If layouts change in the future, the changes will be documented along with the corresponding version numbers.

readOnly: 1

storage_service

Name

Type

Description

name

string

The storage service of the desktops.

desktops

Name

Type

Description

count

integer

The number of desktops to support.

size

integer

The size of the desktops. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

hyper_v_access

Name

Type

Description

service_account

string

Hyper-V service account.

vdi_on_nas

A VDI application using NAS.

Name

Type

Description

desktops

hyper_v_access

nfs_access

array[app_nfs_access]

The list of NFS access controls.

protection_type

vdi_on_san_new_igroups

The list of initiator groups to create.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

protocol

string

The protocol of the new initiator group.

vdi_on_san

A VDI application using SAN.

Name

Type

Description

desktops

hypervisor

string

The name of the hypervisor hosting the application.

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

new_igroups

array[vdi_on_san_new_igroups]

The list of initiator groups to create.

protection_type

storage_service

Name

Type

Description

name

string

The storage service of the datastore.

datastore

Name

Type

Description

count

integer

The number of datastores to support.

size

integer

The size of the datastore. Usage: {<integer>[KB|MB|GB|TB|PB]}

storage_service

vsi_on_nas

A VSI application using NAS.

Name

Type

Description

datastore

hyper_v_access

nfs_access

array[app_nfs_access]

The list of NFS access controls.

protection_type

vsi_on_san_new_igroups

The list of initiator groups to create.

Name

Type

Description

initiators

array[string]

name

string

The name of the new initiator group.

protocol

string

The protocol of the new initiator group.

vsi_on_san

A VSI application using SAN.

Name

Type

Description

datastore

hypervisor

string

The name of the hypervisor hosting the application.

igroup_name

string

The name of the initiator group through which the contents of this application will be accessed. Modification of this parameter is a disruptive operation. All LUNs in the application component will be unmapped from the current igroup and re-mapped to the new igroup.

new_igroups

array[vsi_on_san_new_igroups]

The list of initiator groups to create.

protection_type

application

Applications

Name

Type

Description

_links

creation_timestamp

string

The time when the application was created.

generation

integer

The generation number of the application. This indicates which features are supported on the application. For example, generation 1 applications do not support Snapshot copies. Support for Snapshot copies was added at generation 2. Any future generation numbers and their feature set will be documented.

maxdata_on_san

MAX Data application using SAN.

mongo_db_on_san

MongoDB using SAN.

name

string

Application Name. This field is user supplied when the application is created.

nas

A generic NAS application.

nvme

zapp_nvme

An NVME application.

oracle_on_nfs

Oracle using NFS.

oracle_on_san

Oracle using SAN.

oracle_rac_on_nfs

Oracle RAC using NFS.

oracle_rac_on_san

Oracle RAC using SAN.

protection_granularity

string

Protection granularity determines the scope of Snapshot copy operations for the application. Possible values are "application" and "component". If the value is "application", Snapshot copy operations are performed on the entire application. If the value is "component", Snapshot copy operations are performed separately on the application components.

rpo

san

A generic SAN application.

smart_container

boolean

Identifies if this is a smart container or not.

sql_on_san

Microsoft SQL using SAN.

sql_on_smb

Microsoft SQL using SMB.

state

string

The state of the application. For full functionality, applications must be in the online state. Other states indicate that the application is in a transient state and not all operations are supported.

statistics

svm

template

uuid

string

Application UUID. This field is generated when the application is created.

vdi_on_nas

A VDI application using NAS.

vdi_on_san

A VDI application using SAN.

vsi_on_nas

A VSI application using NAS.

vsi_on_san

A VSI application using SAN.

error_arguments

Name

Type

Description

code

string

Argument code

message

string

Message argument

error

Name

Type

Description

arguments

array[error_arguments]

Message arguments

code

string

Error code

message

string

Error message

target

string

The target parameter that caused the error.

Retrieve applications

Creating your file...

Expensive properties

Query examples

Learn more

Parameters

Response

Error

Definitions