6.2.9.2 lstemplate

List file templates.

Purpose

The lstemplate command displays information about Exascale file templates that are associated with the vault or the Exascale cluster.

Syntax

lstemplate [ template-name ] 
           [ --vault vault [ --vault-level-only ] | --cluster ] 
           [ -l ] [ --detail ] [ --default ] 
           [ --attributes attribute[,attribute]... ] 
           [ --filter filter[,filter]... ] 
           [ --sort [-]attribute[,[-]attribute]... ]

Command Options

The options for the lstemplate command are:

  • template-name: Optionally limits the output to templates that match the specified template name.

  • --vault: Lists templates associated with the specified vault.

  • --vault-level-only: List only the vault-specific templates associated with the specified vault.

  • --cluster: Lists templates associated with the cluster.

  • -l: Displays output in a long, tabular format.

  • --detail: Displays detailed output with additional attributes.

  • --default: List default configuration details for system-defined templates (templateType=systemType or templateType=oracleFileType).

  • --attributes: Identifies specific attributes to display in the output.

    You can use this option to focus on a subset of attributes as an alternative to the --detail option.

  • --filter: Specifies conditions for including items in the output.

  • --sort: Sorts the output using the specified attributes.

Usage Notes

Note the following information when using this command:

  • If --vault is specified without --vault-level-only, then the output contains all templates affecting the specified vault, including the vault-specific templates and any cluster-level templates not overridden by vault-specific templates.

  • If neither --vault nor --cluster is specified, and the user entered a vault in the ESCLI session, then the output contains all templates affecting the specified vault, including the vault-specific templates and any cluster-level templates not overridden by vault-specific templates.

  • If neither --vault nor --cluster is specified, and the user hasn't entered a vault in the ESCLI session (ESCLI prompt shows @>), then templates associated with the cluster are listed.

  • Filter conditions are specified as: <attribute><operator><value>.

    The allowed operators are =, !=, >=, <=, >, and <.

    Multiple comma-separated filter conditions are combined using AND logic.

    For example, the following filter only includes objects created after 9 AM today:

    --filter createTime>9:00:00

  • Sorting attributes are specified as: [-]attribute. Multiple sort attributes are comma-delimited. The default sort order is ascending. For descending sort order, prefix the attribute name with -.

    For example, use the following to primarily sort by name in descending order, and use creation time in ascending order to further sort entries with the same name:

    --sort -name,createTime

Examples

Example 6-116 List Cluster-Wide Templates

These examples list all templates associated with the cluster.

@> lstemplate
@vault2> lstemplate --cluster

Example 6-117 List Effective Vault-Specific Templates

These examples list the effective templates associated with the vault vault2. The output includes templates associated with the vault, and templates associated with the cluster that are not overridden by vault-specific templates. 

@vault2> lstemplate
@> lstemplate --vault vault2

Example 6-118 List Only Templates Affecting a Vault

This examples lists only the vault-specific templates affecting files in the vault vault2. 

@> lstemplate --vault vault2 --vault-level-only

Example 6-119 List a Specific Cluster-Wide Template

This example displays detailed information about the cluster-wide template named DATAFILE. 

@> lstemplate --detail DATAFILE

Example 6-120 List Default Configuration Information for a Specific Cluster-Wide Template

This example displays default configuration information for the cluster-wide template named DATAFILE. 

@> lstemplate --default DATAFILE

Example 6-121 List Specific Cluster-Wide Templates

This example displays detailed information about the cluster-wide templates with names ending with FILE, whose content type is DATA, and sort the list by names (ascending) and media types (descending). 

@> lstemplate --detail *FILE --sort name,-mediaType --filter contentType=DATA

Parent topic: Template Management