Microsoft.NetApp netAppAccounts/capacityPools/volumes

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

Тип ресурса netAppAccounts/capacityPools/volumes можно развернуть с помощью следующих операций:

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

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

Чтобы создать ресурс Microsoft.NetApp/netAppAccounts/capacityPools/volumes, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2023-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    avsDataStore: 'string'
    backupId: 'string'
    capacityPoolResourceId: 'string'
    coolAccess: bool
    coolAccessRetrievalPolicy: 'string'
    coolnessPeriod: int
    creationToken: 'string'
    dataProtection: {
      replication: {
        endpointType: 'string'
        remoteVolumeRegion: 'string'
        remoteVolumeResourceId: 'string'
        replicationSchedule: 'string'
      }
      snapshot: {
        snapshotPolicyId: 'string'
      }
      volumeRelocation: {
        relocationRequested: bool
      }
    }
    defaultGroupQuotaInKiBs: int
    defaultUserQuotaInKiBs: int
    deleteBaseSnapshot: bool
    enableSubvolumes: 'string'
    encryptionKeySource: 'string'
    exportPolicy: {
      rules: [
        {
          allowedClients: 'string'
          chownMode: 'string'
          cifs: bool
          hasRootAccess: bool
          kerberos5iReadWrite: bool
          kerberos5pReadWrite: bool
          kerberos5ReadWrite: bool
          nfsv3: bool
          nfsv41: bool
          ruleIndex: int
          unixReadWrite: bool
        }
      ]
    }
    isDefaultQuotaEnabled: bool
    isLargeVolume: bool
    isRestoring: bool
    kerberosEnabled: bool
    keyVaultPrivateEndpointResourceId: 'string'
    ldapEnabled: bool
    networkFeatures: 'string'
    placementRules: [
      {
        key: 'string'
        value: 'string'
      }
    ]
    protocolTypes: [
      'string'
    ]
    proximityPlacementGroup: 'string'
    securityStyle: 'string'
    serviceLevel: 'string'
    smbAccessBasedEnumeration: 'string'
    smbContinuouslyAvailable: bool
    smbEncryption: bool
    smbNonBrowsable: 'string'
    snapshotDirectoryVisible: bool
    snapshotId: 'string'
    subnetId: 'string'
    throughputMibps: int
    unixPermissions: 'string'
    usageThreshold: int
    volumeSpecName: 'string'
    volumeType: 'string'
  }
  zones: [
    'string'
  ]
}

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

netAppAccounts/capacityPools/volumes

Имя Описание Значение
name имя ресурса.

