---
title: Microsoft Azure Blob Storage
summary: Fastly will upload log messages to the Azure Blob Storage container in the format specified in the Azure Blob object.
url: https://www.fastly.com/documentation/reference/api/logging/azureblob
---

Fastly will upload log messages to the Azure Blob Storage container in the format specified in the Azure Blob object.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `account_name` | string | The unique Azure Blob Storage namespace in which your data objects are stored. Required. |
| `container` | string | The name of the Azure Blob Storage container in which to store logs. Required. |
| `file_max_bytes` | integer | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has <a href="https://learn.microsoft.com/en-us/rest/api/storageservices/put-block?tabs=microsoft-entra-id#remarks">block size limits</a>. |
| `path` | string | The path to upload logs to. |
| `public_key` | string | A PGP public key that Fastly will use to encrypt your log files before writing them to disk. |
| `sas_token` | string | The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required. |
| `compression_codec` | string | The codec used for compressing your logs. Valid values are <code>zstd</code>, <code>snappy</code>, and <code>gzip</code>. Specifying both <code>compression_codec</code> and <code>gzip_level</code> in the same API request will result in an error. |
| `format` | string | A Fastly <a href="https://www.fastly.com/documentation/guides/integrations/streaming-logs/custom-log-formats/">log format string</a>. |
| `format_version` | integer | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in <code>vcl_log</code> if <code>format_version</code> is set to <code>2</code> and in <code>vcl_deliver</code> if <code>format_version</code> is set to <code>1</code>. |
| `gzip_level` | integer | The level of gzip encoding when sending logs (default <code>0</code>, no compression). Specifying both <code>compression_codec</code> and <code>gzip_level</code> in the same API request will result in an error. |
| `log_processing_region` | string | The geographic region where the logs will be processed before streaming. Valid values are <code>us</code>, <code>eu</code>, and <code>none</code> for global. |
| `message_type` | string | How the message should be formatted. |
| `name` | string | The name for the real-time logging configuration. |
| `period` | integer | How frequently log files are finalized so they can be available for reading (in seconds). |
| `placement` | string | Where in the generated VCL the logging call should be placed. If not set, endpoints with <code>format_version</code> of 2 are placed in <code>vcl_log</code> and those with <code>format_version</code> of 1 are placed in <code>vcl_deliver</code>. |
| `response_condition` | string | The name of an existing condition in the configured endpoint, or leave blank to always execute. |
| `timestamp_format` | string | A timestamp format. (Read-only) |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `service_id` | string | Alphanumeric string identifying the service. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `version` | string | String identifying a service version. (Read-only) |

## API endpoints

### List Azure Blob Storage log endpoints

**GET** `/service/{service_id}/version/{version_id}/logging/azureblob`

List all of the Azure Blob Storage logging endpoints for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Create an Azure Blob Storage log endpoint

**POST** `/service/{service_id}/version/{version_id}/logging/azureblob`

Create an Azure Blob Storage logging endpoint for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Get an Azure Blob Storage log endpoint

**GET** `/service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}`

Get the Azure Blob Storage logging endpoint for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `logging_azureblob_name` | string | path | Yes | The name for the real-time logging configuration. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Update an Azure Blob Storage log endpoint

**PUT** `/service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}`

Update the Azure Blob Storage logging endpoint for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `logging_azureblob_name` | string | path | Yes | The name for the real-time logging configuration. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Delete the Azure Blob Storage log endpoint

**DELETE** `/service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}`

Delete the Azure Blob Storage logging endpoint for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `logging_azureblob_name` | string | path | Yes | The name for the real-time logging configuration. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |