Terraform 0.11

azurerm_cosmos_db_account




terraform

azurerm_cosmos_db_account

एक CosmosDB (औपचारिक रूप से DocumentDB) खाते का प्रबंधन करता है।

उदाहरण उपयोग

resource "azurerm_resource_group" "rg" {
    name     = "${var.resource_group_name}"
    location = "${var.resource_group_location}"
}

resource "random_integer" "ri" {
    min = 10000
    max = 99999
}

resource "azurerm_cosmosdb_account" "db" {
    name                = "tfex-cosmos-db-${random_integer.ri.result}"
    location            = "${azurerm_resource_group.rg.location}"
    resource_group_name = "${azurerm_resource_group.rg.name}"
    offer_type          = "Standard"
    kind                = "GlobalDocumentDB"

    enable_automatic_failover = true

    consistency_policy {
        consistency_level       = "BoundedStaleness"
        max_interval_in_seconds = 10
        max_staleness_prefix    = 200
    }

    geo_location {
        location          = "${var.failover_location}"
        failover_priority = 1
    }

    geo_location {
        id                = "tfex-cosmos-db-${random_integer.ri.result}-customid"
        location          = "${azurerm_resource_group.rg.location}"
        failover_priority = 0
    }
}

तर्क संदर्भ

निम्नलिखित तर्क समर्थित हैं:

  • name - (आवश्यक) कॉस्मॉसडीबी खाते का नाम निर्दिष्ट करता है। इस परिवर्तन से एक नया संसाधन बनने के लिए बाध्य होता है।

  • resource_group_name - (आवश्यक) संसाधन समूह का नाम जिसमें CosmosDB खाता बनाया गया है। इस परिवर्तन से एक नया संसाधन बनने के लिए बाध्य होता है।

  • location - (आवश्यक) समर्थित Azure स्थान निर्दिष्ट करता है जहाँ संसाधन मौजूद है। इस परिवर्तन से एक नया संसाधन बनने के लिए बाध्य होता है।

  • tags - (वैकल्पिक) संसाधन को असाइन करने के लिए टैग की मैपिंग।

  • offer_type - (आवश्यक) इस CosmosDB खाते के लिए उपयोग करने के लिए ऑफ़र प्रकार निर्दिष्ट करता है - वर्तमान में इसे केवल Standard सेट किया जा सकता है।

  • kind - (वैकल्पिक) बनाने के लिए ब्रह्मांड के प्रकार निर्दिष्ट करता है - संभव मान GlobalDocumentDB और MongoDBGlobalDocumentDB लिए डिफ़ॉल्ट। इस परिवर्तन से एक नया संसाधन बनने के लिए बाध्य होता है।

  • संगति_पुलिस - (आवश्यक) एक संगति_पुलिस संसाधन निर्दिष्ट करता है, जिसका उपयोग इस कॉस्मोसडीबी खाते के लिए स्थिरता नीति को परिभाषित करने के लिए किया जाता है।

  • geo_location - (आवश्यक) एक geo_location संसाधन निर्दिष्ट करता है, जिसका उपयोग यह परिभाषित करने के लिए किया जाता है कि डेटा कहां से पुनर्प्राप्त किया जाना चाहिए failover_priority 0 प्राथमिक स्थान निर्दिष्ट करने के लिए।

  • ip_range_filter - (वैकल्पिक) CosmosDB फ़ायरवॉल सपोर्ट: यह मान CIDR फ़ॉर्म में IP पते या IP एड्रेस रेंज के सेट को निर्दिष्ट करता है जिसे किसी दिए गए डेटाबेस खाते के लिए क्लाइंट IP की अनुमत सूची के रूप में शामिल किया जाना है। आईपी ​​पते / सीमा को अल्पविराम से अलग किया जाना चाहिए और इसमें कोई स्थान नहीं होना चाहिए।

  • enable_automatic_failover - (वैकल्पिक) इस Cosmos DB खाते के लिए स्वचालित विफल को सक्षम करें।

