Microsoft.Storage StorageAccounts 2021-04-01

  • Статья

Определение ресурса Bicep

Тип ресурса storageAccounts можно развернуть с помощью операций, предназначенных для:

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.Storage/storageAccounts, добавьте в шаблон следующий код Bicep.

resource symbolicname 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  kind: 'string'
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    accessTier: 'string'
    allowBlobPublicAccess: bool
    allowCrossTenantReplication: bool
    allowSharedKeyAccess: bool
    azureFilesIdentityBasedAuthentication: {
      activeDirectoryProperties: {
        azureStorageSid: 'string'
        domainGuid: 'string'
        domainName: 'string'
        domainSid: 'string'
        forestName: 'string'
        netBiosDomainName: 'string'
      }
      defaultSharePermission: 'string'
      directoryServiceOptions: 'string'
    }
    customDomain: {
      name: 'string'
      useSubDomainName: bool
    }
    encryption: {
      identity: {
        userAssignedIdentity: 'string'
      }
      keySource: 'string'
      keyvaultproperties: {
        keyname: 'string'
        keyvaulturi: 'string'
        keyversion: 'string'
      }
      requireInfrastructureEncryption: bool
      services: {
        blob: {
          enabled: bool
          keyType: 'string'
        }
        file: {
          enabled: bool
          keyType: 'string'
        }
        queue: {
          enabled: bool
          keyType: 'string'
        }
        table: {
          enabled: bool
          keyType: 'string'
        }
      }
    }
    isHnsEnabled: bool
    isNfsV3Enabled: bool
    keyPolicy: {
      keyExpirationPeriodInDays: int
    }
    largeFileSharesState: 'string'
    minimumTlsVersion: 'string'
    networkAcls: {
      bypass: 'string'
      defaultAction: 'string'
      ipRules: [
        {
          action: 'Allow'
          value: 'string'
        }
      ]
      resourceAccessRules: [
        {
          resourceId: 'string'
          tenantId: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          action: 'Allow'
          id: 'string'
          state: 'string'
        }
      ]
    }
    routingPreference: {
      publishInternetEndpoints: bool
      publishMicrosoftEndpoints: bool
      routingChoice: 'string'
    }
    sasPolicy: {
      expirationAction: 'Log'
      sasExpirationPeriod: 'string'
    }
    supportsHttpsTrafficOnly: bool
  }
}

Значения свойств

storageAccounts

Имя Описание Значение
name имя ресурса. строка (обязательно)

Ограничение символов: 3–24

Допустимые символы:
Строчные буквы и цифры.

Имя ресурса должно быть уникальным в Azure.
location Обязательный. Получает или задает расположение ресурса. Это будет один из поддерживаемых и зарегистрированных географических регионов Azure (например, западная часть США, восточная часть США, Юго-Восточная Азия и т. д.). Георегион ресурса нельзя изменить после его создания, но если при обновлении указан идентичный географический регион, запрос будет выполнен успешно. строка (обязательно)
tags Возвращает или задает список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать для просмотра и группирования этого ресурса (между группами ресурсов). Для ресурса можно указать не более 15 тегов. Каждый тег должен иметь ключ длиной не более 128 символов и значением длиной не более 256 символов. Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Обязательный. Возвращает или задает имя SKU. SKU (обязательно)
kind Обязательный. Указывает тип учетной записи хранения. BlobStorage
BlockBlobStorage
FileStorage
"Storage"
StorageV2 (обязательно)
extendedLocation Необязательный элемент. Задайте расширенное расположение ресурса. Если значение не задано, учетная запись хранения будет создана в регионе Azure main. В противном случае он будет создан в указанном расширенном расположении. ExtendedLocation
удостоверение Удостоверение ресурса. Удостоверение
properties Параметры, используемые для создания учетной записи хранения. StorageAccountPropertiesCreateParametersOrStorageAcc...

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. EdgeZone

Идентификация

Имя Описание Значение
тип Тип удостоверения. "Нет"
SystemAssigned
"SystemAssigned,UserAssigned"
UserAssigned (обязательно)
userAssignedIdentities Возвращает или задает список пар "ключ-значение", описывающих набор удостоверений, назначаемых пользователем, которые будут использоваться с этой учетной записью хранения. Ключ — это идентификатор ресурса ARM удостоверения. Здесь разрешено только 1 удостоверение, назначаемое пользователем. IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} UserAssignedIdentity

UserAssignedIdentity

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

StorageAccountPropertiesCreateParametersOrStorageAcc...

