Partager via

Base de données Microsoft.DocumentDBAccounts 2023-11-15-preview

  • Article

Définition de ressource Bicep

Le type de ressource databaseAccounts peut être déployé avec des opérations qui ciblent :

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.DocumentDB/databaseAccounts, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2023-11-15-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    analyticalStorageConfiguration: {
      schemaType: 'string'
    }
    apiProperties: {
      serverVersion: 'string'
    }
    backupPolicy: {
      migrationState: {
        startTime: 'string'
        status: 'string'
        targetType: 'string'
      }
      type: 'string'
      // For remaining properties, see BackupPolicy objects
    }
    capabilities: [
      {
        name: 'string'
      }
    ]
    capacity: {
      totalThroughputLimit: int
    }
    connectorOffer: 'Small'
    consistencyPolicy: {
      defaultConsistencyLevel: 'string'
      maxIntervalInSeconds: int
      maxStalenessPrefix: int
    }
    cors: [
      {
        allowedHeaders: 'string'
        allowedMethods: 'string'
        allowedOrigins: 'string'
        exposedHeaders: 'string'
        maxAgeInSeconds: int
      }
    ]
    createMode: 'string'
    customerManagedKeyStatus: 'string'
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'string'
    defaultPriorityLevel: 'string'
    diagnosticLogSettings: {
      enableFullTextQuery: 'string'
    }
    disableKeyBasedMetadataWriteAccess: bool
    disableLocalAuth: bool
    enableAnalyticalStorage: bool
    enableAutomaticFailover: bool
    enableBurstCapacity: bool
    enableCassandraConnector: bool
    enableFreeTier: bool
    enableMaterializedViews: bool
    enableMultipleWriteLocations: bool
    enablePartitionMerge: bool
    enablePriorityBasedExecution: bool
    ipRules: [
      {
        ipAddressOrRange: 'string'
      }
    ]
    isVirtualNetworkFilterEnabled: bool
    keyVaultKeyUri: 'string'
    locations: [
      {
        failoverPriority: int
        isZoneRedundant: bool
        locationName: 'string'
      }
    ]
    minimalTlsVersion: 'string'
    networkAclBypass: 'string'
    networkAclBypassResourceIds: [
      'string'
    ]
    publicNetworkAccess: 'string'
    restoreParameters: {
      databasesToRestore: [
        {
          collectionNames: [
            'string'
          ]
          databaseName: 'string'
        }
      ]
      gremlinDatabasesToRestore: [
        {
          databaseName: 'string'
          graphNames: [
            'string'
          ]
        }
      ]
      restoreMode: 'PointInTime'
      restoreSource: 'string'
      restoreTimestampInUtc: 'string'
      sourceBackupLocation: 'string'
      tablesToRestore: [
        'string'
      ]
    }
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
}

Objets BackupPolicy

Définissez la propriété type pour spécifier le type d’objet.

Pour Continu, utilisez :

  type: 'Continuous'
  continuousModeProperties: {
    tier: 'string'
  }

Pour Périodique, utilisez :

  type: 'Periodic'
  periodicModeProperties: {
    backupIntervalInMinutes: int
    backupRetentionIntervalInHours: int
    backupStorageRedundancy: 'string'
  }

Valeurs de propriétés

