Skip to main content
A newer release of this product is available.

Retrieve an application component

Contributors

GET /application/applications/{application.uuid}/components/{uuid}

Introduced In: 9.6

Retrieves an application component.

Overview

The application component object exposes how to access an application. Most application interfaces abstract away the underlying ONTAP storage elements, but this interface exposes what is necessary to connect to and uses the storage that is provisioned for an application. See the application component model for a detailed description of each property.

Access

Each application component can be accessed via NFS, CIFS, or SAN. NFS and CIFS access can be enabled simultaneously. Each access section includes a backing_storage property. This property is used to correlate the storage elements with the access elements of the application. The backing_storage portion of the access section provides the type and uuid of the backing storage. There is another backing_storage property at the same level as the access properties which contains lists of backing storage elements corresponding to the types listed in the access section.

Learn more

Parameters

Name Type In Required Description

application.uuid

string

path

True

Application UUID

uuid

string

path

True

Application component UUID

fields

array[string]

query

False

Specify the fields to return.

Response

Status: 200, Ok
Name Type Description

_links

_links

application

application

backing_storage

application_backing_storage

cifs_access

array[application_cifs_properties]

file_system

string

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

host_management_url

string

Host management URL

host_name

string

L2 Host FQDN

name

string

Application component name

nfs_access

array[application_nfs_properties]

nvme_access

array[application_nvme_access]

protection_groups

array[application_protection_groups]

san_access

array[application_san_access]

storage_service

storage_service

svm

svm

uuid

string

The application component UUID. Valid in URL.

Example response
{
  "_links": {
    "self": {
      "href": "/api/resourcelink"
    }
  },
  "application": {
    "_links": {
      "self": {
        "href": "/api/resourcelink"
      }
    },
    "name": "string",
    "uuid": "string"
  },
  "backing_storage": {
    "luns": [
      {
        "creation_timestamp": "string",
        "path": "string",
        "size": 0,
        "uuid": "string"
      }
    ],
    "namespaces": [
      {
        "_links": {
          "self": {
            "href": "/api/resourcelink"
          }
        },
        "creation_timestamp": "string",
        "name": "string",
        "size": 0,
        "uuid": "string"
      }
    ],
    "volumes": [
      {
        "creation_timestamp": "string",
        "name": "string",
        "size": 0,
        "uuid": "string"
      }
    ]
  },
  "cifs_access": [
    {
      "backing_storage": {
        "type": "string",
        "uuid": "string"
      },
      "ips": [
        "string"
      ],
      "path": "string",
      "permissions": [
        {
          "access": "string",
          "user_or_group": "string"
        }
      ],
      "server": {
        "name": "string"
      },
      "share": {
        "name": "string"
      }
    }
  ],
  "file_system": "string",
  "host_management_url": "string",
  "host_name": "string",
  "name": "string",
  "nfs_access": [
    {
      "backing_storage": {
        "type": "string",
        "uuid": "string"
      },
      "export_policy": {
        "name": "string"
      },
      "ips": [
        "string"
      ],
      "path": "string",
      "permissions": [
        {
          "access": "string",
          "host": "string"
        }
      ]
    }
  ],
  "nvme_access": [
    {
      "backing_storage": {
        "type": "string",
        "uuid": "string"
      },
      "subsystem_map": {
        "anagrpid": "string",
        "nsid": "string",
        "subsystem": {
          "_links": {
            "self": {
              "href": "/api/resourcelink"
            }
          },
          "hosts": [
            {
              "_links": {
                "self": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                }
              },
              "nqn": "string"
            }
          ],
          "name": "string",
          "uuid": "string"
        }
      }
    }
  ],
  "protection_groups": [
    {
      "name": "string",
      "rpo": {
        "local": {
          "description": "string",
          "name": "string"
        },
        "remote": {
          "description": "string",
          "name": "string"
        }
      },
      "uuid": "string"
    }
  ],
  "san_access": [
    {
      "backing_storage": {
        "type": "string",
        "uuid": "string"
      },
      "lun_mappings": [
        {
          "fcp": [
            {
              "interface": {
                "_links": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                },
                "name": "fc_lif1",
                "uuid": "3a09ab42-4da1-32cf-9d35-3385a6101a0b",
                "wwpn": "20:00:00:50:56:b4:13:a8"
              }
            }
          ],
          "igroup": {
            "initiators": [
              "string"
            ],
            "name": "string",
            "uuid": "string"
          },
          "iscsi": [
            {
              "_links": {
                "self": {
                  "href": "/api/resourcelink"
                }
              },
              "interface": {
                "_links": {
                  "self": {
                    "href": "/api/resourcelink"
                  }
                },
                "ip": {
                  "address": "10.10.10.7"
                },
                "name": "lif1",
                "uuid": "1cd8a442-86d1-11e0-ae1c-123478563412"
              },
              "port": 3260
            }
          ],
          "lun_id": 0
        }
      ],
      "serial_number": "string"
    }
  ],
  "storage_service": {
    "name": "string",
    "uuid": "string"
  },
  "svm": {
    "name": "string",
    "uuid": "string"
  },
  "uuid": "string"
}

