Microsoft.StorageCache amlFilesystems
Bicep resource definition
The amlFilesystems resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.StorageCache/amlFilesystems resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.StorageCache/amlFilesystems@2024-03-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
encryptionSettings: {
keyEncryptionKey: {
keyUrl: 'string'
sourceVault: {
id: 'string'
}
}
}
filesystemSubnet: 'string'
hsm: {
settings: {
container: 'string'
importPrefix: 'string'
importPrefixesInitial: [
'string'
]
loggingContainer: 'string'
}
}
maintenanceWindow: {
dayOfWeek: 'string'
timeOfDayUTC: 'string'
}
rootSquashSettings: {
mode: 'string'
noSquashNidLists: 'string'
squashGID: int
squashUID: int
}
storageCapacityTiB: int
}
zones: [
'string'
]
}
Property values
amlFilesystems
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| location | The geo-location where the resource lives | string (required) |
| tags | Resource tags. | Dictionary of tag names and values. See Tags in templates |
| sku | SKU for the resource. | SkuName |
| identity | The managed identity used by the AML file system, if configured. | AmlFilesystemIdentity |
| properties | Properties of the AML file system. | AmlFilesystemProperties |
| zones | Availability zones for resources. This field should only contain a single element in the array. | string[] |
AmlFilesystemIdentity
| Name | Description | Value |
|---|---|---|
| type | The type of identity used for the resource. | 'None' 'UserAssigned' |
| userAssignedIdentities | A dictionary where each key is a user assigned identity resource ID, and each key's value is an empty dictionary. | UserAssignedIdentities |
UserAssignedIdentities
| Name | Description | Value |
|---|---|---|
| {customized property} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
This object doesn't contain any properties to set during deployment. All properties are ReadOnly.
AmlFilesystemProperties
| Name | Description | Value |
|---|---|---|
| encryptionSettings | Specifies encryption settings of the AML file system. | AmlFilesystemEncryptionSettings |
| filesystemSubnet | Subnet used for managing the AML file system and for client-facing operations. This subnet should have at least a /24 subnet mask within the VNET's address space. | string (required) |
| hsm | Hydration and archive settings and status | AmlFilesystemPropertiesHsm |
| maintenanceWindow | Start time of a 30-minute weekly maintenance window. | AmlFilesystemPropertiesMaintenanceWindow (required) |
| rootSquashSettings | Specifies root squash settings of the AML file system. | AmlFilesystemRootSquashSettings |
| storageCapacityTiB | The size of the AML file system, in TiB. This might be rounded up. | int (required) |
AmlFilesystemEncryptionSettings
| Name | Description | Value |
|---|---|---|
| keyEncryptionKey | Specifies the location of the encryption key in Key Vault. | KeyVaultKeyReference |
KeyVaultKeyReference
| Name | Description | Value |
|---|---|---|
| keyUrl | The URL referencing a key encryption key in key vault. | string (required) |
| sourceVault | Describes a resource Id to source key vault. | KeyVaultKeyReferenceSourceVault (required) |
KeyVaultKeyReferenceSourceVault
| Name | Description | Value |
|---|---|---|
| id | Resource Id. | string |
AmlFilesystemPropertiesHsm
| Name | Description | Value |
|---|---|---|
| settings | Specifies HSM settings of the AML file system. | AmlFilesystemHsmSettings |
AmlFilesystemHsmSettings
| Name | Description | Value |
|---|---|---|
| container | Resource ID of storage container used for hydrating the namespace and archiving from the namespace. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
| importPrefix | Only blobs in the non-logging container that start with this path/prefix get imported into the cluster namespace. This is only used during initial creation of the AML file system. It automatically creates an import job resource that can be deleted. | string |
| importPrefixesInitial | Only blobs in the non-logging container that start with one of the paths/prefixes in this array get imported into the cluster namespace. This is only used during initial creation of the AML file system and has '/' as the default value. It automatically creates an import job resource that can be deleted. | string[] |
| loggingContainer | Resource ID of storage container used for logging events and errors. Must be a separate container in the same storage account as the hydration and archive container. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
AmlFilesystemPropertiesMaintenanceWindow
| Name | Description | Value |
|---|---|---|
| dayOfWeek | Day of the week on which the maintenance window will occur. | 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
| timeOfDayUTC | The time of day (in UTC) to start the maintenance window. | string Constraints: Pattern = ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$ |
AmlFilesystemRootSquashSettings
| Name | Description | Value |
|---|---|---|
| mode | Squash mode of the AML file system. 'All': User and Group IDs on files will be squashed to the provided values for all users on non-trusted systems. 'RootOnly': User and Group IDs on files will be squashed to provided values for solely the root user on non-trusted systems. 'None': No squashing of User and Group IDs is performed for any users on any systems. | 'All' 'None' 'RootOnly' |
| noSquashNidLists | Semicolon separated NID IP Address list(s) to be added to the TrustedSystems. | string |
| squashGID | Group ID to squash to. | int |
| squashUID | User ID to squash to. | int |
SkuName
| Name | Description | Value |
|---|---|---|
| name | SKU name for this resource. | string |
ARM template resource definition
The amlFilesystems resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.StorageCache/amlFilesystems resource, add the following JSON to your template.
{
"type": "Microsoft.StorageCache/amlFilesystems",
"apiVersion": "2024-03-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"encryptionSettings": {
"keyEncryptionKey": {
"keyUrl": "string",
"sourceVault": {
"id": "string"
}
}
},
"filesystemSubnet": "string",
"hsm": {
"settings": {
"container": "string",
"importPrefix": "string",
"importPrefixesInitial": [ "string" ],
"loggingContainer": "string"
}
},
"maintenanceWindow": {
"dayOfWeek": "string",
"timeOfDayUTC": "string"
},
"rootSquashSettings": {
"mode": "string",
"noSquashNidLists": "string",
"squashGID": "int",
"squashUID": "int"
},
"storageCapacityTiB": "int"
},
"zones": [ "string" ]
}
Property values
amlFilesystems
| Name | Description | Value |
|---|---|---|
| type | The resource type | 'Microsoft.StorageCache/amlFilesystems' |
| apiVersion | The resource api version | '2024-03-01' |
| name | The resource name | string (required) |
| location | The geo-location where the resource lives | string (required) |
| tags | Resource tags. | Dictionary of tag names and values. See Tags in templates |
| sku | SKU for the resource. | SkuName |
| identity | The managed identity used by the AML file system, if configured. | AmlFilesystemIdentity |
| properties | Properties of the AML file system. | AmlFilesystemProperties |
| zones | Availability zones for resources. This field should only contain a single element in the array. | string[] |
AmlFilesystemIdentity
| Name | Description | Value |
|---|---|---|
| type | The type of identity used for the resource. | 'None' 'UserAssigned' |
| userAssignedIdentities | A dictionary where each key is a user assigned identity resource ID, and each key's value is an empty dictionary. | UserAssignedIdentities |
UserAssignedIdentities
| Name | Description | Value |
|---|---|---|
| {customized property} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
This object doesn't contain any properties to set during deployment. All properties are ReadOnly.
AmlFilesystemProperties
| Name | Description | Value |
|---|---|---|
| encryptionSettings | Specifies encryption settings of the AML file system. | AmlFilesystemEncryptionSettings |
| filesystemSubnet | Subnet used for managing the AML file system and for client-facing operations. This subnet should have at least a /24 subnet mask within the VNET's address space. | string (required) |
| hsm | Hydration and archive settings and status | AmlFilesystemPropertiesHsm |
| maintenanceWindow | Start time of a 30-minute weekly maintenance window. | AmlFilesystemPropertiesMaintenanceWindow (required) |
| rootSquashSettings | Specifies root squash settings of the AML file system. | AmlFilesystemRootSquashSettings |
| storageCapacityTiB | The size of the AML file system, in TiB. This might be rounded up. | int (required) |
AmlFilesystemEncryptionSettings
| Name | Description | Value |
|---|---|---|
| keyEncryptionKey | Specifies the location of the encryption key in Key Vault. | KeyVaultKeyReference |
KeyVaultKeyReference
| Name | Description | Value |
|---|---|---|
| keyUrl | The URL referencing a key encryption key in key vault. | string (required) |
| sourceVault | Describes a resource Id to source key vault. | KeyVaultKeyReferenceSourceVault (required) |
KeyVaultKeyReferenceSourceVault
| Name | Description | Value |
|---|---|---|
| id | Resource Id. | string |
AmlFilesystemPropertiesHsm
| Name | Description | Value |
|---|---|---|
| settings | Specifies HSM settings of the AML file system. | AmlFilesystemHsmSettings |
AmlFilesystemHsmSettings
| Name | Description | Value |
|---|---|---|
| container | Resource ID of storage container used for hydrating the namespace and archiving from the namespace. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
| importPrefix | Only blobs in the non-logging container that start with this path/prefix get imported into the cluster namespace. This is only used during initial creation of the AML file system. It automatically creates an import job resource that can be deleted. | string |
| importPrefixesInitial | Only blobs in the non-logging container that start with one of the paths/prefixes in this array get imported into the cluster namespace. This is only used during initial creation of the AML file system and has '/' as the default value. It automatically creates an import job resource that can be deleted. | string[] |
| loggingContainer | Resource ID of storage container used for logging events and errors. Must be a separate container in the same storage account as the hydration and archive container. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
AmlFilesystemPropertiesMaintenanceWindow
| Name | Description | Value |
|---|---|---|
| dayOfWeek | Day of the week on which the maintenance window will occur. | 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
| timeOfDayUTC | The time of day (in UTC) to start the maintenance window. | string Constraints: Pattern = ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$ |
AmlFilesystemRootSquashSettings
| Name | Description | Value |
|---|---|---|
| mode | Squash mode of the AML file system. 'All': User and Group IDs on files will be squashed to the provided values for all users on non-trusted systems. 'RootOnly': User and Group IDs on files will be squashed to provided values for solely the root user on non-trusted systems. 'None': No squashing of User and Group IDs is performed for any users on any systems. | 'All' 'None' 'RootOnly' |
| noSquashNidLists | Semicolon separated NID IP Address list(s) to be added to the TrustedSystems. | string |
| squashGID | Group ID to squash to. | int |
| squashUID | User ID to squash to. | int |
SkuName
| Name | Description | Value |
|---|---|---|
| name | SKU name for this resource. | string |
Terraform (AzAPI provider) resource definition
The amlFilesystems resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.StorageCache/amlFilesystems resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.StorageCache/amlFilesystems@2024-03-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
encryptionSettings = {
keyEncryptionKey = {
keyUrl = "string"
sourceVault = {
id = "string"
}
}
}
filesystemSubnet = "string"
hsm = {
settings = {
container = "string"
importPrefix = "string"
importPrefixesInitial = [
"string"
]
loggingContainer = "string"
}
}
maintenanceWindow = {
dayOfWeek = "string"
timeOfDayUTC = "string"
}
rootSquashSettings = {
mode = "string"
noSquashNidLists = "string"
squashGID = int
squashUID = int
}
storageCapacityTiB = int
}
zones = [
"string"
]
sku = {
name = "string"
}
})
}
Property values
amlFilesystems
| Name | Description | Value |
|---|---|---|
| type | The resource type | "Microsoft.StorageCache/amlFilesystems@2024-03-01" |
| name | The resource name | string (required) |
| location | The geo-location where the resource lives | string (required) |
| parent_id | To deploy to a resource group, use the ID of that resource group. | string (required) |
| tags | Resource tags. | Dictionary of tag names and values. |
| sku | SKU for the resource. | SkuName |
| identity | The managed identity used by the AML file system, if configured. | AmlFilesystemIdentity |
| properties | Properties of the AML file system. | AmlFilesystemProperties |
| zones | Availability zones for resources. This field should only contain a single element in the array. | string[] |
AmlFilesystemIdentity
| Name | Description | Value |
|---|---|---|
| type | The type of identity used for the resource. | "UserAssigned" |
| identity_ids | A dictionary where each key is a user assigned identity resource ID, and each key's value is an empty dictionary. | Array of user identity IDs. |
UserAssignedIdentities
| Name | Description | Value |
|---|---|---|
| {customized property} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
This object doesn't contain any properties to set during deployment. All properties are ReadOnly.
AmlFilesystemProperties
| Name | Description | Value |
|---|---|---|
| encryptionSettings | Specifies encryption settings of the AML file system. | AmlFilesystemEncryptionSettings |
| filesystemSubnet | Subnet used for managing the AML file system and for client-facing operations. This subnet should have at least a /24 subnet mask within the VNET's address space. | string (required) |
| hsm | Hydration and archive settings and status | AmlFilesystemPropertiesHsm |
| maintenanceWindow | Start time of a 30-minute weekly maintenance window. | AmlFilesystemPropertiesMaintenanceWindow (required) |
| rootSquashSettings | Specifies root squash settings of the AML file system. | AmlFilesystemRootSquashSettings |
| storageCapacityTiB | The size of the AML file system, in TiB. This might be rounded up. | int (required) |
AmlFilesystemEncryptionSettings
| Name | Description | Value |
|---|---|---|
| keyEncryptionKey | Specifies the location of the encryption key in Key Vault. | KeyVaultKeyReference |
KeyVaultKeyReference
| Name | Description | Value |
|---|---|---|
| keyUrl | The URL referencing a key encryption key in key vault. | string (required) |
| sourceVault | Describes a resource Id to source key vault. | KeyVaultKeyReferenceSourceVault (required) |
KeyVaultKeyReferenceSourceVault
| Name | Description | Value |
|---|---|---|
| id | Resource Id. | string |
AmlFilesystemPropertiesHsm
| Name | Description | Value |
|---|---|---|
| settings | Specifies HSM settings of the AML file system. | AmlFilesystemHsmSettings |
AmlFilesystemHsmSettings
| Name | Description | Value |
|---|---|---|
| container | Resource ID of storage container used for hydrating the namespace and archiving from the namespace. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
| importPrefix | Only blobs in the non-logging container that start with this path/prefix get imported into the cluster namespace. This is only used during initial creation of the AML file system. It automatically creates an import job resource that can be deleted. | string |
| importPrefixesInitial | Only blobs in the non-logging container that start with one of the paths/prefixes in this array get imported into the cluster namespace. This is only used during initial creation of the AML file system and has '/' as the default value. It automatically creates an import job resource that can be deleted. | string[] |
| loggingContainer | Resource ID of storage container used for logging events and errors. Must be a separate container in the same storage account as the hydration and archive container. The resource provider must have permission to create SAS tokens on the storage account. | string (required) |
AmlFilesystemPropertiesMaintenanceWindow
| Name | Description | Value |
|---|---|---|
| dayOfWeek | Day of the week on which the maintenance window will occur. | "Friday" "Monday" "Saturday" "Sunday" "Thursday" "Tuesday" "Wednesday" |
| timeOfDayUTC | The time of day (in UTC) to start the maintenance window. | string Constraints: Pattern = ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$ |
AmlFilesystemRootSquashSettings
| Name | Description | Value |
|---|---|---|
| mode | Squash mode of the AML file system. 'All': User and Group IDs on files will be squashed to the provided values for all users on non-trusted systems. 'RootOnly': User and Group IDs on files will be squashed to provided values for solely the root user on non-trusted systems. 'None': No squashing of User and Group IDs is performed for any users on any systems. | "All" "None" "RootOnly" |
| noSquashNidLists | Semicolon separated NID IP Address list(s) to be added to the TrustedSystems. | string |
| squashGID | Group ID to squash to. | int |
| squashUID | User ID to squash to. | int |
SkuName
| Name | Description | Value |
|---|---|---|
| name | SKU name for this resource. | string |