Edit

Create a blob access point

This article shows you how to connect an external data source to your storage account and read its data through a blob access point. You allow blob access point creation on the account, create a blob access point configuration, test the connection, and then create the blob access point.

This article uses a public connection. To connect over a private connection, see Connect blob access points privately (preview).

To learn how blob access points work, see Blob access points overview.

Prerequisites

  • A standard general-purpose v2 or premium block blob storage account in a supported region. To create one, see Create a storage account. The Azure portal steps work only in regions where the Azure portal experience for blob access points is available. In other supported regions, use the REST API.

  • Network access to the storage account from the client that you use to read data, or to create the blob access point by using the REST API. The network rules of the storage account apply to blob access points the same way that they apply to other containers. For more information, see Networking considerations.

  • The following permissions. For details, see Authorize access to blob access points.

    Task Permission
    Allow blob access point creation Permission to update the storage account (Microsoft.Storage/storageAccounts/write), such as the Storage Account Contributor role
    Create and test a configuration Storage Account Contributor, or Storage Blob Access Point Contributor (preview)
    Create a blob access point Storage Account Contributor in the Azure portal. With the REST API, Storage Blob Access Point Contributor (preview) or Storage Blob Data Contributor.
  • The details of your data source, such as its source endpoint and credentials. For the complete list, see Data source requirements for blob access points.

Allow blob access point creation

Blob access point creation is off by default for every storage account. Turn it on before you create a configuration.

This account-level setting affects security and billing:

  • Impact on security. When the setting is on, users who can manage configurations can connect the storage account to data sources outside Azure Storage. To audit or block the setting across your organization, use Azure Policy. See Govern blob access points with Azure Policy.
  • Impact on billing. Turning on the setting doesn't start billing. You're billed for each configuration while it's active. See Pricing and billing.

Important

After you allow blob access point creation, the storage account doesn't return List Blobs results in Apache Arrow format. List Blobs requests that accept only Apache Arrow aren't supported, and requests that accept Apache Arrow with XML fallback return XML. For details, see Apache Arrow listings.

  1. In the Azure portal, go to your storage account.

  2. Under Data management, select Blob access points.

  3. Select Access settings.

    Screenshot of the Blob access points page in the Azure portal, with the Access settings button and the menu item highlighted.

  4. Select Allow blob access point creation, and then select Apply.

    Screenshot of the Access settings pane with the Allow blob access point creation option selected and highlighted.

    A notification confirms that access point creation is enabled.

Create a configuration

The configuration tells Azure Storage where your data is, how to reach it, and how to sign in to it.

The configuration name must be 3 to 63 characters long and contain only lowercase letters, numbers, and hyphens. It must begin and end with a letter or number, and each hyphen must be preceded and followed by a letter or number.

  1. On the Blob access points page, select Create configuration.

  2. On the Basics tab, under Project details, enter the following values:

    • Name: The configuration name.
    • Data source type: The type that matches your data source. You can't change it later.
    • Source endpoint: The URL of your bucket.
    • Description: Optional. Add aliases or identifiers that help you match the configuration to its data source.
    • Activate configuration: Leave it selected so the configuration serves data as soon as it's created. You're billed for each hour that a configuration is active.

    Screenshot of the Data source type list in a new configuration, showing Azure NetApp Files, Qumulo, Nasuni, and Commvault.

  3. Under Networking, select Public: Access data via the internet. You can't change the connection type later.

  4. Under Authentication, enter the Access key ID and the Secret access key. Change Signing region only if your data source uses a region other than us-east-1.

    Select Allow self-signed certificates for TLS verification (Less secure) only if your data source uses a self-signed certificate.

    Screenshot of the Basics tab of a new blob access point configuration, with a public connection and sample values entered.

  5. Select Next.

  6. On the Create blob access point tab, select + Blob access point, and then enter a name for the blob access point. Add only one blob access point. The name follows container naming rules and must not match an existing container in the storage account.

    Screenshot of the Create blob access point tab with one blob access point name entered.

  7. Select Next, review your settings, and then select Create.

    Screenshot of the Review + create tab for a new blob access point configuration with a public connection.

When the deployment finishes, the configuration appears in the list with the status Active, and its blob access point appears on the Containers page, on the Blob access points tab.

Important

Billing starts when you create an active configuration. You're billed for every hour that the configuration stays active, even when no one reads data through it. To stop charges for a data source that you aren't using, deactivate the configuration.

Test the connection

Creating a configuration doesn't prove that Azure Storage can reach your data source or that your credentials work. The connection test checks the following items:

Check Passes when
Network path Azure Storage reaches the source endpoint.
Authentication The data source accepts the access key ID and secret access key.
Request signing The signing region matches what the data source expects.
  1. On the Blob access points page, select the configuration.

  2. On the Overview page, select Test connection.

    When the test finishes, Connection tested shows Successful with the time of the test.

    Screenshot of a blob access point configuration overview, with a successful connection test highlighted.

If the test fails, see Connection test fails.

Create a blob access point

A blob access point is a container that's linked to your configuration. You link it when you create it, and you can't change the link later. Each configuration serves one blob access point. The name of the blob access point follows container naming rules and must not match an existing container in the storage account.

If you added a blob access point on the Create blob access point tab, it already exists. Skip to Verify blob access point creation.

Otherwise, create it from the configuration:

  1. On the Overview page of the configuration, select + Blob access point.

  2. Enter a Name for the blob access point.

  3. Select Create.

Verify blob access point creation

  1. In your storage account, under Data storage, select Containers.

  2. Select the Blob access points tab, and then select your blob access point.

    The blobs from your data source appear. The Blob access point configuration field shows the configuration that the blob access point uses.

    Screenshot of blobs from an external data source listed in a blob access point in the Azure portal.

    If the portal says that the networking settings of the storage account might be blocking access, allow your client in the network rules of the storage account. For more information, see Networking considerations.