DatabaseAccountCreateUpdateParameters Class

Reference

Parameters to create and update Cosmos DB database accounts.

Variables are only populated by the server, and will be ignored when sending a request.

All required parameters must be populated in order to send to Azure.

Inheritance: azure.mgmt.cosmosdb.models._models_py3.ARMResourceProperties

DatabaseAccountCreateUpdateParameters

Constructor

DatabaseAccountCreateUpdateParameters(*, locations: List[_models.Location], location: str | None = None, tags: Dict[str, str] | None = None, kind: str | _models.DatabaseAccountKind | None = None, identity: _models.ManagedServiceIdentity | None = None, consistency_policy: _models.ConsistencyPolicy | None = None, ip_rules: List[_models.IpAddressOrRange] | None = None, is_virtual_network_filter_enabled: bool | None = None, enable_automatic_failover: bool | None = None, capabilities: List[_models.Capability] | None = None, virtual_network_rules: List[_models.VirtualNetworkRule] | None = None, enable_multiple_write_locations: bool | None = None, enable_cassandra_connector: bool | None = None, connector_offer: str | _models.ConnectorOffer | None = None, disable_key_based_metadata_write_access: bool | None = None, key_vault_key_uri: str | None = None, default_identity: str | None = None, public_network_access: str | _models.PublicNetworkAccess | None = None, enable_free_tier: bool | None = None, api_properties: _models.ApiProperties | None = None, enable_analytical_storage: bool | None = None, analytical_storage_configuration: _models.AnalyticalStorageConfiguration | None = None, create_mode: str | _models.CreateMode = 'Default', backup_policy: _models.BackupPolicy | None = None, cors: List[_models.CorsPolicy] | None = None, network_acl_bypass: str | _models.NetworkAclBypass | None = None, network_acl_bypass_resource_ids: List[str] | None = None, disable_local_auth: bool | None = None, restore_parameters: _models.RestoreParameters | None = None, capacity: _models.Capacity | None = None, enable_partition_merge: bool | None = None, minimal_tls_version: str | _models.MinimalTlsVersion | None = None, enable_burst_capacity: bool | None = None, customer_managed_key_status: str | None = None, **kwargs: Any)

Keyword-Only Parameters

Name	Description
location	str The location of the resource group to which the resource belongs.
tags	dict[str, str] Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
kind	str or DatabaseAccountKind Indicates the type of database account. This can only be set at database account creation. Known values are: "GlobalDocumentDB", "MongoDB", and "Parse".
identity	ManagedServiceIdentity Identity for the resource.
consistency_policy	ConsistencyPolicy The consistency policy for the Cosmos DB account.
locations	list[Location] An array that contains the georeplication locations enabled for the Cosmos DB account. Required.
ip_rules	list[IpAddressOrRange] List of IpRules.
is_virtual_network_filter_enabled	bool Flag to indicate whether to enable/disable Virtual Network ACL rules.
enable_automatic_failover	bool Enables automatic failover of the write region in the rare event that the region is unavailable due to an outage. Automatic failover will result in a new write region for the account and is chosen based on the failover priorities configured for the account.
capabilities	list[Capability] List of Cosmos DB capabilities for the account.
virtual_network_rules	list[VirtualNetworkRule] List of Virtual Network ACL rules configured for the Cosmos DB account.
enable_multiple_write_locations	bool Enables the account to write in multiple locations.
enable_cassandra_connector	bool Enables the cassandra connector on the Cosmos DB C* account.
connector_offer	str or ConnectorOffer The cassandra connector offer type for the Cosmos DB database C* account. "Small"
disable_key_based_metadata_write_access	bool Disable write operations on metadata resources (databases, containers, throughput) via account keys.
key_vault_key_uri	str The URI of the key vault.
default_identity	str The default identity for accessing key vault used in features like customer managed keys. The default identity needs to be explicitly set by the users. It can be "FirstPartyIdentity", "SystemAssignedIdentity" and more.
public_network_access	str or PublicNetworkAccess Whether requests from Public Network are allowed. Known values are: "Enabled", "Disabled", and "SecuredByPerimeter".
enable_free_tier	bool Flag to indicate whether Free Tier is enabled.
api_properties	ApiProperties API specific properties. Currently, supported only for MongoDB API.
enable_analytical_storage	bool Flag to indicate whether to enable storage analytics.
analytical_storage_configuration	AnalyticalStorageConfiguration Analytical storage specific properties.
create_mode	str or CreateMode Enum to indicate the mode of account creation. Known values are: "Default" and "Restore". default value: Default
backup_policy	BackupPolicy The object representing the policy for taking backups on an account.
cors	list[CorsPolicy] The CORS policy for the Cosmos DB database account.
network_acl_bypass	str or NetworkAclBypass Indicates what services are allowed to bypass firewall checks. Known values are: "None" and "AzureServices".
network_acl_bypass_resource_ids	list[str] An array that contains the Resource Ids for Network Acl Bypass for the Cosmos DB account.
disable_local_auth	bool Opt-out of local authentication and ensure only MSI and AAD can be used exclusively for authentication.
restore_parameters	RestoreParameters Parameters to indicate the information about the restore.
capacity	Capacity The object that represents all properties related to capacity enforcement on an account.
enable_partition_merge	bool Flag to indicate enabling/disabling of Partition Merge feature on the account.
minimal_tls_version	str or MinimalTlsVersion Indicates the minimum allowed Tls version. The default value is Tls 1.2. Cassandra and Mongo APIs only work with Tls 1.2. Known values are: "Tls", "Tls11", and "Tls12".
enable_burst_capacity	bool Flag to indicate enabling/disabling of Burst Capacity Preview feature on the account.
customer_managed_key_status	str Indicates the status of the Customer Managed Key feature on the account. In case there are errors, the property provides troubleshooting guidance.