consistency_policy डेटाबेस consistency_policy कॉन्फ़िगर करता है और निम्नलिखित का समर्थन करता है:

  • संगति_लेवल - (आवश्यक) इस कॉस्मोसडीबी खाते के लिए उपयोग करने के लिए निरंतरता स्तर - या तो BoundedStaleness , Eventual , Session , Strong या BoundedStaleness हो सकता है।
  • max_interval_in_seconds - (ऑप्शनल) जब max_interval_in_seconds स्तर के साथ उपयोग किया जाता है, तो यह मान सहनशीलता (सेकंड में) की समय राशि को दर्शाता है। इस मान के लिए स्वीकृत सीमा 5 - 86400 (1 दिन) है। 5 चूक। आवश्यक है जब BoundedStaleness लिए consistency_level निर्धारित किया गया BoundedStaleness
  • max_staleness_prefix - (वैकल्पिक) जब max_staleness_prefix स्थिरता स्तर के साथ उपयोग किया जाता है, तो यह मान सहन किए गए बासी अनुरोधों की संख्या का प्रतिनिधित्व करता है। इस मान के लिए स्वीकृत सीमा 10 - 2147483647100 चूक। आवश्यक है जब BoundedStaleness लिए consistency_level निर्धारित किया गया BoundedStaleness

geo_location उन भौगोलिक स्थानों को कॉन्फ़िगर करता है जहां डेटा को दोहराया जाता है और निम्नलिखित का समर्थन करता है:

  • prefix - (वैकल्पिक) इस क्षेत्र के लिए दस्तावेज़ समापन बिंदु उत्पन्न करने के लिए प्रयुक्त स्ट्रिंग। यदि यह निर्दिष्ट नहीं है तो यह ${cosmosdb_account.name}-${location} लिए डिफॉल्ट करता है। इसे बदलने से स्थान हटा दिया जाता है और पुन: प्रावधान किया जाता है और विफलता के साथ स्थान के लिए नहीं बदला जा सकता है 0
  • location - (आवश्यक) प्रतिकृति डेटा को होस्ट करने के लिए एज़्योर क्षेत्र का नाम।
  • failover_priority - (आवश्यक) क्षेत्र की असफलता प्राथमिकता। 0 का एक विफलता प्राथमिकता एक लेखन क्षेत्र को इंगित करता है। एक असफलता प्राथमिकता के लिए अधिकतम मूल्य = (क्षेत्रों की कुल संख्या - 1)। विफलता प्राथमिकता मान उन क्षेत्रों में से प्रत्येक के लिए अद्वितीय होना चाहिए जिसमें डेटाबेस खाता मौजूद है। इसे बदलने से स्थान को फिर से प्रावधान किया जा सकता है और स्थान के लिए विफलता के साथ नहीं बदला जा सकता है 0

ध्यान दें: किसी स्थान का prefix और failover_priority फ़ील्ड 0 की असफलता प्राथमिकता वाले स्थान के लिए परिवर्तित नहीं की जा सकती हैं।

संदर्भ संदर्भित करता है

निम्नलिखित विशेषताएँ निर्यात की जाती हैं:

  • id - कॉस्मॉसडीबी खाता आईडी।

  • endpoint - एंडपॉइंट को कॉस्मोसडीबी खाते से कनेक्ट करने के लिए उपयोग किया जाता है।

  • read_endpoints - इस कॉस्मोसडीबी खाते के लिए उपलब्ध रीड read_endpoints एक सूची।

  • write_endpoints - इस कॉस्मॉस डीबी खाते के लिए उपलब्ध लेखन समापन बिंदुओं की एक सूची।

  • प्राथमिक_मास्टर_की - कॉस्मॉसडीबी खाते के लिए प्राथमिक मास्टर कुंजी।

  • secondary_master_key - कॉस्मॉसडीबी खाते के लिए माध्यमिक मास्टर कुंजी।

  • primary_readonly_master_key - CosmosDB खाते के लिए प्राथमिक रीड-ओनली मास्टर कुंजी।

  • secondary_readonly_master_key - सेकेंडरी रीड-ओनली मास्टर कुंजी फॉर कोस्मोसबडी अकाउंट।

  • connection_strings - इस CosmosDB खाते के लिए उपलब्ध कनेक्शन स्ट्रिंग्स की एक सूची। अगर GlobalDocumentDB प्रकार है, तो यह खाली हो जाएगा।

आयात

कॉस्मोसडीबी खातों को resource id का उपयोग करके आयात किया जा सकता है, जैसे

terraform import azurerm_cosmosdb_account.account1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.DocumentDB/databaseAccounts/account1