Узнайте, как задать имена и типы для дочерних ресурсов в Bicep.
строка (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
tags Теги ресурсов. Словарь имен и значений тегов. См . раздел Теги в шаблонах
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить только в том случае, если дочерний ресурс объявлен вне родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: capacityPools
properties Свойства тома VolumeProperties (обязательно)
зоны; Зона доступности string[]

Ограничения:
Минимальная длина = 1
Максимальная длина = 255

VolumeProperties

Имя Описание Значение
avsDataStore Указывает, включен ли том для хранилища данных Решение Azure VMware (AVS) "Отключено"
"Включено"
backupId UUID версии 4 или идентификатор ресурса, используемый для идентификации резервной копии. строка
capacityPoolResourceId Идентификатор ресурса пула, используемый при создании тома с помощью группы томов строка
coolAccess Указывает, включен ли холодный доступ (по уровням) для тома. bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy определяет поведение получения данных из холодного уровня в хранилище уровня "Стандартный" на основе шаблона чтения для томов с поддержкой холодного доступа. Возможные значения для этого поля:
По умолчанию — данные будут извлекаться из холодного уровня в хранилище уровня "Стандартный" при случайных чтениях. Эта политика используется по умолчанию.
OnRead — все операции чтения данных, управляемые клиентом, извлекается из холодного уровня в хранилище уровня "Стандартный" при последовательных и случайных чтениях.
Никогда — данные, управляемые клиентом, не извлекается из хранилища холодного уровня в хранилище уровня "Стандартный".
'Default'
"Никогда"
OnRead
coolnessPeriod Указывает количество дней, по истечении которых данные, к которым клиенты не обращаются, будут многоуровневые. INT

Ограничения:
Минимальное значение = 7
Максимальное значение = 183
creationToken Уникальный путь к файлу тома. Используется при создании целевых объектов подключения string (обязательно)

Ограничения:
Минимальная длина = 1
Максимальная длина = 80
Шаблон = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection Тома типа DataProtection включают объект, содержащий сведения о репликации. VolumePropertiesDataProtection
defaultGroupQuotaInKiBs Квота группы по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
defaultUserQuotaInKiBs Квота пользователя по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
deleteBaseSnapshot Если этот параметр включен (true), snapshot, из которого был создан том, будет автоматически удален после завершения операции создания тома. Значение по умолчанию — false. bool
enableSubvolumes Флаг, указывающий, включены ли операции вложенных операций на томе "Отключено"
"Включено"
encryptionKeySource Источник ключа, используемого для шифрования данных в томе. Применимо, если учетная запись NetApp имеет encryption.keySource = Microsoft.KeyVault. Возможные значения (без учета регистра): "Microsoft.NetApp, Microsoft.KeyVault" Microsoft.KeyVault
Microsoft.NetApp
exportPolicy Набор правил политики экспорта VolumePropertiesExportPolicy
isDefaultQuotaEnabled Указывает, включена ли квота по умолчанию для тома. bool
isLargeVolume Указывает, является ли том большим томом или обычным. bool
isRestoring Восстановление из копии bool
kerberosEnabled Описать, является ли том kerberosEnabled. Для использования с swagger версии 2020-05-01 или более поздней bool
keyVaultPrivateEndpointResourceId Идентификатор ресурса частной конечной точки для KeyVault. Он должен находиться в той же виртуальной сети, что и том. Применимо только в том случае, если encryptionKeySource = "Microsoft.KeyVault". строка
ldapEnabled Указывает, включен ли протокол LDAP для заданного тома NFS. bool
networkFeatures Сетевые функции, доступные для тома или текущего состояния обновления. "Базовый"
'Basic_Standard'
"Стандартный"
'Standard_Basic'
placementRules Правила размещения для конкретного тома для конкретного приложения PlacementKeyValuePairs[]
protocolTypes Набор типов протоколов, NFSv3 по умолчанию, CIFS для протокола SMB string[]
proximityPlacementGroup Группа размещения близкого взаимодействия, связанная с томом строка
securityStyle Стиль безопасности тома, unix по умолчанию, по умолчанию — ntfs для двойного протокола или протокола CIFS. "ntfs"
"unix"
serviceLevel Уровень обслуживания файловой системы "Премиум"
"Стандартный"
'StandardZRS'
"Ультра"
smbAccessBasedEnumeration Включает свойство общего ресурса перечисления на основе доступа для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
smbContinuouslyAvailable Включает непрерывно доступное свойство общего ресурса для тома smb. Применимо только для тома SMB bool
smbEncryption Включает шифрование для данных smb3 в полете. Применимо только для тома SMB/DualProtocol. Для использования с swagger версии 2020-08-01 или более поздней bool
smbNonBrowsable Включает недоступное для просмотра свойство для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
snapshotDirectoryVisible Если этот параметр включен (true), том будет содержать каталог snapshot только для чтения, который предоставляет доступ к каждому моментальному снимку тома (по умолчанию — true). bool
snapshotId UUID версии 4 или идентификатор ресурса, используемый для идентификации моментального снимка. строка
subnetId URI ресурса Azure для делегированной подсети. Необходимо иметь делегирование Microsoft.NetApp/volumes string (обязательно)
пропускная способностьMibps Максимальная пропускная способность в МиБ/с, которая может быть достигнута этим томом и будет приниматься в качестве входных данных только для ручного тома qosType INT
unixPermissions Разрешения UNIX для тома NFS принимаются в восьмеричном 4-значном формате. Первая цифра выбирает набор атрибутов идентификатора пользователя (4), идентификатора группы (2) и атрибута sticky (1). Вторая цифра выбирает разрешение для владельца файла: чтение (4), запись (2) и выполнение (1). Третий выбирает разрешения для других пользователей в той же группе. четвертое для других пользователей, не в группе. 0755 — предоставляет разрешения на чтение, запись и выполнение владельцу, а также на чтение и выполнение для групп и других пользователей. строка

Ограничения:
Минимальная длина = 4
Максимальная длина = 4
usageThreshold Максимальная квота хранилища, разрешенная для файловой системы в байтах. Это мягкая квота, используемая только для оповещений. Минимальный размер — 100 ГиБ. Верхний предел — 100TiB, 500Tib для LargeVolume или 2400Tib для LargeVolume в исключительных случаях. Указывается в байтах. int (обязательно)

Ограничения:
Минимальное значение = 107374182400
Максимальное значение = 2638827906662400
volumeSpecName Имя спецификации тома — это конкретное обозначение или идентификатор конкретного тома в группе томов, например данные, журнал. строка
volumeType Какой тип тома. Для конечных томов в репликации между регионами задайте тип DataProtection. строка

VolumePropertiesDataProtection

Имя Описание Значение
репликация; Свойства репликации ReplicationObject
snapshot Свойства моментального снимка. VolumeSnapshotProperties
volumeRelocation Свойства VolumeRelocation VolumeRelocationProperties

ReplicationObject

Имя Описание Значение
endpointType Указывает, является ли локальный том источником или местом назначения для репликации тома. 'dst'
'src'
remoteVolumeRegion Удаленный регион для другого конца репликации тома. строка
remoteVolumeResourceId Идентификатор ресурса удаленного тома. string (обязательно)
replicationSchedule Расписание '_10minutely'
'daily'
"hourly"

VolumeSnapshotProperties

Имя Описание Значение
snapshotPolicyId ResourceId политики моментальных снимков строка

VolumeRelocationProperties

Имя Описание Значение
RelocationRequested Запрашивается ли перемещение для этого тома bool

VolumePropertiesExportPolicy

Имя Описание Значение
правила Правило политики экспорта ExportPolicyRule[]

ExportPolicyRule

Имя Описание Значение
allowedClients Спецификация входящего трафика клиента в виде строки с разделителями-запятыми с IPv4 CIDR, адресами узлов IPv4 и именами узлов строка
chownMode Этот параметр указывает, кто имеет право на изменение владельца файла. restricted — только привилегированный пользователь может изменить владельца файла. неограничен — пользователи, не являющиеся корневыми, могут изменять владельца файлов, которыми они владеют. "Restricted"
'Неограниченный'
Cifs Разрешает протокол CIFS bool
hasRootAccess Имеет корневой доступ к тому bool
kerberos5iReadWrite Доступ для чтения и записи Kerberos5i. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5pReadWrite Доступ для чтения и записи Kerberos5p. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5ReadWrite Доступ на чтение и запись Kerberos5. Для использования с swagger версии 2020-05-01 или более поздней bool
NFSv3 Разрешает протокол NFSv3. Включить только для томов типа NFSv3 bool
nfsv41 Разрешает протокол NFSv4.1. Включить только для томов типа NFSv4.1 bool
ruleIndex Индекс порядка INT
unixReadWrite Доступ на чтение и запись bool

PlacementKeyValuePairs

Имя Описание Значение
key Ключ для конкретного параметра приложения для размещения томов в группе томов строка (обязательно)
значение Значение параметра конкретного приложения для размещения томов в группе томов строка (обязательно)

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

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

Шаблон Описание
Создание ресурса ANF с томом NFSV3/NFSv4.1

Развертывание в Azure
Этот шаблон позволяет создать ресурс Azure NetApp Files с одним пулом емкости и одним томом, настроенным с помощью протокола NFSV3 или NFSv4.1. Все они развертываются вместе с виртуальная сеть Azure и делегированной подсетью, которые необходимы для создания любого тома.
Создание ресурса ANF с томом SMB

Развертывание в Azure
Этот шаблон позволяет создать ресурс Azure NetApp Files с одним пулом емкости и одним томом, настроенным с помощью протокола SMB.

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

Тип ресурса netAppAccounts/capacityPools/volumes можно развернуть с помощью следующих операций:

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

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

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

{
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "apiVersion": "2023-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "avsDataStore": "string",
    "backupId": "string",
    "capacityPoolResourceId": "string",
    "coolAccess": "bool",
    "coolAccessRetrievalPolicy": "string",
    "coolnessPeriod": "int",
    "creationToken": "string",
    "dataProtection": {
      "replication": {
        "endpointType": "string",
        "remoteVolumeRegion": "string",
        "remoteVolumeResourceId": "string",
        "replicationSchedule": "string"
      },
      "snapshot": {
        "snapshotPolicyId": "string"
      },
      "volumeRelocation": {
        "relocationRequested": "bool"
      }
    },
    "defaultGroupQuotaInKiBs": "int",
    "defaultUserQuotaInKiBs": "int",
    "deleteBaseSnapshot": "bool",
    "enableSubvolumes": "string",
    "encryptionKeySource": "string",
    "exportPolicy": {
      "rules": [
        {
          "allowedClients": "string",
          "chownMode": "string",
          "cifs": "bool",
          "hasRootAccess": "bool",
          "kerberos5iReadWrite": "bool",
          "kerberos5pReadWrite": "bool",
          "kerberos5ReadWrite": "bool",
          "nfsv3": "bool",
          "nfsv41": "bool",
          "ruleIndex": "int",
          "unixReadWrite": "bool"
        }
      ]
    },
    "isDefaultQuotaEnabled": "bool",
    "isLargeVolume": "bool",
    "isRestoring": "bool",
    "kerberosEnabled": "bool",
    "keyVaultPrivateEndpointResourceId": "string",
    "ldapEnabled": "bool",
    "networkFeatures": "string",
    "placementRules": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "protocolTypes": [ "string" ],
    "proximityPlacementGroup": "string",
    "securityStyle": "string",
    "serviceLevel": "string",
    "smbAccessBasedEnumeration": "string",
    "smbContinuouslyAvailable": "bool",
    "smbEncryption": "bool",
    "smbNonBrowsable": "string",
    "snapshotDirectoryVisible": "bool",
    "snapshotId": "string",
    "subnetId": "string",
    "throughputMibps": "int",
    "unixPermissions": "string",
    "usageThreshold": "int",
    "volumeSpecName": "string",
    "volumeType": "string"
  },
  "zones": [ "string" ]
}

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