Имя Описание Значение
accessTier Требуется для учетных записей хранения, где тип = BlobStorage. Уровень доступа, используемый для выставления счетов. "Прохладно"
"Горячий"
allowBlobPublicAccess Разрешить или запретить общий доступ ко всем BLOB-объектам или контейнерам в учетной записи хранения. Интерпретация по умолчанию — true для этого свойства. bool
allowCrossTenantReplication Разрешить или запретить репликацию объектов клиента AAD. Интерпретация по умолчанию — true для этого свойства. bool
allowSharedKeyAccess Указывает, разрешена ли учетная запись хранения для авторизации запросов с помощью ключа доступа учетной записи через общий ключ. Если значение равно false, все запросы, включая подписанные URL-адреса, должны быть авторизованы с помощью Azure Active Directory (Azure AD). Значение по умолчанию — null, что эквивалентно true. bool
azureFilesIdentityBasedAuthentication Предоставляет параметры проверки подлинности на основе удостоверений для Файлы Azure. AzureFilesIdentityBasedAuthentication
customDomain Домен пользователя, назначенный учетной записи хранения. Имя является источником CNAME. В настоящее время для каждой учетной записи хранения поддерживается только один личный домен. Чтобы очистить существующий личный домен, используйте пустую строку для свойства имени личного домена. CustomDomain
шифрование Не применяется Шифрование службы хранилища Azure включено для всех учетных записей хранения и не может быть отключено. Шифрование
isHnsEnabled Account HierarchicalNamespace включен, если имеет значение true. bool
isNfsV3Enabled Поддержка протокола NFS 3.0 включена, если задано значение true. bool
keyPolicy KeyPolicy, назначенный учетной записи хранения. KeyPolicy
largeFileSharesState Разрешить большие общие папки, если для параметра задано значение Включено. После включения его нельзя отключить. "Отключено"
"Включено"
minimumTlsVersion Задайте минимальную версию TLS, разрешенную для запросов к хранилищу. Интерпретация по умолчанию — TLS 1.0 для этого свойства. 'TLS1_0'
'TLS1_1'
'TLS1_2'
networkAcls Набор сетевых правил NetworkRuleSet
routingPreference Хранит сведения о выборе сетевой маршрутизации, выбранной пользователем для передачи данных. RoutingPreference
sasPolicy SasPolicy, назначенный учетной записи хранения. SasPolicy
supportsHttpsTrafficOnly Разрешает трафик HTTPS только к службе хранилища, если имеет значение true. Значение по умолчанию — true с версии API 2019-04-01. bool

AzureFilesIdentityBasedAuthentication

Имя Описание Значение
activeDirectoryProperties Требуется при выборе AD. ActiveDirectoryProperties
defaultSharePermission Разрешение общего доступа по умолчанию для пользователей, использующих проверку подлинности Kerberos, если роль RBAC не назначена. "Нет"
StorageFileDataSmbShareContributor
'StorageFileDataSmbShareelevatedContributor'
'StorageFileDataSmbShareOwner'
StorageFileDataSmbShareReader
directoryServiceOptions Указывает используемую службу каталогов. 'AADDS'
"AD"
None (обязательно)

ActiveDirectoryProperties

Имя Описание Значение
azureStorageSid Указывает идентификатор безопасности (SID) для службы хранилища Azure. string (обязательно)
domainGuid Указывает GUID домена. string (обязательно)
domainName Указывает основной домен, для которому является полномочный DNS-сервер AD. строка (обязательно)
domainSid Указывает идентификатор безопасности (SID). строка (обязательно)
имя_леса Указывает лес Active Directory для получения. строка (обязательно)
netBiosDomainName Указывает имя домена NetBIOS. строка (обязательно)

CustomDomain

Имя Описание Значение
name Возвращает или задает имя личного домена, назначенное учетной записи хранения. Name — это источник CNAME. строка (обязательно)
useSubDomainName Указывает, включена ли косвенная проверка CName. Значение по умолчанию — false. Это значение следует устанавливать только при обновлениях. bool

Шифрование

Имя Описание Значение
удостоверение Удостоверение, используемое с неактивным шифрованием на стороне службы. EncryptionIdentity
keySource Источник ключа шифрования (поставщик). Возможные значения (без учета регистра): Microsoft.Storage, Microsoft.Keyvault Microsoft.Keyvault
Microsoft.Storage (обязательно)
keyvaultproperties Свойства, предоставляемые хранилищем ключей. KeyVaultProperties
requireInfrastructureEncryption Логическое значение, указывающее, применяет ли служба дополнительный уровень шифрования с помощью управляемых платформой ключей для неактивных данных. bool
services; Список служб, поддерживающих шифрование. Службы шифрования

EncryptionIdentity

Имя Описание Значение
userAssignedIdentity Идентификатор ресурса удостоверения UserAssigned, связанного с шифрованием на стороне сервера в учетной записи хранения. строка

KeyVaultProperties

Имя Описание Значение
keyname Имя ключа KeyVault. строка
keyvaulturi Универсальный код ресурса (URI) keyVault. строка
keyversion Версия ключа KeyVault. строка

Службы шифрования

Имя Описание Значение
большой двоичный объект Функция шифрования службы хранилища BLOB-объектов. EncryptionService
файл Функция шифрования службы хранилища файлов. EncryptionService
очередь Функция шифрования службы хранилища очередей. EncryptionService
table Функция шифрования службы хранилища таблиц. EncryptionService

EncryptionService

Имя Описание Значение
Включено Логическое значение, указывающее, шифрует ли служба данные при их хранении. bool
keyType Тип ключа шифрования, используемый для службы шифрования. Тип ключа "Учетная запись" означает, что будет использоваться ключ шифрования с областью действия учетной записи. Тип ключа "Служба" подразумевает, что используется ключ службы по умолчанию. "Учетная запись"
"Служба"

KeyPolicy

Имя Описание Значение
keyExpirationPeriodInDays Срок действия ключа в днях. int (обязательно)

NetworkRuleSet

Имя Описание Значение
Обход Указывает, пропускается ли трафик для ведения журнала, метрик или Служб Azure. Возможные значения— это любое сочетание ведения журнала, метрик, AzureServices (например, "Ведение журнала, метрики") или None для обхода ни одного из этих трафика. AzureServices
"Ведение журнала"
"Метрики"
"Нет"
defaultAction Указывает действие по умолчанию разрешить или запретить, если другие правила не соответствуют. "Разрешить"
Deny (обязательно)
ipRules Задает правила списка ACL IP-адресов IPRule[]
resourceAccessRules Задает правила доступа к ресурсам ResourceAccessRule[]
virtualNetworkRules Задает правила виртуальной сети VirtualNetworkRule[]