Error

Status: Default, Error
Name Type Description

error

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

self

href

application

Name Type Description

_links

_links

name

string

Application name

uuid

string

The application UUID. Valid in URL.

application_lun_object

LUN object

Name Type Description

creation_timestamp

string

LUN creation time

path

string

LUN path

size

integer

LUN size

uuid

string

LUN UUID

application_namespace_object

Namespace object

Name Type Description

_links

_links

creation_timestamp

string

Namespace creation time

name

string

Namespace name

size

integer

Namespace size

uuid

string

Namespace UUID

application_volume_object

Volume object

Name Type Description

creation_timestamp

string

Creation time

name

string

Name

size

integer

Size

uuid

string

UUID

application_backing_storage

Name Type Description

luns

array[application_lun_object]

namespaces

array[application_namespace_object]

volumes

array[application_volume_object]

backing_storage

Name Type Description

type

string

Backing storage type

uuid

string

Backing storage UUID

permissions

Name Type Description

access

string

Access granted to the user or group

user_or_group

string

User or group

server

Name Type Description

name

string

Server name

share

Name Type Description

name

string

Share name

application_cifs_properties

Name Type Description

backing_storage

backing_storage

ips

array[string]

path

string

Junction path

permissions

array[permissions]

server

server

share

share

export_policy

Name Type Description

name

string

Export policy name

permissions

Name Type Description

access

string

Access granted to the host

host

string

Host granted access

application_nfs_properties

Name Type Description

backing_storage

backing_storage

export_policy

export_policy

ips

array[string]

path

string

Junction path

permissions

array[permissions]

self

Name Type Description

self

href

Name Type Description

self

self

hosts

Name Type Description

_links

_links

nqn

string

Host

subsystem

Name Type Description

_links

_links

hosts

array[hosts]

name

string

Subsystem name

uuid

string

Subsystem UUID

subsystem_map

Subsystem map object

Name Type Description

anagrpid

string

Subsystem ANA group ID

nsid

string

Subsystem namespace ID

subsystem

subsystem

application_nvme_access

Application NVME access

Name Type Description

backing_storage

backing_storage

is_clone

boolean

Clone

subsystem_map

subsystem_map

Subsystem map object

local

Name Type Description

description

string

A detailed description of the local RPO. This includes details on 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

local

remote

remote

application_protection_groups

Name Type Description

name

string

Protection group name

rpo

rpo

uuid

string

Protection group UUID

fc_interface_reference

An FC interface.

Name Type Description

_links

_links

name

string

The name of the FC interface.

uuid

string

The unique identifier of the FC interface.

wwpn

string

The WWPN of the FC interface.

application_san_access_fcp_endpoint

A Fibre Channel Protocol (FCP) access endpoint for the LUN.

Name Type Description

interface

fc_interface_reference

An FC interface.

igroup

Name Type Description

initiators

array[string]

name

string

Igroup name

uuid

string

Igroup UUID

ip

IP information

Name Type Description

address

string

IPv4 or IPv6 address

interface

Name Type Description

_links

_links

ip

ip

IP information

name

string

The name of the interface. If only the name is provided, the SVM scope must be provided by the object this object is embedded in.

uuid

string

The UUID that uniquely identifies the interface.

application_san_access_iscsi_endpoint

An iSCSI access endpoint for the LUN.

Name Type Description

_links

_links

interface

interface

port

integer

The TCP port number of the iSCSI access endpoint.

application_lun_mapping_object

Name Type Description

fcp

array[application_san_access_fcp_endpoint]

All possible Fibre Channel Protocol (FCP) access endpoints for the LUN.

igroup

igroup

iscsi

array[application_san_access_iscsi_endpoint]

All possible iSCSI access endpoints for the LUN.

lun_id

integer

LUN ID

application_san_access

Name Type Description

backing_storage

backing_storage

is_clone

boolean

Clone

lun_mappings

array[application_lun_mapping_object]

serial_number

string

LUN serial number

storage_service

Name Type Description

name

string

Storage service name

uuid

string

Storage service UUID

svm

Name Type Description

name

string

SVM name

uuid

string

SVM UUID

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.