Sign in

v1

latestOpenAPI 3.0.0Apache 2.02026-07-17524793.1 KB
FileShare

Update a fileshare.

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

Request body

Descriptionstring

The fileshare name specified by user, - Optional

Sizeinteger

The fileshare size, - Optional

Encryptedboolean

Flag for encryted fileshare, - Optional

EncryptedSettingsobject

Encryted fileshare Keys, - Optional

Metadataobject

Metadata for cloud backend specific data, - Required

Example request

{
  "Description": "AWS FileShare",
  "Size": 1073741824,
  "Tags": [
    {
      "key": "Name",
      "Value": "soda"
    }
  ],
  "Encrypted": true,
  "EncryptedSettings": {
    "KmsKeyId": "arn:aws:kms:ap-south-1:676589967111:key/a6e1716e-0e90-407b-b494-b8ef8de91fc"
  },
  "Metadata": {
    "PerformanceMode": "maxIO",
    "ThroughputMode": "provisioned",
    "ProvisionedThroughputInMibps": 1
  }
}

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"
        }
      }
    }
  }
}