IPRule

Имя Описание Значение
action Действие правила ACL IP. "Разрешить"
значение Указывает IP-адрес или диапазон IP-адресов в формате CIDR. Разрешен только IPV4-адрес. string (обязательно)

ResourceAccessRule

Имя Описание Значение
resourceId Идентификатор ресурса строка
tenantId Идентификатор клиента строка

VirtualNetworkRule

Имя Описание Значение
action Действие правила виртуальной сети. "Разрешить"
идентификатор Идентификатор ресурса подсети, например : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. string (обязательно)
Состояние Возвращает состояние правила виртуальной сети. "Отзыв"
"Сбой"
NetworkSourceDeleted
"Подготовка"
"Успешно"

RoutingPreference

Имя Описание Значение
publishInternetEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации в Интернете. bool
publishMicrosoftEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации Майкрософт. bool
routingChoice Вариант маршрутизации определяет тип сетевой маршрутизации, выбранной пользователем. InternetRouting
MicrosoftRouting

SasPolicy

Имя Описание Значение
expirationAction Действие истечения срока действия SAS. Может быть только журналом. Log (обязательно)
sasExpirationPeriod Срок действия SAS: DD.HH:MM:SS. string (обязательно)

Sku

Имя Описание Значение
name Имя номера SKU. Требуется для создания учетной записи; необязательный параметр для обновления. Обратите внимание, что в более ранних версиях имя SKU называлось accountType. 'Premium_LRS'
'Premium_ZRS'
'Standard_GRS'
'Standard_GZRS'
'Standard_LRS'
'Standard_RAGRS'
'Standard_RAGZRS'
"Standard_ZRS" (обязательно)

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
Подключение к учетной записи хранения из виртуальной машины через частную конечную точку

Развертывание в Azure		 В этом примере показано, как использовать подключение виртуальной сети для доступа к учетной записи хранения BLOB-объектов через частную конечную точку.
Подключение к общей папке Azure через частную конечную точку

Развертывание в Azure		 В этом примере показано, как настроить виртуальную сеть и частную зону DNS для доступа к общей папке Azure через частную конечную точку.
Создание учетной записи хранения категории "Стандартный"

Развертывание в Azure		 Этот шаблон создает учетную запись хранения категории "Стандартный"
Создание учетной записи хранения с помощью SSE

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

Развертывание в Azure		 Этот шаблон позволяет развернуть учетную запись хранения Azure с включенной расширенной защитой от угроз.
Создание учетной записи хранения Azure и контейнера BLOB-объектов в Azure

Развертывание в Azure		 Этот шаблон создает учетную запись хранения Azure и контейнер BLOB-объектов.
Учетная запись хранения с политикой хранения SSE и удаления BLOB-объектов

Развертывание в Azure		 Этот шаблон создает учетную запись хранения с шифрованием службы хранилища и политикой хранения удаления BLOB-объектов.
Шифрование учетной записи хранения Azure с помощью ключа, управляемого клиентом

Развертывание в Azure		 Этот шаблон развертывает учетную запись хранения с ключом, управляемым клиентом, для шифрования, который создается и помещается в Key Vault.
Создание учетной записи хранения с общей папкой

Развертывание в Azure		 Этот шаблон создает учетную запись хранения Azure и общую папку.
Создание учетной записи хранения с несколькими контейнерами BLOB-объектов

Развертывание в Azure		 Создает учетную запись хранения Azure и несколько контейнеров BLOB-объектов.
Создание учетной записи хранения с несколькими общими папками

Развертывание в Azure		 Создает учетную запись хранения Azure и несколько общих папок.
Создание учетной записи хранения с включенным протоколом SFTP

Развертывание в Azure		 Создает учетную запись хранения Azure и контейнер BLOB-объектов, доступ к которым можно получить по протоколу SFTP. Доступ может быть на основе пароля или открытого ключа.
Развертывание статического веб-сайта

Развертывание в Azure		 Развертывание статического веб-сайта с резервной учетной записью хранения

Определение ресурса шаблона ARM

Тип ресурса storageAccounts можно развернуть с помощью операций, предназначенных для:

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.Storage/storageAccounts, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Storage/storageAccounts",
  "apiVersion": "2021-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "kind": "string",
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "accessTier": "string",
    "allowBlobPublicAccess": "bool",
    "allowCrossTenantReplication": "bool",
    "allowSharedKeyAccess": "bool",
    "azureFilesIdentityBasedAuthentication": {
      "activeDirectoryProperties": {
        "azureStorageSid": "string",
        "domainGuid": "string",
        "domainName": "string",
        "domainSid": "string",
        "forestName": "string",
        "netBiosDomainName": "string"
      },
      "defaultSharePermission": "string",
      "directoryServiceOptions": "string"
    },
    "customDomain": {
      "name": "string",
      "useSubDomainName": "bool"
    },
    "encryption": {
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keySource": "string",
      "keyvaultproperties": {
        "keyname": "string",
        "keyvaulturi": "string",
        "keyversion": "string"
      },
      "requireInfrastructureEncryption": "bool",
      "services": {
        "blob": {
          "enabled": "bool",
          "keyType": "string"
        },
        "file": {
          "enabled": "bool",
          "keyType": "string"
        },
        "queue": {
          "enabled": "bool",
          "keyType": "string"
        },
        "table": {
          "enabled": "bool",
          "keyType": "string"
        }
      }
    },
    "isHnsEnabled": "bool",
    "isNfsV3Enabled": "bool",
    "keyPolicy": {
      "keyExpirationPeriodInDays": "int"
    },
    "largeFileSharesState": "string",
    "minimumTlsVersion": "string",
    "networkAcls": {
      "bypass": "string",
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "Allow",
          "value": "string"
        }
      ],
      "resourceAccessRules": [
        {
          "resourceId": "string",
          "tenantId": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "action": "Allow",
          "id": "string",
          "state": "string"
        }
      ]
    },
    "routingPreference": {
      "publishInternetEndpoints": "bool",
      "publishMicrosoftEndpoints": "bool",
      "routingChoice": "string"
    },
    "sasPolicy": {
      "expirationAction": "Log",
      "sasExpirationPeriod": "string"
    },
    "supportsHttpsTrafficOnly": "bool"
  }
}

