Azure Blob
Work with Azure Blob Storage containers and blobs with the same functions as S3: list, upload, download, copy, delete and SAS links. Typical uses: archive exports in Azure, exchange files with an Azure application.
azure_blob pingazure_blob bucket_createazure_blob bucket_createazure_blob bucketsazure_blob bucketsazure_blob putazure_blob putazure_blob put_textazure_blob put_textazure_blob listazure_blob listazure_blob getazure_blob getazure_blob get_textazure_blob get_textazure_blob headazure_blob copyazure_blob deleteazure_blob delete_manyazure_blob presignazure_blob presignazure_blob bucket_drop

azure_blob ping <config>


Description

    Test the endpoint and the credentials (lists one container). Returns {ok, account, api_version}; a container SAS cannot list the account and fails

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
admin
azure_blob ping "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}"
mentdb
{"ok": true, "account": "devstoreaccount1", "api_version": "2026-06-06"}

azure_blob bucket_create <config> <container>


Description

    Create a container. Returns {created, existed}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
admin
azure_blob bucket_create "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports"
mentdb
{"created": "reports", "existed": false}

azure_blob bucket_create <config> <container> <json_params>


Description

    Create a container with parameters: metadata (object, names of letters, digits or _), exist_ok (false; true: an existing container is not an error)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    json_params:   The parameters - String - required
