QUERY CONTAINER (Query a container)
Use this command to display information about one or more containers.
Privilege class
Any administrator can issue this command.Syntax
.-*--------------. >>-Query CONTAINER--+-container_name-+--------------------------> .-Format--=--Standard-----. >--+-----------------------+--+-------------------------+-------> '-STGpool--=--pool_name-' '-Format--=--+-Standard-+-' '-Detailed-' .-STate--=--ANY-------------. .-TYPe--=--ANY----------. >--+---------------------------+--+-----------------------+---->< '-STate--=--+-AVAilable---+-' '-TYPe--=--+-NONdedup-+-' +-UNAvailable-+ +-DEDup----+ '-ANY---------' +-CLOud----+ '-ANY------'
Parameters
- container_name (Required)
- Specifies the name of the container. Specify one of the following values:
- *
- Specifies that an asterisk (*) represents a wildcard character. Use wildcard characters such as an asterisk to match any characters. Alternatively, you can use a question mark (?) or a percent sign (%) to match exactly one character. If you specify an asterisk, all container names are displayed. This value is the default.
- container_name
- Specifies the name of the container. The maximum length of the file name is 1024.
- STGpool
- Specifies the name of the directory-container storage pool. This parameter is optional. The maximum length of the storage pool name is 30.
- Format
- Specifies the level of detail of the query results. This parameter is optional. Specify one of
the following values:
- Standard
- Specifies that a summary of the information is displayed. This value is the default.
- Detailed
- Specifies that detailed information is displayed.
- STate
- Specifies the state of the container that is queried. This parameter is optional. Specify one of
the following values:
- AVAilable
- Specifies that only containers that are available are displayed.
- UNAvailable
- Specifies that only containers that are not available are displayed. For example, a container might be unavailable if the header is corrupted or if the container cannot be opened.
- ANY
- Specifies that containers in any state are displayed. This value is the default.
- TYPe
- Specifies the type of container that is queried. This parameter is optional. Specify one of the
following values:
- NONdedup
- Displays containers that contain data that is not deduplicated. This type of data includes metadata, encrypted data, and data that is too small for data deduplication.
- DEDup
- Displays containers that contain deduplicated data.
- CLOud
- Displays containers that are stored in a cloud storage pool.
- ANY
- Displays any type of container. This value is the default.
Example: Display information about a container
See Field descriptions for field
descriptions.
query container /Containers/09/0000000000000943.ncf
Container Storage Container State
Pool Name Type
--------------------------------------- -------------- ------------ ---------
/Containers/09/0000000000000943.ncf STGPOOL1 Non Dedup Available
Example: Display information about a container
See Field descriptions for field
descriptions.
query container C:\abc\00\0000000000000005.ncf
Container Storage Container State
Pool Name Type
---------------------------- -------------- ------------ ---------
C:\abc\00\0000000000000005.dcf STGPOOL1 Non Dedup Available
Example: Display detailed information about a container
Display detailed information about containers that contain deduplicated data in storage pool
STGPOOL1:
query container stgpool=STGPOOL1 type=dedup format=detail
Container: /abc/00/0000000000000001.dcf
Storage Pool Name: STGPOOL1
Container Type: Dedup
State: Available
Maximum size (MB): 40,960
Free Space (MB): 39,700
Approx. Date Last Written: 11/10/2014 15:17:09
Cloud Type:
Cloud URL:
Space Utilized(MB):
Object Count:
Example: Display detailed information about a container
Display detailed information about containers that contain deduplicated data in storage pool
STGPOOL1:
query container stgpool=STGPOOL1 type=dedup format=detail
Container: C:\abc\00\0000000000000001.dcf
Storage Pool Name: STGPOOL1
Container Type: Dedup
State: Available
Maximum size (MB): 40,960
Free Space (MB): 39,700
Approx. Date Last Written: 11/10/2014 15:17:09
Cloud Type:
Cloud URL:
Space Utilized(MB):
Object Count:
Example: Display detailed information about containers that are stored in a cloud storage pool
Display detailed information about containers that are stored in the cloud storage pool
CLOUDPOOL:
query container stgpool=CLOUDPOOL format=detail
Container: 7-64a1261000c811e58e8f005056c00008
Storage Pool Name: CLOUDPOOL
Container Type: Cloud
State:
Free Space(MB):
Maximum Size(MB):
Approx. Date Last Written: 05/22/2015 14:36:57
Cloud Type: SWIFT
Cloud URL: http://cloudurl:5000/v2.0
Space Utilized(MB): 7104
Object Count: 2472
Field descriptions
- Container
- The name of the container.
- Storage pool name
- The name of the storage pool.
- Container type
- The type of container.
- State
- The state of the data in the container. The field can contain one of the following values:
- Available
- The container is available for use.
- Unavailable
- The container cannot be opened or validated.Tip: Issue the AUDIT CONTAINER command to validate the contents of the container.
This field does not apply to containers that are stored in cloud storage pools.
- Maximum size (MB)
- The maximum size of the container, in megabytes.
This field does not apply to containers that are stored in cloud storage pools.
- Free space (MB)
- The total amount of free space that is available in the container, in megabytes.
This field does not apply to containers that are stored in cloud storage pools.
- Approx. date last written
- The approximate date and time that data was written to the container.
- Cloud Type
- If the container is stored in a cloud storage pool, the type of cloud platform.
- Cloud URL
- If the container is stored in a cloud storage pool, the URL for accessing the on-premises private cloud or off-premises public cloud.
- Space Utilized (MB)
- If the container is stored in a cloud storage pool, the amount of space that is used by the container in the on-premises private cloud or off-premises public cloud.
- Object Count
- If the container is stored in a cloud storage pool, the number of objects that are managed by the on-premises private cloud or off-premises public cloud for the container.
Command | Description |
---|---|
AUDIT CONTAINER | Audit a directory-container storage pool. |
MOVE CONTAINER | Moves the contents of a storage pool container to another container. |
QUERY DAMAGED | Displays information about damaged files. |