Значения свойств

storageAccounts

Имя Описание Значение
тип Тип ресурса Microsoft.Storage/storageAccounts
версия_API Версия API ресурсов '2021-04-01'
name имя ресурса. string (обязательно)

Ограничение символов: 3–24

Допустимые символы:
Строчные буквы и цифры.

Имя ресурса должно быть уникальным в Azure.
location Обязательный. Получает или задает расположение ресурса. Это будет один из поддерживаемых и зарегистрированных географических регионов Azure (например, западная часть США, восточная часть США, Юго-Восточная Азия и т. д.). Георегион ресурса нельзя изменить после его создания, но если при обновлении указан идентичный географический регион, запрос будет выполнен успешно. string (обязательно)
tags Возвращает или задает список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать для просмотра и группировки этого ресурса (в разных группах ресурсов). Для ресурса можно указать не более 15 тегов. Каждый тег должен иметь ключ длиной не более 128 символов и значение длиной не более 256 символов. Словарь имен и значений тегов. См . раздел Теги в шаблонах
sku Обязательный. Возвращает или задает имя SKU. SKU (обязательно)
kind Обязательный. Указывает тип учетной записи хранения. 'BlobStorage'
'BlockBlobStorage'
FileStorage
"Storage"
StorageV2 (обязательно)
extendedLocation Необязательный элемент. Задайте расширенное расположение ресурса. Если значение не задано, учетная запись хранения будет создана в регионе Azure main. В противном случае он будет создан в указанном расширенном расположении. ExtendedLocation
удостоверение Удостоверение ресурса. Удостоверение
properties Параметры, используемые для создания учетной записи хранения. StorageAccountPropertiesCreateParametersOrStorageAcc...

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. EdgeZone

Идентификация

Имя Описание Значение
тип Тип удостоверения. "Нет"
SystemAssigned
"SystemAssigned,UserAssigned"
UserAssigned (обязательно)
userAssignedIdentities Возвращает или задает список пар "ключ-значение", описывающих набор удостоверений, назначаемых пользователем, которые будут использоваться с этой учетной записью хранения. Ключ — это идентификатор ресурса ARM удостоверения. Здесь разрешено только 1 удостоверение, назначаемое пользователем. IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} UserAssignedIdentity

UserAssignedIdentity

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

StorageAccountPropertiesCreateParametersOrStorageAcc...

Имя Описание Значение
accessTier Требуется для учетных записей хранения, где тип = BlobStorage. Уровень доступа, используемый для выставления счетов. "Прохладно"
"Горячий"
allowBlobPublicAccess Разрешить или запретить общий доступ ко всем BLOB-объектам или контейнерам в учетной записи хранения. Интерпретация по умолчанию имеет значение true для этого свойства. bool
allowCrossTenantReplication Разрешить или запретить репликацию объектов клиента AAD. Интерпретация по умолчанию имеет значение true для этого свойства. bool
allowSharedKeyAccess Указывает, разрешает ли учетная запись хранения авторизацию запросов с помощью ключа доступа к учетной записи через общий ключ. Если задано значение false, все запросы, включая подписанные URL-адреса, должны быть авторизованы с помощью Azure Active Directory (Azure AD). Значение по умолчанию равно NULL, что эквивалентно true. bool
azureFilesIdentityBasedAuthentication Предоставляет параметры проверки подлинности на основе удостоверений для Файлы Azure. AzureFilesIdentityBasedAuthentication
customDomain Домен пользователя, назначенный учетной записи хранения. Name — это источник CNAME. В настоящее время для каждой учетной записи хранения поддерживается только один личный домен. Чтобы очистить существующий личный домен, используйте пустую строку для свойства имени личного домена. CustomDomain
шифрование Не применяется Шифрование службы хранилища Azure включено для всех учетных записей хранения и не может быть отключено. Шифрование
isHnsEnabled Account HierarchicalNamespace включен, если имеет значение true. bool
isNfsV3Enabled Поддержка протокола NFS 3.0 включена, если задано значение true. bool
keyPolicy KeyPolicy, назначенный учетной записи хранения. KeyPolicy
largeFileSharesState Разрешить большие общие папки, если для параметра задано значение Включено. Его нельзя отключить после включения. "Отключено"
"Включено"
minimumTlsVersion Задайте минимальную версию TLS, разрешенную для запросов к хранилищу. Интерпретация по умолчанию — TLS 1.0 для этого свойства. "TLS1_0"
'TLS1_1'
"TLS1_2"
networkAcls Набор правил сети NetworkRuleSet
routingPreference Хранит сведения о выборе сетевой маршрутизации, выбранном пользователем для передачи данных. RoutingPreference
sasPolicy SasPolicy, назначенный учетной записи хранения. SasPolicy
supportsHttpsTrafficOnly Разрешает трафик HTTPS только к службе хранилища, если имеет значение true. Значение по умолчанию — true с версии API 2019-04-01. bool

