@akadenia/azure

Azure storage utility methods


Keywords
Azure, BlobStorage, QueueStorage, akadenia
License
MIT
Install
npm install @akadenia/azure@1.2.4

Documentation

Installation

npm install @akadenia/azure-storage --save

BlobStorage

BlobStorage - A class that contains azure blob storage helpers

Kind: global class

  • BlobStorage
    • .getBlobServiceUrl(sasUrl: optional) β‡’ BlobServiceClient
    • .listBlobs(containerName, blobNamePrefix, sasUrl: optional) β‡’ Promise<Array<BlobItem>>
    • .downloadBlob(containerName, blobName, sasUrl: optional) β‡’ Promise<Buffer>
    • .blobExists(containerName, blobName, sasUrl: optional) β‡’ Promise<boolean>
    • .upload(containerName, blobName, body, contentLength, contentType) β‡’ Promise<boolean>
    • .uploadData(containerName, blobName, data, sasUrl: optional, bufferSize) β‡’ Promise<boolean>
    • .uploadStream(containerName, blobName, stream, sasUrl: optional, bufferSize) β‡’ Promise<boolean>
    • .generateSASUrl(containerName, blobName, sasOptions) β‡’ string

getBlobServiceUrl(sasUrl: optional)

Kind: instance method of BlobStorage
Returns: BlobServiceClient - - A BlobServiceClient object
Params

  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise

listBlobs(containerName, blobNamePrefix, sasUrl: optional)

Kind: instance method of BlobStorage
Returns: Promise<Array<BlobItem>> - - An array of BlobItem objects
Params

  • containerName string - The name of the container to check
  • blobNamePrefix string - The prefix of the blob name
  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise

downloadBlob(containerName, blobName, sasUrl: optional)

Kind: instance method of BlobStorage
Returns: Promise<Buffer> - - A Buffer object
Params

  • containerName string - The name of the container to download from
  • blobName string - The name of the blob to download
  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise

blobExists(containerName, blobName, sasUrl: optional)

Kind: instance method of BlobStorage
Returns: Promise<boolean> - - A boolean indicating whether or not the blob exists
Params

  • containerName string - The name of the container to check
  • blobName string - The name of the blob to check
  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise

upload(containerName, blobName, body, contentLength, contentType)

Kind: instance method of BlobStorage
Returns: Promise<boolean> - - A boolean indicating whether or not the blob was successfully uploaded
Params

  • containerName string - The name of the container to upload to
  • blobName string - The name of the blob to upload
  • body HttpRequestBody - The body of the blob
  • contentLength string - The content length
  • contentType string - The content type of the blob

uploadData(containerName, blobName, data, sasUrl: optional, bufferSize)

Kind: instance method of BlobStorage
Returns: Promise<boolean> - - A boolean indicating whether or not the blob was successfully uploaded
Params

  • containerName string - The name of the container to upload to
  • blobName string - The name of the blob to upload
  • data - Buffer | Blob | ArrayBuffer | ArrayBufferView
  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise
  • bufferSize - Size of every buffer allocated, also the block size in the uploaded block blob. Default value is 8MB

uploadStream(containerName, blobName, stream, sasUrl: optional, bufferSize)

Kind: instance method of BlobStorage
Returns: Promise<boolean> - - A boolean indicating whether or not the blob was successfully uploaded
Params

  • containerName string - The name of the container to upload to
  • blobName string - The name of the blob to upload
  • stream - Node.js Readable stream
  • sasUrl: optional string - Will construct the blob service client using the sas url if exists, the connection string otherwise
  • bufferSize - Size of every buffer allocated, also the block size in the uploaded block blob. Default value is 8MB

generateSASUrl(containerName, blobName, sasOptions)

Kind: instance method of BlobStorage
Returns: string - -The URL for the blob.
Params

  • containerName string - The name of the blob container.
  • blobName string - The name of the blob.
  • sasOptions SASOptions - The options used for generating the SAS query.

QueueStorage

QueueStorage - A class that contains azure queue storage helpers

Kind: global class

  • QueueStorage
    • .getQueueClient() β‡’ QueueClient
    • .sendMessage(message) β‡’ Promise<any>

getQueueClient()

Kind: instance method of QueueStorage
Returns: QueueClient - - A QueueClient object

sendMessage(message)

Kind: instance method of QueueStorage
Returns: Promise<any> - - The response from the queue
Params

  • message string - The message to send

TableStorage

TableStorage - A class that contains azure table storage helpers

Kind: global class

  • TableStorage
    • .getTableClient() β‡’ TableClient
    • .createTable() β‡’ Promise<void> | Promise<boolean>
    • .deleteTable() β‡’ Promise<void> | Promise<boolean>
    • .insert(entity) β‡’ Promise<boolean>
    • .update(entity) β‡’ Promise<boolean>
    • .upsert(entity) β‡’ Promise<boolean>
    • .delete(partitionKey, rowKey) β‡’ Promise<ITableEntity>
    • .get(partitionKey, rowKey) β‡’ Promise<ITableEntity>

getTableClient()

Kind: instance method of TableStorage
Returns: TableClient - - A TableClient object

createTable()

Creates a table in the storage account

Kind: instance method of TableStorage
Returns: Promise<void> - - A promise that resolves when the table is createdPromise<boolean> - - A promise that resolves to true if the table was created

deleteTable()

Deletes a table in the storage account

Kind: instance method of TableStorage
Returns: Promise<void> - - A promise that resolves when the table is deletedPromise<boolean> - - A promise that resolves to true if the table was deleted

insert(entity)

Kind: instance method of TableStorage
Returns: Promise<boolean> - - A promise that resolves to true if the entity was inserted
Params

  • entity ITableEntity - The entity to insert

update(entity)

Kind: instance method of TableStorage
Returns: Promise<boolean> - - A promise that resolves to true if the entity was updated
Params

  • entity ITableEntity - The entity to update

upsert(entity)

Kind: instance method of TableStorage
Returns: Promise<boolean> - - A promise that resolves to true if the entity was upserted
Params

  • entity ITableEntity - The entity to upsert

delete(partitionKey, rowKey)

Kind: instance method of TableStorage
Returns: Promise<ITableEntity> - - The deleted entity
Params

  • partitionKey string - The partition key
  • rowKey string - The row key

get(partitionKey, rowKey)

Kind: instance method of TableStorage
Returns: Promise<ITableEntity> - - The retrieved entity
Params

  • partitionKey string - The partition key
  • rowKey string - The row key

License

MIT