リソースと属性の説明

用途

describeコマンドは、Exascaleリソースとその属性に関する情報を表示します。

構文

describe { resource-spec | --all } [ --detail ]

コマンド・オプション

describeコマンドのオプションは、次のとおりです:

resource-spec: 次のように、特定のExascaleリソースとその属性に関する情報を表示するようにコマンドに指示します:
- resource-spec値は、大/小文字が区別されません。
  
  したがって、次のコマンドは機能的に同等です:
```
@> describe vaults
```
```
@> describe VAULTS
```
```
@> describe vAUltS
```
- リソース名は、単数形または複数形で指定できます。
  
  したがって、次のコマンドは機能的に同等です:
```
@> describe vault
```
```
@> describe vaults
```
- 完全なリソース名(単数形または複数形)を指定した場合、出力には指定されたリソースのすべての属性が含まれます。
- ワイルドカード(*)を使用してリソース名を指定した場合、出力にはパターンと一致するすべてのリソースが含まれます。
  
  たとえば、次のコマンドでは、文字'v'で始まるリソース(vaults、volumesなど)がすべて表示されます:
```
@> describe v*
```
- 属性名を(<resource>.<attribute>という表記を使用して)指定した場合、出力には指定した属性が表示されます。
  
  次に例を示します:
```
@> describe vaults.name
```
- ワイルドカード(*)を使用して属性名を指定した場合、出力にはパターンと一致するすべての属性が含まれます。
  
  たとえば、次のコマンドでは、'v'で始まるすべてのリソースの'n'で始まるすべての属性が表示されます:
```
@> describe v*.n*
```
- resource-specが'mk'で始まる場合、出力には、リソース作成時に初期化可能な属性(initializable != false)のみが含まれます。
  
  たとえば、次のコマンドでは、ファイル作成時に初期化可能なすべての属性が表示されます:
```
@> describe mkfiles
```
  次のオプションを使用して、出力をさらに絞り込むことができます:
  - --mandatory: リソース作成時に初期化する必要がある必須属性(initializable = Mandatory)のみを表示します。次に例を示します:
```
@> describe mkfiles --mandatory
```
  - --optional: リソース作成時に初期化できるオプション属性(initializable = Optional)のみを表示します。
```
@> describe mkfiles --optional
```
- resource-specが'ch'で始まる場合、出力には、既存のリソースの変更可能な属性(modifiable = true)のみが含まれます。
  
  たとえば、次のコマンドでは、既存のファイルの変更できる属性が表示されます:
```
@> describe chfiles
```
--all: すべてのExascaleリソースに関する情報を表示するようにコマンドに指示します。
--detail: オプションで、デフォルトの表形式出力を使用するかわりに、値が別々の行に表示されるようにコマンド出力を書式設定します。