admin
azure_blob bucket_create "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "{\"exist_ok\": true}"
mentdb
{"created": "reports", "existed": true}
with metadata (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob bucket_create "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "archive" "{\"metadata\": {\"owner\": \"finance\"}}"
mentdb
{"created": "archive", "existed": false}

azure_blob buckets <config>


Description

    List the containers: rows {name, last_modified, etag}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
admin
azure_blob buckets "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}"
mentdb
[{"name": "archive", "last_modified": "2026-11-17T16:15:42Z", "etag": "0x1D302C41BF636B0"}, {"name": "reports", "last_modified": "2026-11-17T16:15:42Z", "etag": "0x215B3415547B3E0"}]

azure_blob buckets <config> <json_params>


Description

    List the containers with parameters: prefix, limit (1000, 100000 at most)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    json_params:   The parameters - String - required
admin
azure_blob buckets "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "{\"prefix\": \"arch\"}"
mentdb
[{"name": "archive", "last_modified": "2026-11-17T16:15:42Z", "etag": "0x1D302C41BF636B0"}]

azure_blob put <config> <container> <key> <file_path>


Description

    Upload a file in streaming as a block blob, in blocks beyond 64 MB. Returns {etag, size}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    file_path:   The local file (same access rules as the other file functions) - String - required
admin
azure_blob put "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/sales.csv" "tmp/sales.csv"
mentdb
{"etag": "0x2160824EC977F80", "size": 22}

azure_blob put <config> <container> <key> <file_path> <json_params>


Description

    Upload with parameters: content_type (application/octet-stream), metadata (object, names of letters, digits or _, printable ASCII values), access_tier (Hot, Cool, Cold or Archive), multipart_threshold (64 MB, from 1 MB to 5000 MB), part_size (the block size, 16 MB, from 1 MB to 4000 MB; more when 50000 blocks would not be enough). A failed block upload leaves uncommitted blocks that Azure drops after 7 days

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    file_path:   The local file (same access rules as the other file functions) - String - required
    json_params:   The parameters - String - required
admin
azure_blob put "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/sales2.csv" "tmp/sales.csv" "{\"content_type\": \"text/csv\", \"metadata\": {\"owner\": \"finance\"}, \"access_tier\": \"Cool\"}"
mentdb
{"etag": "0x1F110A679B289A0", "size": 22}
in blocks of 2 MB (a file of 5.5 MB) (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob put "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/big.bin" "tmp/big.bin" "{\"multipart_threshold\": 1048576, \"part_size\": 2097152}"
mentdb
{"etag": "0x1CCBC678C487A20", "size": 5500000}

azure_blob put_text <config> <container> <key> <text>


Description

    Upload a text in UTF-8 (256 MB at most), text/plain; charset=utf-8 by default. Returns {etag, size}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    text:   The text - String - required
admin
azure_blob put_text "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "readme.txt" "Résumé 2026"
mentdb
{"etag": "0x24A1C9E69B9DEC0", "size": 13}

azure_blob put_text <config> <container> <key> <text> <json_params>


Description

    Upload a text with parameters: content_type, metadata, access_tier

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    text:   The text - String - required
    json_params:   The parameters - String - required
admin
azure_blob put_text "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "state.json" "{}" "{\"content_type\": \"application/json\"}"
mentdb
{"etag": "0x260D5264AC0B540", "size": 2}

azure_blob list <config> <container>


Description

    List the blobs of a container: rows {key, size, last_modified, etag, content_type, access_tier}, 1000 rows at most (see the parameters)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
admin
azure_blob list "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports"
mentdb
[{"key": "2026/big.bin", "size": 5500000, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x1CCBC678C487A20", "content_type": "application/octet-stream", "access_tier": "Hot"}, {"key": "2026/sales.csv", "size": 22, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x2160824EC977F80", "content_type": "application/octet-stream", "access_tier": "Hot"}, {"key": "2026/sales2.csv", "size": 22, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x1F110A679B289A0", "content_type": "text/csv", "access_tier": "Cool"}, {"key": "readme.txt", "size": 13, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x24A1C9E69B9DEC0", "content_type": "text/plain; charset=utf-8", "access_tier": "Hot"}, {"key": "state.json", "size": 2, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x260D5264AC0B540", "content_type": "application/json", "access_tier": "Hot"}]

azure_blob list <config> <container> <json_params>


Description

    List with parameters: prefix, delimiter (the result becomes {rows, prefixes, truncated}: the virtual folders of the level), limit (1000, 100000 at most; the markers are followed)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    json_params:   The parameters - String - required
admin
azure_blob list "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "{\"prefix\": \"2026/\", \"limit\": 2}"
mentdb
[{"key": "2026/big.bin", "size": 5500000, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x1CCBC678C487A20", "content_type": "application/octet-stream", "access_tier": "Hot"}, {"key": "2026/sales.csv", "size": 22, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x2160824EC977F80", "content_type": "application/octet-stream", "access_tier": "Hot"}]
the folders with a delimiter (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob list "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "{\"delimiter\": \"/\"}"
mentdb
{"rows": [{"key": "readme.txt", "size": 13, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x24A1C9E69B9DEC0", "content_type": "text/plain; charset=utf-8", "access_tier": "Hot"}, {"key": "state.json", "size": 2, "last_modified": "2026-11-17T16:15:42Z", "etag": "0x260D5264AC0B540", "content_type": "application/json", "access_tier": "Hot"}], "prefixes": ["2026/"], "truncated": false}

azure_blob get <config> <container> <key> <file_path>


Description

    Download a blob in streaming to a temporary file of the same folder, renamed at the end (no partial file on a failure; an existing file keeps its POSIX permissions). Returns {file, size, etag, content_type, last_modified}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    file_path:   The local file (same access rules as the other file functions) - String - required
admin
azure_blob get "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/big.bin" "tmp/big_copy.bin"
mentdb
{"file": "tmp/big_copy.bin", "size": 5500000, "etag": "0x1CCBC678C487A20", "content_type": "application/octet-stream", "last_modified": "2026-11-17T16:15:42Z"}

azure_blob get <config> <container> <key> <file_path> <json_params>


Description

    Download with parameters: range (bytes=0-9 or bytes=100-; Azure has no suffix range), max_bytes (100 GB)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    file_path:   The local file (same access rules as the other file functions) - String - required
    json_params:   The parameters - String - required
admin
azure_blob get "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/sales.csv" "tmp/head.csv" "{\"range\": \"bytes=0-9\"}"
mentdb
{"file": "tmp/head.csv", "size": 10, "etag": "0x2160824EC977F80", "content_type": "application/octet-stream", "last_modified": "2026-11-17T16:15:42Z"}

azure_blob get_text <config> <container> <key>


Description

    Read a blob as UTF-8 text, 10 MB at most (an error if larger, or if it is not valid UTF-8: use azure_blob get)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
admin
azure_blob get_text "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "readme.txt"
mentdb
Résumé 2026

azure_blob get_text <config> <container> <key> <json_params>


Description

    Read a text with parameters: max_bytes (10 MB, 256 MB at most)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    json_params:   The parameters - String - required
admin
azure_blob get_text "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "readme.txt" "{\"max_bytes\": 1024}"
mentdb
Résumé 2026

azure_blob head <config> <container> <key>


Description

    Information about a blob: {exists, size, etag, content_type, last_modified, access_tier, metadata} (metadata names in lowercase: they come from HTTP headers). A missing blob gives {exists: false}; a missing container is an error

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
admin
azure_blob head "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "2026/sales2.csv"
mentdb
{"exists": true, "size": 22, "etag": "0x1F110A679B289A0", "content_type": "text/csv", "last_modified": "2026-11-17T16:15:42Z", "access_tier": "Cool", "metadata": {"owner": "finance"}}
no such blob (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob head "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "nothing"
mentdb
{"exists": false}

azure_blob copy <config> <src_container> <src_key> <dst_container> <dst_key>


Description

    Copy a blob on the server side (Copy Blob, in the same account); a pending copy is followed until timeout_ms. Returns {etag, last_modified, copy_status}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    src_container:   The source container - String - required
    src_key:   The source blob - String - required
    dst_container:   The target container - String - required
    dst_key:   The target blob - String - required
admin
azure_blob copy "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "readme.txt" "archive" "2026/readme.txt"
mentdb
{"etag": "0x1FF7EF496B1D230", "last_modified": "2026-11-17T16:15:42Z", "copy_status": "success"}

azure_blob delete <config> <container> <key>


Description

    Delete a blob and its snapshots. Returns 1, or 0 when the blob does not exist (a missing container is an error)

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
admin
azure_blob delete "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "state.json"
mentdb
1
no such blob (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob delete "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "nothing.json"
mentdb
0

azure_blob delete_many <config> <container> <json_keys>


Description

    Delete a list of blobs (100000 at most), one request per blob. Returns {deleted, errors}: deleted counts the blobs really deleted, a missing blob is not an error, an error of Azure on a blob does not stop the others

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    json_keys:   The blob names as a JSON array - String - required
admin
azure_blob delete_many "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "[\"2026/big.bin\", \"2026/sales2.csv\"]"
mentdb
{"deleted": 2, "errors": []}

azure_blob presign <config> <container> <key>


Description

    A service SAS URL to read a blob (1 hour), signed with the account key without any network call. The URL gives access to whoever has it

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
admin
azure_blob presign "{\"account\": \"mystorage\", \"account_key\": \"azure_key\"}" "reports" "2026/sales.csv"
mentdb
https://mystorage.blob.core.windows.net/reports/2026/sales.csv?sv=2021-12-02&se=2026-11-17T17%3A15%3A42Z&sr=b&sp=r&spr=https&sig=vvqLZOW3NAnAgPKvSBzteb5MonVagZL37fneB215SwM%3D

azure_blob presign <config> <container> <key> <json_params>


Description

    A SAS URL with parameters: method (GET: read, PUT: create and write), or permissions (letters among r a c w d l), resource (blob, or container with an empty key: a container SAS, usable as sas in a configuration), expires_in (seconds, 3600, 604800 at most), now (a fixed date, for tests: 2026-11-17T10:00:00Z). https only when the endpoint is https

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
    key:   The name of the blob (1 to 1024 bytes in UTF-8, / makes virtual folders; no . or .. segment) - String - required
    json_params:   The parameters - String - required
admin
azure_blob presign "{\"account\": \"mystorage\", \"account_key\": \"azure_key\"}" "reports" "my folder/é+1.txt" "{\"method\": \"PUT\", \"expires_in\": 600, \"now\": \"2026-11-17T10:00:00Z\"}"
mentdb
https://mystorage.blob.core.windows.net/reports/my%20folder/%C3%A9%2B1.txt?sv=2021-12-02&se=2026-11-17T10%3A10%3A00Z&sr=b&sp=cw&spr=https&sig=kByP5pU3YCxNEbXZxDAf8pd6XIpZ25sWxptRhcKoIsw%3D
a container SAS to list and read
admin
azure_blob presign "{\"account\": \"mystorage\", \"account_key\": \"azure_key\"}" "reports" "" "{\"resource\": \"container\", \"permissions\": \"rl\", \"now\": \"2026-11-17T10:00:00Z\"}"
mentdb
https://mystorage.blob.core.windows.net/reports?sv=2021-12-02&se=2026-11-17T11%3A00%3A00Z&sr=c&sp=rl&spr=https&sig=FoyEKvQ%2BJAaa8gkCCTIJzd72mrJTqtJ5p3a%2FWZaOtMs%3D
then this SAS (the query of the link, in AZURE_SAS) as configuration (fixed result: real Azurite 3.37.0 server, the official Azure Storage emulator)
admin
azure_blob get_text "{\"account\": \"devstoreaccount1\", \"sas\": \"azure_sas\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "reports" "readme.txt"
mentdb
Résumé 2026

azure_blob bucket_drop <config> <container>


Description

    Delete a container and all its blobs (Azure deletes it in the background: the name stays taken for a while). Returns {dropped}

Parameters

    config:   The Azure Blob configuration as JSON: account (the storage account name), then one way to authenticate: account_key (Shared Key, the base64 key of the account), sas (a SAS token, without the leading ?), client_secret with tenant_id and client_id (OAuth client credentials of an application; token_url to override https://login.microsoftonline.com//oauth2/v2.0/token) or access_token (a bearer token); every secret also as *_env (the name of a secret (secret set)). endpoint (https://.blob.core.windows.net; a path is allowed for the emulator: http://127.0.0.1:10000/devstoreaccount1), allow_plain (false: http is only accepted for localhost), timeout_ms (60000) - String - required
    container:   The name of the container (3 to 63 lowercase letters, digits or single -) - String - required
admin
azure_blob bucket_drop "{\"account\": \"devstoreaccount1\", \"account_key\": \"azure_key\", \"endpoint\": \"http://127.0.0.1:10000/devstoreaccount1\"}" "archive"
mentdb
{"dropped": "archive"}