databaseAccounts

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 3-44

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Doit commencer par une lettre minuscule ou un chiffre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement du groupe de ressources auquel appartient la ressource. string
tags Les balises sont une liste de paires clé-valeur qui décrivent la ressource. Ces balises peuvent servir à l’affichage et au regroupement des ressources (parmi tous les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit disposer d’une clé de 128 caractères maximum et d’une valeur de 256 caractères maximum. Par exemple, l’expérience par défaut pour un type de modèle est définie avec « defaultExperience » : « Cassandra ». Les valeurs « defaultExperience » actuelles incluent également « Table », « Graph », « DocumentDB » et « MongoDB ». Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind Indique le type de compte de base de données. Cela ne peut être défini qu’au moment de la création du compte de base de données. 'GlobalDocumentDB'
'MongoDB'
'Analyse'
identité Identité de la ressource. ManagedServiceIdentity
properties Propriétés permettant de créer et de mettre à jour des comptes de base de données Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité utilisé pour la ressource. Le type « SystemAssigned,UserAssigned » inclut à la fois une identité implicitement créée et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités du service. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nom Description Valeur
analyticalStorageConfiguration Propriétés spécifiques au stockage analytique. AnalyticalStorageConfiguration
apiProperties Propriétés spécifiques à l’API. Actuellement, pris en charge uniquement pour l’API MongoDB. ApiProperties
backupPolicy Objet représentant la stratégie pour effectuer des sauvegardes sur un compte. BackupPolicy
capabilities Liste des fonctionnalités Cosmos DB pour le compte Capability[]
capacité Objet qui représente toutes les propriétés liées à l’application de la capacité sur un compte. Capacité
connectorOffer Type d’offre de connecteur cassandra pour le compte C* de base de données Cosmos DB. 'Small'
consistencyPolicy Stratégie de cohérence pour le compte Cosmos DB. CohérencePolicy
cors Stratégie CORS pour le compte de base de données Cosmos DB. CorsPolicy[]
createMode Énumérez pour indiquer le mode de création du compte. 'Par défaut'
'PointInTimeRestore'
'Restaurer'
customerManagedKeyStatus Indique l’état de la fonctionnalité Clé gérée par le client sur le compte. En cas d’erreurs, la propriété fournit des conseils de dépannage. string
databaseAccountOfferType Type d’offre pour la base de données 'Standard' (obligatoire)
defaultIdentity Identité par défaut pour accéder au coffre de clés utilisé dans des fonctionnalités telles que les clés gérées par le client. L’identité par défaut doit être définie explicitement par les utilisateurs. Il peut s’agir de « FirstPartyIdentity », « SystemAssignedIdentity » et bien plus encore. string
defaultPriorityLevel Enum pour indiquer le niveau de priorité par défaut de la demande pour l’exécution basée sur la priorité. 'High'
'Faible'
diagnosticLogSettings Objet représentant les différents paramètres du journal de diagnostic pour le compte Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess Désactiver les opérations d’écriture sur les ressources de métadonnées (bases de données, conteneurs, débit) via des clés de compte bool
disableLocalAuth Désactivez l’authentification locale et assurez-vous que seuls MSI et AAD peuvent être utilisés exclusivement pour l’authentification. bool
enableAnalyticalStorage Indicateur pour indiquer s’il faut activer l’analyse du stockage. bool
enableAutomaticFailover Active le basculement automatique de la région d’écriture dans le cas rare où la région n’est pas disponible en raison d’une panne. Le basculement automatique entraîne une nouvelle région d’écriture pour le compte et est choisi en fonction des priorités de basculement configurées pour le compte. bool
enableBurstCapacity Indicateur indiquant l’activation/désactivation de la fonctionnalité Burst Capacity Preview sur le compte bool
enableCassandraConnector Active le connecteur cassandra sur le compte C* Cosmos DB bool
enableFreeTier Indicateur pour indiquer si le niveau gratuit est activé. bool
enableMaterializedViews Indicateur indiquant s’il faut activer MaterializedViews sur le compte Cosmos DB bool
enableMultipleWriteLocations Permet au compte d’écrire à plusieurs emplacements bool
enablePartitionMerge Indicateur pour indiquer l’activation/désactivation de la fonctionnalité de fusion de partitions sur le compte bool
enablePriorityBasedExecution Indicateur indiquant l’activation/désactivation de la fonctionnalité d’aperçu de l’exécution basée sur la priorité sur le compte bool
ipRules Liste des ipRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Indicateur pour indiquer s’il faut activer/désactiver les règles de liste de contrôle d’accès de réseau virtuel. bool
keyVaultKeyUri URI du coffre de clés string
locations Tableau qui contient les emplacements de géoréplication activés pour le compte Cosmos DB. Location[] (obligatoire)
minimalTlsVersion Indique la version minimale autorisée de Tls. La valeur par défaut est Tls 1.0, à l’exception des API Cassandra et Mongo, qui fonctionnent uniquement avec Tls 1.2. 'Tls'
'Tls11'
'Tls12'
networkAclBypass Indique quels services sont autorisés à contourner les vérifications de pare-feu. 'AzureServices'
'None'
networkAclBypassResourceIds Tableau qui contient les ID de ressource pour network Acl Bypass pour le compte Cosmos DB. string[]
publicNetworkAccess Si les requêtes provenant du réseau public sont autorisées 'Désactivé'
'Enabled'
'SecuredByPerimeter'
restoreParameters Paramètres pour indiquer les informations sur la restauration. RestoreParameters
virtualNetworkRules Liste des règles de liste de contrôle d’accès de réseau virtuel configurées pour le compte Cosmos DB. VirtualNetworkRule[]

AnalyticalStorageConfiguration

Nom Description Valeur
schemaType Décrit les types de schéma pour le stockage analytique. 'FullFidelity'
'WellDefined'

ApiProperties

Nom Description Valeur
serverVersion Décrit la serverVersion d’un compte MongoDB. '3.2'
'3.6'
'4.0'
'4.2'

BackupPolicy

Nom Description Valeur
migrationState Objet représentant l’état de la migration entre les stratégies de sauvegarde. BackupPolicyMigrationState
type Définir le type d’objet Continue
Périodique (obligatoire)

BackupPolicyMigrationState

Nom Description Valeur
startTime Heure à laquelle la migration de la stratégie de sauvegarde a démarré (format ISO-8601). string
status Décrit l’état de la migration entre les types de stratégies de sauvegarde. 'Terminé'
'Échec'
'InProgress'
'Non valide'
targetType Décrit le type de stratégie de sauvegarde cible de la migration de stratégie de sauvegarde. 'Continu'
'Périodique'

ContinuousModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. 'Continu' (obligatoire)
continuousModeProperties Valeurs de configuration pour la sauvegarde en mode continu ContinuousModeProperties

ContinuousModeProperties

Nom Description Valeur
Niveau Énumération pour indiquer le type de mode de sauvegarde Continuos 'Continuous30Days'
'Continuous7Days'

PeriodicModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. 'Périodique' (obligatoire)
periodicModeProperties Valeurs de configuration pour la sauvegarde en mode périodique PeriodicModeProperties

PeriodicModeProperties

Nom Description Valeur
backupIntervalInMinutes Entier représentant l’intervalle en minutes entre deux sauvegardes int

Contraintes :
Valeur minimale = 0
backupRetentionIntervalInHours Entier représentant l’heure (en heures) pendant laquelle chaque sauvegarde est conservée int

Contraintes :
Valeur minimale = 0
backupStorageRedundancy Énumération pour indiquer le type de résidence de sauvegarde 'Geo'
'Local'
'Zone'

Fonctionnalité

Nom Description Valeur
name Nom de la fonctionnalité Cosmos DB. Par exemple, « name » : « EnableCassandra ». Les valeurs actuelles incluent également « EnableTable » et « EnableGremlin ». string

Capacité

Nom Description Valeur
totalThroughputLimit Limite de débit totale imposée au compte. Un totalThroughputLimit de 2000 impose une limite stricte de débit maximal qui peut être provisionné sur ce compte à 2000. Un totalThroughputLimit de -1 n’indique aucune limite d’approvisionnement du débit. int

CohérencePolicy

Nom Description Valeur
defaultConsistencyLevel Niveau de cohérence et paramètres de configuration par défaut du compte Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Éventuel'
'Session'
'Strong' (obligatoire)
maxIntervalInSeconds Lorsqu’elle est utilisée avec le niveau de cohérence Borned Staleness, cette valeur représente la durée d’obsolescence (en secondes) tolérée. La plage acceptée pour cette valeur est comprise entre 5 et 86400. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 5
Valeur maximale = 86400
maxStalenessPrefix Lorsqu’elle est utilisée avec le niveau de cohérence Borned Staleness, cette valeur représente le nombre de demandes obsolètes tolérées. Les valeurs acceptables sont 1-2, 147, 483 et 647. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

CorsPolicy

Nom Description Valeur
allowedHeaders En-têtes de requête que le domaine d’origine peut spécifier dans la requête CORS. string
allowedMethods Méthodes (verbes de requête HTTP) que le domaine d’origine peut utiliser pour une requête CORS. string
allowedOrigins Domaines d’origine autorisés à effectuer une requête auprès du service via CORS. chaîne (obligatoire)
exposedHeaders En-têtes de réponse qui peuvent être envoyés dans la réponse à la requête CORS et exposés par le navigateur à l’émetteur de la requête. string
maxAgeInSeconds Durée maximale pendant laquelle un navigateur doit mettre en cache la requête OPTIONS préliminaire. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

DiagnosticLogSettings

Nom Description Valeur
enableFullTextQuery Décrire le niveau de détail avec lequel les requêtes doivent être journalisées. « False »
'None'
'True'

IpAddressOrRange

Nom Description Valeur
ipAddressOrRange Une seule adresse IPv4 ou une seule plage d’adresses IPv4 au format CIDR. Les adresses IP fournies doivent être bien mises en forme et ne peuvent pas être contenues dans l’une des plages suivantes : 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, car elles ne sont pas applicables par le filtre d’adresse IP. Exemple d’entrées valides : « 23.40.210.245 » ou « 23.40.210.0/8 ». string

Emplacement

Nom Description Valeur
failoverPriority Priorité de basculement de la région. Une priorité de basculement de 0 indique une région d’écriture. Valeur maximale d’une priorité de basculement = (nombre total de régions - 1). Les valeurs de priorité de basculement doivent être uniques pour chacune des régions dans lesquelles le compte de base de données existe. int

Contraintes :
Valeur minimale = 0
isZoneRedundant Indicateur pour indiquer si cette région est une région AvailabilityZone bool
locationName Nom de la région. string

RestoreParameters

Nom Description Valeur
databasesToRestore Liste des bases de données spécifiques disponibles pour la restauration. DatabaseRestoreResource
gremlinDatabasesToRestore Liste des bases de données gremlin spécifiques disponibles pour la restauration. GremlinDatabaseRestoreResource[]
restoreMode Décrit le mode de restauration. 'PointInTime'
restoreSource ID du compte de base de données restaurable à partir duquel la restauration doit être lancée. Par exemple : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Heure à laquelle le compte doit être restauré (format ISO-8601). string
sourceBackupLocation Emplacement de sauvegarde source pour la restauration. string
tablesToRestore Liste des tables spécifiques disponibles pour la restauration. string[]

DatabaseRestoreResource

Nom Description Valeur
collectionNames Noms des collections disponibles pour la restauration. string[]
databaseName Nom de la base de données disponible pour la restauration. string

GremlinDatabaseRestoreResource

Nom Description Valeur
databaseName Nom de la base de données gremlin disponible pour la restauration. string
graphNames Noms des graphiques disponibles pour la restauration. string[]

VirtualNetworkRule

Nom Description Valeur
id ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Créez une règle de pare-feu avant que le point de terminaison de service de réseau virtuel soit activé sur le réseau virtuel. bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
CI/CD à l’aide de Jenkins sur Azure Container Service (AKS)

Déployer sur Azure 		Les conteneurs facilitent la création et le déploiement continus de vos applications. En orchestrant le déploiement de ces conteneurs à l’aide de Kubernetes dans Azure Container Service, vous pouvez obtenir des clusters de conteneurs réplicables et gérables. En configurant une génération continue pour produire vos images et votre orchestration de conteneurs, vous pouvez augmenter la vitesse et la fiabilité de votre déploiement.
Application web avec une base de données SQL, Azure Cosmos DB, Recherche Azure

Déployer sur Azure 		Ce modèle approvisionne une application web, une base de données SQL, Azure Cosmos DB, Azure Search et Application Insights.
Créer un compte Azure Cosmos DB pour l’API Cassandra

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Cassandra dans deux régions avec un espace de clés et une table avec un débit dédié.
Créer un compte de mise à l’échelle automatique Azure Cosmos DB pour l’API Cassandra

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Cassandra dans deux régions avec un espace de clés et une table avec un débit de mise à l’échelle automatique.
Créer un compte Azure CosmosDB

Déployer sur Azure 		Ce modèle ARM est destiné à créer rapidement un compte CosmosDB avec les valeurs minimales requises
Créer un compte Azure Cosmos DB dans plusieurs régions

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour n’importe quel type d’API de base de données avec une région principale et une région secondaire avec le choix du niveau de cohérence et du type de basculement.
Créez un compte Azure Cosmos DB de niveau gratuit

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB de niveau gratuit pour l’API SQL avec une base de données avec un débit et un conteneur partagés.
Créer un compte Azure Cosmos DB pour l’API Gremlin

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Gremlin dans deux régions avec une base de données et un graphique à l’aide d’un débit dédié.
Créer un compte Azure Cosmos DB pour la mise à l’échelle automatique de l’API Gremlin

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Gremlin dans deux régions avec une base de données et un graphique à l’aide du débit de mise à l’échelle automatique.
Créer un compte Azure Cosmos pour l’API MongoDB

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API MongoDB 4.2 dans deux régions à l’aide d’un débit partagé et dédié avec deux collections.
Créer un compte Azure Cosmos pour la mise à l’échelle automatique de l’API MongoDB

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API MongoDB 4.2 dans deux régions à l’aide d’un débit de mise à l’échelle automatique partagé et dédié.
Créer un compte Azure Cosmos DB avec un point de terminaison privé

Déployer sur Azure 		Ce modèle crée un compte Cosmos, un réseau virtuel et un point de terminaison privé exposant le compte Cosmos au réseau virtuel.
Créer un compte Azure Cosmos DB pour l’API Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur avec un débit avec plusieurs autres options.
API SQL de compte Azure Cosmos DB avec magasin analytique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur configurés avec un magasin analytique.
Créer une API SQL de compte Azure Cosmos DB avec mise à l’échelle automatique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur avec un débit de mise à l’échelle automatique avec plusieurs autres options.
Créer des procédures stockées de l’API Azure Cosmos DB Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Core (SQL) et un conteneur avec une procédure stockée, un déclencheur et une fonction définie par l’utilisateur.
Créer un compte Azure Cosmos DB minimal pour l’API Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Core (SQL) tout en spécifiant uniquement les propriétés de ressource minimales requises.
Créer Azure Cosmos avec l’API SQL et plusieurs conteneurs

Déployer sur Azure 		Le modèle crée un conteneur Cosmos avec une API SQL et permet d’ajouter des conteneurs mulitple.
Créer un compte SQL Azure Cosmos DB avec RBAC de plan de données

Déployer sur Azure 		Ce modèle crée un compte SQL Cosmos, une définition de rôle gérée en mode natif et une attribution de rôle gérée en mode natif pour une identité AAD.
Créer un compte Azure Cosmos DB serverless pour l’API SQL

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB serverless pour l’API Core (SQL).
Créer un compte Azure Cosmos pour l’API Table

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Table dans deux régions et une seule table avec un débit provisionné.
Créer un compte Azure Cosmos pour l’API Table avec mise à l’échelle automatique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Table dans deux régions et une seule table avec débit de mise à l’échelle automatique.
Créer un compte Azure Cosmos sans contact et Une application web Azure

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos, injecte le point de terminaison et les clés Cosmos DB dans les paramètres Azure Web App, puis déploie une application web ASP MVC à partir de GitHub.
Créer un compte Cosmos DB avec Microsoft Defender activé

Déployer sur Azure 		À l’aide de ce modèle ARM, vous pouvez déployer un compte Azure Cosmos DB avec Microsoft Defender pour Azure Cosmos DB activé. Microsoft Defender pour Azure Cosmos DB est une couche de sécurité native Azure qui détecte les tentatives d’exploitation des bases de données dans vos comptes Azure Cosmos DB. Microsoft Defender pour Azure Cosmos DB détecte les injections SQL potentielles, les acteurs malveillants connus en fonction de Microsoft Threat Intelligence, les modèles d’accès suspects et les exploitations potentielles de votre base de données par le biais d’identités compromises ou d’initiés malveillants.
Déployer Azure Data Explorer DB avec une connexion Cosmos DB

Déployer sur Azure 		Déployez Azure Data Explorer DB avec une connexion Cosmos DB.
Compte Azure Cosmos DB avec application web

Déployer sur Azure 		Ce modèle déploie un compte Azure Cosmos DB, un plan App Service et crée une application web dans le plan App Service. Il ajoute également deux paramètres d’application à l’application web qui référencent le point de terminaison de compte Azure Cosmos DB. De cette façon, les solutions déployées sur l’application web peuvent se connecter au point de terminaison de compte Azure Cosmos DB à l’aide de ces paramètres.

Définition de ressources de modèle ARM

Le type de ressource databaseAccounts peut être déployé avec des opérations qui ciblent :

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.DocumentDB/databaseAccounts, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2023-11-15-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "analyticalStorageConfiguration": {
      "schemaType": "string"
    },
    "apiProperties": {
      "serverVersion": "string"
    },
    "backupPolicy": {
      "migrationState": {
        "startTime": "string",
        "status": "string",
        "targetType": "string"
      },
      "type": "string"
      // For remaining properties, see BackupPolicy objects
    },
    "capabilities": [
      {
        "name": "string"
      }
    ],
    "capacity": {
      "totalThroughputLimit": "int"
    },
    "connectorOffer": "Small",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "string",
      "maxIntervalInSeconds": "int",
      "maxStalenessPrefix": "int"
    },
    "cors": [
      {
        "allowedHeaders": "string",
        "allowedMethods": "string",
        "allowedOrigins": "string",
        "exposedHeaders": "string",
        "maxAgeInSeconds": "int"
      }
    ],
    "createMode": "string",
    "customerManagedKeyStatus": "string",
    "databaseAccountOfferType": "Standard",
    "defaultIdentity": "string",
    "defaultPriorityLevel": "string",
    "diagnosticLogSettings": {
      "enableFullTextQuery": "string"
    },
    "disableKeyBasedMetadataWriteAccess": "bool",
    "disableLocalAuth": "bool",
    "enableAnalyticalStorage": "bool",
    "enableAutomaticFailover": "bool",
    "enableBurstCapacity": "bool",
    "enableCassandraConnector": "bool",
    "enableFreeTier": "bool",
    "enableMaterializedViews": "bool",
    "enableMultipleWriteLocations": "bool",
    "enablePartitionMerge": "bool",
    "enablePriorityBasedExecution": "bool",
    "ipRules": [
      {
        "ipAddressOrRange": "string"
      }
    ],
    "isVirtualNetworkFilterEnabled": "bool",
    "keyVaultKeyUri": "string",
    "locations": [
      {
        "failoverPriority": "int",
        "isZoneRedundant": "bool",
        "locationName": "string"
      }
    ],
    "minimalTlsVersion": "string",
    "networkAclBypass": "string",
    "networkAclBypassResourceIds": [ "string" ],
    "publicNetworkAccess": "string",
    "restoreParameters": {
      "databasesToRestore": [
        {
          "collectionNames": [ "string" ],
          "databaseName": "string"
        }
      ],
      "gremlinDatabasesToRestore": [
        {
          "databaseName": "string",
          "graphNames": [ "string" ]
        }
      ],
      "restoreMode": "PointInTime",
      "restoreSource": "string",
      "restoreTimestampInUtc": "string",
      "sourceBackupLocation": "string",
      "tablesToRestore": [ "string" ]
    },
    "virtualNetworkRules": [
      {
        "id": "string",
        "ignoreMissingVNetServiceEndpoint": "bool"
      }
    ]
  }
}

