Sign in

v1

latestOpenAPI 3.0.0Apache 2.02026-07-17504188.8 KB
FileShare

Get a fileshare information.

get/v1/{tenantId}/file/share/{id}

Response

successful operation

Idstring

The fileshare ID, generated by server

CreatedAtstring

The time of creation of the fileshare.

UpdatedAtstring

The time at which the fileshare was updated.

TenantIdstring

The tenant UUID in a multi-tenancy environment.

UserIdstring

The user UUID in a multi-tenancy environment.

BackendIdstring

The backend ID

Backendstring

The backend Name.

Namestring

The fileshare name specified by user.

Descriptionstring

The fileshare description specified by user.

Typestring

The fileshare type.

Sizeinteger

The fileshare size.

Regionstring

The region for the fileshare.

AvailabilityZonestring

The availability zone for the fileshare.

Status'available' | 'creating' | 'inUse' | 'error' | 'updating' | 'deleting' | 'errorDeleting' | 'deleted'

The fileshare status.

Protocols'NFS' | 'SMB'

The fileshare supported protocols.

SnapshotIdstring

The fileshare snapshot id.

Encryptedboolean

Flag for encryted fileshare.

EncryptedSettingsobject

Encryted fileshare Keys.

Example response

{
  "Id": "5ef1db51202b510001c3804c",
  "CreatedAt": "2020-06-23T16:07:05",
  "UpdatedAt": "2020-06-23T16:07:05",
  "TenantId": "94b280022d0c4401bcf3b0ea85870519",
  "UserId": "5ea809d2553b0f000116be32",
  "BackendId": "5ea809d2553b0f000116be32",
  "Backend": "backend001",
  "Name": "fileshare001",
  "Description": "AWS FileShare",
  "Type": "generalPurpose",
  "Size": 1073741824,
  "Region": "ap-south-1",
  "AvailabilityZone": "ap-south-1a",
  "Status": "available",
  "Tags": [
    {
      "key": "Name",
      "Value": "soda"
    }
  ],
  "SnapshotId": "5eea749a926e5300011a69d6",
  "Encrypted": true,
  "EncryptedSettings": {
    "KmsKeyId": "arn:aws:kms:ap-south-1:676589967111:key/a6e1716e-0e90-407b-b494-b8ef8de91fc"
  },
  "Metadata": {
    "fields": {
      "CreationTimeAtBackend": {
        "kind": {
          "StringValue": "2020-06-17T19:44:06Z"
        }
      },
      "CreationToken": {
        "kind": {
          "StringValue": "J7UWp#KX7BPi#zC5]{0j2/I54ukWP?j~[d3H"
        }
      },
      "FileSystemId": {
        "kind": {
          "StringValue": "fs-68e26cb9"
        }
      },
      "FileSystemSize": {
        "kind": {
          "StructValue": {
            "fields": {
              "Value": {
                "kind": {
                  "NumberValue": 6144
                }
              },
              "ValueInStandard": {
                "kind": {
                  "NumberValue": 6144
                }
              }
            }
          }
        }
      },
      "LifeCycleState": {
        "kind": {
          "StringValue": "available"
        }
      },
      "Name": {
        "kind": {
          "StringValue": "sodafs"
        }
      },
      "OwnerId": {
        "kind": {
          "StringValue": "676599967111"
        }
      },
      "PerformanceMode": {
        "kind": {
          "StringValue": "maxIO"
        }
      },
      "ProvisionedThroughputInMibps": {
        "kind": {
          "NumberValue": 1
        }
      },
      "ThroughputMode": {
        "kind": {
          "StringValue": "provisioned"
        }
      }
    }
  }
}