Запрос конечной точки служба хранилища BLOB-объекта с помощью библиотеки управления служба хранилища Azure

Конечная точка большого двоичного объекта служба хранилища формирует базовый адрес для всех объектов в учетной записи хранения. При создании учетной записи хранения укажите тип конечной точки, которую вы хотите использовать. Большой двоичный объект служба хранилища поддерживает два типа конечных точек:

• Стандартная конечная точка включает уникальное имя учетной записи хранения вместе с фиксированным доменным именем. Формат стандартной конечной точки.https://<storage-account>.blob.core.windows.net
• Конечная точка зоны Azure DNS (предварительная версия) динамически выбирает зону Azure DNS и назначает ее учетной записи хранения при его создании. Формат конечной точки зоны DNS Azure.https://<storage-account>.z[00-99].blob.storage.azure.net

Когда приложение создает объект клиента службы, который подключается к ресурсам данных большого двоичного объекта служба хранилища, вы передаете URI, ссылающийся на конечную точку конструктору клиента службы. Можно создать строку URI вручную или запросить конечную точку службы во время выполнения с помощью библиотеки управления служба хранилища Azure.

Важно!

При ссылке на конечную точку службы в клиентском приложении рекомендуется избегать использования зависимостей от кэшированного IP-адреса. IP-адрес учетной записи хранения может быть изменен, и использование кэшированного IP-адреса может привести к непредвиденному поведению.

CNAMEs, связанные с конечной точкой учетной записи хранения, могут изменяться без уведомления. Приложение не должно зависеть от количества записей CNAME или вложенных доменов, связанных с этими записями CNAME.

Кроме того, рекомендуется учитывать время жизни (TTL) записи DNS и не переопределять ее. Переопределение срока жизни DNS может привести к неожиданному поведению.

Дополнительные сведения см. в записях CNAME, поддоменах и IP-адресах.

Библиотека управления служба хранилища Azure предоставляет программный доступ к поставщику ресурсов служба хранилища Azure. Поставщик ресурсов — это служба хранилища Azure реализация Azure Resource Manager. Библиотека управления позволяет разработчикам управлять учетными записями хранения и конфигурацией учетной записи, а также настраивать политики управления жизненным циклом, политики управления объектами реплика и политики неизменяемости.

Из этой статьи вы узнаете, как запрашивать конечную точку служба хранилища BLOB-объектов с помощью библиотеки управления служба хранилища Azure. Затем вы используете эту конечную BlobServiceClient точку для создания объекта для подключения к ресурсам данных blob-объектов служба хранилища.

Настройка проекта

Чтобы работать с примерами кода в этой статье, выполните следующие действия, чтобы настроить проект.

Установка пакетов

Установите пакеты для работы с библиотеками, используемыми в этом примере.

.NET

Установите следующие пакеты с помощью dotnet add package:

dotnet add package Azure.Identity
dotnet add package Azure.ResourceManager.Storage
dotnet add package Azure.Storage.Blobs

Java

Откройте файл pom.xml в текстовом редакторе.

Добавьте azure-sdk-bom , чтобы получить зависимость от последней версии библиотеки. В следующем фрагменте кода замените {bom_version_to_target} заполнитель номером версии. Использование azure-sdk-bom позволяет указать версию каждой отдельной зависимости. Дополнительные сведения о BOM см. в статье BOM SDK azure README.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Затем добавьте следующие элементы зависимостей в группу зависимостей. Зависимость удостоверений Azure необходима для бессерверных подключений к службам Azure.

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-blob</artifactId>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager</artifactId>
  <version>2.24.0</version>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-storage</artifactId>
  <version>2.24.0</version>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-management</artifactId>
  <version>1.10.2</version>
</dependency>

JavaScript

Установите следующие пакеты с помощью npm install:

npm install @azure/identity
npm install @azure/storage-blob
npm install @azure/arm-resources
npm install @azure/arm-storage

Python

Установите следующие пакеты с помощью pip install:

pip install azure-identity
pip install azure-storage-blob
pip install azure-mgmt-resource
pip install azure-mgmt-storage

Настройка кода приложения