Objets BackupPolicy

Définissez la propriété type pour spécifier le type d’objet.

Pour Continu, utilisez :

  "type": "Continuous",
  "continuousModeProperties": {
    "tier": "string"
  }

Pour Périodique, utilisez :

  "type": "Periodic",
  "periodicModeProperties": {
    "backupIntervalInMinutes": "int",
    "backupRetentionIntervalInHours": "int",
    "backupStorageRedundancy": "string"
  }

Valeurs de propriétés

databaseAccounts

Nom Description Valeur
type Type de ressource 'Microsoft.DocumentDB/databaseAccounts'
apiVersion Version de l’API de ressource « 2023-11-15-preview »
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 3-44

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Doit commencer par une lettre minuscule ou un chiffre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement du groupe de ressources auquel appartient la ressource. string
tags Les balises sont une liste de paires clé-valeur qui décrivent la ressource. Ces balises peuvent servir à l’affichage et au regroupement des ressources (parmi tous les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit disposer d’une clé de 128 caractères maximum et d’une valeur de 256 caractères maximum. Par exemple, l’expérience par défaut pour un type de modèle est définie avec « defaultExperience » : « Cassandra ». Les valeurs « defaultExperience » actuelles incluent également « Table », « Graph », « DocumentDB » et « MongoDB ». Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind Indique le type de compte de base de données. Cela ne peut être défini qu’au moment de la création du compte de base de données. 'GlobalDocumentDB'
'MongoDB'
'Analyse'
identité Identité de la ressource. ManagedServiceIdentity
properties Propriétés permettant de créer et de mettre à jour des comptes de base de données Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité utilisé pour la ressource. Le type « SystemAssigned,UserAssigned » inclut à la fois une identité implicitement créée et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités du service. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nom Description Valeur
analyticalStorageConfiguration Propriétés spécifiques au stockage analytique. AnalyticalStorageConfiguration
apiProperties Propriétés spécifiques à l’API. Actuellement, pris en charge uniquement pour l’API MongoDB. ApiProperties
backupPolicy Objet représentant la stratégie pour effectuer des sauvegardes sur un compte. BackupPolicy
capabilities Liste des fonctionnalités Cosmos DB pour le compte Capability[]
capacité Objet qui représente toutes les propriétés liées à l’application de la capacité sur un compte. Capacité
connectorOffer Type d’offre de connecteur cassandra pour le compte C* de base de données Cosmos DB. 'Small'
consistencyPolicy Stratégie de cohérence pour le compte Cosmos DB. CohérencePolicy
cors Stratégie CORS pour le compte de base de données Cosmos DB. CorsPolicy[]
createMode Énumérez pour indiquer le mode de création du compte. 'Par défaut'
'PointInTimeRestore'
'Restaurer'
customerManagedKeyStatus Indique l’état de la fonctionnalité Clé gérée par le client sur le compte. En cas d’erreurs, la propriété fournit des conseils de dépannage. string
databaseAccountOfferType Type d’offre pour la base de données 'Standard' (obligatoire)
defaultIdentity Identité par défaut pour accéder au coffre de clés utilisé dans des fonctionnalités telles que les clés gérées par le client. L’identité par défaut doit être définie explicitement par les utilisateurs. Il peut s’agir de « FirstPartyIdentity », « SystemAssignedIdentity » et bien plus encore. string
defaultPriorityLevel Énumérez pour indiquer le niveau de priorité par défaut de la requête pour l’exécution basée sur la priorité. 'High'
'Low'
diagnosticLogSettings Objet représentant les différents paramètres du journal de diagnostic pour le compte Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess Désactiver les opérations d’écriture sur les ressources de métadonnées (bases de données, conteneurs, débit) via des clés de compte bool
disableLocalAuth Désactivez l’authentification locale et assurez-vous que seuls MSI et AAD peuvent être utilisés exclusivement pour l’authentification. bool
enableAnalyticalStorage Indicateur pour indiquer s’il faut activer l’analytique du stockage. bool
enableAutomaticFailover Active le basculement automatique de la région d’écriture dans les rares cas où la région n’est pas disponible en raison d’une panne. Le basculement automatique génère une nouvelle région d’écriture pour le compte et est choisi en fonction des priorités de basculement configurées pour le compte. bool
enableBurstCapacity Indicateur pour indiquer l’activation/désactivation de la fonctionnalité Burst Capacity Preview sur le compte bool
enableCassandraConnector Active le connecteur cassandra sur le compte C* Cosmos DB bool
enableFreeTier Indicateur pour indiquer si le niveau gratuit est activé. bool
enableMaterializedViews Indicateur pour indiquer s’il faut activer MaterializedViews sur le compte Cosmos DB bool
enableMultipleWriteLocations Permet au compte d’écrire dans plusieurs emplacements bool
enablePartitionMerge Indicateur pour indiquer l’activation/désactivation de la fonctionnalité de fusion de partitions sur le compte bool
enablePriorityBasedExecution Indicateur pour indiquer l’activation/désactivation de la fonctionnalité d’aperçu de l’exécution basée sur la priorité sur le compte bool
ipRules Liste des iprules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Indicateur pour indiquer s’il faut activer/désactiver les règles ACL de réseau virtuel. bool
keyVaultKeyUri URI du coffre de clés string
locations Tableau qui contient les emplacements de géoréplication activés pour le compte Cosmos DB. Location[] (obligatoire)
minimalTlsVersion Indique la version minimale autorisée de Tls. La valeur par défaut est Tls 1.0, à l’exception des API Cassandra et Mongo, qui fonctionnent uniquement avec Tls 1.2. 'Tls'
'Tls11'
'Tls12'
networkAclBypass Indique quels services sont autorisés à contourner les vérifications de pare-feu. 'AzureServices'
'None'
networkAclBypassResourceIds Tableau qui contient les ID de ressource pour network Acl Bypass pour le compte Cosmos DB. string[]
publicNetworkAccess Si les demandes provenant du réseau public sont autorisées 'Désactivé'
'Enabled'
'SecuredByPerimeter'
restoreParameters Paramètres pour indiquer les informations relatives à la restauration. RestoreParameters
virtualNetworkRules Liste des règles de liste de contrôle d’accès de réseau virtuel configurées pour le compte Cosmos DB. VirtualNetworkRule[]

AnalyticalStorageConfiguration

Nom Description Valeur
schemaType Décrit les types de schéma pour le stockage analytique. 'FullFidelity'
'WellDefined'

ApiProperties

Nom Description Valeur
serverVersion Décrit la ServerVersion d’un compte MongoDB. '3.2'
'3.6'
'4.0'
'4.2'

BackupPolicy

Nom Description Valeur
migrationState Objet représentant l’état de la migration entre les stratégies de sauvegarde. BackupPolicyMigrationState
type Définir le type d’objet Continue
Périodique (obligatoire)

BackupPolicyMigrationState

Nom Description Valeur
startTime Heure à laquelle la migration de la stratégie de sauvegarde a démarré (format ISO-8601). string
status Décrit l’état de la migration entre les types de stratégies de sauvegarde. 'Terminé'
'Échec'
'InProgress'
'Non valide'
targetType Décrit le type de stratégie de sauvegarde cible de la migration de stratégie de sauvegarde. 'Continu'
'Périodique'

ContinuousModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. 'Continu' (obligatoire)
continuousModeProperties Valeurs de configuration pour la sauvegarde en mode continu ContinuousModeProperties

ContinuousModeProperties

Nom Description Valeur
Niveau Énumération pour indiquer le type de mode de sauvegarde Continuos 'Continuous30Days'
'Continuous7Days'

PeriodicModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. 'Périodique' (obligatoire)
periodicModeProperties Valeurs de configuration pour la sauvegarde en mode périodique PeriodicModeProperties

PeriodicModeProperties

Nom Description Valeur
backupIntervalInMinutes Entier représentant l’intervalle en minutes entre deux sauvegardes int

Contraintes :
Valeur minimale = 0
backupRetentionIntervalInHours Entier représentant l’heure (en heures) pendant laquelle chaque sauvegarde est conservée int

Contraintes :
Valeur minimale = 0
backupStorageRedundancy Énumération pour indiquer le type de résidence de sauvegarde 'Geo'
'Local'
'Zone'

Fonctionnalité

Nom Description Valeur
name Nom de la fonctionnalité Cosmos DB. Par exemple, « name » : « EnableCassandra ». Les valeurs actuelles incluent également « EnableTable » et « EnableGremlin ». string

Capacité

Nom Description Valeur
totalThroughputLimit Limite de débit totale imposée au compte. Un totalThroughputLimit de 2000 impose une limite stricte de débit maximal qui peut être provisionné sur ce compte à 2000. Un totalThroughputLimit de -1 n’indique aucune limite d’approvisionnement du débit. int

CohérencePolicy

Nom Description Valeur
defaultConsistencyLevel Niveau de cohérence et paramètres de configuration par défaut du compte Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Éventuel'
'Session'
'Strong' (obligatoire)
maxIntervalInSeconds Lorsqu’elle est utilisée avec le niveau de cohérence de l’obsolescence limitée, cette valeur représente la durée d’obsolescence (en secondes) tolérée. La plage acceptée pour cette valeur est comprise entre 5 et 86400. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 5
Valeur maximale = 86400
maxStalenessPrefix Lorsqu’elle est utilisée avec le niveau de cohérence de l’obsolescence limitée, cette valeur représente le nombre de demandes obsolètes tolérées. Les valeurs acceptables sont 1-2, 147, 483 et 647. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

CorsPolicy

Nom Description Valeur
allowedHeaders En-têtes de requête que le domaine d’origine peut spécifier dans la requête CORS. string
allowedMethods Méthodes (verbes de requête HTTP) que le domaine d’origine peut utiliser pour une requête CORS. string
allowedOrigins Domaines d’origine autorisés à effectuer une demande auprès du service via CORS. string (obligatoire)
exposedHeaders En-têtes de réponse qui peuvent être envoyés dans la réponse à la requête CORS et exposés par le navigateur à l’émetteur de la requête. string
maxAgeInSeconds Durée maximale pendant laquelle un navigateur doit mettre en cache la requête OPTIONS préliminaire. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

DiagnosticLogSettings

Nom Description Valeur
enableFullTextQuery Décrire le niveau de détail avec lequel les requêtes doivent être journalisées. « False »
'None'
'True'

IpAddressOrRange

Nom Description Valeur
ipAddressOrRange Une seule adresse IPv4 ou une seule plage d’adresses IPv4 au format CIDR. Les adresses IP fournies doivent être bien mises en forme et ne peuvent pas être contenues dans l’une des plages suivantes : 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, car elles ne sont pas applicables par le filtre d’adresse IP. Exemple d’entrées valides : « 23.40.210.245 » ou « 23.40.210.0/8 ». string

Emplacement

Nom Description Valeur
failoverPriority Priorité de basculement de la région. Une priorité de basculement de 0 indique une région d’écriture. Valeur maximale d’une priorité de basculement = (nombre total de régions - 1). Les valeurs de priorité de basculement doivent être uniques pour chacune des régions dans lesquelles le compte de base de données existe. int

Contraintes :
Valeur minimale = 0
isZoneRedundant Indicateur pour indiquer si cette région est une région AvailabilityZone bool
locationName Nom de la région. string

RestoreParameters

Nom Description Valeur
databasesToRestore Liste des bases de données spécifiques disponibles pour la restauration. DatabaseRestoreResource
gremlinDatabasesToRestore Liste des bases de données gremlin spécifiques disponibles pour la restauration. GremlinDatabaseRestoreResource[]
restoreMode Décrit le mode de restauration. 'PointInTime'
restoreSource ID du compte de base de données restaurable à partir duquel la restauration doit être lancée. Par exemple : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Heure à laquelle le compte doit être restauré (format ISO-8601). string
sourceBackupLocation Emplacement de sauvegarde source pour la restauration. string
tablesToRestore Liste des tables spécifiques disponibles pour la restauration. string[]

DatabaseRestoreResource

Nom Description Valeur
collectionNames Noms des collections disponibles pour la restauration. string[]
databaseName Nom de la base de données disponible pour la restauration. string

GremlinDatabaseRestoreResource

Nom Description Valeur
databaseName Nom de la base de données gremlin disponible pour la restauration. string
graphNames Noms des graphiques disponibles pour la restauration. string[]

VirtualNetworkRule

Nom Description Valeur
id ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Créez une règle de pare-feu avant que le point de terminaison de service de réseau virtuel soit activé sur le réseau virtuel. bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
CI/CD à l’aide de Jenkins sur Azure Container Service (AKS)

Déployer sur Azure 		Les conteneurs facilitent la création et le déploiement continus de vos applications. En orchestrant le déploiement de ces conteneurs à l’aide de Kubernetes dans Azure Container Service, vous pouvez obtenir des clusters de conteneurs réplicables et gérables. En configurant une génération continue pour produire vos images et votre orchestration de conteneurs, vous pouvez augmenter la vitesse et la fiabilité de votre déploiement.
Application web avec une base de données SQL, Azure Cosmos DB, Recherche Azure

Déployer sur Azure 		Ce modèle provisionne une application web, une base de données SQL, Azure Cosmos DB, Azure Search et Application Insights.
Créer un compte Azure Cosmos DB pour l’API Cassandra

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Cassandra dans deux régions avec un espace de clés et une table avec un débit dédié.
Créer un compte de mise à l’échelle automatique Azure Cosmos DB pour l’API Cassandra

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Cassandra dans deux régions avec un espace de clés et une table avec un débit de mise à l’échelle automatique.
Créer un compte Azure CosmosDB

Déployer sur Azure 		Ce modèle ARM est destiné à créer rapidement un compte CosmosDB avec les valeurs minimales requises
Créer un compte Azure Cosmos DB dans plusieurs régions

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour n’importe quel type d’API de base de données avec une région primaire et secondaire avec le choix du niveau de cohérence et du type de basculement.
Créez un compte Azure Cosmos DB de niveau gratuit

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB de niveau gratuit pour l’API SQL avec une base de données avec un débit et un conteneur partagés.
Créer un compte Azure Cosmos DB pour l’API Gremlin

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Gremlin dans deux régions avec une base de données et un graphique utilisant un débit dédié.
Créer un compte Azure Cosmos DB pour la mise à l’échelle automatique de l’API Gremlin

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Gremlin dans deux régions avec une base de données et un graphique utilisant le débit de mise à l’échelle automatique.
Créer un compte Azure Cosmos pour l’API MongoDB

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API MongoDB 4.2 dans deux régions à l’aide d’un débit partagé et dédié avec deux collections.
Créer un compte Azure Cosmos pour la mise à l’échelle automatique de l’API MongoDB

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API MongoDB 4.2 dans deux régions à l’aide du débit de mise à l’échelle automatique partagé et dédié.
Créer un compte Azure Cosmos DB avec un point de terminaison privé

Déployer sur Azure 		Ce modèle crée un compte Cosmos, un réseau virtuel et un point de terminaison privé exposant le compte Cosmos au réseau virtuel.
Créer un compte Azure Cosmos DB pour l’API Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur avec débit avec plusieurs autres options.
API SQL de compte Azure Cosmos DB avec magasin analytique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur configurés avec un magasin analytique.
Créer une API SQL de compte Azure Cosmos DB avec mise à l’échelle automatique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos pour l’API Core (SQL) avec une base de données et un conteneur avec un débit de mise à l’échelle automatique avec plusieurs autres options.
Créer des procédures stockées de l’API Azure Cosmos DB Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Core (SQL) et un conteneur avec une procédure stockée, un déclencheur et une fonction définie par l’utilisateur.
Créer un compte Azure Cosmos DB minimal pour l’API Core (SQL)

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Core (SQL) tout en spécifiant uniquement les propriétés de ressource minimales requises.
Créer Azure Cosmos avec l’API SQL et plusieurs conteneurs

Déployer sur Azure 		Le modèle crée un conteneur Cosmos avec une API SQL et permet d’ajouter des conteneurs mulitple.
Créer un compte SQL Azure Cosmos DB avec RBAC de plan de données

Déployer sur Azure 		Ce modèle crée un compte SQL Cosmos, une définition de rôle gérée en mode natif et une attribution de rôle gérée en mode natif pour une identité AAD.
Créer un compte Azure Cosmos DB serverless pour l’API SQL

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB serverless pour l’API Core (SQL).
Créer un compte Azure Cosmos pour l’API Table

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Table dans deux régions et une seule table avec un débit approvisionné.
Créer un compte Azure Cosmos pour l’API Table avec mise à l’échelle automatique

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos DB pour l’API Table dans deux régions et une seule table avec débit de mise à l’échelle automatique.
Créer un compte Azure Cosmos sans contact et Une application web Azure

Déployer sur Azure 		Ce modèle crée un compte Azure Cosmos, injecte le point de terminaison et les clés Cosmos DB dans les paramètres Azure Web App, puis déploie une application web ASP MVC à partir de GitHub.
Créer un compte Cosmos DB avec Microsoft Defender activé

Déployer sur Azure 		À l’aide de ce modèle ARM, vous pouvez déployer un compte Azure Cosmos DB avec Microsoft Defender pour Azure Cosmos DB activé. Microsoft Defender pour Azure Cosmos DB est une couche de sécurité native Azure qui détecte les tentatives d’exploitation des bases de données dans vos comptes Azure Cosmos DB. Microsoft Defender pour Azure Cosmos DB détecte les injections SQL potentielles, les acteurs malveillants connus basés sur Microsoft Threat Intelligence, les modèles d’accès suspects et les exploitations potentielles de votre base de données par le biais d’identités compromises ou d’initiés malveillants.
Déployer Azure Data Explorer DB avec une connexion Cosmos DB

Déployer sur Azure 		Déployez Azure Data Explorer DB avec une connexion Cosmos DB.
Compte Azure Cosmos DB avec application web

Déployer sur Azure 		Ce modèle déploie un compte Azure Cosmos DB, un plan App Service et crée une application web dans le plan App Service. Il ajoute également deux paramètres d’application à l’application web qui référencent le point de terminaison de compte Azure Cosmos DB. De cette façon, les solutions déployées sur l’application web peuvent se connecter au point de terminaison de compte Azure Cosmos DB à l’aide de ces paramètres.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource databaseAccounts 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.DocumentDB/databaseAccounts, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2023-11-15-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      analyticalStorageConfiguration = {
        schemaType = "string"
      }
      apiProperties = {
        serverVersion = "string"
      }
      backupPolicy = {
        migrationState = {
          startTime = "string"
          status = "string"
          targetType = "string"
        }
        type = "string"
        // For remaining properties, see BackupPolicy objects
      }
      capabilities = [
        {
          name = "string"
        }
      ]
      capacity = {
        totalThroughputLimit = int
      }
      connectorOffer = "Small"
      consistencyPolicy = {
        defaultConsistencyLevel = "string"
        maxIntervalInSeconds = int
        maxStalenessPrefix = int
      }
      cors = [
        {
          allowedHeaders = "string"
          allowedMethods = "string"
          allowedOrigins = "string"
          exposedHeaders = "string"
          maxAgeInSeconds = int
        }
      ]
      createMode = "string"
      customerManagedKeyStatus = "string"
      databaseAccountOfferType = "Standard"
      defaultIdentity = "string"
      defaultPriorityLevel = "string"
      diagnosticLogSettings = {
        enableFullTextQuery = "string"
      }
      disableKeyBasedMetadataWriteAccess = bool
      disableLocalAuth = bool
      enableAnalyticalStorage = bool
      enableAutomaticFailover = bool
      enableBurstCapacity = bool
      enableCassandraConnector = bool
      enableFreeTier = bool
      enableMaterializedViews = bool
      enableMultipleWriteLocations = bool
      enablePartitionMerge = bool
      enablePriorityBasedExecution = bool
      ipRules = [
        {
          ipAddressOrRange = "string"
        }
      ]
      isVirtualNetworkFilterEnabled = bool
      keyVaultKeyUri = "string"
      locations = [
        {
          failoverPriority = int
          isZoneRedundant = bool
          locationName = "string"
        }
      ]
      minimalTlsVersion = "string"
      networkAclBypass = "string"
      networkAclBypassResourceIds = [
        "string"
      ]
      publicNetworkAccess = "string"
      restoreParameters = {
        databasesToRestore = [
          {
            collectionNames = [
              "string"
            ]
            databaseName = "string"
          }
        ]
        gremlinDatabasesToRestore = [
          {
            databaseName = "string"
            graphNames = [
              "string"
            ]
          }
        ]
        restoreMode = "PointInTime"
        restoreSource = "string"
        restoreTimestampInUtc = "string"
        sourceBackupLocation = "string"
        tablesToRestore = [
          "string"
        ]
      }
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
    kind = "string"
  })
}

