swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Account Operations API
schemes:
- https
tags:
- name: Account Operations
paths:
  /:
    get:
      operationId: microsoftAzureFilesystemList
      summary: Microsoft Azure List Filesystems
      description: List filesystems and their properties in given account.
      x-ms-pageable:
        itemName: filesystems
        nextLinkName: null
      tags:
      - Account Operations
      responses:
        '200':
          description: OK
          headers:
            Date:
              description: A UTC date/time value generated by the service that indicates the time at which the response was initiated.
              type: string
            x-ms-request-id:
              description: A server-generated UUID recorded in the analytics logs for troubleshooting and correlation.
              pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
              type: string
            x-ms-version:
              description: The version of the REST protocol used to process the request.
              type: string
            x-ms-continuation:
              description: If the number of filesystems to be listed exceeds the maxResults limit, a continuation token is returned in this response header.  When a continuation token is returned in the response, it must be specified in a subsequent invocation of the list operation to continue listing the filesystems.
              type: string
            Content-Type:
              description: The content type of list filesystem response. The default content type is application/json.
              type: string
          schema:
            $ref: '#/definitions/FilesystemList'
        default:
          $ref: '#/responses/ErrorResponse'
      parameters:
      - name: resource
        in: query
        description: The value must be "account" for all account operations.
        required: true
        type: string
        enum:
        - account
        x-ms-enum:
          name: AccountResourceType
          modelAsString: false
      - name: prefix
        in: query
        description: Filters results to filesystems within the specified prefix.
        required: false
        type: string
      - name: continuation
        in: query
        description: The number of filesystems returned with each invocation is limited. If the number of filesystems to be returned exceeds this limit, a continuation token is returned in the response header x-ms-continuation. When a continuation token is  returned in the response, it must be specified in a subsequent invocation of the list operation to continue listing the filesystems.
        required: false
        type: string
      - name: maxResults
        in: query
        description: An optional value that specifies the maximum number of items to return. If omitted or greater than 5,000, the response will include up to 5,000 items.
        format: int32
        minimum: 1
        required: false
        type: integer
      - name: x-ms-client-request-id
        description: A UUID recorded in the analytics logs for troubleshooting and correlation.
        in: header
        pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
        required: false
        type: string
        x-ms-client-request-id: true
      - name: timeout
        in: query
        description: An optional operation timeout value in seconds. The period begins when the request is received by the service. If the timeout value elapses before the operation completes, the operation fails.
        format: int32
        minimum: 1
        required: false
        type: integer
      - name: x-ms-date
        in: header
        description: Specifies the Coordinated Universal Time (UTC) for the request.  This is required when using shared key authorization.
        required: false
        type: string
      - $ref: '#/parameters/Version'
definitions:
  FilesystemList:
    properties:
      filesystems:
        type: array
        items:
          $ref: '#/definitions/Filesystem'
  DataLakeStorageError:
    properties:
      error:
        description: The service error response object.
        properties:
          code:
            description: The service error code.
            type: string
          message:
            description: The service error message.
            type: string
  Filesystem:
    properties:
      name:
        type: string
      lastModified:
        type: string
      eTag:
        type: string
parameters:
  Version:
    description: Specifies the version of the REST protocol used for processing the request. This is required when using shared key authorization.
    in: header
    name: x-ms-version
    required: false
    type: string
    x-ms-parameter-location: client
