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	Project ID
share_id	Yes	String	File system ID

Request Parameters

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

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
action_progress	ActionProgress object	Task progress of the SFS Turbo file system. For example, the file system creation progress.
version	String	Version of an SFS Turbo file system
avail_capacity	String	Available capacity of the SFS Turbo file system, in GB
availability_zone	String	Code of the AZ where the SFS Turbo file system resides
az_name	String	Name of the AZ where the SFS Turbo file system resides
created_at	String	Time when the file system was created. UTC time, for example: 2018-11-19T04:02:03
crypt_key_id	String	ID of the encryption key specified by the user. This parameter is not returned for non-encrypted file systems.
expand_type	String	File system extension type. If the requested file system is an enhanced file system, bandwidth will be returned. Or, this parameter is not returned.
export_location	String	Location where the SFS Turbo file system is mounted
id	String	ID of the SFS Turbo file system
name	String	Name of the SFS Turbo file system specified during creation
pay_model	String	Billing mode of the SFS Turbo file system. Value 0 indicates pay-per-use, and 1 indicates yearly/monthly subscription. Enumeration values: 0 1
region	String	Region where the SFS Turbo file system resides
security_group_id	String	ID of the security group specified by the user
share_proto	String	Protocol used by the SFS Turbo file system. The valid value is NFS.
share_type	String	Storage class of the SFS Turbo file system. The valid values are STANDARD and PERFORMANCE.
size	String	Total capacity of the SFS Turbo file system, in GB
status	String	Status of the SFS Turbo file system. The value can be as follows: 100 (creating), 200 (available), 400 (deleted), and 303 (creation failed).
sub_status	String	Sub-status of the SFS Turbo file system. The value can be as follows: 121 (expanding), 221 (expansion succeeded), and 321 (expansion failed).
subnet_id	String	ID of the subnet specified by the user
vpc_id	String	ID of the VPC specified by the user

**Table 4** ActionProgress
Parameter	Type	Description
CREATING	String	File system creation progress

Example Requests

None

Example Responses

Status code: 200

Response body for querying a file system

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