AzureFilesIdentityBasedAuthentication

Имя Описание Значение
activeDirectoryProperties Требуется при выборе AD. ActiveDirectoryProperties
defaultSharePermission Разрешение общего ресурса по умолчанию для пользователей, использующих проверку подлинности Kerberos, если роль RBAC не назначена. "Нет"
StorageFileDataSmbShareContributor
StorageFileDataSmbShareelevatedContributor
StorageFileDataSmbShareOwner
StorageFileDataSmbShareReader
directoryServiceOptions Указывает используемую службу каталогов. 'AADDS'
"AD"
None (обязательно)

ActiveDirectoryProperties

Имя Описание Значение
azureStorageSid Указывает идентификатор безопасности (SID) для службы хранилища Azure. строка (обязательно)
domainGuid Указывает GUID домена. строка (обязательно)
domainName Указывает основной домен, для которому является полномочный DNS-сервер AD. строка (обязательно)
domainSid Указывает идентификатор безопасности (SID). строка (обязательно)
имя_леса Указывает лес Active Directory для получения. строка (обязательно)
netBiosDomainName Указывает имя домена NetBIOS. строка (обязательно)

CustomDomain

Имя Описание Значение
name Возвращает или задает имя личного домена, назначенное учетной записи хранения. Name — это источник CNAME. строка (обязательно)
useSubDomainName Указывает, включена ли косвенная проверка CName. Значение по умолчанию — false. Это значение следует устанавливать только при обновлениях. bool

Шифрование

Имя Описание Значение
удостоверение Удостоверение, используемое с неактивным шифрованием на стороне службы. EncryptionIdentity
keySource Источник ключа шифрования (поставщик). Возможные значения (без учета регистра): Microsoft.Storage, Microsoft.Keyvault Microsoft.Keyvault
Microsoft.Storage (обязательно)
keyvaultproperties Свойства, предоставляемые хранилищем ключей. KeyVaultProperties
requireInfrastructureEncryption Логическое значение, указывающее, применяет ли служба дополнительный уровень шифрования с помощью управляемых платформой ключей для неактивных данных. bool
services; Список служб, поддерживающих шифрование. Службы шифрования

EncryptionIdentity

Имя Описание Значение
userAssignedIdentity Идентификатор ресурса удостоверения UserAssigned, связанного с шифрованием на стороне сервера в учетной записи хранения. строка

KeyVaultProperties

Имя Описание Значение
keyname Имя ключа KeyVault. строка
keyvaulturi Универсальный код ресурса (URI) хранилища ключей. строка
keyversion Версия ключа KeyVault. строка

Службы шифрования

Имя Описание Значение
большой двоичный объект Функция шифрования службы хранилища BLOB-объектов. EncryptionService
файл Функция шифрования службы хранилища файлов. EncryptionService
очередь Функция шифрования службы хранилища очередей. EncryptionService
table Функция шифрования службы хранилища таблиц. EncryptionService

EncryptionService

Имя Описание Значение
Включено Логическое значение, указывающее, шифрует ли служба данные при их хранении. bool
keyType Тип ключа шифрования, используемый для службы шифрования. Тип ключа "Учетная запись" подразумевает, что будет использоваться ключ шифрования с областью действия учетной записи. Тип ключа "Служба" подразумевает, что используется ключ службы по умолчанию. "Учетная запись"
"Service"

KeyPolicy

Имя Описание Значение
keyExpirationPeriodInDays Срок действия ключа в днях. int (обязательно)

NetworkRuleSet

Имя Описание Значение
Обход Указывает, пропускается ли трафик для ведения журнала, метрик или Служб Azure. Возможные значения— это любое сочетание ведения журнала, метрик, AzureServices (например, "Ведение журнала, метрики") или None для обхода ни одного из этих трафика. AzureServices
"Ведение журнала"
"Метрики"
"Нет"
defaultAction Указывает действие по умолчанию разрешить или запретить, если другие правила не соответствуют. "Разрешить"
Deny (обязательно)
ipRules Задает правила списка ACL IP-адресов IPRule[]
resourceAccessRules Задает правила доступа к ресурсам ResourceAccessRule[]
virtualNetworkRules Задает правила виртуальной сети VirtualNetworkRule[]

IPRule

Имя Описание Значение
action Действие правила ACL IP. "Разрешить"
значение Указывает IP-адрес или диапазон IP-адресов в формате CIDR. Разрешен только IPV4-адрес. string (обязательно)

ResourceAccessRule

Имя Описание Значение
resourceId Идентификатор ресурса строка
tenantId Идентификатор клиента строка

VirtualNetworkRule

Имя Описание Значение
action Действие правила виртуальной сети. "Разрешить"
идентификатор Идентификатор ресурса подсети, например : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. string (обязательно)
Состояние Возвращает состояние правила виртуальной сети. "Отзыв"
"Сбой"
NetworkSourceDeleted
"Подготовка"
"Успешно"

RoutingPreference

Имя Описание Значение
publishInternetEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации в Интернете. bool
publishMicrosoftEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации Майкрософт. bool
routingChoice Вариант маршрутизации определяет тип сетевой маршрутизации, выбранной пользователем. InternetRouting
MicrosoftRouting

