Querying Details About a File System

Function

This API is used to query details about an SFS Turbo file system.

URI

GET /v1/{project_id}/sfs-turbo/shares/{share_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	The project ID.
share_id	Yes	String	The file system ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	The account token.
Content-Type	Yes	String	The MIME type.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
action_progress	ActionProgress object	The file system creation progress. This field is only returned when the file system is being created.
version	String	The file system version.
avail_capacity	String	The available capacity of the file system, in GB.
availability_zone	String	The code of the AZ where the file system resides.
az_name	String	The name of the AZ where the file system resides.
created_at	String	The time when the file system was created. UTC time, for example: 2018-11-19T04:02:03.
crypt_key_id	String	The ID of the encryption key. This parameter is not returned for non-encrypted file systems.
expand_type	String	The extension type. bandwidth is returned if the requested file system is an Enhanced file system. The value can be: bandwidth
export_location	String	The file system location, for example, 192.168.0.90:/. This field is not returned when the file system is being created.
id	String	The file system ID.
name	String	The file system name specified during creation.
pay_model	String	The file system billing mode. Value 0 indicates pay-per-use. This field is not returned when the file system is being created. Enumeration values: 0 1
region	String	The region where the file system resides.
security_group_id	String	The ID of the specified security group.
share_proto	String	The protocol used by the SFS Turbo file system. The value can be NFS.
share_type	String	The file system performance type. Valid values are STANDARD and PERFORMANCE.
size	String	The file system total capacity, in GB.
status	String	The file system status. The value can be as follows: 100 (creating), 200 (available), 303 (creation failed), and 800 (frozen) Enumerated values: 100 200 303 800
sub_status	String	The file system sub-status. This field is not returned if no modification is made to the file system. 121 (expanding capacity), 132 (changing security group) 221 (expansion succeeded), 232 (security group changed) 321 (expansion failed), 332 (changing security group failed)
subnet_id	String	The ID of the specified subnet.
vpc_id	String	The ID of the specified VPC.
tags	Array of ResourceTag objects	The tag list.
optional_endpoint	String	The alternative IP addresses that can be used for mount. This field is not returned for previous-generation file systems.
instanceId	String	The node ID of the file system type, which has no meaning. This is a reserved field.
instanceType	String	The node type of the file system type, which has no meaning. This is a reserved field.
statusDetail	String	The file system request ID, which has no meaning. This is a reserved field.

**Table 4** ActionProgress
Parameter	Type	Description
CREATING	String	The file system creation progress.

**Table 5** ResourceTag
Parameter	Type	Description
key	String	The tag key. It can contain a maximum of 128 characters. It cannot be left empty and cannot contain the following characters: ASCII (0-31), equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (), commas (,), vertical bars (\|), and slashes (/). It can contain only letters, digits, hyphens (-), and underscores (_).
value	String	The tag value. Each tag value can contain a maximum of 255 characters and can be an empty string. It cannot contain the following characters: ASCII (0-31), equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (), commas (,), vertical bars (\|), and slashes (/). It can contain only letters, digits, hyphens (-), and underscores (_).

**Table 6** ShareInfoFeature
Parameter	Type	Description
is_support	Boolean	Whether the file system supports this feature.
message	String	The message.
msg_code	String	The message code.

Example Requests

Querying the file system whose ID is 77ba6f4b-6365-4895-8dda-bc7142af4dde

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde

Example Responses

Status code: 200

Query response body

Listing file systems in the project whose ID is e1e45b08f3ea4480ab4655ef9c7160ba

{
  "id" : "8fba8253-c914-439d-ae8b-d5c89d0bf5e8",
  "name" : "sfs-turbo-8468",
  "status" : "200",
  "version" : "1.0.0",
  "region" : "example",
  "availability_zone" : "example",
  "az_name" : "example",
  "created_at" : "2018-11-19T04:02:03",
  "export_location" : "192.168.xx.xx:/",
  "action_progress" : { },
  "share_type" : "STANDARD",
  "sub_status" : "221",
  "vpc_id" : "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
  "subnet_id" : "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
  "security_group_id" : "50586458-aec9-442c-bb13-e08ddc6f1b7a",
  "size" : "600.00",
  "avail_capacity" : "600.00",
  "pay_model" : "0",
  "share_proto" : "NFS"
}