Добавьте необходимые using или import директивы в код. Обратите внимание, что примеры кода могут разделить функциональные возможности между файлами, но в этом разделе перечислены все директивы вместе.

.NET

Затем добавьте следующие using директивы:

using Azure.Core;
using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Storage;

Сведения о клиентской библиотеке:

• Azure.Identity: обеспечивает поддержку проверки подлинности маркера Microsoft Entra в пакете SDK Azure и требуется для подключений без пароля к службам Azure.
• Azure.ResourceManager. служба хранилища. Поддерживает управление ресурсами служба хранилища Azure, включая группы ресурсов и учетные записи хранения.
• Azure. служба хранилища. Большие двоичные объекты: содержит основные классы, которые можно использовать для работы с ресурсами данных служба хранилища BLOB-объектов.

Java

Затем добавьте следующие import директивы:

import com.azure.identity.*;
import com.azure.storage.blob.*;
import com.azure.resourcemanager.*;
import com.azure.resourcemanager.storage.models.*;
import com.azure.core.management.*;
import com.azure.core.management.profile.*;

Сведения о клиентской библиотеке:

• com.azure.identity: обеспечивает поддержку проверки подлинности маркера Microsoft Entra в пакете SDK Azure и требуется для подключений без пароля к службам Azure.
• com.azure.storage.blob: содержит основные классы, которые можно использовать для работы с ресурсами данных больших двоичных объектов служба хранилища.
• com.azure.resourcemanager: поддерживает управление ресурсами и группами ресурсов Azure.
• com.azure.resourcemanager.storage: поддерживает управление служба хранилища Azure ресурсами, включая группы ресурсов и учетные записи хранения.

JavaScript

Добавьте следующие require инструкции для загрузки модулей:

const { DefaultAzureCredential } = require("@azure/identity");
const { BlobServiceClient } = require("@azure/storage-blob");
const { ResourceManagementClient } = require("@azure/arm-resources");
const { StorageManagementClient } = require("@azure/arm-storage");

Сведения о клиентской библиотеке:

• @azure/identity: обеспечивает поддержку проверки подлинности маркера Microsoft Entra в пакете SDK Azure и требуется для подключений без пароля к службам Azure.
• @azure/storage-blob: содержит основные классы, которые можно использовать для работы с ресурсами данных служба хранилища BLOB-объектов.
• @azure/arm-resources: поддерживает управление ресурсами и группами ресурсов Azure.
• @azure/arm-storage: поддерживает управление ресурсами служба хранилища Azure, включая группы ресурсов и учетные записи хранения.

Python

Добавьте следующие операторы import :

from azure.identity import DefaultAzureCredential
from azure.storage.blob import BlobServiceClient
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.storage import StorageManagementClient

Сведения о клиентской библиотеке:

• azure-identity: обеспечивает поддержку проверки подлинности маркера Microsoft Entra в пакете SDK Azure и требуется для подключений без пароля к службам Azure.
• azure-storage-blob: содержит основные классы, которые можно использовать для работы с ресурсами данных служба хранилища BLOB-объектов.
• azure-mgmt-resource: поддерживает управление ресурсами и группами ресурсов Azure.
• azure-mgmt-storage: поддерживает управление ресурсами служба хранилища Azure, включая группы ресурсов и учетные записи хранения.

Регистрация поставщика ресурсов служба хранилища в подписке

Прежде чем вы сможете работать с ним, необходимо зарегистрировать поставщик ресурсов в подписке Azure. Этот шаг необходимо выполнить только один раз для каждой подписки, и применяется только в том случае, если поставщик ресурсов Microsoft.служба хранилища в настоящее время не зарегистрирован в вашей подписке.

Вы можете зарегистрировать поставщика ресурсов служба хранилища или проверка состояние регистрации с помощью портал Azure, Azure CLI или Azure PowerShell.

Вы также можете использовать библиотеки управления Azure для проверка состояния регистрации и регистрации поставщика ресурсов служба хранилища, как показано в следующих примерах:

.NET