SasPolicy

Имя Описание Значение
expirationAction Действие срока действия SAS. Может быть только log. Log (обязательно)
sasExpirationPeriod Срок действия SAS, DD.HH:MM:SS. строка (обязательно)

Sku

Имя Описание Значение
name Имя номера SKU. Требуется для создания учетной записи; необязательный параметр для обновления. Обратите внимание, что в более ранних версиях имя SKU называлось accountType. "Premium_LRS"
"Premium_ZRS"
"Standard_GRS"
"Standard_GZRS"
"Standard_LRS"
"Standard_RAGRS"
"Standard_RAGZRS"
"Standard_ZRS" (обязательно)

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
Подключение к учетной записи хранения из виртуальной машины через частную конечную точку

Развертывание в Azure		 В этом примере показано, как использовать подключение виртуальной сети для доступа к учетной записи хранения BLOB-объектов через частную конечную точку.
Подключение к общей папке Azure через частную конечную точку

Развертывание в Azure		 В этом примере показано, как использовать настройку виртуальной сети и частной зоны DNS для доступа к общей папке Azure через частную конечную точку.
Создание учетной записи хранения уровня "Стандартный"

Развертывание в Azure		 Этот шаблон создает учетную запись хранения уровня "Стандартный"
Создание учетной записи хранения с помощью SSE

Развертывание в Azure		 Этот шаблон создает учетную запись хранения с шифрованием службы хранилища для неактивных данных
Учетная запись хранения с Расширенной защитой от угроз

Развертывание в Azure		 Этот шаблон позволяет развернуть учетную запись хранения Azure с включенной расширенной защитой от угроз.
Создание учетной записи хранения Azure и контейнера BLOB-объектов в Azure

Развертывание в Azure		 Этот шаблон создает учетную запись хранения Azure и контейнер BLOB-объектов.
Учетная запись хранения с политикой хранения SSE и удаления BLOB-объектов

Развертывание в Azure		 Этот шаблон создает учетную запись хранения с шифрованием службы хранилища и политикой хранения удаления BLOB-объектов.
Шифрование учетной записи хранения Azure с помощью ключа, управляемого клиентом

Развертывание в Azure		 Этот шаблон развертывает учетную запись хранения с ключом, управляемым клиентом, для шифрования, который создается и помещается в Key Vault.
Создание учетной записи хранения с общей папкой

Развертывание в Azure		 Этот шаблон создает учетную запись хранения Azure и общую папку.
Создание учетной записи хранения с несколькими контейнерами BLOB-объектов

Развертывание в Azure		 Создает учетную запись хранения Azure и несколько контейнеров BLOB-объектов.
Создание учетной записи хранения с несколькими общими папками

Развертывание в Azure		 Создает учетную запись хранения Azure и несколько общих папок.
Создание учетной записи хранения с включенным SFTP

Развертывание в Azure		 Создает учетную запись хранения Azure и контейнер BLOB-объектов, доступ к которым можно получить по протоколу SFTP. Доступ может быть паролем или открытым ключом.
Развертывание статического веб-сайта

Развертывание в Azure		 Развертывание статического веб-сайта с резервной учетной записью хранения

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса storageAccounts можно развернуть с помощью операций, предназначенных для:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.Storage/storageAccounts, добавьте в шаблон следующую terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts@2021-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      accessTier = "string"
      allowBlobPublicAccess = bool
      allowCrossTenantReplication = bool
      allowSharedKeyAccess = bool
      azureFilesIdentityBasedAuthentication = {
        activeDirectoryProperties = {
          azureStorageSid = "string"
          domainGuid = "string"
          domainName = "string"
          domainSid = "string"
          forestName = "string"
          netBiosDomainName = "string"
        }
        defaultSharePermission = "string"
        directoryServiceOptions = "string"
      }
      customDomain = {
        name = "string"
        useSubDomainName = bool
      }
      encryption = {
        identity = {
          userAssignedIdentity = "string"
        }
        keySource = "string"
        keyvaultproperties = {
          keyname = "string"
          keyvaulturi = "string"
          keyversion = "string"
        }
        requireInfrastructureEncryption = bool
        services = {
          blob = {
            enabled = bool
            keyType = "string"
          }
          file = {
            enabled = bool
            keyType = "string"
          }
          queue = {
            enabled = bool
            keyType = "string"
          }
          table = {
            enabled = bool
            keyType = "string"
          }
        }
      }
      isHnsEnabled = bool
      isNfsV3Enabled = bool
      keyPolicy = {
        keyExpirationPeriodInDays = int
      }
      largeFileSharesState = "string"
      minimumTlsVersion = "string"
      networkAcls = {
        bypass = "string"
        defaultAction = "string"
        ipRules = [
          {
            action = "Allow"
            value = "string"
          }
        ]
        resourceAccessRules = [
          {
            resourceId = "string"
            tenantId = "string"
          }
        ]
        virtualNetworkRules = [
          {
            action = "Allow"
            id = "string"
            state = "string"
          }
        ]
      }
      routingPreference = {
        publishInternetEndpoints = bool
        publishMicrosoftEndpoints = bool
        routingChoice = "string"
      }
      sasPolicy = {
        expirationAction = "Log"
        sasExpirationPeriod = "string"
      }
      supportsHttpsTrafficOnly = bool
    }
    sku = {
      name = "string"
    }
    kind = "string"
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Значения свойств

storageAccounts