Objets BackupPolicy

Définissez la propriété type pour spécifier le type d’objet.

Pour Continu, utilisez :

  type = "Continuous"
  continuousModeProperties = {
    tier = "string"
  }

Pour Périodique, utilisez :

  type = "Periodic"
  periodicModeProperties = {
    backupIntervalInMinutes = int
    backupRetentionIntervalInHours = int
    backupStorageRedundancy = "string"
  }

Valeurs de propriétés

databaseAccounts

Nom Description Valeur
type Type de ressource « Microsoft.DocumentDB/databaseAccounts@2023-11-15-preview »
name Nom de la ressource string (obligatoire)

Limite de caractères : 3-44

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Doit commencer par une lettre minuscule ou un chiffre.

Le nom de la ressource doit être unique dans Azure.
location Emplacement du groupe de ressources auquel appartient la ressource. string
parent_id Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. string (obligatoire)
tags Les balises sont une liste de paires clé-valeur qui décrivent la ressource. Ces balises peuvent servir à l’affichage et au regroupement des ressources (parmi tous les groupes de ressources). Un maximum de 15 balises peut être fourni pour une ressource. Chaque balise doit disposer d’une clé de 128 caractères maximum et d’une valeur de 256 caractères maximum. Par exemple, l’expérience par défaut pour un type de modèle est définie avec « defaultExperience » : « Cassandra ». Les valeurs « defaultExperience » actuelles incluent également « Table », « Graph », « DocumentDB » et « MongoDB ». Dictionnaire de noms et de valeurs d’étiquettes.
kind Indique le type de compte de base de données. Cela ne peut être défini qu’au moment de la création du compte de base de données. « GlobalDocumentDB »
« MongoDB »
« Analyser »
identité Identité de la ressource. ManagedServiceIdentity
properties Propriétés permettant de créer et de mettre à jour des comptes de base de données Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatoire)