netAppAccounts/capacityPools/volumes

Имя Описание Значение
тип Тип ресурса Microsoft.NetApp/netAppAccounts/capacityPools/volumes
версия_API Версия API ресурсов '2023-07-01'
name имя ресурса.

Узнайте, как задать имена и типы для дочерних ресурсов в шаблонах JSON ARM.
строка (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
tags Теги ресурсов. Словарь имен и значений тегов. См . раздел Теги в шаблонах
properties Свойства тома VolumeProperties (обязательно)
зоны; Зона доступности string[]

Ограничения:
Минимальная длина = 1
Максимальная длина = 255

VolumeProperties

Имя Описание Значение
avsDataStore Указывает, включен ли том для назначения хранилища данных Решение Azure VMware (AVS) "Отключено"
"Включено"
backupId UUID версии 4 или идентификатор ресурса, используемый для идентификации резервной копии. строка
capacityPoolResourceId Идентификатор ресурса пула, используемый при создании тома через группу томов строка
coolAccess Указывает, включен ли холодный доступ (по уровням) для тома. bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy определяет поведение извлечения данных из холодного уровня в хранилище уровня "Стандартный" на основе шаблона чтения для томов с поддержкой холодного доступа. Возможные значения для этого поля:
По умолчанию — данные будут извлекаться из холодного уровня в хранилище уровня "Стандартный" при случайном чтении. Эта политика используется по умолчанию.
OnRead — все операции чтения данных, управляемые клиентом, извлекается из хранилища холодного уровня в хранилище уровня "Стандартный" при последовательных и случайных чтениях.
Никогда — данные, управляемые клиентом, не извлекается из хранилища холодного уровня в хранилище уровня "Стандартный".
'Default'
"Никогда"
OnRead
coolnessPeriod Указывает количество дней, по истечении которых данные, к которым клиенты не обращаются, будут многоуровневые. INT

Ограничения:
Минимальное значение = 7
Максимальное значение = 183
creationToken Уникальный путь к файлу тома. Используется при создании целевых объектов подключения string (обязательно)

Ограничения:
Минимальная длина = 1
Максимальная длина = 80
Шаблон = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection Тома типа DataProtection включают объект, содержащий сведения о репликации. VolumePropertiesDataProtection
defaultGroupQuotaInKiBs Квота группы по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
defaultUserQuotaInKiBs Квота пользователя по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
deleteBaseSnapshot Если этот параметр включен (true), snapshot, из которого был создан том, будет автоматически удален после завершения операции создания тома. Значение по умолчанию — false. bool
enableSubvolumes Флаг, указывающий, включены ли операции вложенных операций на томе "Отключено"
"Включено"
encryptionKeySource Источник ключа, используемого для шифрования данных в томе. Применимо, если учетная запись NetApp имеет encryption.keySource = Microsoft.KeyVault. Возможные значения (без учета регистра): "Microsoft.NetApp, Microsoft.KeyVault" Microsoft.KeyVault
Microsoft.NetApp
exportPolicy Набор правил политики экспорта VolumePropertiesExportPolicy
isDefaultQuotaEnabled Указывает, включена ли квота по умолчанию для тома. bool
isLargeVolume Указывает, является ли том большим томом или обычным. bool
isRestoring Восстановление из копии bool
kerberosEnabled Описать, является ли том kerberosEnabled. Для использования с swagger версии 2020-05-01 или более поздней bool
keyVaultPrivateEndpointResourceId Идентификатор ресурса частной конечной точки для KeyVault. Он должен находиться в той же виртуальной сети, что и том. Применимо только в том случае, если encryptionKeySource = "Microsoft.KeyVault". строка
ldapEnabled Указывает, включен ли протокол LDAP для заданного тома NFS. bool
networkFeatures Сетевые функции, доступные для тома или текущего состояния обновления. "Базовый"
'Basic_Standard'
"Стандартный"
'Standard_Basic'
placementRules Правила размещения для конкретного тома для конкретного приложения PlacementKeyValuePairs[]
protocolTypes Набор типов протоколов, NFSv3 по умолчанию, CIFS для протокола SMB string[]
proximityPlacementGroup Группа размещения близкого взаимодействия, связанная с томом строка
securityStyle Стиль безопасности тома, unix по умолчанию, по умолчанию — ntfs для двойного протокола или протокола CIFS. "ntfs"
"unix"
serviceLevel Уровень обслуживания файловой системы "Премиум"
"Стандартный"
'StandardZRS'
"Ультра"
smbAccessBasedEnumeration Включает свойство общего ресурса перечисления на основе доступа для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
smbContinuouslyAvailable Включает непрерывно доступное свойство общего ресурса для тома smb. Применимо только для тома SMB bool
smbEncryption Включает шифрование для данных smb3 в полете. Применимо только для тома SMB/DualProtocol. Для использования с swagger версии 2020-08-01 или более поздней bool
smbNonBrowsable Включает недоступное для просмотра свойство для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
snapshotDirectoryVisible Если этот параметр включен (true), том будет содержать каталог snapshot только для чтения, который предоставляет доступ к каждому моментальному снимку тома (по умолчанию — true). bool
snapshotId UUID версии 4 или идентификатор ресурса, используемый для идентификации моментального снимка. строка
subnetId URI ресурса Azure для делегированной подсети. Необходимо иметь делегирование Microsoft.NetApp/volumes string (обязательно)
пропускная способностьMibps Максимальная пропускная способность в МиБ/с, которая может быть достигнута этим томом и будет приниматься в качестве входных данных только для ручного тома qosType INT
unixPermissions Разрешения UNIX для тома NFS принимаются в восьмеричном 4-значном формате. Первая цифра выбирает набор атрибутов идентификатора пользователя (4), идентификатора группы (2) и атрибута sticky (1). Вторая цифра выбирает разрешение для владельца файла: чтение (4), запись (2) и выполнение (1). Третий выбирает разрешения для других пользователей в той же группе. четвертое для других пользователей, не в группе. 0755 — предоставляет разрешения на чтение, запись и выполнение владельцу, а также на чтение и выполнение для групп и других пользователей. строка

Ограничения:
Минимальная длина = 4
Максимальная длина = 4
usageThreshold Максимальная квота хранилища, разрешенная для файловой системы в байтах. Это мягкая квота, используемая только для оповещений. Минимальный размер — 100 ГиБ. Верхний предел — 100TiB, 500Tib для LargeVolume или 2400Tib для LargeVolume в исключительных случаях. Указывается в байтах. int (обязательно)

Ограничения:
Минимальное значение = 107374182400
Максимальное значение = 2638827906662400
volumeSpecName Имя спецификации тома — это конкретное обозначение или идентификатор конкретного тома в группе томов, например данные, журнал. строка
volumeType Какой тип тома. Для конечных томов в репликации между регионами задайте тип DataProtection. строка

VolumePropertiesDataProtection

Имя Описание Значение
репликация; Свойства репликации ReplicationObject
snapshot Свойства моментального снимка. VolumeSnapshotProperties
volumeRelocation Свойства VolumeRelocation VolumeRelocationProperties

ReplicationObject

Имя Описание Значение
endpointType Указывает, является ли локальный том источником или местом назначения для репликации тома. 'dst'
'src'
remoteVolumeRegion Удаленный регион для другого конца репликации тома. строка
remoteVolumeResourceId Идентификатор ресурса удаленного тома. string (обязательно)
replicationSchedule Расписание '_10minutely'
'daily'
"hourly"

VolumeSnapshotProperties

Имя Описание Значение
snapshotPolicyId ResourceId политики моментальных снимков строка

VolumeRelocationProperties

Имя Описание Значение
RelocationRequested Запрашивается ли перемещение для этого тома bool

VolumePropertiesExportPolicy

Имя Описание Значение
правила Правило политики экспорта ExportPolicyRule[]

ExportPolicyRule

Имя Описание Значение
allowedClients Спецификация входящего трафика клиента в виде строки с разделителями-запятыми с идентификаторами CIDR IPv4, адресами узлов IPv4 и именами узлов строка
chownMode Этот параметр указывает, кто имеет право изменять владельца файла. restricted — только корневой пользователь может изменить владельца файла. неограничен — пользователи, не являющиеся корневыми, могут сменить владельца файлов, которыми они владеют. "Ограниченный"
'Неограниченный'
Cifs Разрешает протокол CIFS bool
hasRootAccess Имеет корневой доступ к тому bool
kerberos5iReadWrite Доступ на чтение и запись Kerberos5i. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5pReadWrite Доступ на чтение и запись Kerberos5p. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5ReadWrite Доступ на чтение и запись Kerberos5. Для использования с swagger версии 2020-05-01 или более поздней bool
NFSv3 Разрешает протокол NFSv3. Включить только для томов типа NFSv3 bool
nfsv41 Разрешает протокол NFSv4.1. Включить только для томов типа NFSv4.1 bool
ruleIndex Индекс заказа INT
unixReadWrite Доступ на чтение и запись bool

PlacementKeyValuePairs

Имя Описание Значение
key Ключ для конкретного параметра приложения для размещения томов в группе томов string (обязательно)
значение Значение параметра конкретного приложения для размещения томов в группе томов string (обязательно)

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

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

Шаблон Описание
Создание нового ресурса ANF с томом NFSV3/NFSv4.1

Развертывание в Azure
Этот шаблон позволяет создать новый ресурс Azure NetApp Files с одним пулом емкости и одним томом, настроенным по протоколу NFSV3 или NFSv4.1. Все они развертываются вместе с виртуальная сеть Azure и делегированной подсетью, которые необходимы для создания любого тома.
Создание ресурса ANF с томом SMB

Развертывание в Azure
Этот шаблон позволяет создать новый ресурс Azure NetApp Files с одним пулом емкости и одним томом, настроенным по протоколу SMB.

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

Тип ресурса netAppAccounts/capacityPools/volumes можно развернуть с помощью следующих операций:

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2023-07-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      avsDataStore = "string"
      backupId = "string"
      capacityPoolResourceId = "string"
      coolAccess = bool
      coolAccessRetrievalPolicy = "string"
      coolnessPeriod = int
      creationToken = "string"
      dataProtection = {
        replication = {
          endpointType = "string"
          remoteVolumeRegion = "string"
          remoteVolumeResourceId = "string"
          replicationSchedule = "string"
        }
        snapshot = {
          snapshotPolicyId = "string"
        }
        volumeRelocation = {
          relocationRequested = bool
        }
      }
      defaultGroupQuotaInKiBs = int
      defaultUserQuotaInKiBs = int
      deleteBaseSnapshot = bool
      enableSubvolumes = "string"
      encryptionKeySource = "string"
      exportPolicy = {
        rules = [
          {
            allowedClients = "string"
            chownMode = "string"
            cifs = bool
            hasRootAccess = bool
            kerberos5iReadWrite = bool
            kerberos5pReadWrite = bool
            kerberos5ReadWrite = bool
            nfsv3 = bool
            nfsv41 = bool
            ruleIndex = int
            unixReadWrite = bool
          }
        ]
      }
      isDefaultQuotaEnabled = bool
      isLargeVolume = bool
      isRestoring = bool
      kerberosEnabled = bool
      keyVaultPrivateEndpointResourceId = "string"
      ldapEnabled = bool
      networkFeatures = "string"
      placementRules = [
        {
          key = "string"
          value = "string"
        }
      ]
      protocolTypes = [
        "string"
      ]
      proximityPlacementGroup = "string"
      securityStyle = "string"
      serviceLevel = "string"
      smbAccessBasedEnumeration = "string"
      smbContinuouslyAvailable = bool
      smbEncryption = bool
      smbNonBrowsable = "string"
      snapshotDirectoryVisible = bool
      snapshotId = "string"
      subnetId = "string"
      throughputMibps = int
      unixPermissions = "string"
      usageThreshold = int
      volumeSpecName = "string"
      volumeType = "string"
    }
    zones = [
      "string"
    ]
  })
}

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

