doc-exports/docs/sfs/api-ref/sfs_02_0025.html

Querying Mount Locations of a Shared File System

Function

This API is used to query mount locations of a shared file system.

This API exists only when X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.9. The following is an example request sent by the curl command: curl -k -i -X GET https://192.168.196.47:8786/v2/13c7ff9a479c4e3599f4331d9e4a1835/shares/2a8c5470-d5d9-4fe1-b9fc-66a15a162e41/export_locations -H "X-Openstack-Manila-Api-Version: 2.9" -H "X-Auth-Token: $token" -H "Accept: application/json"

URI

• GET /v2/{project_id}/shares/{share_id}/export_locations
• Parameter description

  Parameter	Mandatory	Type	Description
  share_id	Yes	String	Specifies the ID of the shared file system.
  project_id	Yes	String	Specifies the project ID of the operator.

Request

• Parameter description

  None

• Example request

  None

Response

• Parameter description

  Parameter	Type	Description
  export_locations	Array of strings	Specifies the list of export locations.

• Description of field export_location

  Parameter	Type	Description
  id	String	Specifies the ID of the mount location of the shared file system.
  share_instance_id	String	Specifies the ID of the shared file system.
  path	String	Specifies the path to which the shared file system will be mounted.
  is_admin_only	Boolean	Specifies whether the shared file system is only visible to administrators and its owner. Possible values are true (only visible to administrators and its owner) and false (visible to all users).
  preferred	Boolean	Identifies which mount locations are most efficient and are used preferentially when multiple mount locations exist.

• Example response
  NFS share:

  {
    "export_locations": [
      {
        "path": "sfs-nas1.dong.com:/share-236b936a",
        "id": "b03d2aac-aeed-409a-af07-5d1b9024241c",
        "preferred": false
      }
    ]
  }

  CIFS share:

  {
    "export_locations": [
      {
        "path": "\\\\sfs-nas1.dong.com\\share-4e76e627",
        "id": "85eb5849-1a89-43ae-99ac-2e781514a228",
        "preferred": false
      }
    ]
  }

Status Codes

• Normal

  200

• Abnormal

  Status Code	Description
  400 Bad Request	The server failed to process the request.
  401 Unauthorized	You must enter a username and the password to access the requested page.
  403 Forbidden	Access to the requested page is forbidden.
  404 Not Found	The requested page was not found.

Parent topic: File Sharing