Variables

Name	Description
id	str The unique resource identifier of the ARM resource.
name	str The name of the ARM resource.
type	str The type of Azure resource.
location	str The location of the resource group to which the resource belongs.
tags	dict[str, str] Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
kind	str or DatabaseAccountKind Indicates the type of database account. This can only be set at database account creation. Known values are: "GlobalDocumentDB", "MongoDB", and "Parse".
identity	ManagedServiceIdentity Identity for the resource.
consistency_policy	ConsistencyPolicy The consistency policy for the Cosmos DB account.
locations	list[Location] An array that contains the georeplication locations enabled for the Cosmos DB account. Required.
database_account_offer_type	str The offer type for the database. Required. Default value is "Standard".
ip_rules	list[IpAddressOrRange] List of IpRules.
is_virtual_network_filter_enabled	bool Flag to indicate whether to enable/disable Virtual Network ACL rules.
enable_automatic_failover	bool Enables automatic failover of the write region in the rare event that the region is unavailable due to an outage. Automatic failover will result in a new write region for the account and is chosen based on the failover priorities configured for the account.
capabilities	list[Capability] List of Cosmos DB capabilities for the account.
virtual_network_rules	list[VirtualNetworkRule] List of Virtual Network ACL rules configured for the Cosmos DB account.
enable_multiple_write_locations	bool Enables the account to write in multiple locations.
enable_cassandra_connector	bool Enables the cassandra connector on the Cosmos DB C* account.
connector_offer	str or ConnectorOffer The cassandra connector offer type for the Cosmos DB database C* account. "Small"
disable_key_based_metadata_write_access	bool Disable write operations on metadata resources (databases, containers, throughput) via account keys.
key_vault_key_uri	str The URI of the key vault.
default_identity	str The default identity for accessing key vault used in features like customer managed keys. The default identity needs to be explicitly set by the users. It can be "FirstPartyIdentity", "SystemAssignedIdentity" and more.
public_network_access	str or PublicNetworkAccess Whether requests from Public Network are allowed. Known values are: "Enabled", "Disabled", and "SecuredByPerimeter".
enable_free_tier	bool Flag to indicate whether Free Tier is enabled.
api_properties	ApiProperties API specific properties. Currently, supported only for MongoDB API.
enable_analytical_storage	bool Flag to indicate whether to enable storage analytics.
analytical_storage_configuration	AnalyticalStorageConfiguration Analytical storage specific properties.
create_mode	str or CreateMode Enum to indicate the mode of account creation. Known values are: "Default" and "Restore".
backup_policy	BackupPolicy The object representing the policy for taking backups on an account.
cors	list[CorsPolicy] The CORS policy for the Cosmos DB database account.
network_acl_bypass	str or NetworkAclBypass Indicates what services are allowed to bypass firewall checks. Known values are: "None" and "AzureServices".
network_acl_bypass_resource_ids	list[str] An array that contains the Resource Ids for Network Acl Bypass for the Cosmos DB account.
disable_local_auth	bool Opt-out of local authentication and ensure only MSI and AAD can be used exclusively for authentication.
restore_parameters	RestoreParameters Parameters to indicate the information about the restore.
capacity	Capacity The object that represents all properties related to capacity enforcement on an account.
keys_metadata	DatabaseAccountKeysMetadata This property is ignored during the update/create operation, as the metadata is read-only. The object represents the metadata for the Account Keys of the Cosmos DB account.
enable_partition_merge	bool Flag to indicate enabling/disabling of Partition Merge feature on the account.
minimal_tls_version	str or MinimalTlsVersion Indicates the minimum allowed Tls version. The default value is Tls 1.2. Cassandra and Mongo APIs only work with Tls 1.2. Known values are: "Tls", "Tls11", and "Tls12".
enable_burst_capacity	bool Flag to indicate enabling/disabling of Burst Capacity Preview feature on the account.
customer_managed_key_status	str Indicates the status of the Customer Managed Key feature on the account. In case there are errors, the property provides troubleshooting guidance.

Attributes

database_account_offer_type

database_account_offer_type = 'Standard'

Share via