netAppAccounts/capacityPools/volumes

Имя Описание Значение
тип Тип ресурса "Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2023-07-01"
name имя ресурса. строка (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: capacityPools
tags Теги ресурсов. Словарь имен и значений тегов.
properties Свойства тома VolumeProperties (обязательно)
зоны; Зона доступности string[]

Ограничения:
Минимальная длина = 1
Максимальная длина = 255

VolumeProperties

Имя Описание Значение
avsDataStore Указывает, включен ли том для хранилища данных Решение Azure VMware (AVS) "Отключено"
"Включено"
backupId UUID версии 4 или идентификатор ресурса, используемый для идентификации резервной копии. строка
capacityPoolResourceId Идентификатор ресурса пула, используемый при создании тома с помощью группы томов строка
coolAccess Указывает, включен ли холодный доступ (по уровням) для тома. bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy определяет поведение получения данных из холодного уровня в хранилище уровня "Стандартный" на основе шаблона чтения для томов с поддержкой холодного доступа. Возможные значения для этого поля:
По умолчанию — данные будут извлекаться из холодного уровня в хранилище уровня "Стандартный" при случайных чтениях. Эта политика используется по умолчанию.
OnRead — все операции чтения данных, управляемые клиентом, извлекается из холодного уровня в хранилище уровня "Стандартный" при последовательных и случайных чтениях.
Никогда — данные, управляемые клиентом, не извлекается из хранилища холодного уровня в хранилище уровня "Стандартный".
"По умолчанию"
"Никогда"
OnRead
coolnessPeriod Указывает количество дней, по истечении которого данные, к которым клиенты не обращаются, будут по уровням. INT

Ограничения:
Минимальное значение = 7
Максимальное значение = 183
creationToken Уникальный путь к файлу тома. Используется при создании целевых объектов подключения строка (обязательно)

Ограничения:
Минимальная длина = 1
Максимальная длина = 80
Шаблон = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection Тома типа DataProtection включают объект, содержащий сведения о репликации. VolumePropertiesDataProtection
defaultGroupQuotaInKiBs Квота группы по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
defaultUserQuotaInKiBs Квота пользователя по умолчанию для тома в КиБ. Если задан параметр isDefaultQuotaEnabled, применяется минимальное значение в 4 КиБ. INT
deleteBaseSnapshot Если параметр включен (true), snapshot, из которого был создан том, будет автоматически удален после завершения операции создания тома. Значение по умолчанию — false. bool
enableSubvolumes Флаг, указывающий, включены ли на томе операции вложенных операций "Отключено"
"Включено"
encryptionKeySource Источник ключа, используемого для шифрования данных в томе. Применимо, если учетная запись NetApp имеет encryption.keySource = "Microsoft.KeyVault". Возможные значения (без учета регистра): "Microsoft.NetApp, Microsoft.KeyVault". Microsoft.KeyVault
Microsoft.NetApp
exportPolicy Набор правил политики экспорта VolumePropertiesExportPolicy
isDefaultQuotaEnabled Указывает, включена ли квота по умолчанию для тома. bool
isLargeVolume Указывает, является ли том большим или обычным. bool
isRestoring Восстановление из копии bool
kerberosEnabled Описать, является ли том kerberosEnabled. Для использования с swagger версии 2020-05-01 или более поздней bool
keyVaultPrivateEndpointResourceId Идентификатор ресурса частной конечной точки для KeyVault. Он должен находиться в той же виртуальной сети, что и том. Применимо только в том случае, если encryptionKeySource = 'Microsoft.KeyVault'. строка
ldapEnabled Указывает, включен ли ldap для заданного тома NFS. bool
networkFeatures Сетевые функции, доступные для тома или текущего состояния обновления. "Basic"
"Basic_Standard"
"Стандартный"
"Standard_Basic"
placementRules Правила размещения конкретного приложения для конкретного тома PlacementKeyValuePairs[]
protocolTypes Набор типов протоколов, по умолчанию NFSv3, CIFS для протокола SMB string[]
proximityPlacementGroup Группа размещения близкого взаимодействия, связанная с томом строка
securityStyle Стиль безопасности тома, unix по умолчанию, по умолчанию — ntfs для двойного протокола или протокола CIFS. "ntfs"
"unix"
serviceLevel Уровень обслуживания файловой системы "Премиум"
"Стандартный"
"StandardZRS"
"Ультра"
smbAccessBasedEnumeration Включает свойство общего ресурса перечисления на основе доступа для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
smbContinuouslyAvailable Включает постоянно доступное свойство общего ресурса для тома smb. Применимо только для тома SMB bool
smbEncryption Включает шифрование для данных smb3 в режиме выполнения. Применимо только для тома SMB/DualProtocol. Для использования с swagger версии 2020-08-01 или более поздней bool
smbNonBrowsable Включает свойство, не являющееся просмотром, для общих папок SMB. Применимо только для тома SMB/DualProtocol "Отключено"
"Включено"
snapshotDirectoryVisible Если этот параметр включен (true), том будет содержать каталог snapshot только для чтения, который предоставляет доступ к каждому моментальному снимку тома (по умолчанию — true). bool
snapshotId UUID версии 4 или идентификатор ресурса, используемый для идентификации моментального снимка. строка
subnetId URI ресурса Azure для делегированной подсети. Необходимо иметь делегирование Microsoft.NetApp/volumes строка (обязательно)
throughputMibps Максимальная пропускная способность в МиБ/с, которая может быть достигнута этим томом, и будет приниматься в качестве входных данных только для ручного тома qosType INT
unixPermissions Разрешения UNIX для тома NFS принимаются в восьмеричном 4-значном формате. Первая цифра выбирает набор атрибутов идентификатора пользователя (4), идентификатора группы (2) и залипания (1). Вторая цифра выбирает разрешение для владельца файла: чтение (4), запись (2) и выполнение (1). Третий выбирает разрешения для других пользователей в той же группе. четвертое значение для других пользователей, не в группе. 0755 — предоставляет разрешения на чтение, запись и выполнение владельцу, а также на чтение и выполнение для группы и других пользователей. строка

Ограничения:
Минимальная длина = 4
Максимальная длина = 4
usageThreshold Максимальная квота хранилища для файловой системы в байтах. Это мягкая квота, используемая только для оповещений. Минимальный размер — 100 ГиБ. Верхний предел — 100TiB, 500Tib для LargeVolume или 2400Tib для LargeVolume в исключительных случаях. Указывается в байтах. int (обязательно)

Ограничения:
Минимальное значение = 107374182400
Максимальное значение = 2638827906662400
volumeSpecName Имя спецификации тома — это конкретное обозначение или идентификатор конкретного тома в группе томов, например данные, журнал. строка
volumeType Какой тип тома. Для конечных томов в репликации между регионами задайте тип DataProtection. строка

VolumePropertiesDataProtection

Имя Описание Значение
репликация; Свойства репликации ReplicationObject
snapshot Свойства моментального снимка. VolumeSnapshotProperties
volumeRelocation Свойства VolumeRelocation VolumeRelocationProperties

ReplicationObject

Имя Описание Значение
endpointType Указывает, является ли локальный том источником или местом назначения для репликации тома. "dst"
"src"
remoteVolumeRegion Удаленный регион для другого конца репликации тома. строка
remoteVolumeResourceId Идентификатор ресурса удаленного тома. string (обязательно)
replicationSchedule Расписание "_10minutely"
"daily"
"hourly"

VolumeSnapshotProperties

Имя Описание Значение
snapshotPolicyId ResourceId политики моментальных снимков строка

VolumeRelocationProperties

Имя Описание Значение
RelocationRequested Запрашивается ли перемещение для этого тома bool

VolumePropertiesExportPolicy

Имя Описание Значение
правила Правило политики экспорта ExportPolicyRule[]

ExportPolicyRule

Имя Описание Значение
allowedClients Спецификация входящего трафика клиента в виде строки с разделителями-запятыми с идентификаторами CIDR IPv4, адресами узлов IPv4 и именами узлов строка
chownMode Этот параметр указывает, кто имеет право изменять владельца файла. restricted — только корневой пользователь может изменить владельца файла. неограничен — пользователи, не являющиеся корневыми, могут сменить владельца файлов, которыми они владеют. "Ограниченный"
"Неограниченный"
Cifs Разрешает протокол CIFS bool
hasRootAccess Имеет корневой доступ к тому bool
kerberos5iReadWrite Доступ на чтение и запись Kerberos5i. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5pReadWrite Доступ на чтение и запись Kerberos5p. Для использования с swagger версии 2020-05-01 или более поздней bool
kerberos5ReadWrite Доступ на чтение и запись Kerberos5. Для использования с swagger версии 2020-05-01 или более поздней bool
NFSv3 Разрешает протокол NFSv3. Включить только для томов типа NFSv3 bool
nfsv41 Разрешает протокол NFSv4.1. Включить только для томов типа NFSv4.1 bool
ruleIndex Индекс порядка INT
unixReadWrite Доступ на чтение и запись bool

PlacementKeyValuePairs

Имя Описание Значение
key Ключ для конкретного параметра приложения для размещения томов в группе томов строка (обязательно)
значение Значение параметра конкретного приложения для размещения томов в группе томов строка (обязательно)