Microsoft.DocumentDB databaseAccounts 2020-03-01
- Najnowsza
- 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
Definicja zasobu Bicep
Typ zasobu databaseAccounts można wdrożyć z operacjami docelowymi:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-03-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
properties: {
capabilities: [
{
name: 'string'
}
]
connectorOffer: 'Small'
consistencyPolicy: {
defaultConsistencyLevel: 'string'
maxIntervalInSeconds: int
maxStalenessPrefix: int
}
databaseAccountOfferType: 'Standard'
disableKeyBasedMetadataWriteAccess: bool
enableAutomaticFailover: bool
enableCassandraConnector: bool
enableMultipleWriteLocations: bool
ipRangeFilter: 'string'
isVirtualNetworkFilterEnabled: bool
keyVaultKeyUri: 'string'
locations: [
{
failoverPriority: int
isZoneRedundant: bool
locationName: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVNetServiceEndpoint: bool
}
]
}
}
Wartości właściwości
databaseAccounts
| Nazwa | Opis | Wartość |
|---|---|---|
| name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–44 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Zacznij od małej litery lub cyfry. Nazwa zasobu musi być unikatowa na platformie Azure. |
| location | Lokalizacja grupy zasobów, do której należy zasób. | ciąg |
| tags | Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB". | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
| Rodzaju | Wskazuje typ konta bazy danych. Można to ustawić tylko podczas tworzenia konta bazy danych. | "GlobalDocumentDB" "MongoDB" "Analizowanie" |
| properties | Właściwości do tworzenia i aktualizowania kont bazy danych usługi Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (wymagane) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nazwa | Opis | Wartość |
|---|---|---|
| możliwości | Lista możliwości usługi Cosmos DB dla konta | Możliwości[] |
| connectorOffer | Typ oferty łącznika cassandra dla konta bazy danych Cosmos DB C*. | "Mały" |
| consistencyPolicy | Zasady spójności dla konta usługi Cosmos DB. | ConsistencyPolicy |
| databaseAccountOfferType | Typ oferty bazy danych | "Standard" (wymagany) |
| disableKeyBasedMetadataWriteAccess | Wyłączanie operacji zapisu na zasobach metadanych (bazach danych, kontenerach, przepływności) za pomocą kluczy konta | bool |
| enableAutomaticFailover | Włącza automatyczne przechodzenie w tryb failover regionu zapisu w rzadkim przypadku niedostępności regionu z powodu awarii. Automatyczne przechodzenie w tryb failover spowoduje utworzenie nowego regionu zapisu dla konta i zostanie wybrane na podstawie priorytetów trybu failover skonfigurowanych dla konta. | bool |
| enableCassandraConnector | Włącza łącznik cassandra na koncie usługi Cosmos DB C* | bool |
| enableMultipleWriteLocations | Umożliwia zapisywanie konta w wielu lokalizacjach | bool |
| ipRangeFilter | Obsługa zapory usługi Cosmos DB: ta wartość określa zestaw adresów IP lub zakresów adresów IP w formularzu CIDR, który ma być uwzględniony jako dozwolona lista adresów IP klienta dla danego konta bazy danych. Adresy IP/zakresy muszą być rozdzielone przecinkami i nie mogą zawierać żadnych spacji. | ciąg |
| isVirtualNetworkFilterEnabled | Flaga wskazująca, czy włączyć/wyłączyć reguły listy ACL sieci wirtualnej. | bool |
| keyVaultKeyUri | Identyfikator URI magazynu kluczy | ciąg |
| locations | Tablica zawierająca lokalizacje georeplikacji włączone dla konta usługi Cosmos DB. | Lokalizacja[] (wymagane) |
| virtualNetworkRules | Lista reguł listy ACL sieci wirtualnej skonfigurowanych dla konta usługi Cosmos DB. | VirtualNetworkRule[] |
Możliwość
| Nazwa | Opis | Wartość |
|---|---|---|
| name | Nazwa możliwości usługi Cosmos DB. Na przykład "name": "EnableCassandra". Bieżące wartości obejmują również "EnableTable" i "EnableGremlin". | ciąg |
SpójnośćPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultConsistencyLevel | Domyślny poziom spójności i ustawienia konfiguracji konta usługi Cosmos DB. | "BoundedStaleness" "Spójny prefiks" "Ostateczna" "Sesja" "Strong" (wymagane) |
| maxIntervalInSeconds | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje tolerowaną ilość czasu nieaktualności (w sekundach). Zaakceptowany zakres dla tej wartości to 5 – 86400. Wymagane, gdy wartość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 5 Maksymalna wartość = 86400 |
| maxStalenessPrefix | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje liczbę przestarzałych żądań tolerowanych. Zaakceptowany zakres dla tej wartości to 1 – 2147 483 647. Wymagane, gdy wartość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 1 Maksymalna wartość = 2147483647 |
Location
| Nazwa | Opis | Wartość |
|---|---|---|
| failoverPriority | Priorytet trybu failover regionu. Priorytet pracy w trybie failover 0 wskazuje region zapisu. Maksymalna wartość priorytetu trybu failover = (całkowita liczba regionów — 1). Wartości priorytetów trybu failover muszą być unikatowe dla każdego z regionów, w których istnieje konto bazy danych. | int Ograniczenia: Minimalna wartość = 0 |
| isZoneRedundant | Flaga wskazująca, czy ten region jest regionem AvailabilityZone | bool |
| locationName | Nazwa regionu. | ciąg |
VirtualNetworkRule
| Nazwa | Opis | Wartość |
|---|---|---|
| identyfikator | Identyfikator zasobu podsieci, na przykład: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | ciąg |
| ignoreMissingVNetServiceEndpoint | Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej. | bool |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Template | Opis |
|---|---|
Ciągła integracja/ciągłe wdrażanie przy użyciu narzędzia Jenkins w usłudze Azure Container Service (AKS) |
Kontenery ułatwiają ciągłe kompilowanie i wdrażanie aplikacji. Organizując wdrażanie tych kontenerów przy użyciu platformy Kubernetes w usłudze Azure Container Service, można osiągnąć replikowalne klastry kontenerów, którymi można zarządzać. Konfigurując ciągłą kompilację w celu tworzenia obrazów kontenerów i aranżacji, można zwiększyć szybkość i niezawodność wdrożenia. |
| Aplikacja internetowa z usługą SQL Database, Azure Cosmos DB, Azure Search |
Ten szablon aprowizuje aplikację internetową, usługę SQL Database, usługę Azure Cosmos DB, usługę Azure Search i usługę Application Insights. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Cassandra |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z dedykowaną przepływnością. |
| Tworzenie automatycznego skalowania konta usługi Azure Cosmos DB dla interfejsu API Cassandra |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z przepływnością autoskalowania. |
| Tworzenie konta usługi Azure CosmosDB |
Ten szablon usługi ARM ma na celu szybkie utworzenie konta usługi CosmosDB z minimalnymi wymaganymi wartościami |
| Tworzenie konta usługi Azure Cosmos DB w wielu regionach |
Ten szablon tworzy konto usługi Azure Cosmos DB dla dowolnego typu interfejsu API bazy danych z regionem podstawowym i pomocniczym z wyborem poziomu spójności i typu trybu failover. |
| Tworzenie konta usługi Azure Cosmos DB w warstwie Bezpłatna |
Ten szablon tworzy bezpłatne konto usługi Azure Cosmos DB dla interfejsu API SQL z bazą danych z udostępnioną przepływnością i kontenerem. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API języka Gremlin |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API języka Gremlin w dwóch regionach z jedną bazą danych i jednym grafem przy użyciu dedykowanej przepływności. |
| Tworzenie konta usługi Azure Cosmos DB dla automatycznego skalowania interfejsu API języka Gremlin |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API języka Gremlin w dwóch regionach z jedną bazą danych i jednym grafem przy użyciu przepływności autoskalowania. |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API bazy danych MongoDB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API bazy danych MongoDB 4.2 w dwóch regionach przy użyciu udostępnionej i dedykowanej przepływności z dwiema kolekcjami. |
| Tworzenie konta usługi Azure Cosmos dla autoskalowania interfejsu API bazy danych MongoDB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API bazy danych MongoDB 4.2 w dwóch regionach przy użyciu udostępnionej i dedykowanej przepływności skalowania automatycznego. |
| Tworzenie konta usługi Azure Cosmos DB z prywatnym punktem końcowym |
Ten szablon spowoduje utworzenie konta usługi Cosmos, sieci wirtualnej i prywatnego punktu końcowego uwidaczniającego konto usługi Cosmos w sieci wirtualnej. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Core (SQL) |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem z przepływnością z wieloma innymi opcjami. |
| Interfejs API SQL konta usługi Azure Cosmos DB z magazynem analitycznym |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem skonfigurowanym z magazynem analitycznym. |
| Tworzenie interfejsu API SQL konta usługi Azure Cosmos DB przy użyciu autoskalowania |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem z przepływnością autoskalowania z wieloma innymi opcjami. |
| Tworzenie procedur składowanych interfejsu API Core (SQL) usługi Azure Cosmos DB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Core (SQL) i kontener z procedurą składowaną, wyzwalaczem i funkcją zdefiniowaną przez użytkownika. |
| Tworzenie minimalnego konta usługi Azure Cosmos DB dla interfejsu API Core (SQL) |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Core (SQL) przy jednoczesnym określeniu tylko minimalnych wymaganych właściwości zasobów. |
| Tworzenie usługi Azure Cosmos przy użyciu interfejsu API SQL i wielu kontenerów |
Szablon tworzy kontener usługi Cosmos za pomocą interfejsu API SQL i umożliwia dodawanie kontenerów mulitple. |
| Tworzenie konta SQL usługi Azure Cosmos DB przy użyciu kontroli dostępu opartej na rolach płaszczyzny danych |
Ten szablon utworzy konto usługi SQL Cosmos, natywnie utrzymywaną definicję roli i natywnie obsługiwane przypisanie roli dla tożsamości usługi AAD. |
| Tworzenie bezserwerowego konta usługi Azure Cosmos DB dla interfejsu API SQL |
Ten szablon tworzy bezserwerowe konto usługi Azure Cosmos DB dla interfejsu API Core (SQL). |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API tabel |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API tabel w dwóch regionach i jedną tabelę z aprowizowaną przepływnością. |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API tabel przy użyciu autoskalowania |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API tabel w dwóch regionach i jedną tabelę z przepływnością autoskalowania. |
| Tworzenie bezobsługowego konta usługi Azure Cosmos i aplikacji internetowej platformy Azure |
Ten szablon tworzy konto usługi Azure Cosmos, wprowadza punkt końcowy i klucze usługi Cosmos DB do ustawień aplikacji internetowej platformy Azure, a następnie wdraża aplikację internetową ASP MVC z usługi GitHub. |
| Tworzenie konta usługi Cosmos DB z włączoną usługą Microsoft Defender |
Za pomocą tego szablonu usługi ARM można wdrożyć konto usługi Azure Cosmos DB z włączoną usługą Microsoft Defender dla usługi Azure Cosmos DB. Usługa Microsoft Defender dla usługi Azure Cosmos DB to natywna dla platformy Azure warstwa zabezpieczeń, która wykrywa próby wykorzystania baz danych na kontach usługi Azure Cosmos DB. Usługa Microsoft Defender dla usługi Azure Cosmos DB wykrywa potencjalne wstrzyknięcia kodu SQL, znane złe podmioty oparte na usłudze Microsoft Threat Intelligence, podejrzane wzorce dostępu i potencjalne wykorzystanie bazy danych za pośrednictwem tożsamości lub złośliwych testerów. |
| Wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Cosmos DB |
Wdrażanie usługi Azure Data Explorer DB za pomocą połączenia usługi Cosmos DB. |
| Konto usługi Azure Cosmos DB z aplikacją internetową |
Ten szablon służy do wdrażania konta usługi Azure Cosmos DB, planu usługi App Service i tworzenia aplikacji internetowej w planie usługi App Service. Dodaje również dwa ustawienia aplikacji do aplikacji internetowej odwołującej się do punktu końcowego konta usługi Azure Cosmos DB. Dzięki temu rozwiązania wdrożone w aplikacji internetowej mogą łączyć się z punktem końcowym konta usługi Azure Cosmos DB przy użyciu tych ustawień. |
Definicja zasobu szablonu usługi ARM
Typ zasobu databaseAccounts można wdrożyć z operacjami docelowymi:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.DocumentDB/databaseAccounts",
"apiVersion": "2020-03-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"properties": {
"capabilities": [
{
"name": "string"
}
],
"connectorOffer": "Small",
"consistencyPolicy": {
"defaultConsistencyLevel": "string",
"maxIntervalInSeconds": "int",
"maxStalenessPrefix": "int"
},
"databaseAccountOfferType": "Standard",
"disableKeyBasedMetadataWriteAccess": "bool",
"enableAutomaticFailover": "bool",
"enableCassandraConnector": "bool",
"enableMultipleWriteLocations": "bool",
"ipRangeFilter": "string",
"isVirtualNetworkFilterEnabled": "bool",
"keyVaultKeyUri": "string",
"locations": [
{
"failoverPriority": "int",
"isZoneRedundant": "bool",
"locationName": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVNetServiceEndpoint": "bool"
}
]
}
}
Wartości właściwości
databaseAccounts
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ zasobu | "Microsoft.DocumentDB/databaseAccounts" |
| apiVersion | Wersja interfejsu API zasobów | '2020-03-01' |
| name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–44 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Zacznij od małej litery lub cyfry. Nazwa zasobu musi być unikatowa na platformie Azure. |
| location | Lokalizacja grupy zasobów, do której należy zasób. | ciąg |
| tags | Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB". | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
| Rodzaju | Wskazuje typ konta bazy danych. Można to ustawić tylko podczas tworzenia konta bazy danych. | "GlobalDocumentDB" "MongoDB" "Analizowanie" |
| properties | Właściwości do tworzenia i aktualizowania kont bazy danych usługi Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (wymagane) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nazwa | Opis | Wartość |
|---|---|---|
| możliwości | Lista możliwości usługi Cosmos DB dla konta | Możliwości[] |
| connectorOffer | Typ oferty łącznika cassandra dla konta bazy danych Cosmos DB C*. | "Mały" |
| consistencyPolicy | Zasady spójności dla konta usługi Cosmos DB. | ConsistencyPolicy |
| databaseAccountOfferType | Typ oferty bazy danych | "Standardowa" (wymagana) |
| disableKeyBasedMetadataWriteAccess | Wyłączanie operacji zapisu dla zasobów metadanych (baz danych, kontenerów, przepływności) za pomocą kluczy konta | bool |
| enableAutomaticFailover | Włącza automatyczne przełączanie regionu zapisu w tryb failover w rzadkim przypadku niedostępności regionu z powodu awarii. Automatyczne przełączanie w tryb failover spowoduje utworzenie nowego regionu zapisu dla konta i zostanie wybrane na podstawie priorytetów trybu failover skonfigurowanych dla konta. | bool |
| enableCassandraConnector | Włącza łącznik cassandra na koncie usługi Cosmos DB C* | bool |
| enableMultipleWriteLocations | Umożliwia zapisywanie konta w wielu lokalizacjach | bool |
| ipRangeFilter | Obsługa zapory usługi Cosmos DB: ta wartość określa zestaw adresów IP lub zakresów adresów IP w formularzu CIDR, który ma być uwzględniony jako lista dozwolonych adresów IP klienta dla danego konta bazy danych. Adresy IP/zakresy muszą być rozdzielone przecinkami i nie mogą zawierać spacji. | ciąg |
| isVirtualNetworkFilterEnabled | Flaga wskazująca, czy włączyć/wyłączyć reguły listy ACL sieci wirtualnej. | bool |
| keyVaultKeyUri | Identyfikator URI magazynu kluczy | ciąg |
| locations | Tablica zawierająca lokalizacje georeplikacji włączone dla konta usługi Cosmos DB. | Lokalizacja[] (wymagane) |
| virtualNetworkRules | Lista reguł listy kontroli dostępu dla sieci wirtualnej skonfigurowanych dla konta usługi Cosmos DB. | VirtualNetworkRule[] |
Możliwość
| Nazwa | Opis | Wartość |
|---|---|---|
| name | Nazwa możliwości usługi Cosmos DB. Na przykład "name": "EnableCassandra". Bieżące wartości obejmują również wartości "EnableTable" i "EnableGremlin". | ciąg |
ConsistencyPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultConsistencyLevel | Domyślny poziom spójności i ustawienia konfiguracji konta usługi Cosmos DB. | "BoundedStaleness" "ConsistentPrefix" "Ostateczna" "Sesja" "Strong" (wymagane) |
| maxIntervalInSeconds | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje czas, w jakim tolerowana jest nieaktualność (w sekundach). Zaakceptowany zakres dla tej wartości to 5– 86400. Wymagane, gdy właściwość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 5 Maksymalna wartość = 86400 |
| maxStalenessPrefix | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje liczbę nieaktywnych żądań tolerowanych. Zaakceptowany zakres dla tej wartości to 1 – 2 147 483 647. Wymagane, gdy właściwość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 2147483647 |
Location
| Nazwa | Opis | Wartość |
|---|---|---|
| tryb failoverPriority | Priorytet trybu failover regionu. Priorytet trybu failover 0 wskazuje region zapisu. Maksymalna wartość priorytetu trybu failover = (łączna liczba regionów — 1). Wartości priorytetów trybu failover muszą być unikatowe dla każdego z regionów, w których istnieje konto bazy danych. | int Ograniczenia: Wartość minimalna = 0 |
| isZoneRedundant | Flaga wskazująca, czy ten region jest regionem AvailabilityZone | bool |
| locationName | Nazwa regionu. | ciąg |
VirtualNetworkRule
| Nazwa | Opis | Wartość |
|---|---|---|
| identyfikator | Identyfikator zasobu podsieci, na przykład: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | ciąg |
| ignoreMissingVNetServiceEndpoint | Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej. | bool |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Template | Opis |
|---|---|
| Ciągła integracja/ciągłe wdrażanie przy użyciu narzędzia Jenkins w usłudze Azure Container Service (AKS) |
Kontenery ułatwiają ciągłe kompilowanie i wdrażanie aplikacji. Organizując wdrażanie tych kontenerów przy użyciu platformy Kubernetes w usłudze Azure Container Service, można osiągnąć replikowalne klastry kontenerów, którymi można zarządzać. Konfigurując ciągłą kompilację w celu tworzenia obrazów kontenerów i aranżacji, można zwiększyć szybkość i niezawodność wdrożenia. |
| Aplikacja internetowa z usługą SQL Database, Azure Cosmos DB, Azure Search |
Ten szablon aprowizuje aplikację internetową, usługę SQL Database, usługę Azure Cosmos DB, usługę Azure Search i usługę Application Insights. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Cassandra |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z dedykowaną przepływnością. |
| Tworzenie automatycznego skalowania konta usługi Azure Cosmos DB dla interfejsu API Cassandra |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z przepływnością autoskalowania. |
| Tworzenie konta usługi Azure CosmosDB |
Ten szablon usługi ARM ma na celu szybkie utworzenie konta usługi CosmosDB z minimalnymi wymaganymi wartościami |
| Tworzenie konta usługi Azure Cosmos DB w wielu regionach |
Ten szablon tworzy konto usługi Azure Cosmos DB dla dowolnego typu interfejsu API bazy danych z regionem podstawowym i pomocniczym z wyborem poziomu spójności i typu trybu failover. |
| Tworzenie konta usługi Azure Cosmos DB w warstwie Bezpłatna |
Ten szablon tworzy bezpłatne konto usługi Azure Cosmos DB dla interfejsu API SQL z bazą danych z udostępnioną przepływnością i kontenerem. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API języka Gremlin |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API języka Gremlin w dwóch regionach z jedną bazą danych i jednym grafem przy użyciu dedykowanej przepływności. |
| Tworzenie konta usługi Azure Cosmos DB dla automatycznego skalowania interfejsu API języka Gremlin |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API języka Gremlin w dwóch regionach z jedną bazą danych i jednym grafem przy użyciu przepływności autoskalowania. |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API bazy danych MongoDB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API bazy danych MongoDB 4.2 w dwóch regionach przy użyciu udostępnionej i dedykowanej przepływności z dwiema kolekcjami. |
| Tworzenie konta usługi Azure Cosmos dla autoskalowania interfejsu API bazy danych MongoDB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API bazy danych MongoDB 4.2 w dwóch regionach przy użyciu udostępnionej i dedykowanej przepływności skalowania automatycznego. |
| Tworzenie konta usługi Azure Cosmos DB z prywatnym punktem końcowym |
Ten szablon spowoduje utworzenie konta usługi Cosmos, sieci wirtualnej i prywatnego punktu końcowego uwidaczniającego konto usługi Cosmos w sieci wirtualnej. |
| Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Core (SQL) |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem z przepływnością z wieloma innymi opcjami. |
| Interfejs API SQL konta usługi Azure Cosmos DB z magazynem analitycznym |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem skonfigurowanym z magazynem analitycznym. |
| Tworzenie interfejsu API SQL konta usługi Azure Cosmos DB przy użyciu autoskalowania |
Ten szablon tworzy konto usługi Azure Cosmos dla interfejsu API Core (SQL) z bazą danych i kontenerem z przepływnością autoskalowania z wieloma innymi opcjami. |
| Tworzenie procedur składowanych interfejsu API Core (SQL) usługi Azure Cosmos DB |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Core (SQL) i kontener z procedurą składowaną, wyzwalaczem i funkcją zdefiniowaną przez użytkownika. |
| Tworzenie minimalnego konta usługi Azure Cosmos DB dla interfejsu API Core (SQL) |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Core (SQL) przy jednoczesnym określeniu tylko minimalnych wymaganych właściwości zasobów. |
| Tworzenie usługi Azure Cosmos przy użyciu interfejsu API SQL i wielu kontenerów |
Szablon tworzy kontener usługi Cosmos za pomocą interfejsu API SQL i umożliwia dodawanie kontenerów mulitple. |
| Tworzenie konta SQL usługi Azure Cosmos DB przy użyciu kontroli dostępu opartej na rolach płaszczyzny danych |
Ten szablon utworzy konto usługi SQL Cosmos, natywnie utrzymywaną definicję roli i natywnie obsługiwane przypisanie roli dla tożsamości usługi AAD. |
| Tworzenie bezserwerowego konta usługi Azure Cosmos DB dla interfejsu API SQL |
Ten szablon tworzy bezserwerowe konto usługi Azure Cosmos DB dla interfejsu API Core (SQL). |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API tabel |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API tabel w dwóch regionach i jedną tabelę z aprowizowaną przepływnością. |
| Tworzenie konta usługi Azure Cosmos dla interfejsu API tabel przy użyciu autoskalowania |
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API tabel w dwóch regionach i jedną tabelę z przepływnością autoskalowania. |
| Tworzenie bezobsługowego konta usługi Azure Cosmos i aplikacji internetowej platformy Azure |
Ten szablon tworzy konto usługi Azure Cosmos, wprowadza punkt końcowy i klucze usługi Cosmos DB do ustawień aplikacji internetowej platformy Azure, a następnie wdraża aplikację internetową ASP MVC z usługi GitHub. |
| Tworzenie konta usługi Cosmos DB z włączoną usługą Microsoft Defender |
Za pomocą tego szablonu usługi ARM można wdrożyć konto usługi Azure Cosmos DB z włączoną usługą Microsoft Defender dla usługi Azure Cosmos DB. Usługa Microsoft Defender dla usługi Azure Cosmos DB to natywna dla platformy Azure warstwa zabezpieczeń, która wykrywa próby wykorzystania baz danych na kontach usługi Azure Cosmos DB. Usługa Microsoft Defender dla usługi Azure Cosmos DB wykrywa potencjalne wstrzyknięcia kodu SQL, znane złe podmioty oparte na usłudze Microsoft Threat Intelligence, podejrzane wzorce dostępu i potencjalne wykorzystanie bazy danych za pośrednictwem tożsamości lub złośliwych testerów. |
| Wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Cosmos DB |
Wdrażanie usługi Azure Data Explorer DB za pomocą połączenia usługi Cosmos DB. |
| Konto usługi Azure Cosmos DB z aplikacją internetową |
Ten szablon służy do wdrażania konta usługi Azure Cosmos DB, planu usługi App Service i tworzenia aplikacji internetowej w planie usługi App Service. Dodaje również dwa ustawienia aplikacji do aplikacji internetowej odwołującej się do punktu końcowego konta usługi Azure Cosmos DB. Dzięki temu rozwiązania wdrożone w aplikacji internetowej mogą łączyć się z punktem końcowym konta usługi Azure Cosmos DB przy użyciu tych ustawień. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu databaseAccounts można wdrożyć z operacjami docelowymi:
- Grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts@2020-03-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
capabilities = [
{
name = "string"
}
]
connectorOffer = "Small"
consistencyPolicy = {
defaultConsistencyLevel = "string"
maxIntervalInSeconds = int
maxStalenessPrefix = int
}
databaseAccountOfferType = "Standard"
disableKeyBasedMetadataWriteAccess = bool
enableAutomaticFailover = bool
enableCassandraConnector = bool
enableMultipleWriteLocations = bool
ipRangeFilter = "string"
isVirtualNetworkFilterEnabled = bool
keyVaultKeyUri = "string"
locations = [
{
failoverPriority = int
isZoneRedundant = bool
locationName = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVNetServiceEndpoint = bool
}
]
}
kind = "string"
})
}
Wartości właściwości
databaseAccounts
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ zasobu | "Microsoft.DocumentDB/databaseAccounts@2020-03-01" |
| name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–44 Prawidłowe znaki: Wyłącznie małe litery, cyfry i łączniki. Zacznij od małej litery lub cyfry. Nazwa zasobu musi być unikatowa na platformie Azure. |
| location | Lokalizacja grupy zasobów, do której należy zasób. | ciąg |
| parent_id | Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów. | ciąg (wymagany) |
| tags | Tagi to lista par klucz-wartość, które opisują zasób. Te tagi mogą służyć do wyświetlania i grupowania tego zasobu (między grupami zasobów). Dla zasobu można podać maksymalnie 15 tagów. Każdy tag musi mieć klucz nie większy niż 128 znaków i wartość nie większą niż 256 znaków. Na przykład domyślne środowisko dla typu szablonu jest ustawiane z wartością "defaultExperience": "Cassandra". Bieżące wartości "defaultExperience" obejmują również wartości "Table", "Graph", "DocumentDB" i "MongoDB". | Słownik nazw tagów i wartości. |
| Rodzaju | Wskazuje typ konta bazy danych. Można to ustawić tylko podczas tworzenia konta bazy danych. | "GlobalDocumentDB" "MongoDB" "Analizowanie" |
| properties | Właściwości do tworzenia i aktualizowania kont bazy danych usługi Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (wymagane) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nazwa | Opis | Wartość |
|---|---|---|
| możliwości | Lista możliwości usługi Cosmos DB dla konta | Możliwości[] |
| connectorOffer | Typ oferty łącznika cassandra dla konta bazy danych Cosmos DB C*. | "Mały" |
| consistencyPolicy | Zasady spójności dla konta usługi Cosmos DB. | ConsistencyPolicy |
| databaseAccountOfferType | Typ oferty bazy danych | "Standardowa" (wymagane) |
| disableKeyBasedMetadataWriteAccess | Wyłączanie operacji zapisu dla zasobów metadanych (baz danych, kontenerów, przepływności) za pomocą kluczy konta | bool |
| enableAutomaticFailover | Włącza automatyczne przełączanie regionu zapisu w tryb failover w rzadkim przypadku niedostępności regionu z powodu awarii. Automatyczne przełączanie w tryb failover spowoduje utworzenie nowego regionu zapisu dla konta i zostanie wybrane na podstawie priorytetów trybu failover skonfigurowanych dla konta. | bool |
| enableCassandraConnector | Włącza łącznik cassandra na koncie usługi Cosmos DB C* | bool |
| enableMultipleWriteLocations | Umożliwia zapisywanie konta w wielu lokalizacjach | bool |
| ipRangeFilter | Obsługa zapory usługi Cosmos DB: ta wartość określa zestaw adresów IP lub zakresów adresów IP w formularzu CIDR, który ma być uwzględniony jako lista dozwolonych adresów IP klienta dla danego konta bazy danych. Adresy IP/zakresy muszą być rozdzielone przecinkami i nie mogą zawierać spacji. | ciąg |
| isVirtualNetworkFilterEnabled | Flaga wskazująca, czy włączyć/wyłączyć reguły listy ACL sieci wirtualnej. | bool |
| keyVaultKeyUri | Identyfikator URI magazynu kluczy | ciąg |
| locations | Tablica zawierająca lokalizacje georeplikacji włączone dla konta usługi Cosmos DB. | Lokalizacja[] (wymagane) |
| virtualNetworkRules | Lista reguł listy kontroli dostępu dla sieci wirtualnej skonfigurowanych dla konta usługi Cosmos DB. | VirtualNetworkRule[] |
Możliwość
| Nazwa | Opis | Wartość |
|---|---|---|
| name | Nazwa możliwości usługi Cosmos DB. Na przykład "name": "EnableCassandra". Bieżące wartości obejmują również wartości "EnableTable" i "EnableGremlin". | ciąg |
ConsistencyPolicy
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultConsistencyLevel | Domyślny poziom spójności i ustawienia konfiguracji konta usługi Cosmos DB. | "BoundedStaleness" "Spójny prefiks" "Ostateczna" "Sesja" "Strong" (wymagane) |
| maxIntervalInSeconds | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje czas, w jakim tolerowana jest nieaktualność (w sekundach). Zaakceptowany zakres dla tej wartości to 5– 86400. Wymagane, gdy właściwość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 5 Maksymalna wartość = 86400 |
| maxStalenessPrefix | W przypadku użycia z poziomem spójności Powiązana nieaktualność ta wartość reprezentuje liczbę nieaktywnych żądań tolerowanych. Zaakceptowany zakres dla tej wartości to 1 – 2 147 483 647. Wymagane, gdy właściwość defaultConsistencyPolicy jest ustawiona na wartość "BoundedStaleness". | int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 2147483647 |
Location
| Nazwa | Opis | Wartość |
|---|---|---|
| tryb failoverPriority | Priorytet trybu failover regionu. Priorytet trybu failover 0 wskazuje region zapisu. Maksymalna wartość priorytetu trybu failover = (łączna liczba regionów — 1). Wartości priorytetów trybu failover muszą być unikatowe dla każdego z regionów, w których istnieje konto bazy danych. | int Ograniczenia: Wartość minimalna = 0 |
| isZoneRedundant | Flaga wskazująca, czy ten region jest regionem AvailabilityZone | bool |
| locationName | Nazwa regionu. | ciąg |
VirtualNetworkRule
| Nazwa | Opis | Wartość |
|---|---|---|
| identyfikator | Identyfikator zasobu podsieci, na przykład: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | ciąg |
| ignoreMissingVNetServiceEndpoint | Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej. | bool |