共用方式為


Microsoft.NetApp netAppAccounts/capacityPools/卷 2024-05-01

Bicep 資源定義

netAppAccounts/capacityPools/volumes 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.NetApp/netAppAccounts/capacityPools/volumes 資源,請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2024-05-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    avsDataStore: 'string'
    backupId: 'string'
    capacityPoolResourceId: 'string'
    coolAccess: bool
    coolAccessRetrievalPolicy: 'string'
    coolnessPeriod: int
    creationToken: 'string'
    dataProtection: {
      backup: {
        backupPolicyId: 'string'
        backupVaultId: 'string'
        policyEnforced: bool
      }
      replication: {
        endpointType: 'string'
        remotePath: {
          externalHostName: 'string'
          serverName: 'string'
          volumeName: '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
          kerberos5iReadOnly: bool
          kerberos5iReadWrite: bool
          kerberos5pReadOnly: bool
          kerberos5pReadWrite: bool
          kerberos5ReadOnly: bool
          kerberos5ReadWrite: bool
          nfsv3: bool
          nfsv41: bool
          ruleIndex: int
          unixReadOnly: bool
          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'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

屬性值

Microsoft.NetApp/netAppAccounts/capacityPools/卷

名稱 說明 價值觀
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 64
模式 = ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$ (必要)
父代 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增這個屬性。

如需詳細資訊,請參閱 父資源外部的子資源
類型資源的符號名稱: netAppAccounts/capacityPools
屬性 磁碟區屬性 VolumeProperties (必要)
標記 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
區域 可用性區域 字串

約束:
最小長度 = 1
最大長度 = 255[]

匯出策略規則

名稱 說明 價值觀
allowedClients (允許用戶端) 用戶端輸入規格以逗號分隔字串,其中包含IPv4CIDR、IPv4 主機名和主機名 字串
chownMode 此參數會指定誰有權變更檔案的擁有權。 受限制 - 只有根使用者可以變更檔案的擁有權。 不受限制 - 非根使用者可以變更其擁有的檔案擁有權。 “受限”
“不受限制”
CIFS 允許 CIFS 通訊協定 布爾 (bool)
hasRootAccess 具有磁碟區的根存取權 布爾 (bool)
kerberos5i唯讀 Kerberos5i 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5iReadWrite Kerberos5i 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadOnly Kerberos5p 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadWrite Kerberos5p 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5隻讀 Kerberos5 只讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5ReadWrite Kerberos5 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
NFSv3 允許 NFSv3 通訊協定。 僅針對 NFSv3 類型磁碟區啟用 布爾 (bool)
NFSv41 允許 NFSv4.1 通訊協定。 僅針對 NFSv4.1 類型磁碟區啟用 布爾 (bool)
ruleIndex 訂單索引 整數 (int)
unix只讀 唯讀存取 布爾 (bool)
unixReadWrite 讀取和寫入存取權 布爾 (bool)

PlacementKeyValuePairs

名稱 說明 價值觀
Key 磁碟區群組中磁碟區放置的應用程式特定參數索引鍵 字串 (必要)
價值 磁碟區群組中磁碟區放置的應用程式特定參數值 字串 (必要)

遠端路徑

名稱 說明 價值觀
externalHostName (外部主機名) ONTAP 主機的路徑 字串 (必要)
伺服器名稱 ONTAP 主機上的伺服器名稱 字串 (必要)
卷名稱 伺服器上的磁碟區名稱 字串 (必要)

ReplicationObject (複製物件)

名稱 說明 價值觀
endpoint類型 指出本機磁碟區是磁碟區復寫的來源或目的地 'DST'
'src'
遠端路徑 要移轉至 ANF 之磁碟區的完整路徑。 移轉磁碟區的必要專案 [RemotePath]
remoteVolumeRegion (遠端卷區域) 磁碟區復寫另一端的遠端區域。 字串
remoteVolumeResourceId 遠端磁碟區的資源標識碼。 字串 (必要)
replicationSchedule 排程 '每天'
“每小時”
“_10minutely”

TrackedResourceTags

名稱 說明 價值觀

VolumeBackupProperties

名稱 說明 價值觀
backupPolicyId 備份原則資源標識碼 字串
backupVaultId 檔 備份保存庫資源標識碼 字串
policyEnforced 策略 強制執行原則 布爾 (bool)

VolumeProperties (體積屬性)

名稱 說明 價值觀
avsDataStore 指定磁碟區是否已啟用 Azure VMware 解決方案 (AVS) 資料存放區用途 “已禁用”
“已啟用”
備份ID 用來識別備份的資源標識碼。 字串
capacityPoolResourceId 透過磁碟區群組建立磁碟區時所使用的集區資源標識碼 字串
酷訪問 指定是否為磁碟區啟用非經常性存取(階層處理)。 布爾 (bool)
coolAccessRetrievalPolicy coolAccessRetrievalPolicy 會根據已啟用非經常性存取的磁碟區讀取模式,決定從非經常性存取層到標準記憶體的數據擷取行為。 此欄位的可能值為:
預設值 - 資料會從非經常性存取層提取到隨機讀取的標準記憶體。 此原則是預設值。
OnRead - 所有用戶端驅動數據讀取都會從非經常性存取層提取到循序和隨機讀取的標準記憶體。
永不 - 不會從非經常性存取層提取任何用戶端驅動數據到標準記憶體。
預設
“從來沒有”
“OnRead”
coolnessPeriod (涼爽時期) 指定用戶端不會存取資料的天數。 int

約束:
最小值 = 2
最大值 = 183
creationToken 磁碟區的唯一檔案路徑。 建立掛接目標時使用 字串

約束:
最小長度 = 1
最大長度 = 80
模式 = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$ (必要)
數據保護 DataProtection 類型磁碟區包含包含複寫詳細數據的物件 VolumePropertiesDataProtection
defaultGroupQuotaInKiBs KiB 中磁碟區的預設群組配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
defaultUserQuotaInKiBs KiBs 中磁碟區的預設使用者配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
deleteBaseSnapshot 如果已啟用 (true),則磁碟區建立的快照集會在磁碟區建立作業完成之後自動刪除。 默認值為 false 布爾 (bool)
enableSubvolumes 指出磁碟區上是否啟用子捲作業的旗標 “已禁用”
“已啟用”
encryptionKeySource 用來加密磁碟區中數據的金鑰來源。 如果 NetApp 帳戶具有 encryption.keySource = 'Microsoft.KeyVault',則適用。 可能的值(不區分大小寫)為:'Microsoft.NetApp,Microsoft.KeyVault' “Microsoft.KeyVault”
“Microsoft.NetApp”
匯出策略 一組導出原則規則 VolumePropertiesExportPolicy 導出策略
isDefaultQuotaEnabled 已啟用 指定磁碟區是否啟用預設配額。 布爾 (bool)
isLargeVolume 指定磁碟區是大型磁碟區還是一般磁碟區。 布爾 (bool)
is正在恢復 恢復 布爾 (bool)
kerberos已啟用 描述磁碟區是否為 KerberosEnabled。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
keyVaultPrivateEndpointResourceId KeyVault 私人端點的資源標識碼。 它必須位於與磁碟區相同的 VNET 中。 只有在 encryptionKeySource = 'Microsoft.KeyVault' 時才適用。 字串
ldap已啟用 指定指定的NFS磁碟區是否啟用LDAP。 布爾 (bool)
網路特性 磁碟區可用的網路功能,或更新的目前狀態。 “基本”
“Basic_Standard”
“標準”
“Standard_Basic”
placementRules 特定磁碟區的應用程式特定放置規則 PlacementKeyValuePairs[]
protocolTypes 協議類型 一組通訊協定類型、預設的 NFSv3、SMB 通訊協定的 CIFS 字串[]
proximityPlacementGroup 與磁碟區相關聯的鄰近放置群組 字串
securityStyle 安全 磁碟區的安全性樣式,預設 unix,預設為 ntfs 的雙重通訊協定或 CIFS 通訊協定 'NTFS'
'unix'
serviceLevel 服務 檔系統的服務等級 “高級”
“標準”
“StandardZRS”
'Ultra'
smbAccessBased枚舉 啟用SMB共用的存取型列舉共享屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
smbContinuouslyAvailable 為smb磁碟區啟用持續可用的共享屬性。 僅適用於SMB磁碟區 布爾 (bool)
smb加密 啟用內部 smb3 資料的加密。 僅適用於SMB/DualProtocol磁碟區。 與 Swagger 版本 2020-08-01 或更新版本搭配使用 布爾 (bool)
smbNonBrowsable 啟用SMB共用不可瀏覽的屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
快照目錄可見 如果啟用 (true), 磁碟區將包含唯讀快照集目錄,可提供每個磁碟區快照集的存取權(預設值為 true)。 布爾 (bool)
快照ID 用來識別快照集的資源標識碼。 字串
子網ID 委派子網的 Azure 資源 URI。 必須有委派Microsoft.NetApp/volumes 字串 (必要)
輸送量Mibps MiB/s 中可透過此磁碟區達到的最大輸送量,這隻會接受為手動 qosType 磁碟區的輸入 整數 (int)
unix許可權 以八進位 4 位數格式接受的 NFS 磁碟區 UNIX 許可權。 第一個數字會選取設定的使用者標識元(4)、設定群組標識碼 (2) 和黏性 (1) 屬性。 第二位數會選取檔案擁有者的許可權:讀取 (4)、寫入 (2) 和執行 (1)。 第三個會選取相同群組中其他用戶的許可權。 群組中其他使用者的第四個。 0755 - 提供擁有者讀取/寫入/執行許可權給群組和其他使用者。 字串

約束:
最小長度 = 4
最大長度 = 4
usageThreshold 的 文件系統允許的記憶體配額上限,以位元組為單位。 這是僅用於警示的軟配額。 針對一般磁碟區,有效值介於 50GiB 到 100TiB 的範圍內。 對於大型磁碟區,有效值的範圍是 100TiB 到 500TiB,且以例外為基礎,從 2400GiB 到 2400TiB。 以位元組表示為1 GiB倍數的值。 int

約束:
最小值 = 53687091200
最大值 = 2638827906662400 (必要)
volumeSpecName (體積規格名稱) 磁碟區規格名稱是磁碟區群組中特定磁碟區的應用程式特定指定或標識元,例如數據、記錄 字串
容量類型 此磁碟區的類型為何。 針對跨區域復寫中的目的地磁碟區,請將類型設定為 DataProtection 字串

VolumePropertiesDataProtection

名稱 說明 價值觀
備份 備份屬性 VolumeBackupProperties
複寫 複寫屬性 ReplicationObject (複製物件)
快照集 快照集屬性。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation 屬性 VolumeRelocation屬性

VolumePropertiesExportPolicy 導出策略

名稱 說明 價值觀
規則 匯出原則規則 ExportPolicyRule[]

VolumeRelocation屬性

名稱 說明 價值觀
relocation已請求 已要求重新配置此磁碟區 布爾 (bool)

VolumeSnapshotProperties

名稱 說明 價值觀
快照策略 ID 快照集原則 ResourceId 字串

ARM 樣本資源定義

netAppAccounts/capacityPools/volumes 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.NetApp/netAppAccounts/capacityPools/volumes 資源,請將下列 JSON 新增至範本。

{
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "apiVersion": "2024-05-01",
  "name": "string",
  "location": "string",
  "properties": {
    "avsDataStore": "string",
    "backupId": "string",
    "capacityPoolResourceId": "string",
    "coolAccess": "bool",
    "coolAccessRetrievalPolicy": "string",
    "coolnessPeriod": "int",
    "creationToken": "string",
    "dataProtection": {
      "backup": {
        "backupPolicyId": "string",
        "backupVaultId": "string",
        "policyEnforced": "bool"
      },
      "replication": {
        "endpointType": "string",
        "remotePath": {
          "externalHostName": "string",
          "serverName": "string",
          "volumeName": "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",
          "kerberos5iReadOnly": "bool",
          "kerberos5iReadWrite": "bool",
          "kerberos5pReadOnly": "bool",
          "kerberos5pReadWrite": "bool",
          "kerberos5ReadOnly": "bool",
          "kerberos5ReadWrite": "bool",
          "nfsv3": "bool",
          "nfsv41": "bool",
          "ruleIndex": "int",
          "unixReadOnly": "bool",
          "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"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

屬性值

Microsoft.NetApp/netAppAccounts/capacityPools/卷

名稱 說明 價值觀
apiVersion API 版本 '2024-05-01'
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 64
模式 = ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$ (必要)
屬性 磁碟區屬性 VolumeProperties (必要)
標記 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
型別 資源類型 “Microsoft.NetApp/netAppAccounts/capacityPools/volumes”
區域 可用性區域 字串

約束:
最小長度 = 1
最大長度 = 255[]

匯出策略規則

名稱 說明 價值觀
allowedClients (允許用戶端) 用戶端輸入規格以逗號分隔字串,其中包含IPv4CIDR、IPv4 主機名和主機名 字串
chownMode 此參數會指定誰有權變更檔案的擁有權。 受限制 - 只有根使用者可以變更檔案的擁有權。 不受限制 - 非根使用者可以變更其擁有的檔案擁有權。 “受限”
“不受限制”
CIFS 允許 CIFS 通訊協定 布爾 (bool)
hasRootAccess 具有磁碟區的根存取權 布爾 (bool)
kerberos5i唯讀 Kerberos5i 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5iReadWrite Kerberos5i 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadOnly Kerberos5p 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadWrite Kerberos5p 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5隻讀 Kerberos5 只讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5ReadWrite Kerberos5 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
NFSv3 允許 NFSv3 通訊協定。 僅針對 NFSv3 類型磁碟區啟用 布爾 (bool)
NFSv41 允許 NFSv4.1 通訊協定。 僅針對 NFSv4.1 類型磁碟區啟用 布爾 (bool)
ruleIndex 訂單索引 整數 (int)
unix只讀 唯讀存取 布爾 (bool)
unixReadWrite 讀取和寫入存取權 布爾 (bool)

PlacementKeyValuePairs

名稱 說明 價值觀
Key 磁碟區群組中磁碟區放置的應用程式特定參數索引鍵 字串 (必要)
價值 磁碟區群組中磁碟區放置的應用程式特定參數值 字串 (必要)

遠端路徑

名稱 說明 價值觀
externalHostName (外部主機名) ONTAP 主機的路徑 字串 (必要)
伺服器名稱 ONTAP 主機上的伺服器名稱 字串 (必要)
卷名稱 伺服器上的磁碟區名稱 字串 (必要)

ReplicationObject (複製物件)

名稱 說明 價值觀
endpoint類型 指出本機磁碟區是磁碟區復寫的來源或目的地 'DST'
'src'
遠端路徑 要移轉至 ANF 之磁碟區的完整路徑。 移轉磁碟區的必要專案 [RemotePath]
remoteVolumeRegion (遠端卷區域) 磁碟區復寫另一端的遠端區域。 字串
remoteVolumeResourceId 遠端磁碟區的資源標識碼。 字串 (必要)
replicationSchedule 排程 '每天'
“每小時”
“_10minutely”

TrackedResourceTags

名稱 說明 價值觀

VolumeBackupProperties

名稱 說明 價值觀
backupPolicyId 備份原則資源標識碼 字串
backupVaultId 檔 備份保存庫資源標識碼 字串
policyEnforced 策略 強制執行原則 布爾 (bool)

VolumeProperties (體積屬性)

名稱 說明 價值觀
avsDataStore 指定磁碟區是否已啟用 Azure VMware 解決方案 (AVS) 資料存放區用途 “已禁用”
“已啟用”
備份ID 用來識別備份的資源標識碼。 字串
capacityPoolResourceId 透過磁碟區群組建立磁碟區時所使用的集區資源標識碼 字串
酷訪問 指定是否為磁碟區啟用非經常性存取(階層處理)。 布爾 (bool)
coolAccessRetrievalPolicy coolAccessRetrievalPolicy 會根據已啟用非經常性存取的磁碟區讀取模式,決定從非經常性存取層到標準記憶體的數據擷取行為。 此欄位的可能值為:
預設值 - 資料會從非經常性存取層提取到隨機讀取的標準記憶體。 此原則是預設值。
OnRead - 所有用戶端驅動數據讀取都會從非經常性存取層提取到循序和隨機讀取的標準記憶體。
永不 - 不會從非經常性存取層提取任何用戶端驅動數據到標準記憶體。
預設
“從來沒有”
“OnRead”
coolnessPeriod (涼爽時期) 指定用戶端不會存取資料的天數。 int

約束:
最小值 = 2
最大值 = 183
creationToken 磁碟區的唯一檔案路徑。 建立掛接目標時使用 字串

約束:
最小長度 = 1
最大長度 = 80
模式 = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$ (必要)
數據保護 DataProtection 類型磁碟區包含包含複寫詳細數據的物件 VolumePropertiesDataProtection
defaultGroupQuotaInKiBs KiB 中磁碟區的預設群組配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
defaultUserQuotaInKiBs KiBs 中磁碟區的預設使用者配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
deleteBaseSnapshot 如果已啟用 (true),則磁碟區建立的快照集會在磁碟區建立作業完成之後自動刪除。 默認值為 false 布爾 (bool)
enableSubvolumes 指出磁碟區上是否啟用子捲作業的旗標 “已禁用”
“已啟用”
encryptionKeySource 用來加密磁碟區中數據的金鑰來源。 如果 NetApp 帳戶具有 encryption.keySource = 'Microsoft.KeyVault',則適用。 可能的值(不區分大小寫)為:'Microsoft.NetApp,Microsoft.KeyVault' “Microsoft.KeyVault”
“Microsoft.NetApp”
匯出策略 一組導出原則規則 VolumePropertiesExportPolicy 導出策略
isDefaultQuotaEnabled 已啟用 指定磁碟區是否啟用預設配額。 布爾 (bool)
isLargeVolume 指定磁碟區是大型磁碟區還是一般磁碟區。 布爾 (bool)
is正在恢復 恢復 布爾 (bool)
kerberos已啟用 描述磁碟區是否為 KerberosEnabled。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
keyVaultPrivateEndpointResourceId KeyVault 私人端點的資源標識碼。 它必須位於與磁碟區相同的 VNET 中。 只有在 encryptionKeySource = 'Microsoft.KeyVault' 時才適用。 字串
ldap已啟用 指定指定的NFS磁碟區是否啟用LDAP。 布爾 (bool)
網路特性 磁碟區可用的網路功能,或更新的目前狀態。 “基本”
“Basic_Standard”
“標準”
“Standard_Basic”
placementRules 特定磁碟區的應用程式特定放置規則 PlacementKeyValuePairs[]
protocolTypes 協議類型 一組通訊協定類型、預設的 NFSv3、SMB 通訊協定的 CIFS 字串[]
proximityPlacementGroup 與磁碟區相關聯的鄰近放置群組 字串
securityStyle 安全 磁碟區的安全性樣式,預設 unix,預設為 ntfs 的雙重通訊協定或 CIFS 通訊協定 'NTFS'
'unix'
serviceLevel 服務 檔系統的服務等級 “高級”
“標準”
“StandardZRS”
'Ultra'
smbAccessBased枚舉 啟用SMB共用的存取型列舉共享屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
smbContinuouslyAvailable 為smb磁碟區啟用持續可用的共享屬性。 僅適用於SMB磁碟區 布爾 (bool)
smb加密 啟用內部 smb3 資料的加密。 僅適用於SMB/DualProtocol磁碟區。 與 Swagger 版本 2020-08-01 或更新版本搭配使用 布爾 (bool)
smbNonBrowsable 啟用SMB共用不可瀏覽的屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
快照目錄可見 如果啟用 (true), 磁碟區將包含唯讀快照集目錄,可提供每個磁碟區快照集的存取權(預設值為 true)。 布爾 (bool)
快照ID 用來識別快照集的資源標識碼。 字串
子網ID 委派子網的 Azure 資源 URI。 必須有委派Microsoft.NetApp/volumes 字串 (必要)
輸送量Mibps MiB/s 中可透過此磁碟區達到的最大輸送量,這隻會接受為手動 qosType 磁碟區的輸入 整數 (int)
unix許可權 以八進位 4 位數格式接受的 NFS 磁碟區 UNIX 許可權。 第一個數字會選取設定的使用者標識元(4)、設定群組標識碼 (2) 和黏性 (1) 屬性。 第二位數會選取檔案擁有者的許可權:讀取 (4)、寫入 (2) 和執行 (1)。 第三個會選取相同群組中其他用戶的許可權。 群組中其他使用者的第四個。 0755 - 提供擁有者讀取/寫入/執行許可權給群組和其他使用者。 字串

約束:
最小長度 = 4
最大長度 = 4
usageThreshold 的 文件系統允許的記憶體配額上限,以位元組為單位。 這是僅用於警示的軟配額。 針對一般磁碟區,有效值介於 50GiB 到 100TiB 的範圍內。 對於大型磁碟區,有效值的範圍是 100TiB 到 500TiB,且以例外為基礎,從 2400GiB 到 2400TiB。 以位元組表示為1 GiB倍數的值。 int

約束:
最小值 = 53687091200
最大值 = 2638827906662400 (必要)
volumeSpecName (體積規格名稱) 磁碟區規格名稱是磁碟區群組中特定磁碟區的應用程式特定指定或標識元,例如數據、記錄 字串
容量類型 此磁碟區的類型為何。 針對跨區域復寫中的目的地磁碟區,請將類型設定為 DataProtection 字串

VolumePropertiesDataProtection

名稱 說明 價值觀
備份 備份屬性 VolumeBackupProperties
複寫 複寫屬性 ReplicationObject (複製物件)
快照集 快照集屬性。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation 屬性 VolumeRelocation屬性

VolumePropertiesExportPolicy 導出策略

名稱 說明 價值觀
規則 匯出原則規則 ExportPolicyRule[]

VolumeRelocation屬性

名稱 說明 價值觀
relocation已請求 已要求重新配置此磁碟區 布爾 (bool)

VolumeSnapshotProperties

名稱 說明 價值觀
快照策略 ID 快照集原則 ResourceId 字串

使用範例

Azure 快速入門範本

下列 Azure 快速入門範本 部署此資源類型。

範本 說明
使用 NFSV3/NFSv4.1 磁碟區建立新的 ANF 資源

部署至 Azure
此範本可讓您建立新的 Azure NetApp Files 資源,其中包含單一容量集區和使用 NFSV3 或 NFSv4.1 通訊協定設定的單一磁碟區。 它們全都部署在一起,以及建立任何磁碟區所需的 Azure 虛擬網路和委派子網
使用SMB磁碟區建立新的ANF資源

部署至 Azure
此範本可讓您使用單一容量集區和使用SMB通訊協定設定的單一磁碟區來建立新的 Azure NetApp Files 資源。

Terraform (AzAPI 提供者) 資源定義

netAppAccounts/capacityPools/volumes 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.NetApp/netAppAccounts/capacityPools/volumes 資源,請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2024-05-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      avsDataStore = "string"
      backupId = "string"
      capacityPoolResourceId = "string"
      coolAccess = bool
      coolAccessRetrievalPolicy = "string"
      coolnessPeriod = int
      creationToken = "string"
      dataProtection = {
        backup = {
          backupPolicyId = "string"
          backupVaultId = "string"
          policyEnforced = bool
        }
        replication = {
          endpointType = "string"
          remotePath = {
            externalHostName = "string"
            serverName = "string"
            volumeName = "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
            kerberos5iReadOnly = bool
            kerberos5iReadWrite = bool
            kerberos5pReadOnly = bool
            kerberos5pReadWrite = bool
            kerberos5ReadOnly = bool
            kerberos5ReadWrite = bool
            nfsv3 = bool
            nfsv41 = bool
            ruleIndex = int
            unixReadOnly = bool
            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"
    ]
  }
}

屬性值

Microsoft.NetApp/netAppAccounts/capacityPools/卷

名稱 說明 價值觀
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 字串

約束:
最小長度 = 1
最大長度 = 64
模式 = ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$ (必要)
父項識別碼 此資源為父系之資源的標識碼。 類型資源的標識碼: netAppAccounts/capacityPools
屬性 磁碟區屬性 VolumeProperties (必要)
標記 資源標籤 標記名稱和值的字典。
型別 資源類型 “Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2024-05-01”
區域 可用性區域 字串

約束:
最小長度 = 1
最大長度 = 255[]

匯出策略規則

名稱 說明 價值觀
allowedClients (允許用戶端) 用戶端輸入規格以逗號分隔字串,其中包含IPv4CIDR、IPv4 主機名和主機名 字串
chownMode 此參數會指定誰有權變更檔案的擁有權。 受限制 - 只有根使用者可以變更檔案的擁有權。 不受限制 - 非根使用者可以變更其擁有的檔案擁有權。 “受限”
“不受限制”
CIFS 允許 CIFS 通訊協定 布爾 (bool)
hasRootAccess 具有磁碟區的根存取權 布爾 (bool)
kerberos5i唯讀 Kerberos5i 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5iReadWrite Kerberos5i 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadOnly Kerberos5p 唯讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5pReadWrite Kerberos5p 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5隻讀 Kerberos5 只讀存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
kerberos5ReadWrite Kerberos5 讀取和寫入存取權。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
NFSv3 允許 NFSv3 通訊協定。 僅針對 NFSv3 類型磁碟區啟用 布爾 (bool)
NFSv41 允許 NFSv4.1 通訊協定。 僅針對 NFSv4.1 類型磁碟區啟用 布爾 (bool)
ruleIndex 訂單索引 整數 (int)
unix只讀 唯讀存取 布爾 (bool)
unixReadWrite 讀取和寫入存取權 布爾 (bool)

PlacementKeyValuePairs

名稱 說明 價值觀
Key 磁碟區群組中磁碟區放置的應用程式特定參數索引鍵 字串 (必要)
價值 磁碟區群組中磁碟區放置的應用程式特定參數值 字串 (必要)

遠端路徑

名稱 說明 價值觀
externalHostName (外部主機名) ONTAP 主機的路徑 字串 (必要)
伺服器名稱 ONTAP 主機上的伺服器名稱 字串 (必要)
卷名稱 伺服器上的磁碟區名稱 字串 (必要)

ReplicationObject (複製物件)

名稱 說明 價值觀
endpoint類型 指出本機磁碟區是磁碟區復寫的來源或目的地 'DST'
'src'
遠端路徑 要移轉至 ANF 之磁碟區的完整路徑。 移轉磁碟區的必要專案 [RemotePath]
remoteVolumeRegion (遠端卷區域) 磁碟區復寫另一端的遠端區域。 字串
remoteVolumeResourceId 遠端磁碟區的資源標識碼。 字串 (必要)
replicationSchedule 排程 '每天'
“每小時”
“_10minutely”

TrackedResourceTags

名稱 說明 價值觀

VolumeBackupProperties

名稱 說明 價值觀
backupPolicyId 備份原則資源標識碼 字串
backupVaultId 檔 備份保存庫資源標識碼 字串
policyEnforced 策略 強制執行原則 布爾 (bool)

VolumeProperties (體積屬性)

名稱 說明 價值觀
avsDataStore 指定磁碟區是否已啟用 Azure VMware 解決方案 (AVS) 資料存放區用途 “已禁用”
“已啟用”
備份ID 用來識別備份的資源標識碼。 字串
capacityPoolResourceId 透過磁碟區群組建立磁碟區時所使用的集區資源標識碼 字串
酷訪問 指定是否為磁碟區啟用非經常性存取(階層處理)。 布爾 (bool)
coolAccessRetrievalPolicy coolAccessRetrievalPolicy 會根據已啟用非經常性存取的磁碟區讀取模式,決定從非經常性存取層到標準記憶體的數據擷取行為。 此欄位的可能值為:
預設值 - 資料會從非經常性存取層提取到隨機讀取的標準記憶體。 此原則是預設值。
OnRead - 所有用戶端驅動數據讀取都會從非經常性存取層提取到循序和隨機讀取的標準記憶體。
永不 - 不會從非經常性存取層提取任何用戶端驅動數據到標準記憶體。
預設
“從來沒有”
“OnRead”
coolnessPeriod (涼爽時期) 指定用戶端不會存取資料的天數。 int

約束:
最小值 = 2
最大值 = 183
creationToken 磁碟區的唯一檔案路徑。 建立掛接目標時使用 字串

約束:
最小長度 = 1
最大長度 = 80
模式 = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$ (必要)
數據保護 DataProtection 類型磁碟區包含包含複寫詳細數據的物件 VolumePropertiesDataProtection
defaultGroupQuotaInKiBs KiB 中磁碟區的預設群組配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
defaultUserQuotaInKiBs KiBs 中磁碟區的預設使用者配額。 如果已設定 isDefaultQuotaEnabled,則會套用 4 KiBs 的最小值。 整數 (int)
deleteBaseSnapshot 如果已啟用 (true),則磁碟區建立的快照集會在磁碟區建立作業完成之後自動刪除。 默認值為 false 布爾 (bool)
enableSubvolumes 指出磁碟區上是否啟用子捲作業的旗標 “已禁用”
“已啟用”
encryptionKeySource 用來加密磁碟區中數據的金鑰來源。 如果 NetApp 帳戶具有 encryption.keySource = 'Microsoft.KeyVault',則適用。 可能的值(不區分大小寫)為:'Microsoft.NetApp,Microsoft.KeyVault' “Microsoft.KeyVault”
“Microsoft.NetApp”
匯出策略 一組導出原則規則 VolumePropertiesExportPolicy 導出策略
isDefaultQuotaEnabled 已啟用 指定磁碟區是否啟用預設配額。 布爾 (bool)
isLargeVolume 指定磁碟區是大型磁碟區還是一般磁碟區。 布爾 (bool)
is正在恢復 恢復 布爾 (bool)
kerberos已啟用 描述磁碟區是否為 KerberosEnabled。 與 Swagger 版本 2020-05-01 或更新版本搭配使用 布爾 (bool)
keyVaultPrivateEndpointResourceId KeyVault 私人端點的資源標識碼。 它必須位於與磁碟區相同的 VNET 中。 只有在 encryptionKeySource = 'Microsoft.KeyVault' 時才適用。 字串
ldap已啟用 指定指定的NFS磁碟區是否啟用LDAP。 布爾 (bool)
網路特性 磁碟區可用的網路功能,或更新的目前狀態。 “基本”
“Basic_Standard”
“標準”
“Standard_Basic”
placementRules 特定磁碟區的應用程式特定放置規則 PlacementKeyValuePairs[]
protocolTypes 協議類型 一組通訊協定類型、預設的 NFSv3、SMB 通訊協定的 CIFS 字串[]
proximityPlacementGroup 與磁碟區相關聯的鄰近放置群組 字串
securityStyle 安全 磁碟區的安全性樣式,預設 unix,預設為 ntfs 的雙重通訊協定或 CIFS 通訊協定 'NTFS'
'unix'
serviceLevel 服務 檔系統的服務等級 “高級”
“標準”
“StandardZRS”
'Ultra'
smbAccessBased枚舉 啟用SMB共用的存取型列舉共享屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
smbContinuouslyAvailable 為smb磁碟區啟用持續可用的共享屬性。 僅適用於SMB磁碟區 布爾 (bool)
smb加密 啟用內部 smb3 資料的加密。 僅適用於SMB/DualProtocol磁碟區。 與 Swagger 版本 2020-08-01 或更新版本搭配使用 布爾 (bool)
smbNonBrowsable 啟用SMB共用不可瀏覽的屬性。 僅適用於SMB/DualProtocol磁碟區 “已禁用”
“已啟用”
快照目錄可見 如果啟用 (true), 磁碟區將包含唯讀快照集目錄,可提供每個磁碟區快照集的存取權(預設值為 true)。 布爾 (bool)
快照ID 用來識別快照集的資源標識碼。 字串
子網ID 委派子網的 Azure 資源 URI。 必須有委派Microsoft.NetApp/volumes 字串 (必要)
輸送量Mibps MiB/s 中可透過此磁碟區達到的最大輸送量,這隻會接受為手動 qosType 磁碟區的輸入 整數 (int)
unix許可權 以八進位 4 位數格式接受的 NFS 磁碟區 UNIX 許可權。 第一個數字會選取設定的使用者標識元(4)、設定群組標識碼 (2) 和黏性 (1) 屬性。 第二位數會選取檔案擁有者的許可權:讀取 (4)、寫入 (2) 和執行 (1)。 第三個會選取相同群組中其他用戶的許可權。 群組中其他使用者的第四個。 0755 - 提供擁有者讀取/寫入/執行許可權給群組和其他使用者。 字串

約束:
最小長度 = 4
最大長度 = 4
usageThreshold 的 文件系統允許的記憶體配額上限,以位元組為單位。 這是僅用於警示的軟配額。 針對一般磁碟區,有效值介於 50GiB 到 100TiB 的範圍內。 對於大型磁碟區,有效值的範圍是 100TiB 到 500TiB,且以例外為基礎,從 2400GiB 到 2400TiB。 以位元組表示為1 GiB倍數的值。 int

約束:
最小值 = 53687091200
最大值 = 2638827906662400 (必要)
volumeSpecName (體積規格名稱) 磁碟區規格名稱是磁碟區群組中特定磁碟區的應用程式特定指定或標識元,例如數據、記錄 字串
容量類型 此磁碟區的類型為何。 針對跨區域復寫中的目的地磁碟區,請將類型設定為 DataProtection 字串

VolumePropertiesDataProtection

名稱 說明 價值觀
備份 備份屬性 VolumeBackupProperties
複寫 複寫屬性 ReplicationObject (複製物件)
快照集 快照集屬性。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation 屬性 VolumeRelocation屬性

VolumePropertiesExportPolicy 導出策略

名稱 說明 價值觀
規則 匯出原則規則 ExportPolicyRule[]

VolumeRelocation屬性

名稱 說明 價值觀
relocation已請求 已要求重新配置此磁碟區 布爾 (bool)

VolumeSnapshotProperties

名稱 說明 價值觀
快照策略 ID 快照集原則 ResourceId 字串