ManagedServiceIdentity

Nom Description Valeur
type Type d’identité utilisé pour la ressource. Le type « SystemAssigned,UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités du service. « SystemAssigned »
« SystemAssigned,UserAssigned »
« UserAssigned »
identity_ids Liste des identités utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». Tableau d’ID d’identité utilisateur.

ManagedServiceIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Nom Description Valeur
analyticalStorageConfiguration Propriétés spécifiques au stockage analytique. AnalyticalStorageConfiguration
apiProperties Propriétés spécifiques à l’API. Actuellement, pris en charge uniquement pour l’API MongoDB. ApiProperties
backupPolicy Objet représentant la stratégie pour effectuer des sauvegardes sur un compte. BackupPolicy
capabilities Liste des fonctionnalités Cosmos DB pour le compte Capability[]
capacité Objet qui représente toutes les propriétés liées à l’application de la capacité sur un compte. Capacité
connectorOffer Type d’offre de connecteur cassandra pour le compte C* de base de données Cosmos DB. « Petit »
consistencyPolicy Stratégie de cohérence pour le compte Cosmos DB. CohérencePolicy
cors Stratégie CORS pour le compte de base de données Cosmos DB. CorsPolicy[]
createMode Énumérez pour indiquer le mode de création du compte. « Par défaut »
« PointInTimeRestore »
« Restaurer »
customerManagedKeyStatus Indique l’état de la fonctionnalité Clé gérée par le client sur le compte. En cas d’erreurs, la propriété fournit des conseils de dépannage. string
databaseAccountOfferType Type d’offre pour la base de données « Standard » (obligatoire)
defaultIdentity Identité par défaut pour accéder au coffre de clés utilisé dans des fonctionnalités telles que les clés gérées par le client. L’identité par défaut doit être définie explicitement par les utilisateurs. Il peut s’agir de « FirstPartyIdentity », « SystemAssignedIdentity » et bien plus encore. string
defaultPriorityLevel Enum pour indiquer le niveau de priorité par défaut de la demande pour l’exécution basée sur la priorité. "High"
"Low"
diagnosticLogSettings Objet représentant les différents paramètres du journal de diagnostic pour le compte Cosmos DB. DiagnosticLogSettings
disableKeyBasedMetadataWriteAccess Désactiver les opérations d’écriture sur les ressources de métadonnées (bases de données, conteneurs, débit) via des clés de compte bool
disableLocalAuth Désactivez l’authentification locale et assurez-vous que seuls MSI et AAD peuvent être utilisés exclusivement pour l’authentification. bool
enableAnalyticalStorage Indicateur pour indiquer s’il faut activer l’analyse du stockage. bool
enableAutomaticFailover Active le basculement automatique de la région d’écriture dans le cas rare où la région n’est pas disponible en raison d’une panne. Le basculement automatique entraîne une nouvelle région d’écriture pour le compte et est choisi en fonction des priorités de basculement configurées pour le compte. bool
enableBurstCapacity Indicateur indiquant l’activation/désactivation de la fonctionnalité Burst Capacity Preview sur le compte bool
enableCassandraConnector Active le connecteur cassandra sur le compte C* Cosmos DB bool
enableFreeTier Indicateur pour indiquer si le niveau gratuit est activé. bool
enableMaterializedViews Indicateur indiquant s’il faut activer MaterializedViews sur le compte Cosmos DB bool
enableMultipleWriteLocations Permet au compte d’écrire à plusieurs emplacements bool
enablePartitionMerge Indicateur pour indiquer l’activation/désactivation de la fonctionnalité de fusion de partitions sur le compte bool
enablePriorityBasedExecution Indicateur indiquant l’activation/désactivation de la fonctionnalité d’aperçu de l’exécution basée sur la priorité sur le compte bool
ipRules Liste des ipRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Indicateur pour indiquer s’il faut activer/désactiver les règles de liste de contrôle d’accès de réseau virtuel. bool
keyVaultKeyUri URI du coffre de clés string
locations Tableau qui contient les emplacements de géoréplication activés pour le compte Cosmos DB. Location[] (obligatoire)
minimalTlsVersion Indique la version minimale autorisée de Tls. La valeur par défaut est Tls 1.0, à l’exception des API Cassandra et Mongo, qui fonctionnent uniquement avec Tls 1.2. « Tls »
« Tls11 »
« Tls12 »
networkAclBypass Indique quels services sont autorisés à contourner les vérifications de pare-feu. « AzureServices »
"None"
networkAclBypassResourceIds Tableau qui contient les ID de ressource pour network Acl Bypass pour le compte Cosmos DB. string[]
publicNetworkAccess Si les demandes provenant du réseau public sont autorisées « Désactivé »
« Activé »
« SecuredByPerimeter »
restoreParameters Paramètres pour indiquer les informations relatives à la restauration. RestoreParameters
virtualNetworkRules Liste des règles de liste de contrôle d’accès de réseau virtuel configurées pour le compte Cosmos DB. VirtualNetworkRule[]

