Microsoft.StorageAccounts 2021-01-01
Définition de ressource Bicep
Le type de ressource storageAccounts peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Storage/storageAccounts, ajoutez le Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Storage/storageAccounts@2021-01-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
kind: 'string'
extendedLocation: {
name: 'string'
type: 'EdgeZone'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
accessTier: 'string'
allowBlobPublicAccess: bool
allowSharedKeyAccess: bool
azureFilesIdentityBasedAuthentication: {
activeDirectoryProperties: {
azureStorageSid: 'string'
domainGuid: 'string'
domainName: 'string'
domainSid: 'string'
forestName: 'string'
netBiosDomainName: 'string'
}
directoryServiceOptions: 'string'
}
customDomain: {
name: 'string'
useSubDomainName: bool
}
encryption: {
identity: {
userAssignedIdentity: 'string'
}
keySource: 'string'
keyvaultproperties: {
keyname: 'string'
keyvaulturi: 'string'
keyversion: 'string'
}
requireInfrastructureEncryption: bool
services: {
blob: {
enabled: bool
keyType: 'string'
}
file: {
enabled: bool
keyType: 'string'
}
queue: {
enabled: bool
keyType: 'string'
}
table: {
enabled: bool
keyType: 'string'
}
}
}
isHnsEnabled: bool
isNfsV3Enabled: bool
largeFileSharesState: 'string'
minimumTlsVersion: 'string'
networkAcls: {
bypass: 'string'
defaultAction: 'string'
ipRules: [
{
action: 'Allow'
value: 'string'
}
]
resourceAccessRules: [
{
resourceId: 'string'
tenantId: 'string'
}
]
virtualNetworkRules: [
{
action: 'Allow'
id: 'string'
state: 'string'
}
]
}
routingPreference: {
publishInternetEndpoints: bool
publishMicrosoftEndpoints: bool
routingChoice: 'string'
}
supportsHttpsTrafficOnly: bool
}
}
Valeurs de propriétés
storageAccounts
Nom | Description | Valeur |
---|---|---|
name | Nom de la ressource | chaîne (obligatoire) Limite de caractères : 3-24 Caractères valides : Lettres minuscules et chiffres. Le nom de la ressource doit être unique dans Azure. |
location | Obligatoire. Obtient ou définit l'emplacement de la ressource. Il s’agit de l’une des régions Azure Geo prises en charge et enregistrées (par exemple, USA Ouest, USA Est, Asie Sud-Est, etc.). La région géographique d’une ressource ne peut pas être modifiée une fois qu’elle est créée, mais si une région géographique identique est spécifiée lors de la mise à jour, la demande réussit. | chaîne (obligatoire) |
tags | Obtient ou définit une liste de paires de valeurs de clé qui décrivent la ressource. Ces balises peuvent être utilisées pour afficher et regrouper cette ressource (entre les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit avoir une clé dont la longueur ne dépasse pas 128 caractères et une valeur d’une longueur maximale de 256 caractères. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
sku | Obligatoire. Obtient ou définit le nom de la référence SKU. | Référence SKU (obligatoire) |
kind | Obligatoire. Indique le type de compte de stockage. | 'BlobStorage' 'BlockBlobStorage' 'FileStorage' « Storage » 'StorageV2' (obligatoire) |
extendedLocation | facultatif. Définissez l’emplacement étendu de la ressource. S’il n’est pas défini, le compte de stockage est créé dans azure main région. Sinon, il sera créé dans l’emplacement étendu spécifié | ExtendedLocation |
identité | Identité de la ressource. | Identité |
properties | Paramètres utilisés pour créer le compte de stockage. | StorageAccountPropertiesCreateParametersOrStorageAcc... |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
name | Nom de l’emplacement étendu. | string |
type | Type de l’emplacement étendu. | 'EdgeZone' |
Identité
Nom | Description | Valeur |
---|---|---|
type | Type d’identité. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire) |
userAssignedIdentities | Obtient ou définit une liste de paires de valeurs de clé qui décrivent l’ensemble d’identités affectées par l’utilisateur qui seront utilisées avec ce compte de stockage. La clé est l’identificateur de ressource ARM de l’identité. Une seule identité affectée par l’utilisateur est autorisée ici. | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | userAssignedIdentity |
userAssignedIdentity
Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.
StorageAccountPropertiesCreateParametersOrStorageAcc...
Nom | Description | Valeur |
---|---|---|
accessTier | Obligatoire pour les comptes de stockage où type = BlobStorage. Niveau d’accès utilisé pour la facturation. | 'Cool' 'Chaud' |
allowBlobPublicAccess | Autoriser ou interdire l’accès public à tous les objets blob ou conteneurs dans le compte de stockage. L’interprétation par défaut est true pour cette propriété. | bool |
allowSharedKeyAccess | Indique si le compte de stockage autorise les demandes à être autorisées avec la clé d’accès au compte via la clé partagée. Si la valeur est false, toutes les demandes, y compris les signatures d’accès partagé, doivent être autorisées avec Azure Active Directory (Azure AD). La valeur par défaut est null, ce qui équivaut à true. | bool |
azureFilesIdentityBasedAuthentication | Fournit les paramètres d’authentification basés sur l’identité pour Azure Files. | AzureFilesIdentityBasedAuthentication |
customDomain | Domaine utilisateur affecté au compte de stockage. Name est la source CNAME. Pour l’instant, un seul domaine personnalisé est pris en charge par compte de stockage. Pour effacer le domaine personnalisé existant, utilisez une chaîne vide pour la propriété de nom de domaine personnalisé. | CustomDomain |
le chiffrement | Non applicable. Le chiffrement stockage Azure est activé pour tous les comptes de stockage et ne peut pas être désactivé. | Chiffrement |
isHnsEnabled | Account HierarchicalNamespace activé si définit la valeur true. | bool |
isNfsV3Enabled | Prise en charge du protocole NFS 3.0 activée si la valeur est true. | bool |
largeFileSharesState | Autoriser les partages de fichiers volumineux si définit sur Activé. Il ne peut pas être désactivé une fois qu’il est activé. | 'Désactivé' 'Enabled' |
minimumTlsVersion | Définissez la version TLS minimale à autoriser sur les demandes de stockage. L’interprétation par défaut est TLS 1.0 pour cette propriété. | 'TLS1_0' 'TLS1_1' 'TLS1_2' |
networkAcls | Ensemble de règles réseau | NetworkRuleSet |
routingPreference | Conserve les informations sur le choix de routage réseau choisi par l’utilisateur pour le transfert de données | RoutagePreference |
supportsHttpsTrafficOnly | Autorise le trafic https uniquement vers le service de stockage si la valeur est true. La valeur par défaut est true depuis la version de l’API 2019-04-01. | bool |
AzureFilesIdentityBasedAuthentication
Nom | Description | Valeur |
---|---|---|
activeDirectoryProperties | Obligatoire si vous choisissez AD. | ActiveDirectoryProperties |
directoryServiceOptions | Indique le service d’annuaire utilisé. | 'AADDS' 'AD' 'None' (obligatoire) |
ActiveDirectoryProperties
Nom | Description | Valeur |
---|---|---|
azureStorageSid | Spécifie l’identificateur de sécurité (SID) pour stockage Azure. | chaîne (obligatoire) |
domainGuid | Spécifie le GUID de domaine. | chaîne (obligatoire) |
domainName | Spécifie le domaine principal pour lequel le serveur DNS AD fait autorité. | chaîne (obligatoire) |
domainSid | Spécifie l’identificateur de sécurité (SID). | chaîne (obligatoire) |
forestName | Spécifie la forêt Active Directory à obtenir. | chaîne (obligatoire) |
netBiosDomainName | Spécifie le nom de domaine NetBIOS. | chaîne (obligatoire) |
CustomDomain
Nom | Description | Valeur |
---|---|---|
name | Obtient ou définit le nom de domaine personnalisé affecté au compte de stockage. Name est la source CNAME. | chaîne (obligatoire) |
useSubDomainName | Indique si la validation CName indirecte est activée. La valeur par défaut est false. Cela ne doit être défini que sur les mises à jour. | bool |
Chiffrement
Nom | Description | Valeur |
---|---|---|
identité | Identité à utiliser avec le chiffrement côté service au repos. | EncryptionIdentity |
keySource | Chiffrement keySource (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Storage, Microsoft.Keyvault | « Microsoft.Keyvault » 'Microsoft.Storage' (obligatoire) |
keyvaultpropriétés | Propriétés fournies par le coffre de clés. | KeyVaultProperties |
requireInfrastructureEncryption | Boolean indiquant si le service applique ou non une couche secondaire de chiffrement avec des clés gérées par la plateforme pour les données au repos. | bool |
services | Liste des services qui prennent en charge le chiffrement. | EncryptionServices |
EncryptionIdentity
Nom | Description | Valeur |
---|---|---|
userAssignedIdentity | Identificateur de ressource de l’identité UserAssigned à associer au chiffrement côté serveur sur le compte de stockage. | string |
KeyVaultProperties
Nom | Description | Valeur |
---|---|---|
Keyname | Nom de la clé KeyVault. | string |
keyvaulturi | URI de KeyVault. | string |
keyversion | Version de la clé KeyVault. | string |
EncryptionServices
Nom | Description | Valeur |
---|---|---|
objet BLOB | Fonction de chiffrement du service de stockage d’objets blob. | EncryptionService |
fichier | Fonction de chiffrement du service de stockage de fichiers. | EncryptionService |
queue | Fonction de chiffrement du service de stockage de file d’attente. | EncryptionService |
table | Fonction de chiffrement du service de stockage table. | EncryptionService |
EncryptionService
Nom | Description | Valeur |
---|---|---|
enabled | Boolean indiquant si le service chiffre ou non les données telles qu’elles sont stockées. | bool |
keyType | Type de clé de chiffrement à utiliser pour le service de chiffrement. Le type de clé « Compte » implique qu’une clé de chiffrement étendue au compte sera utilisée. Le type de clé 'Service' implique qu’une clé de service par défaut est utilisée. | 'Compte' 'Service' |
NetworkRuleSet
Nom | Description | Valeur |
---|---|---|
ignorer | Spécifie si le trafic est contourné pour journalisation/métriques/AzureServices. Les valeurs possibles sont n’importe quelle combinaison de journalisation, de métriques, d’AzureServices (par exemple, « Journalisation, métriques ») ou de Aucun pour contourner aucun de ces trafics. | 'AzureServices' 'Journalisation' 'Metrics' 'None' |
defaultAction | Spécifie l’action par défaut d’autoriser ou de refuser lorsqu’aucune autre règle ne correspond. | 'Autoriser' 'Deny' (obligatoire) |
ipRules | Définit les règles de liste de contrôle d’accès IP | IPRule[] |
resourceAccessRules | Définit les règles d’accès aux ressources | ResourceAccessRule[] |
virtualNetworkRules | Définit les règles de réseau virtuel | VirtualNetworkRule[] |
IPRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle ACL IP. | 'Autoriser' |
value | Spécifie l’adresse IP ou la plage d’adresses IP au format CIDR. Seule l’adresse IPV4 est autorisée. | chaîne (obligatoire) |
ResourceAccessRule
Nom | Description | Valeur |
---|---|---|
resourceId | ID de ressource | string |
tenantId | ID client | string |
VirtualNetworkRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle de réseau virtuel. | 'Autoriser' |
id | ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. | chaîne (obligatoire) |
state | Obtient l’état de la règle de réseau virtuel. | « déprovisionnement » 'failed' 'networkSourceDeleted' 'provisionnement' 'réussi' |
RoutagePreference
Nom | Description | Valeur |
---|---|---|
publishInternetEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Internet doivent être publiés | bool |
publishMicrosoftEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Microsoft doivent être publiés | bool |
routingChoice | Le choix de routage définit le type de routage réseau choisi par l’utilisateur. | 'InternetRouting' 'MicrosoftRouting' |
Sku
Nom | Description | Valeur |
---|---|---|
name | Le nom du SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType. | 'Premium_LRS' 'Premium_ZRS' 'Standard_GRS' 'Standard_GZRS' 'Standard_LRS' 'Standard_RAGRS' 'Standard_RAGZRS' 'Standard_ZRS' (obligatoire) |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
Modèle | Description |
---|---|
Se connecter à un compte de stockage à partir d’une machine virtuelle via un point de terminaison privé |
Cet exemple montre comment utiliser la connexion d’un réseau virtuel pour accéder à un compte de stockage d’objets blob via un point de terminaison privé. |
Se connecter à un partage de fichiers Azure via un point de terminaison privé |
Cet exemple montre comment utiliser la configuration d’un réseau virtuel et d’une zone DNS privée pour accéder à un partage de fichiers Azure via un point de terminaison privé. |
Créer un compte de stockage standard |
Ce modèle crée un compte de stockage Standard |
Créer un compte de stockage avec SSE |
Ce modèle crée un compte de stockage avec chiffrement du service de stockage pour les données au repos |
Compte de stockage avec Protection avancée contre les menaces |
Ce modèle vous permet de déployer un compte stockage Azure avec Advanced Threat Protection activé. |
Créer un compte de stockage Azure et un conteneur d’objets blob sur Azure |
Ce modèle crée un compte stockage Azure et un conteneur d’objets blob. |
Compte de stockage avec stratégie de rétention SSE et suppression d’objets blob |
Ce modèle crée un compte de stockage avec le chiffrement du service de stockage et une stratégie de rétention de suppression d’objets blob |
Chiffrement de compte de stockage Azure avec clé gérée par le client |
Ce modèle déploie un compte de stockage avec une clé gérée par le client pour le chiffrement généré et placé à l’intérieur d’un Key Vault. |
Créer un compte de stockage avec un partage de fichiers |
Ce modèle crée un compte de stockage Azure et un partage de fichiers. |
Créer un compte de stockage avec plusieurs conteneurs d’objets blob |
Crée un compte de stockage Azure et plusieurs conteneurs d’objets blob. |
Créer un compte de stockage avec plusieurs partages de fichiers |
Crée un compte de stockage Azure et plusieurs partages de fichiers. |
Créer un compte de stockage avec SFTP activé |
Crée un compte de stockage Azure et un conteneur d’objets blob accessibles à l’aide du protocole SFTP. L’accès peut être basé sur un mot de passe ou une clé publique. |
Déploie un site web statique |
Déploie un site web statique avec un compte de stockage de stockage |
Définition de ressources de modèle ARM
Le type de ressource storageAccounts peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupe de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Storage/storageAccounts, ajoutez le JSON suivant à votre modèle.
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2021-01-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"kind": "string",
"extendedLocation": {
"name": "string",
"type": "EdgeZone"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"accessTier": "string",
"allowBlobPublicAccess": "bool",
"allowSharedKeyAccess": "bool",
"azureFilesIdentityBasedAuthentication": {
"activeDirectoryProperties": {
"azureStorageSid": "string",
"domainGuid": "string",
"domainName": "string",
"domainSid": "string",
"forestName": "string",
"netBiosDomainName": "string"
},
"directoryServiceOptions": "string"
},
"customDomain": {
"name": "string",
"useSubDomainName": "bool"
},
"encryption": {
"identity": {
"userAssignedIdentity": "string"
},
"keySource": "string",
"keyvaultproperties": {
"keyname": "string",
"keyvaulturi": "string",
"keyversion": "string"
},
"requireInfrastructureEncryption": "bool",
"services": {
"blob": {
"enabled": "bool",
"keyType": "string"
},
"file": {
"enabled": "bool",
"keyType": "string"
},
"queue": {
"enabled": "bool",
"keyType": "string"
},
"table": {
"enabled": "bool",
"keyType": "string"
}
}
},
"isHnsEnabled": "bool",
"isNfsV3Enabled": "bool",
"largeFileSharesState": "string",
"minimumTlsVersion": "string",
"networkAcls": {
"bypass": "string",
"defaultAction": "string",
"ipRules": [
{
"action": "Allow",
"value": "string"
}
],
"resourceAccessRules": [
{
"resourceId": "string",
"tenantId": "string"
}
],
"virtualNetworkRules": [
{
"action": "Allow",
"id": "string",
"state": "string"
}
]
},
"routingPreference": {
"publishInternetEndpoints": "bool",
"publishMicrosoftEndpoints": "bool",
"routingChoice": "string"
},
"supportsHttpsTrafficOnly": "bool"
}
}
Valeurs de propriétés
storageAccounts
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | 'Microsoft.Storage/storageAccounts' |
apiVersion | Version de l’API de ressource | '2021-01-01' |
name | Nom de la ressource | string (obligatoire) Limite de caractères : 3-24 Caractères valides : Lettres minuscules et chiffres. Le nom de la ressource doit être unique dans Azure. |
location | Obligatoire. Obtient ou définit l'emplacement de la ressource. Il s’agit de l’une des régions géographiques Azure prises en charge et inscrites (par exemple, USA Ouest, USA Est, Asie Sud-Est, etc.). La région géographique d’une ressource ne peut pas être modifiée une fois qu’elle est créée, mais si une région géographique identique est spécifiée lors de la mise à jour, la demande réussit. | string (obligatoire) |
tags | Obtient ou définit une liste de paires clé-valeur qui décrivent la ressource. Ces balises peuvent être utilisées pour afficher et regrouper cette ressource (entre les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit avoir une clé dont la longueur ne dépasse pas 128 caractères et une valeur dont la longueur ne doit pas dépasser 256 caractères. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
sku | Obligatoire. Obtient ou définit le nom de la référence SKU. | Référence SKU (obligatoire) |
kind | Obligatoire. Indique le type de compte de stockage. | 'BlobStorage' 'BlockBlobStorage' 'FileStorage' « Storage » 'StorageV2' (obligatoire) |
extendedLocation | facultatif. Définissez l’emplacement étendu de la ressource. S’il n’est pas défini, le compte de stockage est créé dans la région Azure main. Sinon, il sera créé à l’emplacement étendu spécifié | ExtendedLocation |
identité | Identité de la ressource. | Identité |
properties | Paramètres utilisés pour créer le compte de stockage. | StorageAccountPropertiesCreateParametersOrStorageAcc... |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
name | Nom de l’emplacement étendu. | string |
type | Type de l’emplacement étendu. | 'EdgeZone' |
Identité
Nom | Description | Valeur |
---|---|---|
type | Type d’identité. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire) |
userAssignedIdentities | Obtient ou définit une liste de paires clé-valeur qui décrivent l’ensemble d’identités affectées par l’utilisateur qui seront utilisées avec ce compte de stockage. La clé est l’identificateur de ressource ARM de l’identité. Seule 1 identité affectée par l’utilisateur est autorisée ici. | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | userAssignedIdentity |
userAssignedIdentity
Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.
StorageAccountPropertiesCreateParametersOrStorageAcc...
Nom | Description | Valeur |
---|---|---|
accessTier | Obligatoire pour les comptes de stockage où type = BlobStorage. Niveau d’accès utilisé pour la facturation. | 'Cool' 'Chaud' |
allowBlobPublicAccess | Autoriser ou interdire l’accès public à tous les objets blob ou conteneurs dans le compte de stockage. L’interprétation par défaut est true pour cette propriété. | bool |
allowSharedKeyAccess | Indique si le compte de stockage autorise les demandes à être autorisées avec la clé d’accès au compte via la clé partagée. Si la valeur est false, toutes les demandes, y compris les signatures d’accès partagé, doivent être autorisées avec Azure Active Directory (Azure AD). La valeur par défaut est null, ce qui équivaut à true. | bool |
azureFilesIdentityBasedAuthentication | Fournit les paramètres d’authentification basés sur l’identité pour Azure Files. | AzureFilesIdentityBasedAuthentication |
customDomain | Domaine utilisateur affecté au compte de stockage. Name est la source CNAME. Pour l’instant, un seul domaine personnalisé est pris en charge par compte de stockage. Pour effacer le domaine personnalisé existant, utilisez une chaîne vide pour la propriété de nom de domaine personnalisé. | CustomDomain |
le chiffrement | Non applicable. Le chiffrement stockage Azure est activé pour tous les comptes de stockage et ne peut pas être désactivé. | Chiffrement |
isHnsEnabled | Account HierarchicalNamespace activé si définit la valeur true. | bool |
isNfsV3Enabled | Prise en charge du protocole NFS 3.0 activée si la valeur est true. | bool |
largeFileSharesState | Autoriser les partages de fichiers volumineux si définit sur Activé. Il ne peut pas être désactivé une fois qu’il est activé. | 'Désactivé' 'Enabled' |
minimumTlsVersion | Définissez la version TLS minimale à autoriser sur les demandes de stockage. L’interprétation par défaut est TLS 1.0 pour cette propriété. | 'TLS1_0' 'TLS1_1' 'TLS1_2' |
networkAcls | Ensemble de règles réseau | NetworkRuleSet |
routingPreference | Conserve les informations sur le choix de routage réseau choisi par l’utilisateur pour le transfert de données | RoutagePreference |
supportsHttpsTrafficOnly | Autorise le trafic https uniquement vers le service de stockage si la valeur est true. La valeur par défaut est true depuis la version de l’API 2019-04-01. | bool |
AzureFilesIdentityBasedAuthentication
Nom | Description | Valeur |
---|---|---|
activeDirectoryProperties | Obligatoire si vous choisissez AD. | ActiveDirectoryProperties |
directoryServiceOptions | Indique le service d’annuaire utilisé. | 'AADDS' 'AD' 'None' (obligatoire) |
ActiveDirectoryProperties
Nom | Description | Valeur |
---|---|---|
azureStorageSid | Spécifie l’identificateur de sécurité (SID) pour stockage Azure. | chaîne (obligatoire) |
domainGuid | Spécifie le GUID de domaine. | chaîne (obligatoire) |
domainName | Spécifie le domaine principal pour lequel le serveur DNS AD fait autorité. | chaîne (obligatoire) |
domainSid | Spécifie l’identificateur de sécurité (SID). | chaîne (obligatoire) |
forestName | Spécifie la forêt Active Directory à obtenir. | chaîne (obligatoire) |
netBiosDomainName | Spécifie le nom de domaine NetBIOS. | chaîne (obligatoire) |
CustomDomain
Nom | Description | Valeur |
---|---|---|
name | Obtient ou définit le nom de domaine personnalisé affecté au compte de stockage. Name est la source CNAME. | chaîne (obligatoire) |
useSubDomainName | Indique si la validation CName indirecte est activée. La valeur par défaut est false. Cela ne doit être défini que sur les mises à jour. | bool |
Chiffrement
Nom | Description | Valeur |
---|---|---|
identité | Identité à utiliser avec le chiffrement côté service au repos. | EncryptionIdentity |
keySource | Chiffrement keySource (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Storage, Microsoft.Keyvault | « Microsoft.Keyvault » 'Microsoft.Storage' (obligatoire) |
keyvaultpropriétés | Propriétés fournies par le coffre de clés. | KeyVaultProperties |
requireInfrastructureEncryption | Boolean indiquant si le service applique ou non une couche secondaire de chiffrement avec des clés gérées par la plateforme pour les données au repos. | bool |
services | Liste des services qui prennent en charge le chiffrement. | EncryptionServices |
EncryptionIdentity
Nom | Description | Valeur |
---|---|---|
userAssignedIdentity | Identificateur de ressource de l’identité UserAssigned à associer au chiffrement côté serveur sur le compte de stockage. | string |
KeyVaultProperties
Nom | Description | Valeur |
---|---|---|
Keyname | Nom de la clé KeyVault. | string |
keyvaulturi | URI de KeyVault. | string |
keyversion | Version de la clé KeyVault. | string |
EncryptionServices
Nom | Description | Valeur |
---|---|---|
objet BLOB | Fonction de chiffrement du service de stockage d’objets blob. | EncryptionService |
fichier | Fonction de chiffrement du service de stockage de fichiers. | EncryptionService |
queue | Fonction de chiffrement du service de stockage de file d’attente. | EncryptionService |
table | Fonction de chiffrement du service de stockage table. | EncryptionService |
EncryptionService
Nom | Description | Valeur |
---|---|---|
enabled | Boolean indiquant si le service chiffre ou non les données telles qu’elles sont stockées. | bool |
keyType | Type de clé de chiffrement à utiliser pour le service de chiffrement. Le type de clé « Compte » implique qu’une clé de chiffrement étendue au compte sera utilisée. Le type de clé 'Service' implique qu’une clé de service par défaut est utilisée. | 'Compte' 'Service' |
NetworkRuleSet
Nom | Description | Valeur |
---|---|---|
ignorer | Spécifie si le trafic est contourné pour journalisation/métriques/AzureServices. Les valeurs possibles sont n’importe quelle combinaison de journalisation, de métriques, d’AzureServices (par exemple, « Journalisation, métriques ») ou de Aucun pour contourner aucun de ces trafics. | 'AzureServices' 'Journalisation' 'Metrics' 'None' |
defaultAction | Spécifie l’action par défaut d’autoriser ou de refuser lorsqu’aucune autre règle ne correspond. | 'Autoriser' 'Deny' (obligatoire) |
ipRules | Définit les règles de liste de contrôle d’accès IP | IPRule[] |
resourceAccessRules | Définit les règles d’accès aux ressources | ResourceAccessRule[] |
virtualNetworkRules | Définit les règles de réseau virtuel | VirtualNetworkRule[] |
IPRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle ACL IP. | 'Autoriser' |
value | Spécifie l’adresse IP ou la plage d’adresses IP au format CIDR. Seule l’adresse IPV4 est autorisée. | chaîne (obligatoire) |
ResourceAccessRule
Nom | Description | Valeur |
---|---|---|
resourceId | ID de ressource | string |
tenantId | ID client | string |
VirtualNetworkRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle de réseau virtuel. | 'Autoriser' |
id | ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. | chaîne (obligatoire) |
state | Obtient l’état de la règle de réseau virtuel. | « déprovisionnement » 'failed' 'networkSourceDeleted' 'provisionnement' 'réussi' |
RoutagePreference
Nom | Description | Valeur |
---|---|---|
publishInternetEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Internet doivent être publiés | bool |
publishMicrosoftEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Microsoft doivent être publiés | bool |
routingChoice | Le choix de routage définit le type de routage réseau choisi par l’utilisateur. | 'InternetRouting' 'MicrosoftRouting' |
Sku
Nom | Description | Valeur |
---|---|---|
name | Le nom du SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType. | 'Premium_LRS' 'Premium_ZRS' 'Standard_GRS' 'Standard_GZRS' 'Standard_LRS' 'Standard_RAGRS' 'Standard_RAGZRS' 'Standard_ZRS' (obligatoire) |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
Modèle | Description |
---|---|
Se connecter à un compte de stockage à partir d’une machine virtuelle via un point de terminaison privé |
Cet exemple montre comment utiliser la connexion d’un réseau virtuel pour accéder à un compte de stockage d’objets blob via un point de terminaison privé. |
Se connecter à un partage de fichiers Azure via un point de terminaison privé |
Cet exemple montre comment utiliser la configuration d’un réseau virtuel et d’une zone DNS privée pour accéder à un partage de fichiers Azure via un point de terminaison privé. |
Créer un compte de stockage standard |
Ce modèle crée un compte de stockage Standard |
Créer un compte de stockage avec SSE |
Ce modèle crée un compte de stockage avec chiffrement du service de stockage pour les données au repos |
Compte de stockage avec Protection avancée contre les menaces |
Ce modèle vous permet de déployer un compte stockage Azure avec Advanced Threat Protection activé. |
Créer un compte de stockage Azure et un conteneur d’objets blob sur Azure |
Ce modèle crée un compte stockage Azure et un conteneur d’objets blob. |
Compte de stockage avec stratégie de rétention SSE et suppression d’objets blob |
Ce modèle crée un compte de stockage avec le chiffrement du service de stockage et une stratégie de rétention de suppression d’objets blob |
Azure Storage Account Encryption avec une clé gérée par le client |
Ce modèle déploie un compte de stockage avec une clé gérée par le client pour le chiffrement qui est générée et placée dans un Key Vault. |
Créer un compte de stockage avec un partage de fichiers |
Ce modèle crée un compte de stockage Azure et un partage de fichiers. |
Créer un compte de stockage avec plusieurs conteneurs d’objets blob |
Crée un compte de stockage Azure et plusieurs conteneurs d’objets blob. |
Créer un compte de stockage avec plusieurs partages de fichiers |
Crée un compte de stockage Azure et plusieurs partages de fichiers. |
Créer un compte de stockage avec SFTP activé |
Crée un compte de stockage Azure et un conteneur d’objets blob accessibles à l’aide du protocole SFTP. L’accès peut être basé sur un mot de passe ou une clé publique. |
Déploie un site web statique |
Déploie un site web statique avec un compte de stockage de stockage |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource storageAccounts peut être déployé avec des opérations qui ciblent :
- Groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Storage/storageAccounts, ajoutez le Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Storage/storageAccounts@2021-01-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
accessTier = "string"
allowBlobPublicAccess = bool
allowSharedKeyAccess = bool
azureFilesIdentityBasedAuthentication = {
activeDirectoryProperties = {
azureStorageSid = "string"
domainGuid = "string"
domainName = "string"
domainSid = "string"
forestName = "string"
netBiosDomainName = "string"
}
directoryServiceOptions = "string"
}
customDomain = {
name = "string"
useSubDomainName = bool
}
encryption = {
identity = {
userAssignedIdentity = "string"
}
keySource = "string"
keyvaultproperties = {
keyname = "string"
keyvaulturi = "string"
keyversion = "string"
}
requireInfrastructureEncryption = bool
services = {
blob = {
enabled = bool
keyType = "string"
}
file = {
enabled = bool
keyType = "string"
}
queue = {
enabled = bool
keyType = "string"
}
table = {
enabled = bool
keyType = "string"
}
}
}
isHnsEnabled = bool
isNfsV3Enabled = bool
largeFileSharesState = "string"
minimumTlsVersion = "string"
networkAcls = {
bypass = "string"
defaultAction = "string"
ipRules = [
{
action = "Allow"
value = "string"
}
]
resourceAccessRules = [
{
resourceId = "string"
tenantId = "string"
}
]
virtualNetworkRules = [
{
action = "Allow"
id = "string"
state = "string"
}
]
}
routingPreference = {
publishInternetEndpoints = bool
publishMicrosoftEndpoints = bool
routingChoice = "string"
}
supportsHttpsTrafficOnly = bool
}
sku = {
name = "string"
}
kind = "string"
extendedLocation = {
name = "string"
type = "EdgeZone"
}
})
}
Valeurs de propriétés
storageAccounts
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.Storage/storageAccounts@2021-01-01 » |
name | Nom de la ressource | string (obligatoire) Limite de caractères : 3-24 Caractères valides : Lettres minuscules et chiffres. Le nom de la ressource doit être unique dans Azure. |
location | Obligatoire. Obtient ou définit l'emplacement de la ressource. Il s’agit de l’une des régions géographiques Azure prises en charge et inscrites (par exemple, USA Ouest, USA Est, Asie Sud-Est, etc.). La région géographique d’une ressource ne peut pas être modifiée une fois qu’elle est créée, mais si une région géographique identique est spécifiée lors de la mise à jour, la demande réussit. | string (obligatoire) |
parent_id | Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. | string (obligatoire) |
tags | Obtient ou définit une liste de paires clé-valeur qui décrivent la ressource. Ces balises peuvent être utilisées pour afficher et regrouper cette ressource (entre les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit avoir une clé dont la longueur ne dépasse pas 128 caractères et une valeur dont la longueur ne doit pas dépasser 256 caractères. | Dictionnaire de noms et de valeurs d’étiquettes. |
sku | Obligatoire. Obtient ou définit le nom de la référence SKU. | Référence SKU (obligatoire) |
kind | Obligatoire. Indique le type de compte de stockage. | « BlobStorage » « BlockBlobStorage » « FileStorage » « Stockage » « StorageV2 » (obligatoire) |
extendedLocation | facultatif. Définissez l’emplacement étendu de la ressource. S’il n’est pas défini, le compte de stockage est créé dans la région Azure main. Sinon, il sera créé à l’emplacement étendu spécifié | ExtendedLocation |
identité | Identité de la ressource. | Identité |
properties | Paramètres utilisés pour créer le compte de stockage. | StorageAccountPropertiesCreateParametersOrStorageAcc... |
ExtendedLocation
Nom | Description | Valeur |
---|---|---|
name | Nom de l’emplacement étendu. | string |
type | Type de l’emplacement étendu. | « EdgeZone » |
Identité
Nom | Description | Valeur |
---|---|---|
type | Type d’identité. | « SystemAssigned » « SystemAssigned,UserAssigned » « UserAssigned » (obligatoire) |
identity_ids | Obtient ou définit une liste de paires clé-valeur qui décrivent l’ensemble d’identités affectées par l’utilisateur qui seront utilisées avec ce compte de stockage. La clé est l’identificateur de ressource ARM de l’identité. Seule 1 identité affectée par l’utilisateur est autorisée ici. | Tableau d’ID d’identité utilisateur. |
IdentityUserAssignedIdentities
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | userAssignedIdentity |
userAssignedIdentity
Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.
StorageAccountPropertiesCreateParametersOrStorageAcc...
Nom | Description | Valeur |
---|---|---|
accessTier | Obligatoire pour les comptes de stockage où kind = BlobStorage. Niveau d’accès utilisé pour la facturation. | « Cool » « Chaud » |
allowBlobPublicAccess | Autoriser ou interdire l’accès public à tous les objets blob ou conteneurs dans le compte de stockage. L’interprétation par défaut est true pour cette propriété. | bool |
allowSharedKeyAccess | Indique si le compte de stockage autorise les demandes à être autorisées avec la clé d’accès au compte via la clé partagée. Si la valeur est false, toutes les demandes, y compris les signatures d’accès partagé, doivent être autorisées avec Azure Active Directory (Azure AD). La valeur par défaut est null, ce qui équivaut à true. | bool |
azureFilesIdentityBasedAuthentication | Fournit les paramètres d’authentification basés sur l’identité pour Azure Files. | AzureFilesIdentityBasedAuthentication |
customDomain | Domaine utilisateur affecté au compte de stockage. Name est la source CNAME. Un seul domaine personnalisé est pris en charge par compte de stockage pour l’instant. Pour effacer le domaine personnalisé existant, utilisez une chaîne vide pour la propriété de nom de domaine personnalisé. | CustomDomain |
le chiffrement | Non applicable. Le chiffrement du stockage Azure est activé pour tous les comptes de stockage et ne peut pas être désactivé. | Chiffrement |
isHnsEnabled | Account HierarchicalNamespace activé si définit sur true. | bool |
isNfsV3Enabled | Prise en charge du protocole NFS 3.0 activée si la valeur est true. | bool |
largeFileSharesState | Autorisez les partages de fichiers volumineux si définit sur Activé. Il ne peut pas être désactivé une fois qu’il est activé. | « Désactivé » « Activé » |
minimumTlsVersion | Définissez la version TLS minimale à autoriser sur les demandes de stockage. L’interprétation par défaut est TLS 1.0 pour cette propriété. | « TLS1_0 » « TLS1_1 » « TLS1_2 » |
networkAcls | Ensemble de règles réseau | NetworkRuleSet |
routingPreference | Conserve les informations sur le choix de routage réseau choisi par l’utilisateur pour le transfert de données | RoutingPreference |
supportsHttpsTrafficOnly | Autorise le trafic https uniquement vers le service de stockage si a la valeur true. La valeur par défaut est true depuis la version d’API 2019-04-01. | bool |
AzureFilesIdentityBasedAuthentication
Nom | Description | Valeur |
---|---|---|
activeDirectoryProperties | Obligatoire si vous choisissez AD. | ActiveDirectoryProperties |
directoryServiceOptions | Indique le service d’annuaire utilisé. | « AADDS » « AD » « None » (obligatoire) |
ActiveDirectoryProperties
Nom | Description | Valeur |
---|---|---|
azureStorageSid | Spécifie l’identificateur de sécurité (SID) pour stockage Azure. | string (obligatoire) |
domainGuid | Spécifie le GUID de domaine. | string (obligatoire) |
domainName | Spécifie le domaine principal pour lequel le serveur DNS AD fait autorité. | string (obligatoire) |
domainSid | Spécifie l’identificateur de sécurité (SID). | string (obligatoire) |
forestName | Spécifie la forêt Active Directory à obtenir. | chaîne (obligatoire) |
netBiosDomainName | Spécifie le nom de domaine NetBIOS. | chaîne (obligatoire) |
CustomDomain
Nom | Description | Valeur |
---|---|---|
name | Obtient ou définit le nom de domaine personnalisé affecté au compte de stockage. Name est la source CNAME. | chaîne (obligatoire) |
useSubDomainName | Indique si la validation CName indirecte est activée. La valeur par défaut est false. Cela ne doit être défini que sur les mises à jour. | bool |
Chiffrement
Nom | Description | Valeur |
---|---|---|
identité | Identité à utiliser avec le chiffrement côté service au repos. | EncryptionIdentity |
keySource | Chiffrement keySource (fournisseur). Valeurs possibles (sans respect de la casse) : Microsoft.Storage, Microsoft.Keyvault | « Microsoft.Keyvault » « Microsoft.Storage » (obligatoire) |
keyvaultpropriétés | Propriétés fournies par le coffre de clés. | KeyVaultProperties |
requireInfrastructureEncryption | Boolean indiquant si le service applique ou non une couche secondaire de chiffrement avec des clés gérées par la plateforme pour les données au repos. | bool |
services | Liste des services qui prennent en charge le chiffrement. | EncryptionServices |
EncryptionIdentity
Nom | Description | Valeur |
---|---|---|
userAssignedIdentity | Identificateur de ressource de l’identité UserAssigned à associer au chiffrement côté serveur sur le compte de stockage. | string |
KeyVaultProperties
Nom | Description | Valeur |
---|---|---|
Keyname | Nom de la clé KeyVault. | string |
keyvaulturi | URI de KeyVault. | string |
keyversion | Version de la clé KeyVault. | string |
EncryptionServices
Nom | Description | Valeur |
---|---|---|
objet BLOB | Fonction de chiffrement du service de stockage d’objets blob. | EncryptionService |
fichier | Fonction de chiffrement du service de stockage de fichiers. | EncryptionService |
queue | Fonction de chiffrement du service de stockage de file d’attente. | EncryptionService |
table | Fonction de chiffrement du service de stockage table. | EncryptionService |
EncryptionService
Nom | Description | Valeur |
---|---|---|
enabled | Boolean indiquant si le service chiffre ou non les données telles qu’elles sont stockées. | bool |
keyType | Type de clé de chiffrement à utiliser pour le service de chiffrement. Le type de clé « Compte » implique qu’une clé de chiffrement étendue au compte sera utilisée. Le type de clé 'Service' implique qu’une clé de service par défaut est utilisée. | « Compte » « Service » |
NetworkRuleSet
Nom | Description | Valeur |
---|---|---|
ignorer | Spécifie si le trafic est contourné pour journalisation/métriques/AzureServices. Les valeurs possibles sont n’importe quelle combinaison de journalisation, de métriques, d’AzureServices (par exemple, « Journalisation, métriques ») ou de Aucun pour contourner aucun de ces trafics. | « AzureServices » « Journalisation » « Métriques » "None" |
defaultAction | Spécifie l’action par défaut d’autoriser ou de refuser lorsqu’aucune autre règle ne correspond. | « Autoriser » « Refuser » (obligatoire) |
ipRules | Définit les règles de liste de contrôle d’accès IP | IPRule[] |
resourceAccessRules | Définit les règles d’accès aux ressources | ResourceAccessRule[] |
virtualNetworkRules | Définit les règles de réseau virtuel | VirtualNetworkRule[] |
IPRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle ACL IP. | « Autoriser » |
value | Spécifie l’adresse IP ou la plage d’adresses IP au format CIDR. Seule l’adresse IPV4 est autorisée. | chaîne (obligatoire) |
ResourceAccessRule
Nom | Description | Valeur |
---|---|---|
resourceId | ID de ressource | string |
tenantId | ID client | string |
VirtualNetworkRule
Nom | Description | Valeur |
---|---|---|
action | Action de la règle de réseau virtuel. | « Autoriser » |
id | ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}. | chaîne (obligatoire) |
state | Obtient l’état de la règle de réseau virtuel. | « déprovisionnement » « échec » « networkSourceDeleted » « provisionnement » « réussi » |
RoutagePreference
Nom | Description | Valeur |
---|---|---|
publishInternetEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Internet doivent être publiés | bool |
publishMicrosoftEndpoints | Indicateur booléen qui indique si les points de terminaison de stockage de routage Microsoft doivent être publiés | bool |
routingChoice | Le choix de routage définit le type de routage réseau choisi par l’utilisateur. | « InternetRouting » « MicrosoftRouting » |
Sku
Nom | Description | Valeur |
---|---|---|
name | Le nom du SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType. | « Premium_LRS » « Premium_ZRS » « Standard_GRS » « Standard_GZRS » « Standard_LRS » « Standard_RAGRS » « Standard_RAGZRS » « Standard_ZRS » (obligatoire) |