次の方法で共有


Microsoft.NetApp netAppAccounts/capacityPools/volumes 2023-11-01

Bicep リソース定義

netAppAccounts/capacityPools/volumes リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.NetApp/netAppAccounts/capacityPools/volumes リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.NetApp/netAppAccounts/capacityPools/volumes@2023-11-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: {
      backup: {
        backupPolicyId: 'string'
        backupVaultId: 'string'
        policyEnforced: bool
      }
      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

名前 形容 価値
名前 リソース名

Bicepで子リソースの名前と種類 設定する方法を参照してください。
string (必須)
場所 リソースが存在する地理的な場所 string (必須)
タグ リソース タグ。 タグ名と値のディクショナリ。 テンプレート の タグを参照してください
Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。
種類のリソースのシンボリック名: capacityPools
プロパティ ボリュームのプロパティ VolumeProperties (必須)
ゾーン 可用性ゾーン string[]

制約:
最小長 = 1
最大長 = 255

VolumeProperties

名前 形容 価値
avsDataStore ボリュームが Azure VMware Solution (AVS) データストアの目的で有効になっているかどうかを指定します 'Disabled'
'Enabled'
backupId バックアップを識別するために使用されるリソース識別子。
capacityPoolResourceId ボリューム グループを使用してボリュームを作成する場合に使用されるプール リソース ID
coolAccess ボリュームに対してクール アクセス (階層化) を有効にするかどうかを指定します。 bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy は、クール アクセスが有効なボリュームの読み取りパターンに基づいて、クール層から Standard Storage へのデータ取得動作を決定します。 このフィールドに使用できる値は次のとおりです。
既定値 - データは、ランダム読み取り時にクール層から Standard ストレージにプルされます。 このポリシーが既定です。
OnRead - すべてのクライアント駆動型データ読み取りは、順次読み取りとランダム読み取りの両方でクール層から Standard ストレージにプルされます。
なし - クライアント駆動型データはクール層から Standard Storage にプルされません。
'Default'
'Never'
'OnRead'
coolnessPeriod クライアントがアクセスしないデータを階層化するまでの日数を指定します。 int

制約:
最小値 = 2
最大値 = 183
creationToken ボリュームの一意のファイル パス。 マウント ターゲットを作成するときに使用されます string (必須)

制約:
最小長 = 1
最大長 = 80
パターン = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection DataProtection の種類のボリュームには、レプリケーションの詳細を含むオブジェクトが含まれます VolumePropertiesDataProtection の
defaultGroupQuotaInKiBs KiB のボリュームの既定のグループ クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
defaultUserQuotaInKiBs KiB のボリュームの既定のユーザー クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
deleteBaseSnapshot 有効 (true) の場合、ボリュームの作成操作が完了すると、ボリュームの作成元のスナップショットが自動的に削除されます。 既定値は false bool
enableSubvolumes ボリュームでサブボリューム操作が有効かどうかを示すフラグ 'Disabled'
'Enabled'
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 のプライベート エンドポイントのリソース ID。 ボリュームと同じ VNET 内に存在する必要があります。 encryptionKeySource = 'Microsoft.KeyVault' の場合にのみ適用されます。
ldapEnabled 特定の NFS ボリュームに対して LDAP を有効にするかどうかを指定します。 bool
networkFeatures ボリュームで使用できるネットワーク機能、または更新の現在の状態。 'Basic'
'Basic_Standard'
'Standard'
'Standard_Basic'
placementRules 特定のボリュームのアプリケーション固有の配置規則 PlacementKeyValuePairs[]
protocolTypes 一連のプロトコルの種類、既定の NFSv3、SMB プロトコルの CIFS string[]
proximityPlacementGroup ボリュームに関連付けられている近接通信配置グループ
securityStyle ボリュームのセキュリティ スタイル (既定の unix)、デュアル プロトコルまたは CIFS プロトコルの場合は既定で ntfs 'ntfs'
'unix'
serviceLevel ファイル システムのサービス レベル 'Premium'
'Standard'
'StandardZRS'
'Ultra'
smbAccessBasedEnumeration SMB 共有のアクセス ベースの列挙共有プロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます 'Disabled'
'Enabled'
smbContinuouslyAvailable smb ボリュームに対して継続的に使用可能な共有プロパティを有効にします。 SMB ボリュームにのみ適用されます bool
smbEncryption 転送中の smb3 データの暗号化を有効にします。 SMB/DualProtocol ボリュームにのみ適用されます。 swagger バージョン 2020-08-01 以降で使用する bool
smbNonBrowsable SMB 共有のブロウズ不可能なプロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます 'Disabled'
'Enabled'
snapshotDirectoryVisible 有効 (true) の場合、ボリュームには、各ボリュームのスナップショットへのアクセスを提供する読み取り専用のスナップショット ディレクトリが含まれます (既定値は true)。 bool
snapshotId スナップショットを識別するために使用されるリソース識別子。
subnetId 委任されたサブネットの Azure リソース URI。 委任 Microsoft.NetApp/ボリュームが必要です string (必須)
throughputMibps このボリュームで実現できる MiB/秒の最大スループット。これは手動 qosType ボリュームの入力としてのみ受け入れられます int
unixPermissions 8 進数の 4 桁の形式で受け入れられる NFS ボリュームに対する UNIX アクセス許可。 最初の桁は、設定されたユーザー ID (4)、グループ ID (2) およびスティッキー (1) 属性を選択します。 2 桁目は、ファイルの所有者のアクセス許可を選択します。読み取り (4)、書き込み (2)、実行 (1) です。 3 番目は、同じグループ内の他のユーザーのアクセス許可を選択します。 グループに含まれていない他のユーザーの場合は 4 番目です。 0755 - 所有者に読み取り/書き込み/実行アクセス許可を付与し、グループやその他のユーザーに対して読み取り/実行を行います。

制約:
最小長 = 4
最大長 = 4
usageThreshold ファイル システムで許容される最大ストレージ クォータ (バイト単位)。 これは、アラートにのみ使用されるソフト クォータです。 最小サイズは 100 GiB です。 上限は、100TiB、LargeVolume の場合は 500Tib、LargeVolume の場合は 2400Tib です。例外的な基準です。 バイト単位で指定します。 int (必須)

制約:
最小値 = 107374182400
最大値 = 2638827906662400
volumeSpecName ボリューム スペック名は、データ、ログなどのボリューム グループ内の特定のボリュームに対するアプリケーション固有の指定または識別子です。
volumeType ボリュームの種類は何ですか。 リージョン間レプリケーションの宛先ボリュームの場合は、種類を DataProtection に設定します

VolumePropertiesDataProtection

名前 形容 価値
バックアップ バックアップのプロパティ VolumeBackupProperties
複製 レプリケーションのプロパティ ReplicationObject
スナップショット スナップショットのプロパティ。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation プロパティ VolumeRelocationProperties の

VolumeBackupProperties

名前 形容 価値
backupPolicyId バックアップ ポリシーのリソース ID
backupVaultId バックアップ コンテナーのリソース ID
policyEnforced ポリシーの適用 bool

ReplicationObject

名前 形容 価値
endpointType ローカル ボリュームがボリューム レプリケーションのソースか宛先かを示します 'dst'
'src'
remoteVolumeRegion ボリューム レプリケーションのもう一方の端のリモート リージョン。
remoteVolumeResourceId リモート ボリュームのリソース ID。 string (必須)
replicationSchedule 計画 '_10minutely'
'daily'
'hourly'

VolumeSnapshotProperties

名前 形容 価値
snapshotPolicyId スナップショット ポリシー ResourceId

VolumeRelocationProperties

名前 形容 価値
relocationRequested このボリュームに再配置が要求されました bool

VolumePropertiesExportPolicy

名前 形容 価値
準則 ポリシー ルールのエクスポート ExportPolicyRule[]

ExportPolicyRule

名前 形容 価値
allowedClients IPv4 CIDR、IPv4 ホスト アドレス、およびホスト名を含むコンマ区切り文字列としてのクライアントイングレス仕様
chownMode このパラメーターは、ファイルの所有権を変更する権限を持つユーザーを指定します。 restricted - ルート ユーザーのみがファイルの所有権を変更できます。 無制限 - 非ルート ユーザーは、自分が所有するファイルの所有権を変更できます。 'Restricted'
'Unrestricted'
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

名前 形容 価値
ボリューム グループ内のボリュームを配置するためのアプリケーション固有のパラメーターのキー string (必須)
価値 ボリューム グループ内のボリュームの配置に関するアプリケーション固有のパラメーターの値 string (必須)

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
NFSV3/NFSv4.1 ボリューム を使用して新しい ANF リソースを作成する

Azure にデプロイする
このテンプレートを使用すると、NFSV3 または NFSv4.1 プロトコルで構成された単一の容量プールと単一ボリュームを使用して、新しい Azure NetApp Files リソースを作成できます。 これらはすべて、任意のボリュームを作成するために必要な Azure Virtual Network と委任されたサブネットと共にデプロイされます
SMB ボリューム を使用して新しい ANF リソースを作成する

Azure にデプロイする
このテンプレートを使用すると、1 つの容量プールと SMB プロトコルで構成された単一ボリュームを使用して、新しい Azure NetApp Files リソースを作成できます。

ARM テンプレート リソース定義

netAppAccounts/capacityPools/volumes リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.NetApp/netAppAccounts/capacityPools/volumes リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "apiVersion": "2023-11-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": {
      "backup": {
        "backupPolicyId": "string",
        "backupVaultId": "string",
        "policyEnforced": "bool"
      },
      "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'
apiVersion リソース API のバージョン '2023-11-01'
名前 リソース名

JSON ARM テンプレートで子リソースの名前と型 設定する方法を参照してください。
string (必須)
場所 リソースが存在する地理的な場所 string (必須)
タグ リソース タグ。 タグ名と値のディクショナリ。 テンプレート の タグを参照してください
プロパティ ボリュームのプロパティ VolumeProperties (必須)
ゾーン 可用性ゾーン string[]

制約:
最小長 = 1
最大長 = 255

VolumeProperties

名前 形容 価値
avsDataStore ボリュームが Azure VMware Solution (AVS) データストアの目的で有効になっているかどうかを指定します 'Disabled'
'Enabled'
backupId バックアップを識別するために使用されるリソース識別子。
capacityPoolResourceId ボリューム グループを使用してボリュームを作成する場合に使用されるプール リソース ID
coolAccess ボリュームに対してクール アクセス (階層化) を有効にするかどうかを指定します。 bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy は、クール アクセスが有効なボリュームの読み取りパターンに基づいて、クール層から Standard Storage へのデータ取得動作を決定します。 このフィールドに使用できる値は次のとおりです。
既定値 - データは、ランダム読み取り時にクール層から Standard ストレージにプルされます。 このポリシーが既定です。
OnRead - すべてのクライアント駆動型データ読み取りは、順次読み取りとランダム読み取りの両方でクール層から Standard ストレージにプルされます。
なし - クライアント駆動型データはクール層から Standard Storage にプルされません。
'Default'
'Never'
'OnRead'
coolnessPeriod クライアントがアクセスしないデータを階層化するまでの日数を指定します。 int

制約:
最小値 = 2
最大値 = 183
creationToken ボリュームの一意のファイル パス。 マウント ターゲットを作成するときに使用されます string (必須)

制約:
最小長 = 1
最大長 = 80
パターン = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection DataProtection の種類のボリュームには、レプリケーションの詳細を含むオブジェクトが含まれます VolumePropertiesDataProtection の
defaultGroupQuotaInKiBs KiB のボリュームの既定のグループ クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
defaultUserQuotaInKiBs KiB のボリュームの既定のユーザー クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
deleteBaseSnapshot 有効 (true) の場合、ボリュームの作成操作が完了すると、ボリュームの作成元のスナップショットが自動的に削除されます。 既定値は false bool
enableSubvolumes ボリュームでサブボリューム操作が有効かどうかを示すフラグ 'Disabled'
'Enabled'
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 のプライベート エンドポイントのリソース ID。 ボリュームと同じ VNET 内に存在する必要があります。 encryptionKeySource = 'Microsoft.KeyVault' の場合にのみ適用されます。
ldapEnabled 特定の NFS ボリュームに対して LDAP を有効にするかどうかを指定します。 bool
networkFeatures ボリュームで使用できるネットワーク機能、または更新の現在の状態。 'Basic'
'Basic_Standard'
'Standard'
'Standard_Basic'
placementRules 特定のボリュームのアプリケーション固有の配置規則 PlacementKeyValuePairs[]
protocolTypes 一連のプロトコルの種類、既定の NFSv3、SMB プロトコルの CIFS string[]
proximityPlacementGroup ボリュームに関連付けられている近接通信配置グループ
securityStyle ボリュームのセキュリティ スタイル (既定の unix)、デュアル プロトコルまたは CIFS プロトコルの場合は既定で ntfs 'ntfs'
'unix'
serviceLevel ファイル システムのサービス レベル 'Premium'
'Standard'
'StandardZRS'
'Ultra'
smbAccessBasedEnumeration SMB 共有のアクセス ベースの列挙共有プロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます 'Disabled'
'Enabled'
smbContinuouslyAvailable smb ボリュームに対して継続的に使用可能な共有プロパティを有効にします。 SMB ボリュームにのみ適用されます bool
smbEncryption 転送中の smb3 データの暗号化を有効にします。 SMB/DualProtocol ボリュームにのみ適用されます。 swagger バージョン 2020-08-01 以降で使用する bool
smbNonBrowsable SMB 共有のブロウズ不可能なプロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます 'Disabled'
'Enabled'
snapshotDirectoryVisible 有効 (true) の場合、ボリュームには、各ボリュームのスナップショットへのアクセスを提供する読み取り専用のスナップショット ディレクトリが含まれます (既定値は true)。 bool
snapshotId スナップショットを識別するために使用されるリソース識別子。
subnetId 委任されたサブネットの Azure リソース URI。 委任 Microsoft.NetApp/ボリュームが必要です string (必須)
throughputMibps このボリュームで実現できる MiB/秒の最大スループット。これは手動 qosType ボリュームの入力としてのみ受け入れられます int
unixPermissions 8 進数の 4 桁の形式で受け入れられる NFS ボリュームに対する UNIX アクセス許可。 最初の桁は、設定されたユーザー ID (4)、グループ ID (2) およびスティッキー (1) 属性を選択します。 2 桁目は、ファイルの所有者のアクセス許可を選択します。読み取り (4)、書き込み (2)、実行 (1) です。 3 番目は、同じグループ内の他のユーザーのアクセス許可を選択します。 グループに含まれていない他のユーザーの場合は 4 番目です。 0755 - 所有者に読み取り/書き込み/実行アクセス許可を付与し、グループやその他のユーザーに対して読み取り/実行を行います。

制約:
最小長 = 4
最大長 = 4
usageThreshold ファイル システムで許容される最大ストレージ クォータ (バイト単位)。 これは、アラートにのみ使用されるソフト クォータです。 最小サイズは 100 GiB です。 上限は、100TiB、LargeVolume の場合は 500Tib、LargeVolume の場合は 2400Tib です。例外的な基準です。 バイト単位で指定します。 int (必須)

制約:
最小値 = 107374182400
最大値 = 2638827906662400
volumeSpecName ボリューム スペック名は、データ、ログなどのボリューム グループ内の特定のボリュームに対するアプリケーション固有の指定または識別子です。
volumeType ボリュームの種類は何ですか。 リージョン間レプリケーションの宛先ボリュームの場合は、種類を DataProtection に設定します

VolumePropertiesDataProtection

名前 形容 価値
バックアップ バックアップのプロパティ VolumeBackupProperties
複製 レプリケーションのプロパティ ReplicationObject
スナップショット スナップショットのプロパティ。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation プロパティ VolumeRelocationProperties の

VolumeBackupProperties

名前 形容 価値
backupPolicyId バックアップ ポリシーのリソース ID
backupVaultId バックアップ コンテナーのリソース ID
policyEnforced ポリシーの適用 bool

ReplicationObject

名前 形容 価値
endpointType ローカル ボリュームがボリューム レプリケーションのソースか宛先かを示します 'dst'
'src'
remoteVolumeRegion ボリューム レプリケーションのもう一方の端のリモート リージョン。
remoteVolumeResourceId リモート ボリュームのリソース ID。 string (必須)
replicationSchedule 計画 '_10minutely'
'daily'
'hourly'

VolumeSnapshotProperties

名前 形容 価値
snapshotPolicyId スナップショット ポリシー ResourceId

VolumeRelocationProperties

名前 形容 価値
relocationRequested このボリュームに再配置が要求されました bool

VolumePropertiesExportPolicy

名前 形容 価値
準則 ポリシー ルールのエクスポート ExportPolicyRule[]

ExportPolicyRule

名前 形容 価値
allowedClients IPv4 CIDR、IPv4 ホスト アドレス、およびホスト名を含むコンマ区切り文字列としてのクライアントイングレス仕様
chownMode このパラメーターは、ファイルの所有権を変更する権限を持つユーザーを指定します。 restricted - ルート ユーザーのみがファイルの所有権を変更できます。 無制限 - 非ルート ユーザーは、自分が所有するファイルの所有権を変更できます。 'Restricted'
'Unrestricted'
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

名前 形容 価値
ボリューム グループ内のボリュームを配置するためのアプリケーション固有のパラメーターのキー string (必須)
価値 ボリューム グループ内のボリュームの配置に関するアプリケーション固有のパラメーターの値 string (必須)

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
NFSV3/NFSv4.1 ボリューム を使用して新しい ANF リソースを作成する

Azure にデプロイする
このテンプレートを使用すると、NFSV3 または NFSv4.1 プロトコルで構成された単一の容量プールと単一ボリュームを使用して、新しい Azure NetApp Files リソースを作成できます。 これらはすべて、任意のボリュームを作成するために必要な Azure Virtual Network と委任されたサブネットと共にデプロイされます
SMB ボリューム を使用して新しい ANF リソースを作成する

Azure にデプロイする
このテンプレートを使用すると、1 つの容量プールと 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@2023-11-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 = {
        backup = {
          backupPolicyId = "string"
          backupVaultId = "string"
          policyEnforced = bool
        }
        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-11-01"
名前 リソース名 string (必須)
場所 リソースが存在する地理的な場所 string (必須)
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: capacityPools
タグ リソース タグ。 タグ名と値のディクショナリ。
プロパティ ボリュームのプロパティ VolumeProperties (必須)
ゾーン 可用性ゾーン string[]

制約:
最小長 = 1
最大長 = 255

VolumeProperties

名前 形容 価値
avsDataStore ボリュームが Azure VMware Solution (AVS) データストアの目的で有効になっているかどうかを指定します "無効"
"有効"
backupId バックアップを識別するために使用されるリソース識別子。
capacityPoolResourceId ボリューム グループを使用してボリュームを作成する場合に使用されるプール リソース ID
coolAccess ボリュームに対してクール アクセス (階層化) を有効にするかどうかを指定します。 bool
coolAccessRetrievalPolicy coolAccessRetrievalPolicy は、クール アクセスが有効なボリュームの読み取りパターンに基づいて、クール層から Standard Storage へのデータ取得動作を決定します。 このフィールドに使用できる値は次のとおりです。
既定値 - データは、ランダム読み取り時にクール層から Standard ストレージにプルされます。 このポリシーが既定です。
OnRead - すべてのクライアント駆動型データ読み取りは、順次読み取りとランダム読み取りの両方でクール層から Standard ストレージにプルされます。
なし - クライアント駆動型データはクール層から Standard Storage にプルされません。
"Default"
"Never"
"OnRead"
coolnessPeriod クライアントがアクセスしないデータを階層化するまでの日数を指定します。 int

制約:
最小値 = 2
最大値 = 183
creationToken ボリュームの一意のファイル パス。 マウント ターゲットを作成するときに使用されます string (必須)

制約:
最小長 = 1
最大長 = 80
パターン = ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$
dataProtection DataProtection の種類のボリュームには、レプリケーションの詳細を含むオブジェクトが含まれます VolumePropertiesDataProtection の
defaultGroupQuotaInKiBs KiB のボリュームの既定のグループ クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
defaultUserQuotaInKiBs KiB のボリュームの既定のユーザー クォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。 int
deleteBaseSnapshot 有効 (true) の場合、ボリュームの作成操作が完了すると、ボリュームの作成元のスナップショットが自動的に削除されます。 既定値は 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 のプライベート エンドポイントのリソース ID。 ボリュームと同じ VNET 内に存在する必要があります。 encryptionKeySource = 'Microsoft.KeyVault' の場合にのみ適用されます。
ldapEnabled 特定の NFS ボリュームに対して LDAP を有効にするかどうかを指定します。 bool
networkFeatures ボリュームで使用できるネットワーク機能、または更新の現在の状態。 "Basic"
"Basic_Standard"
"Standard"
"Standard_Basic"
placementRules 特定のボリュームのアプリケーション固有の配置規則 PlacementKeyValuePairs[]
protocolTypes 一連のプロトコルの種類、既定の NFSv3、SMB プロトコルの CIFS string[]
proximityPlacementGroup ボリュームに関連付けられている近接通信配置グループ
securityStyle ボリュームのセキュリティ スタイル (既定の unix)、デュアル プロトコルまたは CIFS プロトコルの場合は既定で ntfs "ntfs"
"unix"
serviceLevel ファイル システムのサービス レベル "Premium"
"Standard"
"StandardZRS"
"Ultra"
smbAccessBasedEnumeration SMB 共有のアクセス ベースの列挙共有プロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます "無効"
"有効"
smbContinuouslyAvailable smb ボリュームに対して継続的に使用可能な共有プロパティを有効にします。 SMB ボリュームにのみ適用されます bool
smbEncryption 転送中の smb3 データの暗号化を有効にします。 SMB/DualProtocol ボリュームにのみ適用されます。 swagger バージョン 2020-08-01 以降で使用する bool
smbNonBrowsable SMB 共有のブロウズ不可能なプロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます "無効"
"有効"
snapshotDirectoryVisible 有効 (true) の場合、ボリュームには、各ボリュームのスナップショットへのアクセスを提供する読み取り専用のスナップショット ディレクトリが含まれます (既定値は true)。 bool
snapshotId スナップショットを識別するために使用されるリソース識別子。
subnetId 委任されたサブネットの Azure リソース URI。 委任 Microsoft.NetApp/ボリュームが必要です string (必須)
throughputMibps このボリュームで実現できる MiB/秒の最大スループット。これは手動 qosType ボリュームの入力としてのみ受け入れられます int
unixPermissions 8 進数の 4 桁の形式で受け入れられる NFS ボリュームに対する UNIX アクセス許可。 最初の桁は、設定されたユーザー ID (4)、グループ ID (2) およびスティッキー (1) 属性を選択します。 2 桁目は、ファイルの所有者のアクセス許可を選択します。読み取り (4)、書き込み (2)、実行 (1) です。 3 番目は、同じグループ内の他のユーザーのアクセス許可を選択します。 グループに含まれていない他のユーザーの場合は 4 番目です。 0755 - 所有者に読み取り/書き込み/実行アクセス許可を付与し、グループやその他のユーザーに対して読み取り/実行を行います。

制約:
最小長 = 4
最大長 = 4
usageThreshold ファイル システムで許容される最大ストレージ クォータ (バイト単位)。 これは、アラートにのみ使用されるソフト クォータです。 最小サイズは 100 GiB です。 上限は、100TiB、LargeVolume の場合は 500Tib、LargeVolume の場合は 2400Tib です。例外的な基準です。 バイト単位で指定します。 int (必須)

制約:
最小値 = 107374182400
最大値 = 2638827906662400
volumeSpecName ボリューム スペック名は、データ、ログなどのボリューム グループ内の特定のボリュームに対するアプリケーション固有の指定または識別子です。
volumeType ボリュームの種類は何ですか。 リージョン間レプリケーションの宛先ボリュームの場合は、種類を DataProtection に設定します

VolumePropertiesDataProtection

名前 形容 価値
バックアップ バックアップのプロパティ VolumeBackupProperties
複製 レプリケーションのプロパティ ReplicationObject
スナップショット スナップショットのプロパティ。 VolumeSnapshotProperties
volumeRelocation VolumeRelocation プロパティ VolumeRelocationProperties の

VolumeBackupProperties

名前 形容 価値
backupPolicyId バックアップ ポリシーのリソース ID
backupVaultId バックアップ コンテナーのリソース ID
policyEnforced ポリシーの適用 bool

ReplicationObject

名前 形容 価値
endpointType ローカル ボリュームがボリューム レプリケーションのソースか宛先かを示します "dst"
"src"
remoteVolumeRegion ボリューム レプリケーションのもう一方の端のリモート リージョン。
remoteVolumeResourceId リモート ボリュームのリソース ID。 string (必須)
replicationSchedule 計画 "_10minutely"
"daily"
"hourly"

VolumeSnapshotProperties

名前 形容 価値
snapshotPolicyId スナップショット ポリシー ResourceId

VolumeRelocationProperties

名前 形容 価値
relocationRequested このボリュームに再配置が要求されました bool

VolumePropertiesExportPolicy

名前 形容 価値
準則 ポリシー ルールのエクスポート ExportPolicyRule[]

ExportPolicyRule

名前 形容 価値
allowedClients IPv4 CIDR、IPv4 ホスト アドレス、およびホスト名を含むコンマ区切り文字列としてのクライアントイングレス仕様
chownMode このパラメーターは、ファイルの所有権を変更する権限を持つユーザーを指定します。 restricted - ルート ユーザーのみがファイルの所有権を変更できます。 無制限 - 非ルート ユーザーは、自分が所有するファイルの所有権を変更できます。 "Restricted"
"Unrestricted"
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

名前 形容 価値
ボリューム グループ内のボリュームを配置するためのアプリケーション固有のパラメーターのキー string (必須)
価値 ボリューム グループ内のボリュームの配置に関するアプリケーション固有のパラメーターの値 string (必須)