public static async Task RegisterSRPInSubscription(SubscriptionResource subscription)
{
    ResourceProviderResource resourceProvider = 
        await subscription.GetResourceProviderAsync("Microsoft.Storage");

    // Check the registration state of the resource provider and register, if needed
    if (resourceProvider.Data.RegistrationState == "NotRegistered")
        resourceProvider.Register();
}

Java

public void RegisterSRPInSubscription(AzureResourceManager armClient) {
    // Check the registration state of the resource provider and register, if needed
    if (armClient.providers().getByName("Microsoft.Storage").registrationState() == "NotRegistered")
        armClient.providers().register("Microsoft.Storage");
}

JavaScript

async function registerSRPInSubscription(resourceMgmtClient /*: ResourceManagementClient*/) {
  // Check the registration state of the resource provider and register, if needed
  if (resourceMgmtClient.providers.get("Microsoft.Storage").registrationState == "NotRegistered")
    resourceMgmtClient.providers.register("Microsoft.Storage");
}

Python

def register_srp_in_subscription(self, resource_mgmt_client: ResourceManagementClient):
    if (resource_mgmt_client.providers.get("Microsoft.Storage").registration_state == "NotRegistered"):
        resource_mgmt_client.providers.register("Microsoft.Storage")

Примечание.

Для выполнения операции регистрации вам потребуются разрешения для следующего действия Azure RBAC: Microsoft.служба хранилища/register/action. Это разрешение включается в роли участника и владельца .

Запрос конечной точки служба хранилища BLOB-объекта

Чтобы получить конечную точку большого двоичного объекта служба хранилища для данной учетной записи хранения, необходимо получить свойства учетной записи хранения, вызвав операцию Get Properties. В следующих примерах кода используются библиотеки доступа к данным и управления для получения конечной точки служба хранилища BLOB-объектов для указанной учетной записи хранения:

.NET

Чтобы получить свойства для указанной учетной записи хранения, используйте следующий метод из объекта служба хранилища AccountCollection:

• Getasync

Этот метод возвращает объект служба хранилища AccountResource, представляющий учетную запись хранения.

public static async Task<Uri> GetBlobServiceEndpoint(
    string storageAccountName,
    TokenCredential credential)
{
    // TODO: replace with your subscription ID and resource group name
    // You can locate your subscription ID on the Subscriptions blade
    // of the Azure portal (https://portal.azure.com)
    const string subscriptionId = "<subscription-id>";
    const string rgName = "<resource-group-name>";

    ArmClient armClient = new(credential);

    // Create a resource identifier, then get the subscription resource
    ResourceIdentifier resourceIdentifier = new($"/subscriptions/{subscriptionId}");
    SubscriptionResource subscription = armClient.GetSubscriptionResource(resourceIdentifier);

    // Get a resource group
    ResourceGroupResource resourceGroup = await subscription.GetResourceGroupAsync(rgName);

    // Get a collection of storage account resources
    StorageAccountCollection accountCollection = resourceGroup.GetStorageAccounts();

    // Get the properties for the specified storage account
    StorageAccountResource storageAccount = await accountCollection.GetAsync(storageAccountName);

    // Return the primary endpoint for the blob service
    return storageAccount.Data.PrimaryEndpoints.BlobUri;
}

Java

Чтобы получить свойства для указанной учетной записи хранения, используйте следующий метод из объекта AzureResourceManager :

• storageAccounts().getByResourceGroup

Этот метод возвращает интерфейс служба хранилища Account, который является неизменяемым клиентским представлением учетной записи хранения.

public String GetBlobServiceEndpoint(String saName, DefaultAzureCredential credential) {
    String subscriptionID = "<subscription-id>";
    String rgName = "<resource-group-name>";
    AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);

    AzureResourceManager azureResourceManager = AzureResourceManager
            .configure()
            .authenticate(credential, profile)
            .withSubscription(subscriptionID);

    StorageAccount storageAccount = azureResourceManager.storageAccounts()
            .getByResourceGroup(rgName, saName);

    String endpoint = storageAccount.endPoints().primary().blob();

    return endpoint;
}

JavaScript