responses:
  ErrorResponse:
    description: 'An error occurred. The possible HTTP status, code, and message strings are listed below:

      * 400 Bad Request, ContentLengthMustBeZero, "The Content-Length request header must be zero."

      * 400 Bad Request, InvalidAuthenticationInfo, "Authentication information is not given in the correct format. Check the value of Authorization header."

      * 400 Bad Request, InvalidFlushPosition, "The uploaded data is not contiguous or the position query parameter value is not equal to the length of the file after appending the uploaded data."

      * 400 Bad Request, InvalidHeaderValue, "The value for one of the HTTP headers is not in the correct format."

      * 400 Bad Request, InvalidHttpVerb, "The HTTP verb specified is invalid - it is not recognized by the server."

      * 400 Bad Request, InvalidInput, "One of the request inputs is not valid."

      * 400 Bad Request, InvalidPropertyName, "A property name cannot be empty."

      * 400 Bad Request, InvalidPropertyName, "The property name contains invalid characters."

      * 400 Bad Request, InvalidQueryParameterValue, "Value for one of the query parameters specified in the request URI is invalid."

      * 400 Bad Request, InvalidResourceName, "The specified resource name contains invalid characters."

      * 400 Bad Request, InvalidSourceUri, "The source URI is invalid."

      * 400 Bad Request, InvalidUri, "The request URI is invalid."

      * 400 Bad Request, MissingRequiredHeader, "An HTTP header that''s mandatory for this request is not specified."

      * 400 Bad Request, MissingRequiredQueryParameter, "A query parameter that''s mandatory for this request is not specified."

      * 400 Bad Request, MultipleConditionHeadersNotSupported, "Multiple condition headers are not supported."

      * 400 Bad Request, OutOfRangeInput, "One of the request inputs is out of range."

      * 400 Bad Request, OutOfRangeQueryParameterValue, "One of the query parameters specified in the request URI is outside the permissible range."

      * 400 Bad Request, UnsupportedHeader, "One of the headers specified in the request is not supported."

      * 400 Bad Request, UnsupportedQueryParameter, "One of the query parameters specified in the request URI is not supported."

      * 400 Bad Request, UnsupportedRestVersion, "The specified Rest Version is Unsupported."

      * 403 Forbidden, AccountIsDisabled, "The specified account is disabled."

      * 403 Forbidden, AuthorizationFailure, "This request is not authorized to perform this operation."

      * 403 Forbidden, InsufficientAccountPermissions, "The account being accessed does not have sufficient permissions to execute this operation."

      * 404 Not Found, FilesystemNotFound, "The specified filesystem does not exist."

      * 404 Not Found, PathNotFound, "The specified path does not exist."

      * 404 Not Found, RenameDestinationParentPathNotFound, "The parent directory of the destination path does not exist."

      * 404 Not Found, ResourceNotFound, "The specified resource does not exist."

      * 404 Not Found, SourcePathNotFound, "The source path for a rename operation does not exist."

      * 405 Method Not Allowed, UnsupportedHttpVerb, "The resource doesn''t support the specified HTTP verb."

      * 409 Conflict, DestinationPathIsBeingDeleted, "The specified destination path is marked to be deleted."

      * 409 Conflict, DirectoryNotEmpty, "The recursive query parameter value must be true to delete a non-empty directory."

      * 409 Conflict, FilesystemAlreadyExists, "The specified filesystem already exists."

      * 409 Conflict, FilesystemBeingDeleted, "The specified filesystem is being deleted."

      * 409 Conflict, InvalidDestinationPath, "The specified path, or an element of the path, exists and its resource type is invalid for this operation."* 409 Conflict, InvalidFlushOperation, "The resource was created or modified by the Blob Service API and cannot be written to by the Data Lake Storage Service API."

      * 409 Conflict, InvalidRenameSourcePath, "The source directory cannot be the same as the destination directory, nor can the destination be a subdirectory of the source directory."

      * 409 Conflict, InvalidSourceOrDestinationResourceType, "The source and destination resource type must be identical."

      * 409 Conflict, LeaseAlreadyPresent, "There is already a lease present."

      * 409 Conflict, LeaseIdMismatchWithLeaseOperation, "The lease ID specified did not match the lease ID for the resource with the specified lease operation."

      * 409 Conflict, LeaseIsAlreadyBroken, "The lease has already been broken and cannot be broken again."

      * 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "The lease ID matched, but the lease is currently in breaking state and cannot be acquired until it is broken."

      * 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "The lease ID matched, but the lease is currently in breaking state and cannot be changed."

      * 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "The lease ID matched, but the lease has been broken explicitly and cannot be renewed."

      * 409 Conflict, LeaseNameMismatch, "The lease name specified did not match the existing lease name."

      * 409 Conflict, LeaseNotPresentWithLeaseOperation, "The lease ID is not present with the specified lease operation."

      * 409 Conflict, PathAlreadyExists, "The specified path already exists."

      * 409 Conflict, PathConflict, "The specified path, or an element of the path, exists and its resource type is invalid for this operation."

      * 409 Conflict, SourcePathIsBeingDeleted, "The specified source path is marked to be deleted."

      * 409 Conflict, ResourceTypeMismatch, "The resource type specified in the request does not match the type of the resource."

      * 412 Precondition Failed, ConditionNotMet, "The condition specified using HTTP conditional header(s) is not met."

      * 412 Precondition Failed, LeaseIdMismatch, "The lease ID specified did not match the lease ID for the resource."

      * 412 Precondition Failed, LeaseIdMissing, "There is currently a lease on the resource and no lease ID was specified in the request."

      * 412 Precondition Failed, LeaseNotPresent, "There is currently no lease on the resource."

      * 412 Precondition Failed, LeaseLost, "A lease ID was specified, but the lease for the resource has expired."

      * 412 Precondition Failed, SourceConditionNotMet, "The source condition specified using HTTP conditional header(s) is not met."

      * 413 Request Entity Too Large, RequestBodyTooLarge, "The request body is too large and exceeds the maximum permissible limit."

      * 416 Requested Range Not Satisfiable, InvalidRange, "The range specified is invalid for the current size of the resource."

      * 500 Internal Server Error, InternalError, "The server encountered an internal error. Please retry the request."

      * 500 Internal Server Error, OperationTimedOut, "The operation could not be completed within the permitted time."

      * 503 Service Unavailable, ServerBusy, "Egress is over the account limit."

      * 503 Service Unavailable, ServerBusy, "Ingress is over the account limit."

      * 503 Service Unavailable, ServerBusy, "Operations per second is over the account limit."

      * 503 Service Unavailable, ServerBusy, "The server is currently unable to receive requests. Please retry your request."'
    headers:
      x-ms-request-id:
        description: A server-generated UUID recorded in the analytics logs for troubleshooting and correlation.
        pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
        type: string
      x-ms-version:
        description: The version of the REST protocol used to process the request.
        type: string
    schema:
      $ref: '#/definitions/DataLakeStorageError'
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'