Microsoft.DocumentDB databaseAccounts 2020-04-01
- meest recente
- 2024-12-01-preview-
- 2024-11-15
- 2024-09-01-preview-
- 2024-08-15
- 2024-05-15
- 2024-05-15-preview-
- 2024-02-15-preview-
- 2023-11-15
- 2023-11-15-preview-
- 2023-09-15
- 2023-09-15-preview-
- 2023-04-15
- 2023-03-15
- 2023-03-15-preview-
- 2023-03-01-preview-
- 2022-11-15
- 2022-11-15-preview-
- 2022-08-15
- 2022-08-15-preview-
- 2022-05-15
- 2022-05-15-preview-
- 2022-02-15-preview-
- 2021-11-15-preview-
- 2021-10-15
- 2021-10-15-preview-
- 2021-07-01-preview-
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-preview-
- 2021-03-15
- 2021-03-01-preview-
- 2021-01-15
- 2020-09-01
- 2020-06-01-preview-
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
- 2016-03-31
- 2016-03-19
- 2015-11-06
- 2015-04-08
- 2015-04-01
Bicep-resourcedefinitie
Het resourcetype databaseAccounts kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Resource Microsoft.DocumentDB/databaseAccounts wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-04-01' = {
kind: 'string'
location: 'string'
name: 'string'
properties: {
apiProperties: {
serverVersion: 'string'
}
capabilities: [
{
name: 'string'
}
]
connectorOffer: 'string'
consistencyPolicy: {
defaultConsistencyLevel: 'string'
maxIntervalInSeconds: int
maxStalenessPrefix: int
}
cors: [
{
allowedHeaders: 'string'
allowedMethods: 'string'
allowedOrigins: 'string'
exposedHeaders: 'string'
maxAgeInSeconds: int
}
]
databaseAccountOfferType: 'Standard'
disableKeyBasedMetadataWriteAccess: bool
enableAnalyticalStorage: bool
enableAutomaticFailover: bool
enableCassandraConnector: bool
enableFreeTier: bool
enableMultipleWriteLocations: bool
ipRules: [
{
ipAddressOrRange: 'string'
}
]
isVirtualNetworkFilterEnabled: bool
keyVaultKeyUri: 'string'
locations: [
{
failoverPriority: int
isZoneRedundant: bool
locationName: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVNetServiceEndpoint: bool
}
]
}
tags: {
{customized property}: 'string'
}
}
Eigenschapswaarden
ApiProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| serverVersion | Beschrijft de ServerVersion van een MongoDB-account. | '3.2' '3.6' |
Vermogen
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van de Cosmos DB-functie. Bijvoorbeeld 'name': 'EnableCassandra'. De huidige waarden omvatten ook 'EnableTable' en 'EnableGremlin'. | snaar |
ConsistencyPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| defaultConsistencyLevel | Het standaardconsistentieniveau en de configuratie-instellingen van het Cosmos DB-account. | 'BoundedStaleness' 'ConsistentPrefix' 'Uiteindelijk' 'Sessie' 'Sterk' (vereist) |
| maxIntervalInSeconds | Bij gebruik met het consistentieniveau Gebonden veroudering vertegenwoordigt deze waarde de tijdsduur van veroudering (in seconden) die wordt getolereerd. Geaccepteerd bereik voor deze waarde is 5 - 86400. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 5 Maximumwaarde = 86400 |
| maxStalenessPrefix | Wanneer deze waarde wordt gebruikt met het consistentieniveau Gebonden veroudering, vertegenwoordigt deze waarde het aantal verlopen aanvragen dat wordt getolereerd. Geaccepteerd bereik voor deze waarde is 1 – 2.147.483.647. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
CorsPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| allowedHeaders | De aanvraagheaders die het oorspronkelijke domein kan opgeven voor de CORS-aanvraag. | snaar |
| allowedMethods | De methoden (HTTP-aanvraagwoorden) die het oorspronkelijke domein kan gebruiken voor een CORS-aanvraag. | snaar |
| allowedOrigins | De oorspronkelijke domeinen die via CORS een aanvraag voor de service mogen indienen. | tekenreeks (vereist) |
| exposedHeaders | De antwoordheaders die kunnen worden verzonden in het antwoord op de CORS-aanvraag en die door de browser worden weergegeven aan de verlener van de aanvraag. | snaar |
| maxAgeInSeconds | De maximale hoeveelheid tijd die een browser moet opslaan in de cache van de preflight OPTIONS-aanvraag. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| apiProperties | API-specifieke eigenschappen. Momenteel wordt alleen ondersteund voor mongoDB-API. | ApiProperties- |
| Mogelijkheden | Lijst met Cosmos DB-mogelijkheden voor het account | Mogelijkheid[] |
| connectorOffer | De cassandra-connectoraanbiedingstype voor het Cosmos DB-database-C*-account. | 'Klein' |
| consistencyPolicy | Het consistentiebeleid voor het Cosmos DB-account. | ConsistencyPolicy- |
| cors | Het CORS-beleid voor het Cosmos DB-databaseaccount. | CorsPolicy[] |
| databaseAccountOfferType | Het aanbiedingstype voor de database | 'Standaard' (vereist) |
| disableKeyBasedMetadataWriteAccess | Schrijfbewerkingen uitschakelen voor metagegevensresources (databases, containers, doorvoer) via accountsleutels | Bool |
| enableAnalyticalStorage | Vlag om aan te geven of opslaganalyse moet worden ingeschakeld. | Bool |
| enableAutomaticFailover | Maakt automatische failover van de schrijfregio mogelijk in de zeldzame gebeurtenis dat de regio niet beschikbaar is vanwege een storing. Automatische failover resulteert in een nieuwe schrijfregio voor het account en wordt gekozen op basis van de failoverprioriteiten die voor het account zijn geconfigureerd. | Bool |
| enableCassandraConnector | Hiermee schakelt u de Cassandra-connector in het Cosmos DB C*-account in | Bool |
| enableFreeTier | Vlag om aan te geven of de gratis laag is ingeschakeld. | Bool |
| enableMultipleWriteLocations | Hiermee kan het account op meerdere locaties schrijven | Bool |
| ipRules | Lijst met IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Vlag om aan te geven of virtuele netwerk-ACL-regels moeten worden ingeschakeld/uitgeschakeld. | Bool |
| keyVaultKeyUri | De URI van de sleutelkluis | snaar |
| Locaties | Een matrix die de georeplicatielocaties bevat die zijn ingeschakeld voor het Cosmos DB-account. | Locatie[] (vereist) |
| virtualNetworkRules | Lijst met ACL-regels voor virtueel netwerk die zijn geconfigureerd voor het Cosmos DB-account. | VirtualNetworkRule[] |
IpAddressOrRange
| Naam | Beschrijving | Waarde |
|---|---|---|
| ipAddressOrRange | Eén IPv4-adres of één IPv4-adresbereik in CIDR-indeling. Opgegeven IP-adressen moeten goed zijn opgemaakt en kunnen niet worden opgenomen in een van de volgende bereiken: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, omdat deze niet kunnen worden afgedwongen door het IP-adresfilter. Voorbeeld van geldige invoer: '23.40.210.245' of '23.40.210.0/8'. | snaar |
Plaats
| Naam | Beschrijving | Waarde |
|---|---|---|
| failoverPriority | De failoverprioriteit van de regio. Een failoverprioriteit van 0 geeft een schrijfregio aan. De maximumwaarde voor een failoverprioriteit = (totaal aantal regio's - 1). Failoverprioriteitswaarden moeten uniek zijn voor elk van de regio's waarin het databaseaccount bestaat. | Int Beperkingen: Minimumwaarde = 0 |
| isZoneRedundant | Vlag om aan te geven of deze regio een AvailabilityZone-regio is | Bool |
| locationName | De naam van de regio. | snaar |
Microsoft.DocumentDB/databaseAccounts
| Naam | Beschrijving | Waarde |
|---|---|---|
| soort | Geeft het type databaseaccount aan. Dit kan alleen worden ingesteld bij het maken van een databaseaccount. | 'GlobalDocumentDB' 'MongoDB' 'Parseren' |
| plaats | De locatie van de resourcegroep waartoe de resource behoort. | snaar |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 3 Patroon = ^[a-z0-9]+(-[a-z0-9]+)* (vereist) |
| Eigenschappen | Eigenschappen voor het maken en bijwerken van Azure Cosmos DB-databaseaccounts. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (vereist) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
Tags
| Naam | Beschrijving | Waarde |
|---|
VirtualNetworkRule
| Naam | Beschrijving | Waarde |
|---|---|---|
| legitimatiebewijs | Resource-id van een subnet, bijvoorbeeld: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnetten/{subnetName}. | snaar |
| ignoreMissingVNetServiceEndpoint | Maak een firewallregel voordat vnet-service-eindpunt is ingeschakeld voor het virtuele netwerk. | Bool |
Quickstart-voorbeelden
In de volgende quickstartvoorbeelden wordt dit resourcetype geïmplementeerd.
| Bicep-bestand | Beschrijving |
|---|---|
| SQL API voor Azure Cosmos DB-account met analytische opslag | Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container die is geconfigureerd met analytische opslag. |
| Azure Cosmos DB-account met web-app- | Met deze sjabloon implementeert u een Azure Cosmos DB-account, een App Service-plan en maakt u een web-app in het App Service-plan. Er worden ook twee toepassingsinstellingen toegevoegd aan de web-app die verwijst naar het Azure Cosmos DB-accounteindpunt. Op deze manier kunnen oplossingen die zijn geïmplementeerd in de web-app verbinding maken met het Eindpunt van het Azure Cosmos DB-account met behulp van deze instellingen. |
| Een Cosmos DB-account maken waarvoor Microsoft Defender is ingeschakeld | Met deze ARM-sjabloon kunt u een Azure Cosmos DB-account implementeren waarvoor Microsoft Defender voor Azure Cosmos DB is ingeschakeld. Microsoft Defender voor Azure Cosmos DB is een systeemeigen Azure-beveiligingslaag die pogingen detecteert om databases in uw Azure Cosmos DB-accounts te misbruiken. Microsoft Defender voor Azure Cosmos DB detecteert mogelijke SQL-injecties, bekende slechte actoren op basis van Microsoft Threat Intelligence, verdachte toegangspatronen en mogelijke exploitatie van uw database via verdachte identiteiten of kwaadwillende insiders. |
| Een Gratis Azure Cosmos DB-account maken | Met deze sjabloon maakt u een Gratis Azure Cosmos DB-account voor SQL API met een database met gedeelde doorvoer en container. |
| een minimaal Azure Cosmos DB-account maken voor Core (SQL) API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor de Core (SQL)-API, terwijl u alleen de minimaal vereiste resource-eigenschappen opgeeft. |
| Een serverloos Azure Cosmos DB-account maken voor SQL API- | Met deze sjabloon maakt u een serverloos Azure Cosmos DB-account voor de Core (SQL) API. |
| Een Azure Cosmos-account en Azure Web App- met nul aanraken maken | Met deze sjabloon maakt u een Azure Cosmos-account, injecteert u het Cosmos DB-eindpunt en de sleutels in de Azure Web App-instellingen en implementeert u vervolgens een ASP MVC-web-app vanuit GitHub. |
| Een Azure Cosmos-account maken voor mongoDB-API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor MongoDB API 4.2 in twee regio's met behulp van gedeelde en toegewezen doorvoer met twee verzamelingen. |
| Een Azure Cosmos-account maken voor automatische schaalaanpassing van MongoDB-API's | Met deze sjabloon maakt u een Azure Cosmos DB-account voor MongoDB API 4.2 in twee regio's met behulp van zowel gedeelde als toegewezen doorvoer voor automatische schaalaanpassing. |
| Een Azure Cosmos-account maken voor table-API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor table-API in twee regio's en één tabel met ingerichte doorvoer. |
| Een Azure Cosmos-account maken voor table-API met automatische schaalaanpassing | Met deze sjabloon maakt u een Azure Cosmos DB-account voor table-API in twee regio's en één tabel met doorvoer voor automatische schaalaanpassing. |
| Een Azure Cosmos DB-account maken voor cassandra-API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor cassandra-API in twee regio's met een keyspace en tabel met toegewezen doorvoer. |
| Een Azure Cosmos DB-account maken voor Core (SQL) API- | Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container met doorvoer met meerdere andere opties. |
| Een Azure Cosmos DB-account maken voor Gremlin-API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor Gremlin-API in twee regio's met één database en één grafiek met behulp van toegewezen doorvoer. |
| Een Azure Cosmos DB-account maken voor automatische schaalaanpassing van Gremlin-API's | Met deze sjabloon maakt u een Azure Cosmos DB-account voor Gremlin-API in twee regio's met één database en één grafiek met automatische schaalaanpassing van doorvoer. |
| Een Azure Cosmos DB-account maken in meerdere regio's | Met deze sjabloon maakt u een Azure Cosmos DB-account voor elk database-API-type met een primaire en secundaire regio met de keuze van het consistentieniveau en het failovertype. |
| Een SQL API voor een Azure Cosmos DB-account maken met automatische schaalaanpassing | Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container met doorvoer voor automatische schaalaanpassing met meerdere andere opties. |
| Een Azure Cosmos DB-account maken met een privé-eindpunt | Met deze sjabloon maakt u een Cosmos-account, een virtueel netwerk en een privé-eindpunt dat het Cosmos-account beschikbaar maakt voor het virtuele netwerk. |
| Een Azure Cosmos DB SQL-account maken met RBAC- | Met deze sjabloon maakt u een SQL Cosmos-account, een systeemeigen onderhouden roldefinitie en een systeemeigen onderhouden roltoewijzing voor een AAD-identiteit. |
| Een Azure CosmosDB-account maken | Deze ARM-sjabloon is bedoeld om snel een CosmosDB-account te maken met de minimale vereiste waarden |
| Een Azure Cosmos DB-account voor automatische schaalaanpassing maken voor cassandra-API- | Met deze sjabloon maakt u een Azure Cosmos DB-account voor Cassandra-API in twee regio's met een keyspace en tabel met doorvoer voor automatische schaalaanpassing. |
| Opgeslagen procedures voor azure Cosmos DB Core (SQL) MAKEN | Met deze sjabloon maakt u een Azure Cosmos DB-account voor Core (SQL) API en een container met een opgeslagen procedure, trigger en door de gebruiker gedefinieerde functie. |
| Maakt een Dapr-microservices-app met container-apps | Een Dapr-microservices-app maken met behulp van Container Apps. |
| Maakt een Dapr pub-sub servicebus-app met behulp van Container Apps | Maak een Dapr pub-sub servicebus-app met behulp van Container Apps. |
| Azure Data Explorer DB implementeren met Cosmos DB-verbinding | Azure Data Explorer DB implementeren met Cosmos DB-verbinding. |
Resourcedefinitie van ARM-sjabloon
Het resourcetype databaseAccounts kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.DocumentDB-/databaseAccounts-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"type": "Microsoft.DocumentDB/databaseAccounts",
"apiVersion": "2020-04-01",
"name": "string",
"kind": "string",
"location": "string",
"properties": {
"apiProperties": {
"serverVersion": "string"
},
"capabilities": [
{
"name": "string"
}
],
"connectorOffer": "string",
"consistencyPolicy": {
"defaultConsistencyLevel": "string",
"maxIntervalInSeconds": "int",
"maxStalenessPrefix": "int"
},
"cors": [
{
"allowedHeaders": "string",
"allowedMethods": "string",
"allowedOrigins": "string",
"exposedHeaders": "string",
"maxAgeInSeconds": "int"
}
],
"databaseAccountOfferType": "Standard",
"disableKeyBasedMetadataWriteAccess": "bool",
"enableAnalyticalStorage": "bool",
"enableAutomaticFailover": "bool",
"enableCassandraConnector": "bool",
"enableFreeTier": "bool",
"enableMultipleWriteLocations": "bool",
"ipRules": [
{
"ipAddressOrRange": "string"
}
],
"isVirtualNetworkFilterEnabled": "bool",
"keyVaultKeyUri": "string",
"locations": [
{
"failoverPriority": "int",
"isZoneRedundant": "bool",
"locationName": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVNetServiceEndpoint": "bool"
}
]
},
"tags": {
"{customized property}": "string"
}
}
Eigenschapswaarden
ApiProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| serverVersion | Beschrijft de ServerVersion van een MongoDB-account. | '3.2' '3.6' |
Vermogen
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van de Cosmos DB-functie. Bijvoorbeeld 'name': 'EnableCassandra'. De huidige waarden omvatten ook 'EnableTable' en 'EnableGremlin'. | snaar |
ConsistencyPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| defaultConsistencyLevel | Het standaardconsistentieniveau en de configuratie-instellingen van het Cosmos DB-account. | 'BoundedStaleness' 'ConsistentPrefix' 'Uiteindelijk' 'Sessie' 'Sterk' (vereist) |
| maxIntervalInSeconds | Bij gebruik met het consistentieniveau Gebonden veroudering vertegenwoordigt deze waarde de tijdsduur van veroudering (in seconden) die wordt getolereerd. Geaccepteerd bereik voor deze waarde is 5 - 86400. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 5 Maximumwaarde = 86400 |
| maxStalenessPrefix | Wanneer deze waarde wordt gebruikt met het consistentieniveau Gebonden veroudering, vertegenwoordigt deze waarde het aantal verlopen aanvragen dat wordt getolereerd. Geaccepteerd bereik voor deze waarde is 1 – 2.147.483.647. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
CorsPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| allowedHeaders | De aanvraagheaders die het oorspronkelijke domein kan opgeven voor de CORS-aanvraag. | snaar |
| allowedMethods | De methoden (HTTP-aanvraagwoorden) die het oorspronkelijke domein kan gebruiken voor een CORS-aanvraag. | snaar |
| allowedOrigins | De oorspronkelijke domeinen die via CORS een aanvraag voor de service mogen indienen. | tekenreeks (vereist) |
| exposedHeaders | De antwoordheaders die kunnen worden verzonden in het antwoord op de CORS-aanvraag en die door de browser worden weergegeven aan de verlener van de aanvraag. | snaar |
| maxAgeInSeconds | De maximale hoeveelheid tijd die een browser moet opslaan in de cache van de preflight OPTIONS-aanvraag. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| apiProperties | API-specifieke eigenschappen. Momenteel wordt alleen ondersteund voor mongoDB-API. | ApiProperties- |
| Mogelijkheden | Lijst met Cosmos DB-mogelijkheden voor het account | Mogelijkheid[] |
| connectorOffer | De cassandra-connectoraanbiedingstype voor het Cosmos DB-database-C*-account. | 'Klein' |
| consistencyPolicy | Het consistentiebeleid voor het Cosmos DB-account. | ConsistencyPolicy- |
| cors | Het CORS-beleid voor het Cosmos DB-databaseaccount. | CorsPolicy[] |
| databaseAccountOfferType | Het aanbiedingstype voor de database | 'Standaard' (vereist) |
| disableKeyBasedMetadataWriteAccess | Schrijfbewerkingen uitschakelen voor metagegevensresources (databases, containers, doorvoer) via accountsleutels | Bool |
| enableAnalyticalStorage | Vlag om aan te geven of opslaganalyse moet worden ingeschakeld. | Bool |
| enableAutomaticFailover | Maakt automatische failover van de schrijfregio mogelijk in de zeldzame gebeurtenis dat de regio niet beschikbaar is vanwege een storing. Automatische failover resulteert in een nieuwe schrijfregio voor het account en wordt gekozen op basis van de failoverprioriteiten die voor het account zijn geconfigureerd. | Bool |
| enableCassandraConnector | Hiermee schakelt u de Cassandra-connector in het Cosmos DB C*-account in | Bool |
| enableFreeTier | Vlag om aan te geven of de gratis laag is ingeschakeld. | Bool |
| enableMultipleWriteLocations | Hiermee kan het account op meerdere locaties schrijven | Bool |
| ipRules | Lijst met IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Vlag om aan te geven of virtuele netwerk-ACL-regels moeten worden ingeschakeld/uitgeschakeld. | Bool |
| keyVaultKeyUri | De URI van de sleutelkluis | snaar |
| Locaties | Een matrix die de georeplicatielocaties bevat die zijn ingeschakeld voor het Cosmos DB-account. | Locatie[] (vereist) |
| virtualNetworkRules | Lijst met ACL-regels voor virtueel netwerk die zijn geconfigureerd voor het Cosmos DB-account. | VirtualNetworkRule[] |
IpAddressOrRange
| Naam | Beschrijving | Waarde |
|---|---|---|
| ipAddressOrRange | Eén IPv4-adres of één IPv4-adresbereik in CIDR-indeling. Opgegeven IP-adressen moeten goed zijn opgemaakt en kunnen niet worden opgenomen in een van de volgende bereiken: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, omdat deze niet kunnen worden afgedwongen door het IP-adresfilter. Voorbeeld van geldige invoer: '23.40.210.245' of '23.40.210.0/8'. | snaar |
Plaats
| Naam | Beschrijving | Waarde |
|---|---|---|
| failoverPriority | De failoverprioriteit van de regio. Een failoverprioriteit van 0 geeft een schrijfregio aan. De maximumwaarde voor een failoverprioriteit = (totaal aantal regio's - 1). Failoverprioriteitswaarden moeten uniek zijn voor elk van de regio's waarin het databaseaccount bestaat. | Int Beperkingen: Minimumwaarde = 0 |
| isZoneRedundant | Vlag om aan te geven of deze regio een AvailabilityZone-regio is | Bool |
| locationName | De naam van de regio. | snaar |
Microsoft.DocumentDB/databaseAccounts
| Naam | Beschrijving | Waarde |
|---|---|---|
| apiVersion | De API-versie | '2020-04-01' |
| soort | Geeft het type databaseaccount aan. Dit kan alleen worden ingesteld bij het maken van een databaseaccount. | 'GlobalDocumentDB' 'MongoDB' 'Parseren' |
| plaats | De locatie van de resourcegroep waartoe de resource behoort. | snaar |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 3 Patroon = ^[a-z0-9]+(-[a-z0-9]+)* (vereist) |
| Eigenschappen | Eigenschappen voor het maken en bijwerken van Azure Cosmos DB-databaseaccounts. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (vereist) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
| type | Het resourcetype | 'Microsoft.DocumentDB/databaseAccounts' |
Tags
| Naam | Beschrijving | Waarde |
|---|
VirtualNetworkRule
| Naam | Beschrijving | Waarde |
|---|---|---|
| legitimatiebewijs | Resource-id van een subnet, bijvoorbeeld: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnetten/{subnetName}. | snaar |
| ignoreMissingVNetServiceEndpoint | Maak een firewallregel voordat vnet-service-eindpunt is ingeschakeld voor het virtuele netwerk. | Bool |
Quickstart-sjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
| Sjabloon | Beschrijving |
|---|---|
SQL API voor Azure Cosmos DB-account met analytische opslag
|
Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container die is geconfigureerd met analytische opslag. |
|
Azure Cosmos DB-account met web-app-
|
Met deze sjabloon implementeert u een Azure Cosmos DB-account, een App Service-plan en maakt u een web-app in het App Service-plan. Er worden ook twee toepassingsinstellingen toegevoegd aan de web-app die verwijst naar het Azure Cosmos DB-accounteindpunt. Op deze manier kunnen oplossingen die zijn geïmplementeerd in de web-app verbinding maken met het Eindpunt van het Azure Cosmos DB-account met behulp van deze instellingen. |
|
CI/CD met Behulp van Jenkins in Azure Container Service (AKS)
|
Met containers kunt u eenvoudig uw toepassingen continu bouwen en implementeren. Door de implementatie van deze containers te organiseren met behulp van Kubernetes in Azure Container Service, kunt u repliceerbare, beheerbare clusters van containers bereiken. Door een continue build in te stellen om uw containerinstallatiekopieën en indeling te produceren, kunt u de snelheid en betrouwbaarheid van uw implementatie verhogen. |
|
Een Cosmos DB-account maken waarvoor Microsoft Defender is ingeschakeld
|
Met deze ARM-sjabloon kunt u een Azure Cosmos DB-account implementeren waarvoor Microsoft Defender voor Azure Cosmos DB is ingeschakeld. Microsoft Defender voor Azure Cosmos DB is een systeemeigen Azure-beveiligingslaag die pogingen detecteert om databases in uw Azure Cosmos DB-accounts te misbruiken. Microsoft Defender voor Azure Cosmos DB detecteert mogelijke SQL-injecties, bekende slechte actoren op basis van Microsoft Threat Intelligence, verdachte toegangspatronen en mogelijke exploitatie van uw database via verdachte identiteiten of kwaadwillende insiders. |
|
Een Gratis Azure Cosmos DB-account maken
|
Met deze sjabloon maakt u een Gratis Azure Cosmos DB-account voor SQL API met een database met gedeelde doorvoer en container. |
|
een minimaal Azure Cosmos DB-account maken voor Core (SQL) API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor de Core (SQL)-API, terwijl u alleen de minimaal vereiste resource-eigenschappen opgeeft. |
|
Een serverloos Azure Cosmos DB-account maken voor SQL API-
|
Met deze sjabloon maakt u een serverloos Azure Cosmos DB-account voor de Core (SQL) API. |
|
Een Azure Cosmos-account en Azure Web App- met nul aanraken maken
|
Met deze sjabloon maakt u een Azure Cosmos-account, injecteert u het Cosmos DB-eindpunt en de sleutels in de Azure Web App-instellingen en implementeert u vervolgens een ASP MVC-web-app vanuit GitHub. |
|
Een Azure Cosmos-account maken voor mongoDB-API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor MongoDB API 4.2 in twee regio's met behulp van gedeelde en toegewezen doorvoer met twee verzamelingen. |
|
Een Azure Cosmos-account maken voor automatische schaalaanpassing van MongoDB-API's
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor MongoDB API 4.2 in twee regio's met behulp van zowel gedeelde als toegewezen doorvoer voor automatische schaalaanpassing. |
|
Een Azure Cosmos-account maken voor table-API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor table-API in twee regio's en één tabel met ingerichte doorvoer. |
|
Een Azure Cosmos-account maken voor table-API met automatische schaalaanpassing
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor table-API in twee regio's en één tabel met doorvoer voor automatische schaalaanpassing. |
|
Een Azure Cosmos DB-account maken voor cassandra-API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor cassandra-API in twee regio's met een keyspace en tabel met toegewezen doorvoer. |
|
Een Azure Cosmos DB-account maken voor Core (SQL) API-
|
Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container met doorvoer met meerdere andere opties. |
|
Een Azure Cosmos DB-account maken voor Gremlin-API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor Gremlin-API in twee regio's met één database en één grafiek met behulp van toegewezen doorvoer. |
|
Een Azure Cosmos DB-account maken voor automatische schaalaanpassing van Gremlin-API's
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor Gremlin-API in twee regio's met één database en één grafiek met automatische schaalaanpassing van doorvoer. |
|
Een Azure Cosmos DB-account maken in meerdere regio's
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor elk database-API-type met een primaire en secundaire regio met de keuze van het consistentieniveau en het failovertype. |
|
Een SQL API voor een Azure Cosmos DB-account maken met automatische schaalaanpassing
|
Met deze sjabloon maakt u een Azure Cosmos-account voor Core (SQL) API met een database en container met doorvoer voor automatische schaalaanpassing met meerdere andere opties. |
|
Een Azure Cosmos DB-account maken met een privé-eindpunt
|
Met deze sjabloon maakt u een Cosmos-account, een virtueel netwerk en een privé-eindpunt dat het Cosmos-account beschikbaar maakt voor het virtuele netwerk. |
|
Een Azure Cosmos DB SQL-account maken met RBAC-
|
Met deze sjabloon maakt u een SQL Cosmos-account, een systeemeigen onderhouden roldefinitie en een systeemeigen onderhouden roltoewijzing voor een AAD-identiteit. |
|
Een Azure CosmosDB-account maken
|
Deze ARM-sjabloon is bedoeld om snel een CosmosDB-account te maken met de minimale vereiste waarden |
|
Een Azure Cosmos DB-account voor automatische schaalaanpassing maken voor cassandra-API-
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor Cassandra-API in twee regio's met een keyspace en tabel met doorvoer voor automatische schaalaanpassing. |
|
Opgeslagen procedures voor azure Cosmos DB Core (SQL) MAKEN
|
Met deze sjabloon maakt u een Azure Cosmos DB-account voor Core (SQL) API en een container met een opgeslagen procedure, trigger en door de gebruiker gedefinieerde functie. |
|
Azure Cosmos maken met SQL API en meerdere containers
|
De sjabloon maakt een Cosmos-container met een SQL-API en maakt het toevoegen van meerdere containers mogelijk. |
|
Maakt een Dapr-microservices-app met container-apps
|
Een Dapr-microservices-app maken met behulp van Container Apps. |
|
Maakt een Dapr pub-sub servicebus-app met behulp van Container Apps
|
Maak een Dapr pub-sub servicebus-app met behulp van Container Apps. |
|
Azure Data Explorer DB implementeren met Cosmos DB-verbinding
|
Azure Data Explorer DB implementeren met Cosmos DB-verbinding. |
|
web-app met een SQL Database, Azure Cosmos DB, Azure Search-
|
Deze sjabloon richt een web-app, een SQL Database, Azure Cosmos DB, Azure Search en Application Insights in. |
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype databaseAccounts kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Microsoft.DocumentDB/databaseAccounts-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts@2020-04-01"
name = "string"
kind = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
apiProperties = {
serverVersion = "string"
}
capabilities = [
{
name = "string"
}
]
connectorOffer = "string"
consistencyPolicy = {
defaultConsistencyLevel = "string"
maxIntervalInSeconds = int
maxStalenessPrefix = int
}
cors = [
{
allowedHeaders = "string"
allowedMethods = "string"
allowedOrigins = "string"
exposedHeaders = "string"
maxAgeInSeconds = int
}
]
databaseAccountOfferType = "Standard"
disableKeyBasedMetadataWriteAccess = bool
enableAnalyticalStorage = bool
enableAutomaticFailover = bool
enableCassandraConnector = bool
enableFreeTier = bool
enableMultipleWriteLocations = bool
ipRules = [
{
ipAddressOrRange = "string"
}
]
isVirtualNetworkFilterEnabled = bool
keyVaultKeyUri = "string"
locations = [
{
failoverPriority = int
isZoneRedundant = bool
locationName = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVNetServiceEndpoint = bool
}
]
}
})
}
Eigenschapswaarden
ApiProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| serverVersion | Beschrijft de ServerVersion van een MongoDB-account. | '3.2' '3.6' |
Vermogen
| Naam | Beschrijving | Waarde |
|---|---|---|
| naam | Naam van de Cosmos DB-functie. Bijvoorbeeld 'name': 'EnableCassandra'. De huidige waarden omvatten ook 'EnableTable' en 'EnableGremlin'. | snaar |
ConsistencyPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| defaultConsistencyLevel | Het standaardconsistentieniveau en de configuratie-instellingen van het Cosmos DB-account. | 'BoundedStaleness' 'ConsistentPrefix' 'Uiteindelijk' 'Sessie' 'Sterk' (vereist) |
| maxIntervalInSeconds | Bij gebruik met het consistentieniveau Gebonden veroudering vertegenwoordigt deze waarde de tijdsduur van veroudering (in seconden) die wordt getolereerd. Geaccepteerd bereik voor deze waarde is 5 - 86400. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 5 Maximumwaarde = 86400 |
| maxStalenessPrefix | Wanneer deze waarde wordt gebruikt met het consistentieniveau Gebonden veroudering, vertegenwoordigt deze waarde het aantal verlopen aanvragen dat wordt getolereerd. Geaccepteerd bereik voor deze waarde is 1 – 2.147.483.647. Vereist wanneer defaultConsistencyPolicy is ingesteld op 'BoundedStaleness'. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
CorsPolicy
| Naam | Beschrijving | Waarde |
|---|---|---|
| allowedHeaders | De aanvraagheaders die het oorspronkelijke domein kan opgeven voor de CORS-aanvraag. | snaar |
| allowedMethods | De methoden (HTTP-aanvraagwoorden) die het oorspronkelijke domein kan gebruiken voor een CORS-aanvraag. | snaar |
| allowedOrigins | De oorspronkelijke domeinen die via CORS een aanvraag voor de service mogen indienen. | tekenreeks (vereist) |
| exposedHeaders | De antwoordheaders die kunnen worden verzonden in het antwoord op de CORS-aanvraag en die door de browser worden weergegeven aan de verlener van de aanvraag. | snaar |
| maxAgeInSeconds | De maximale hoeveelheid tijd die een browser moet opslaan in de cache van de preflight OPTIONS-aanvraag. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 2147483647 |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties
| Naam | Beschrijving | Waarde |
|---|---|---|
| apiProperties | API-specifieke eigenschappen. Momenteel wordt alleen ondersteund voor mongoDB-API. | ApiProperties- |
| Mogelijkheden | Lijst met Cosmos DB-mogelijkheden voor het account | Mogelijkheid[] |
| connectorOffer | De cassandra-connectoraanbiedingstype voor het Cosmos DB-database-C*-account. | 'Klein' |
| consistencyPolicy | Het consistentiebeleid voor het Cosmos DB-account. | ConsistencyPolicy- |
| cors | Het CORS-beleid voor het Cosmos DB-databaseaccount. | CorsPolicy[] |
| databaseAccountOfferType | Het aanbiedingstype voor de database | 'Standaard' (vereist) |
| disableKeyBasedMetadataWriteAccess | Schrijfbewerkingen uitschakelen voor metagegevensresources (databases, containers, doorvoer) via accountsleutels | Bool |
| enableAnalyticalStorage | Vlag om aan te geven of opslaganalyse moet worden ingeschakeld. | Bool |
| enableAutomaticFailover | Maakt automatische failover van de schrijfregio mogelijk in de zeldzame gebeurtenis dat de regio niet beschikbaar is vanwege een storing. Automatische failover resulteert in een nieuwe schrijfregio voor het account en wordt gekozen op basis van de failoverprioriteiten die voor het account zijn geconfigureerd. | Bool |
| enableCassandraConnector | Hiermee schakelt u de Cassandra-connector in het Cosmos DB C*-account in | Bool |
| enableFreeTier | Vlag om aan te geven of de gratis laag is ingeschakeld. | Bool |
| enableMultipleWriteLocations | Hiermee kan het account op meerdere locaties schrijven | Bool |
| ipRules | Lijst met IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Vlag om aan te geven of virtuele netwerk-ACL-regels moeten worden ingeschakeld/uitgeschakeld. | Bool |
| keyVaultKeyUri | De URI van de sleutelkluis | snaar |
| Locaties | Een matrix die de georeplicatielocaties bevat die zijn ingeschakeld voor het Cosmos DB-account. | Locatie[] (vereist) |
| virtualNetworkRules | Lijst met ACL-regels voor virtueel netwerk die zijn geconfigureerd voor het Cosmos DB-account. | VirtualNetworkRule[] |
IpAddressOrRange
| Naam | Beschrijving | Waarde |
|---|---|---|
| ipAddressOrRange | Eén IPv4-adres of één IPv4-adresbereik in CIDR-indeling. Opgegeven IP-adressen moeten goed zijn opgemaakt en kunnen niet worden opgenomen in een van de volgende bereiken: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, omdat deze niet kunnen worden afgedwongen door het IP-adresfilter. Voorbeeld van geldige invoer: '23.40.210.245' of '23.40.210.0/8'. | snaar |
Plaats
| Naam | Beschrijving | Waarde |
|---|---|---|
| failoverPriority | De failoverprioriteit van de regio. Een failoverprioriteit van 0 geeft een schrijfregio aan. De maximumwaarde voor een failoverprioriteit = (totaal aantal regio's - 1). Failoverprioriteitswaarden moeten uniek zijn voor elk van de regio's waarin het databaseaccount bestaat. | Int Beperkingen: Minimumwaarde = 0 |
| isZoneRedundant | Vlag om aan te geven of deze regio een AvailabilityZone-regio is | Bool |
| locationName | De naam van de regio. | snaar |
Microsoft.DocumentDB/databaseAccounts
| Naam | Beschrijving | Waarde |
|---|---|---|
| soort | Geeft het type databaseaccount aan. Dit kan alleen worden ingesteld bij het maken van een databaseaccount. | 'GlobalDocumentDB' 'MongoDB' 'Parseren' |
| plaats | De locatie van de resourcegroep waartoe de resource behoort. | snaar |
| naam | De resourcenaam | snaar Beperkingen: Minimale lengte = 3 Maximale lengte = 3 Patroon = ^[a-z0-9]+(-[a-z0-9]+)* (vereist) |
| Eigenschappen | Eigenschappen voor het maken en bijwerken van Azure Cosmos DB-databaseaccounts. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccountGetProperties (vereist) |
| Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. |
| type | Het resourcetype | "Microsoft.DocumentDB/databaseAccounts@2020-04-01" |
Tags
| Naam | Beschrijving | Waarde |
|---|
VirtualNetworkRule
| Naam | Beschrijving | Waarde |
|---|---|---|
| legitimatiebewijs | Resource-id van een subnet, bijvoorbeeld: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnetten/{subnetName}. | snaar |
| ignoreMissingVNetServiceEndpoint | Maak een firewallregel voordat vnet-service-eindpunt is ingeschakeld voor het virtuele netwerk. | Bool |