Чтобы получить свойства для указанной учетной записи хранения, используйте следующий метод из объекта служба хранилища ManagementClient:

• storageAccounts.getProperties

Этот метод возвращает значение Promise<StorageAccountsGetPropertiesResponse>, представляющее учетную запись хранения.

async function getBlobServiceEndpoint(saName, credential) {
  const subscriptionId = "<subscription-id>";
  const rgName = "<resource-group-name>";

  const storageMgmtClient = new StorageManagementClient(
    credential,
    subscriptionId
  );

  // Get the properties for the specified storage account
  const storageAccount = await storageMgmtClient.storageAccounts.getProperties(
    rgName,
    saName
  );

  // Get the primary endpoint for the blob service
  const endpoint = storageAccount.primaryEndpoints.blob;

  return endpoint;
}

Python

Чтобы получить свойства для указанной учетной записи хранения, используйте следующий метод из объекта служба хранилища ManagementClient:

• storageAccounts.getProperties

Этот метод возвращает StorageAccount объект, представляющий учетную запись хранения.

def get_blob_service_endpoint(self, storage_account_name, credential: DefaultAzureCredential) -> str:
    subscription_id = "<subscription-id>"
    rg_name = "<resource-group-name>"

    storage_mgmt_client = StorageManagementClient(
        credential=credential,
        subscription_id=subscription_id
    )
    
    # Get the properties for the specified storage account
    storage_account = storage_mgmt_client.storage_accounts.get_properties(
        resource_group_name=rg_name,
        account_name=storage_account_name
    )
    
    # Get blob service endpoint
    endpoint = storage_account.primary_endpoints.blob

    return endpoint

Создание клиентского объекта с помощью конечной точки

Получив конечную точку большого двоичного объекта служба хранилища для учетной записи хранения, можно создать экземпляр клиентского объекта для работы с ресурсами данных. В следующем примере кода создается объект с помощью конечной BlobServiceClient точки, полученной в предыдущем примере:

.NET

// Create an instance of DefaultAzureCredential for authorization
TokenCredential credential = new DefaultAzureCredential();

// TODO: replace with your storage account name
string storageAccountName = "<storage-account-name>";

// Call out to our function that retrieves the blob service endpoint for the given storage account
Uri blobURI = await AccountProperties.GetBlobServiceEndpoint(storageAccountName, credential);
Console.WriteLine($"URI: {blobURI}");

// Now that we know the endpoint, create the client object
BlobServiceClient blobServiceClient = new(blobURI, credential);

// Do something with the storage account or its resources ...

Java

String saName = "<storage-account-name>";
DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();

AccountProperties accountProps = new AccountProperties();

String blobEndpoint = accountProps.GetBlobServiceEndpoint(saName, credential);
System.out.printf("URI: %s", blobEndpoint);

BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
        .endpoint(blobEndpoint)
        .credential(credential)
        .buildClient();

// Do something with the storage account or its resources ...

JavaScript

// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. 
// See https://aka.ms/azsdk/js/identity/examples for more details.

const saName = "<storage-account-name>";
const credential = new DefaultAzureCredential();

// Call out to our function that retrieves the blob service endpoint for a storage account
const endpoint = await getBlobServiceEndpoint(saName, credential)
console.log(endpoint);

// Now that we know the endpoint, create the client object
const blobServiceClient = new BlobServiceClient(
  endpoint,
  credential);

// Do something with the storage account or its resources ...

Python

storage_account_name = "<storage-account-name>"
credential = DefaultAzureCredential()

sample = BlobEndpointSample()

# Call out to our function that retrieves the blob service endpoint for a storage account
endpoint = sample.get_blob_service_endpoint(storage_account_name, credential)
print(f"URL: {endpoint}")

# Now that we know the endpoint, create the client object
blob_service_client = BlobServiceClient(account_url=endpoint, credential=credential)

# Do something with the storage account or its resources ...

Следующие шаги

Просмотрите полные примеры кода (GitHub):

• .NET
• Java
• JavaScript
• Python

Дополнительные сведения о создании клиентских объектов см. в статье "Создание клиентских объектов и управление ими", взаимодействующих с ресурсами данных.