Имя Описание Значение
тип Тип ресурса "Microsoft.Storage/storageAccounts@2021-04-01"
name имя ресурса. строка (обязательно)

Ограничение символов: 3–24

Допустимые символы:
Строчные буквы и цифры.

Имя ресурса должно быть уникальным в Azure.
location Обязательный. Получает или задает расположение ресурса. Это будет один из поддерживаемых и зарегистрированных географических регионов Azure (например, западная часть США, восточная часть США, Юго-Восточная Азия и т. д.). Георегион ресурса нельзя изменить после его создания, но если при обновлении указан идентичный географический регион, запрос будет выполнен успешно. строка (обязательно)
parent_id Чтобы выполнить развертывание в группе ресурсов, используйте идентификатор этой группы ресурсов. строка (обязательно)
tags Возвращает или задает список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать для просмотра и группирования этого ресурса (между группами ресурсов). Для ресурса можно указать не более 15 тегов. Каждый тег должен иметь ключ длиной не более 128 символов и значением длиной не более 256 символов. Словарь имен и значений тегов.
sku Обязательный. Возвращает или задает имя SKU. SKU (обязательно)
kind Обязательный. Указывает тип учетной записи хранения. BlobStorage
"BlockBlobStorage"
FileStorage
"Хранилище"
StorageV2 (обязательно)
extendedLocation Необязательный элемент. Задайте расширенное расположение ресурса. Если значение не задано, учетная запись хранения будет создана в регионе Azure main. В противном случае он будет создан в указанном расширенном расположении. ExtendedLocation
удостоверение Удостоверение ресурса. Удостоверение
properties Параметры, используемые для создания учетной записи хранения. StorageAccountPropertiesCreateParametersOrStorageAcc...

ExtendedLocation

Имя Описание Значение
name Имя расширенного расположения. строка
type Тип расширенного расположения. "EdgeZone"

Идентификация

Имя Описание Значение
тип Тип удостоверения. "SystemAssigned"
"SystemAssigned,UserAssigned"
UserAssigned (обязательно)
identity_ids Возвращает или задает список пар "ключ-значение", описывающих набор удостоверений, назначаемых пользователем, которые будут использоваться с этой учетной записью хранения. Ключ — это идентификатор ресурса ARM удостоверения. Здесь разрешено только 1 удостоверение, назначаемое пользователем. Массив идентификаторов удостоверений пользователей.

IdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} UserAssignedIdentity

UserAssignedIdentity

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

StorageAccountPropertiesCreateParametersOrStorageAcc...

Имя Описание Значение
accessTier Требуется для учетных записей хранения, где тип = BlobStorage. Уровень доступа, используемый для выставления счетов. "Холодный"
"Горячий"
allowBlobPublicAccess Разрешить или запретить общий доступ ко всем BLOB-объектам или контейнерам в учетной записи хранения. Интерпретация по умолчанию имеет значение true для этого свойства. bool
allowCrossTenantReplication Разрешить или запретить репликацию объектов клиента AAD. Интерпретация по умолчанию имеет значение true для этого свойства. bool
allowSharedKeyAccess Указывает, разрешена ли учетная запись хранения для авторизации запросов с помощью ключа доступа учетной записи через общий ключ. Если значение равно false, все запросы, включая подписанные URL-адреса, должны быть авторизованы с помощью Azure Active Directory (Azure AD). Значение по умолчанию — null, что эквивалентно true. bool
azureFilesIdentityBasedAuthentication Предоставляет параметры проверки подлинности на основе удостоверений для Файлы Azure. AzureFilesIdentityBasedAuthentication
customDomain Домен пользователя, назначенный учетной записи хранения. Имя является источником CNAME. В настоящее время для каждой учетной записи хранения поддерживается только один личный домен. Чтобы очистить существующий личный домен, используйте пустую строку для свойства имени личного домена. CustomDomain
шифрование Не применяется Шифрование службы хранилища Azure включено для всех учетных записей хранения и не может быть отключено. Шифрование
isHnsEnabled Account HierarchicalNamespace включен, если имеет значение true. bool
isNfsV3Enabled Поддержка протокола NFS 3.0 включена, если задано значение true. bool
keyPolicy KeyPolicy, назначенный учетной записи хранения. KeyPolicy
largeFileSharesState Разрешить большие общие папки, если для параметра задано значение Включено. После включения его нельзя отключить. "Отключено"
"Включено"
minimumTlsVersion Задайте минимальную версию TLS, разрешенную для запросов к хранилищу. Интерпретация по умолчанию — TLS 1.0 для этого свойства. "TLS1_0"
"TLS1_1"
"TLS1_2"
networkAcls Набор сетевых правил NetworkRuleSet
routingPreference Хранит сведения о выборе сетевой маршрутизации, выбранной пользователем для передачи данных. RoutingPreference
sasPolicy SasPolicy, назначенный учетной записи хранения. SasPolicy
supportsHttpsTrafficOnly Разрешает трафик HTTPS только к службе хранилища, если имеет значение true. Значение по умолчанию — true с версии API 2019-04-01. bool

AzureFilesIdentityBasedAuthentication

Имя Описание Значение
activeDirectoryProperties Требуется при выборе AD. ActiveDirectoryProperties
defaultSharePermission Разрешение общего доступа по умолчанию для пользователей, использующих проверку подлинности Kerberos, если роль RBAC не назначена. "None"
"StorageFileDataSmbShareContributor"
"StorageFileDataSmbShareelevatedContributor"
"StorageFileDataSmbShareOwner"
StorageFileDataSmbShareReader
directoryServiceOptions Указывает используемую службу каталогов. "AADDS"
"AD"
"None" (обязательно)