AnalyticalStorageConfiguration

Nom Description Valeur
schemaType Décrit les types de schéma pour le stockage analytique. « FullFidelity »
« WellDefined »

ApiProperties

Nom Description Valeur
serverVersion Décrit la ServerVersion d’un compte MongoDB. "3.2"
"3.6"
"4.0"
"4.2"

BackupPolicy

Nom Description Valeur
migrationState Objet représentant l’état de la migration entre les stratégies de sauvegarde. BackupPolicyMigrationState
type Définir le type d’objet Continue
Périodique (obligatoire)

BackupPolicyMigrationState

Nom Description Valeur
startTime Heure à laquelle la migration de la stratégie de sauvegarde a démarré (format ISO-8601). string
status Décrit l’état de la migration entre les types de stratégie de sauvegarde. « Terminé »
« Échec »
« InProgress »
« Non valide »
targetType Décrit le type de stratégie de sauvegarde cible de la migration de la stratégie de sauvegarde. « Continu »
« Périodique »

ContinuousModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. « Continu » (obligatoire)
continuousModeProperties Valeurs de configuration pour la sauvegarde en mode continu ContinuousModeProperties

ContinuousModeProperties

Nom Description Valeur
Niveau Énumération pour indiquer le type de mode de sauvegarde Continuos « Continuous30Days »
« Continuous7Days »

