Skip to main content

database_accounts

Overview

Namedatabase_accounts
TypeResource
Idazure.cosmos_db.database_accounts

Fields

NameDatatypeDescription
idstringThe unique resource identifier of the ARM resource.
namestringThe name of the ARM resource.
identityobjectIdentity for the resource.
kindstringIndicates the type of database account. This can only be set at database account creation.
locationstringThe location of the resource group to which the resource belongs.
propertiesobjectProperties for the database account.
systemDataobjectMetadata pertaining to creation and last modification of the resource.
tagsobjectTags 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".
typestringThe type of Azure resource.

Methods

NameAccessible byRequired ParamsDescription
getSELECTaccountName, resourceGroupName, subscriptionIdRetrieves the properties of an existing Azure Cosmos DB database account.
listSELECTsubscriptionIdLists all the Azure Cosmos DB database accounts available under the subscription.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdLists all the Azure Cosmos DB database accounts available under the given resource group.
create_or_updateINSERTaccountName, resourceGroupName, subscriptionId, data__propertiesCreates or updates an Azure Cosmos DB database account. The "Update" method is preferred when performing updates on an account.
deleteDELETEaccountName, resourceGroupName, subscriptionIdDeletes an existing Azure Cosmos DB database account.
_listEXECsubscriptionIdLists all the Azure Cosmos DB database accounts available under the subscription.
_list_by_resource_groupEXECresourceGroupName, subscriptionIdLists all the Azure Cosmos DB database accounts available under the given resource group.
check_name_existsEXECaccountNameChecks that the Azure Cosmos DB account name already exists. A valid account name may contain only lowercase letters, numbers, and the '-' character, and must be between 3 and 50 characters.
failover_priority_changeEXECaccountName, resourceGroupName, subscriptionId, data__failoverPoliciesChanges the failover priority for the Azure Cosmos DB database account. A failover priority of 0 indicates a write region. The maximum value for a failover priority = (total number of regions - 1). Failover priority values must be unique for each of the regions in which the database account exists.
offline_regionEXECaccountName, resourceGroupName, subscriptionId, data__regionOffline the specified region for the specified Azure Cosmos DB database account.
online_regionEXECaccountName, resourceGroupName, subscriptionId, data__regionOnline the specified region for the specified Azure Cosmos DB database account.
regenerate_keyEXECaccountName, resourceGroupName, subscriptionId, data__keyKindRegenerates an access key for the specified Azure Cosmos DB database account.
updateEXECaccountName, resourceGroupName, subscriptionIdUpdates the properties of an existing Azure Cosmos DB database account.