ActiveDirectoryProperties

Имя Описание Значение
azureStorageSid Указывает идентификатор безопасности (SID) для службы хранилища Azure. string (обязательно)
domainGuid Указывает GUID домена. string (обязательно)
domainName Указывает основной домен, для который является полномочным DNS-сервер AD. string (обязательно)
domainSid Указывает идентификатор безопасности (SID). string (обязательно)
forestName Указывает лес Active Directory для получения. string (обязательно)
netBiosDomainName Указывает доменное имя NetBIOS. string (обязательно)

CustomDomain

Имя Описание Значение
name Возвращает или задает имя личного домена, назначенное учетной записи хранения. Имя является источником CNAME. string (обязательно)
useSubDomainName Указывает, включена ли косвенная проверка CName. Значение по умолчанию — false. Это значение следует устанавливать только при обновлениях. bool

Шифрование

Имя Описание Значение
удостоверение Удостоверение, используемое с неактивным шифрованием на стороне службы. EncryptionIdentity
keySource Источник ключа шифрования (поставщик). Возможные значения (без учета регистра): Microsoft.Storage, Microsoft.Keyvault Microsoft.Keyvault
Microsoft.Storage (обязательно)
keyvaultproperties Свойства, предоставляемые хранилищем ключей. KeyVaultProperties
requireInfrastructureEncryption Логическое значение, указывающее, применяет ли служба дополнительный уровень шифрования с помощью управляемых платформой ключей для неактивных данных. bool
services; Список служб, поддерживающих шифрование. Службы шифрования

EncryptionIdentity

Имя Описание Значение
userAssignedIdentity Идентификатор ресурса удостоверения UserAssigned, связанного с шифрованием на стороне сервера в учетной записи хранения. строка

KeyVaultProperties

Имя Описание Значение
keyname Имя ключа KeyVault. строка
keyvaulturi Универсальный код ресурса (URI) keyVault. строка
keyversion Версия ключа KeyVault. строка

Службы шифрования

Имя Описание Значение
большой двоичный объект Функция шифрования службы хранилища BLOB-объектов. EncryptionService
файл Функция шифрования службы хранилища файлов. EncryptionService
очередь Функция шифрования службы хранилища очередей. EncryptionService
table Функция шифрования службы хранилища таблиц. EncryptionService

EncryptionService

Имя Описание Значение
Включено Логическое значение, указывающее, шифрует ли служба данные при их хранении. bool
keyType Тип ключа шифрования, используемый для службы шифрования. Тип ключа "Учетная запись" означает, что будет использоваться ключ шифрования с областью действия учетной записи. Тип ключа "Служба" подразумевает, что используется ключ службы по умолчанию. "Учетная запись"
"Служба"

KeyPolicy

Имя Описание Значение
keyExpirationPeriodInDays Срок действия ключа в днях. int (обязательно)

NetworkRuleSet

Имя Описание Значение
Обход Указывает, пропускается ли трафик для ведения журнала, метрик и служб Azure. Возможные значения: любое сочетание ведения журнала, метрик, Служб Azure (например, "Ведение журнала, метрики") или None для обхода ни одного из этих трафика. AzureServices
"Ведение журнала"
"Метрики"
"None"
defaultAction Указывает действие по умолчанию разрешить или запретить, если другие правила не совпадают. "Разрешить"
"Deny" (обязательно)
ipRules Задает правила ACL ip-адресов IPRule[]
resourceAccessRules Задает правила доступа к ресурсам ResourceAccessRule[]
virtualNetworkRules Задает правила виртуальной сети VirtualNetworkRule[]

IPRule

Имя Описание Значение
action Действие правила ACL IP. "Разрешить"
значение Указывает IP-адрес или диапазон IP-адресов в формате CIDR. Разрешен только IPV4-адрес. строка (обязательно)

ResourceAccessRule

Имя Описание Значение
resourceId Идентификатор ресурса строка
tenantId Идентификатор клиента строка

VirtualNetworkRule

Имя Описание Значение
action Действие правила виртуальной сети. "Разрешить"
идентификатор Идентификатор ресурса подсети, например :subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. строка (обязательно)
Состояние Возвращает состояние правила виртуальной сети. "Отзыв"
"Сбой"
NetworkSourceDeleted
"Подготовка"
"Успешно"

RoutingPreference

Имя Описание Значение
publishInternetEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации в Интернете. bool
publishMicrosoftEndpoints Логический флаг, указывающий, должны ли публиковаться конечные точки хранилища маршрутизации Майкрософт. bool
routingChoice Вариант маршрутизации определяет тип сетевой маршрутизации, выбранной пользователем. InternetRouting
MicrosoftRouting

SasPolicy

Имя Описание Значение
expirationAction Действие срока действия SAS. Может быть только log. "Log" (обязательно)
sasExpirationPeriod Срок действия SAS, DD.HH:MM:SS. строка (обязательно)

Sku

Имя Описание Значение
name Имя номера SKU. Требуется для создания учетной записи; необязательный параметр для обновления. Обратите внимание, что в более ранних версиях имя SKU называлось accountType. "Premium_LRS"
"Premium_ZRS"
"Standard_GRS"
"Standard_GZRS"
"Standard_LRS"
"Standard_RAGRS"
"Standard_RAGZRS"
"Standard_ZRS" (обязательно)