PeriodicModeBackupPolicy

Nom Description Valeur
type Décrit le mode des sauvegardes. « Périodique » (obligatoire)
periodicModeProperties Valeurs de configuration pour la sauvegarde en mode périodique PeriodicModeProperties

PeriodicModeProperties

Nom Description Valeur
backupIntervalInMinutes Entier représentant l’intervalle en minutes entre deux sauvegardes int

Contraintes :
Valeur minimale = 0
backupRetentionIntervalInHours Entier représentant l’heure (en heures) pendant laquelle chaque sauvegarde est conservée int

Contraintes :
Valeur minimale = 0
backupStorageRedundancy Énumération pour indiquer le type de résidence de sauvegarde « Géo »
« Local »
« Zone »

Fonctionnalité

Nom Description Valeur
name Nom de la fonctionnalité Cosmos DB. Par exemple, « name » : « EnableCassandra ». Les valeurs actuelles incluent également « EnableTable » et « EnableGremlin ». string

Capacité

Nom Description Valeur
totalThroughputLimit Limite de débit totale imposée au compte. Un totalThroughputLimit de 2000 impose une limite stricte de débit maximal qui peut être provisionné sur ce compte à 2000. Un totalThroughputLimit de -1 n’indique aucune limite d’approvisionnement du débit. int

