azure_storage_client

A simple client for Azure Storage and Key Vault REST API.

This client works query builder chaining. Each methods returns a Response object of the Fetch API.

Usage

You need the connection string for your Azure storage account. It has at least three fields:

AccountName=*****;
AccountKey=*****;
EndpointSuffix=*****;

It’s easy to get from the Azure portal.

import { AzureStorage } from "https://deno.land/x/azure_storage_client@0.8.0/mod.ts"

let storage = new AzureStorage(/* The connection string here */)

Blob Examples

Identify the blob

let blob = await storage
  .container('example') // A container name
  .dir('dir') // A directory name(optional)
  .file('file.txt') // A file name or a file path

Create or Update

let res = await blob.put(
  new TextEncoder().encode('Hello World'), // Blob or BufferSource
  'text/plain' // Content-Type
)

console.log('Succeed:': res.ok)

Get

let text = await blob.get().then(res => res.text())

Delete

let res = await blob.delete()

console.log('isDeleted:': res.ok)

List

let xml = await storage
  .container('example')
  .dir('dir') // Optional
  .list()
  .then(res => res.text())

Table Examples

Identify the entity

let entity = await storage
  .table('example')
  .partition('abc') // A partition key
  .entity('def') // A row key

Create

let res = await entity.post(
  {
    prop1: 'value' // A string or number or boolean
    prop2: 100
  }
)

console.log('Succeed:': res.ok)

Get

let data = await entity.get().then(res => res.json())

Update

let res = await entity.merge(
  {
    key2: 400
  }
)

console.log('Succeed:': res.ok)

Create or Update

let res = await entity.put(
  {
    key1: 'value'
    key2: 400
  }
)

console.log('Succeed:': res.ok)

Delete

let res = await entity.delete()

console.log('isDeleted:': res.ok)

List

let entities = await storage
  .table('example')
  .partition('abc') // Optional
  .list()
  .then(res => res.json())

Filter

let entities = await storage
  .table('example')
  .partition('abc') // Optional
  .filter()
  .list(`Timestamp ge datetime'2023-01-01T00:00:00.000Z'`)
  .then(res => res.json())

Key Vault

In advance, please create an Azure AD application in the Azure portal so that it can access the kay vault

import { AzureADApplication } from 'https://deno.land/x/azure_storage_client@0.8.0/mod.ts'

let vault = new AzureADApplication(
  {
    tenantId: '****',
    clientId: '****',
    clientSecret: '****'
  }
).vault('****') // A kay vault resource name

Secret Examples

Get

let response = await key.get() // Response
let result = await key.getJson() // SecretResult object
let webKey = await key.getValue() // string value

Key Examples

Identify the key

let key = await vault
  .key('example')
  .version('***') // A version(optional)

Get

let response = await key.get() // Response
let result = await key.getJson() // KeyResult object
let webKey = await key.getKey() // JsonWebKey

Sign

let res = await key.sign(
  '****', // A digest encoded by BASE64 URL
  'RS256' // A encryption algorithm
)

console.log('Succeed:': res.ok)

Get versions

let data: KeyVersionsResult = await key.versions().then(res => res.json())