CohérencePolicy

Nom Description Valeur
defaultConsistencyLevel Niveau de cohérence et paramètres de configuration par défaut du compte Cosmos DB. « BoundedStaleness »
« ConsistentPrefix »
« Éventuel »
« Session »
« Fort » (obligatoire)
maxIntervalInSeconds Lorsqu’elle est utilisée avec le niveau de cohérence Borned Staleness, cette valeur représente la durée d’obsolescence (en secondes) tolérée. La plage acceptée pour cette valeur est comprise entre 5 et 86400. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 5
Valeur maximale = 86400
maxStalenessPrefix Lorsqu’elle est utilisée avec le niveau de cohérence Borned Staleness, cette valeur représente le nombre de demandes obsolètes tolérées. Les valeurs acceptables sont 1-2, 147, 483 et 647. Obligatoire lorsque defaultConsistencyPolicy est défini sur « BoundedStaleness ». int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

CorsPolicy

Nom Description Valeur
allowedHeaders En-têtes de requête que le domaine d’origine peut spécifier dans la requête CORS. string
allowedMethods Méthodes (verbes de requête HTTP) que le domaine d’origine peut utiliser pour une requête CORS. string
allowedOrigins Domaines d’origine autorisés à effectuer une requête auprès du service via CORS. chaîne (obligatoire)
exposedHeaders En-têtes de réponse qui peuvent être envoyés dans la réponse à la requête CORS et exposés par le navigateur à l’émetteur de la requête. string
maxAgeInSeconds Durée maximale pendant laquelle un navigateur doit mettre en cache la requête OPTIONS préliminaire. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 2147483647

DiagnosticLogSettings

Nom Description Valeur
enableFullTextQuery Décrire le niveau de détail avec lequel les requêtes doivent être journalisées. « False » (faux)
"None"
« True » (vrai)

IpAddressOrRange

Nom Description Valeur
ipAddressOrRange Une seule adresse IPv4 ou une seule plage d’adresses IPv4 au format CIDR. Les adresses IP fournies doivent être correctement mises en forme et ne peuvent pas être contenues dans l’une des plages suivantes : 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, car elles ne sont pas applicables par le filtre d’adresse IP. Exemple d’entrées valides : « 23.40.210.245 » ou « 23.40.210.0/8 ». string

Emplacement

Nom Description Valeur
basculementPriority Priorité de basculement de la région. Une priorité de basculement de 0 indique une région d’écriture. Valeur maximale d’une priorité de basculement = (nombre total de régions - 1). Les valeurs de priorité de basculement doivent être uniques pour chacune des régions dans lesquelles le compte de base de données existe. int

Contraintes :
Valeur minimale = 0
isZoneRedundant Indicateur indiquant si cette région est ou non une région AvailabilityZone bool
locationName Nom de la région. string

RestoreParameters

Nom Description Valeur
databasesToRestore Liste des bases de données spécifiques disponibles pour la restauration. DatabaseRestoreResource
gremlinDatabasesToRestore Liste des bases de données gremlin spécifiques disponibles pour la restauration. GremlinDatabaseRestoreResource[]
restoreMode Décrit le mode de restauration. « PointInTime »
restoreSource ID du compte de base de données restaurable à partir duquel la restauration doit être lancée. Par exemple : /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} string
restoreTimestampInUtc Heure à laquelle le compte doit être restauré (format ISO-8601). string
sourceBackupLocation Emplacement de sauvegarde source pour la restauration. string
tablesToRestore Liste des tables spécifiques disponibles pour la restauration. string[]

DatabaseRestoreResource

Nom Description Valeur
collectionNames Noms des collections disponibles pour la restauration. string[]
databaseName Nom de la base de données disponible pour la restauration. string

GremlinDatabaseRestoreResource

Nom Description Valeur
databaseName Nom de la base de données gremlin disponible pour la restauration. string
graphNames Noms des graphiques disponibles pour la restauration. string[]

VirtualNetworkRule

Nom Description Valeur
id ID de ressource d’un sous-réseau, par exemple : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Créez une règle de pare-feu avant que le point de terminaison de service de réseau virtuel soit activé sur le réseau virtuel. bool