Database Accounts - Update

Riferimento

Servizio:: Cosmos DB Resource Provider

Versione API:: 2024-11-15

Aggiorna le proprietà di un account di database Azure Cosmos DB esistente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}?api-version=2024-11-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account del database Cosmos DB. Criterio di espressione regolare: `^[a-z0-9]+(-[a-z0-9]+)*`
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità per la risorsa.
location	string	Posizione del gruppo di risorse a cui appartiene la risorsa.
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration	Proprietà specifiche dell'archiviazione analitica.
properties.apiProperties	ApiProperties	Proprietà specifiche dell'API. Attualmente, supportato solo per l'API MongoDB.
properties.backupPolicy	BackupPolicy: PeriodicModeBackupPolicy ContinuousModeBackupPolicy	Oggetto che rappresenta i criteri per l'esecuzione di backup in un account.
properties.capabilities	Capability[]	Elenco delle funzionalità di Cosmos DB per l'account
properties.capacity	Capacity	Oggetto che rappresenta tutte le proprietà correlate all'imposizione della capacità in un account.
properties.connectorOffer	ConnectorOffer	Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB.
properties.consistencyPolicy	ConsistencyPolicy	Criteri di coerenza per l'account Cosmos DB.
properties.cors	CorsPolicy[]	Criteri CORS per l'account del database Cosmos DB.
properties.customerManagedKeyStatus	string	Indica lo stato della funzionalità Chiave gestita dal cliente nell'account. In caso di errori, la proprietà fornisce indicazioni per la risoluzione dei problemi.
properties.defaultIdentity	string	Identità predefinita per l'accesso all'insieme di credenziali delle chiavi usato nelle funzionalità come le chiavi gestite dal cliente. L'identità predefinita deve essere impostata in modo esplicito dagli utenti. Può essere "FirstPartyIdentity", "SystemAssignedIdentity" e altro ancora.
properties.disableKeyBasedMetadataWriteAccess	boolean	Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account
properties.disableLocalAuth	boolean	Rifiutare esplicitamente l'autenticazione locale e assicurarsi che solo MSI e AAD possano essere usati esclusivamente per l'autenticazione.
properties.enableAnalyticalStorage	boolean	Flag per indicare se abilitare l'analisi dell'archiviazione.
properties.enableAutomaticFailover	boolean	Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account.
properties.enableBurstCapacity	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità Capacità burst nell'account
properties.enableCassandraConnector	boolean	Abilita il connettore cassandra nell'account C* di Cosmos DB
properties.enableFreeTier	boolean	Flag per indicare se il livello gratuito è abilitato.
properties.enableMultipleWriteLocations	boolean	Consente all'account di scrivere in più posizioni
properties.enablePartitionMerge	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità di merge partizione nell'account
properties.enablePerRegionPerPartitionAutoscale	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità PerRegionPerPartitionAutoscale nell'account
properties.ipRules	IpAddressOrRange[]	Elenco di IpRules.
properties.isVirtualNetworkFilterEnabled	boolean	Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale.
properties.keyVaultKeyUri	string	URI dell'insieme di credenziali delle chiavi
properties.locations	Location[]	Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB.
properties.minimalTlsVersion	MinimalTlsVersion	Indica la versione minima consentita di Tls. Il valore predefinito è Tls 1.2. Le API Cassandra e Mongo funzionano solo con Tls 1.2.
properties.networkAclBypass	NetworkAclBypass	Indica quali servizi sono autorizzati a ignorare i controlli del firewall.
properties.networkAclBypassResourceIds	string[]	Matrice che contiene gli ID risorsa per il bypass Acl di rete per l'account Cosmos DB.
properties.publicNetworkAccess	PublicNetworkAccess	Indica se le richieste dalla rete pubblica sono consentite
properties.virtualNetworkRules	VirtualNetworkRule[]	Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB.
tags	object	I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere usati per visualizzare e raggruppare questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non maggiore di 128 caratteri e un valore non maggiore di 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".

Risposte

Nome	Tipo	Descrizione
200 OK	DatabaseAccountGetResults	L'operazione di aggiornamento dell'account del database verrà completata in modo asincrono.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Esempio

CosmosDBDatabaseAccountPatch

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1?api-version=2024-11-15

{
  "location": "westus",
  "tags": {
    "dept": "finance"
  },
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
    }
  },
  "properties": {
    "ipRules": [
      {
        "ipAddressOrRange": "23.43.230.120"
      },
      {
        "ipAddressOrRange": "110.12.240.0/12"
      }
    ],
    "isVirtualNetworkFilterEnabled": true,
    "virtualNetworkRules": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "ignoreMissingVNetServiceEndpoint": false
      }
    ],
    "consistencyPolicy": {
      "defaultConsistencyLevel": "BoundedStaleness",
      "maxIntervalInSeconds": 10,
      "maxStalenessPrefix": 200
    },
    "defaultIdentity": "FirstPartyIdentity",
    "enableFreeTier": false,
    "enableAnalyticalStorage": true,
    "enableBurstCapacity": true,
    "enablePerRegionPerPartitionAutoscale": true,
    "analyticalStorageConfiguration": {
      "schemaType": "WellDefined"
    },
    "backupPolicy": {
      "type": "Periodic",
      "periodicModeProperties": {
        "backupIntervalInMinutes": 240,
        "backupRetentionIntervalInHours": 720,
        "backupStorageRedundancy": "Local"
      }
    },
    "networkAclBypass": "AzureServices",
    "networkAclBypassResourceIds": [
      "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
    ],
    "capacity": {
      "totalThroughputLimit": 2000
    },
    "enablePartitionMerge": true,
    "minimalTlsVersion": "Tls"
  }
}


import com.azure.resourcemanager.cosmos.models.AnalyticalStorageConfiguration;
import com.azure.resourcemanager.cosmos.models.AnalyticalStorageSchemaType;
import com.azure.resourcemanager.cosmos.models.BackupStorageRedundancy;
import com.azure.resourcemanager.cosmos.models.Capacity;
import com.azure.resourcemanager.cosmos.models.ConsistencyPolicy;
import com.azure.resourcemanager.cosmos.models.DatabaseAccountUpdateParameters;
import com.azure.resourcemanager.cosmos.models.DefaultConsistencyLevel;
import com.azure.resourcemanager.cosmos.models.IpAddressOrRange;
import com.azure.resourcemanager.cosmos.models.ManagedServiceIdentity;
import com.azure.resourcemanager.cosmos.models.ManagedServiceIdentityUserAssignedIdentities;
import com.azure.resourcemanager.cosmos.models.MinimalTlsVersion;
import com.azure.resourcemanager.cosmos.models.NetworkAclBypass;
import com.azure.resourcemanager.cosmos.models.PeriodicModeBackupPolicy;
import com.azure.resourcemanager.cosmos.models.PeriodicModeProperties;
import com.azure.resourcemanager.cosmos.models.ResourceIdentityType;
import com.azure.resourcemanager.cosmos.models.VirtualNetworkRule;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DatabaseAccounts Update.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2024-11-15/examples/
     * CosmosDBDatabaseAccountPatch.json
     */
    /**
     * Sample code: CosmosDBDatabaseAccountPatch.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void cosmosDBDatabaseAccountPatch(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cosmosDBAccounts().manager().serviceClient().getDatabaseAccounts().update("rg1", "ddb1",
            new DatabaseAccountUpdateParameters().withTags(mapOf("dept", "finance")).withLocation("westus")
                .withIdentity(new ManagedServiceIdentity().withType(ResourceIdentityType.SYSTEM_ASSIGNED_USER_ASSIGNED)
                    .withUserAssignedIdentities(mapOf(
                        "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
                        new ManagedServiceIdentityUserAssignedIdentities())))
                .withConsistencyPolicy(
                    new ConsistencyPolicy().withDefaultConsistencyLevel(DefaultConsistencyLevel.BOUNDED_STALENESS)
                        .withMaxStalenessPrefix(200L).withMaxIntervalInSeconds(10))
                .withIpRules(Arrays.asList(new IpAddressOrRange().withIpAddressOrRange("23.43.230.120"),
                    new IpAddressOrRange().withIpAddressOrRange("110.12.240.0/12")))
                .withIsVirtualNetworkFilterEnabled(true)
                .withVirtualNetworkRules(Arrays.asList(new VirtualNetworkRule().withId(
                    "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1")
                    .withIgnoreMissingVNetServiceEndpoint(false)))
                .withDefaultIdentity("FirstPartyIdentity").withEnableFreeTier(false).withEnableAnalyticalStorage(true)
                .withAnalyticalStorageConfiguration(
                    new AnalyticalStorageConfiguration().withSchemaType(AnalyticalStorageSchemaType.WELL_DEFINED))
                .withBackupPolicy(new PeriodicModeBackupPolicy().withPeriodicModeProperties(new PeriodicModeProperties()
                    .withBackupIntervalInMinutes(240).withBackupRetentionIntervalInHours(720)
                    .withBackupStorageRedundancy(BackupStorageRedundancy.LOCAL)))
                .withNetworkAclBypass(NetworkAclBypass.AZURE_SERVICES)
                .withNetworkAclBypassResourceIds(Arrays.asList(
                    "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"))
                .withCapacity(new Capacity().withTotalThroughputLimit(2000)).withEnablePartitionMerge(true)
                .withMinimalTlsVersion(MinimalTlsVersion.TLS).withEnableBurstCapacity(true)
                .withEnablePerRegionPerPartitionAutoscale(true),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.cosmosdb import CosmosDBManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cosmosdb
# USAGE
    python cosmos_db_database_account_patch.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CosmosDBManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.database_accounts.begin_update(
        resource_group_name="rg1",
        account_name="ddb1",
        update_parameters={
            "identity": {
                "type": "SystemAssigned,UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
                },
            },
            "location": "westus",
            "properties": {
                "analyticalStorageConfiguration": {"schemaType": "WellDefined"},
                "backupPolicy": {
                    "periodicModeProperties": {
                        "backupIntervalInMinutes": 240,
                        "backupRetentionIntervalInHours": 720,
                        "backupStorageRedundancy": "Local",
                    },
                    "type": "Periodic",
                },
                "capacity": {"totalThroughputLimit": 2000},
                "consistencyPolicy": {
                    "defaultConsistencyLevel": "BoundedStaleness",
                    "maxIntervalInSeconds": 10,
                    "maxStalenessPrefix": 200,
                },
                "defaultIdentity": "FirstPartyIdentity",
                "enableAnalyticalStorage": True,
                "enableBurstCapacity": True,
                "enableFreeTier": False,
                "enablePartitionMerge": True,
                "enablePerRegionPerPartitionAutoscale": True,
                "ipRules": [{"ipAddressOrRange": "23.43.230.120"}, {"ipAddressOrRange": "110.12.240.0/12"}],
                "isVirtualNetworkFilterEnabled": True,
                "minimalTlsVersion": "Tls",
                "networkAclBypass": "AzureServices",
                "networkAclBypassResourceIds": [
                    "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
                ],
                "virtualNetworkRules": [
                    {
                        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
                        "ignoreMissingVNetServiceEndpoint": False,
                    }
                ],
            },
            "tags": {"dept": "finance"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2024-11-15/examples/CosmosDBDatabaseAccountPatch.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcosmos_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cosmos/armcosmos/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ded6306d00ae294c24211e5069c1f56b15ba8ef5/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2024-11-15/examples/CosmosDBDatabaseAccountPatch.json
func ExampleDatabaseAccountsClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcosmos.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDatabaseAccountsClient().BeginUpdate(ctx, "rg1", "ddb1", armcosmos.DatabaseAccountUpdateParameters{
		Identity: &armcosmos.ManagedServiceIdentity{
			Type: to.Ptr(armcosmos.ResourceIdentityTypeSystemAssignedUserAssigned),
			UserAssignedIdentities: map[string]*armcosmos.Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties{
				"/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
			},
		},
		Location: to.Ptr("westus"),
		Properties: &armcosmos.DatabaseAccountUpdateProperties{
			AnalyticalStorageConfiguration: &armcosmos.AnalyticalStorageConfiguration{
				SchemaType: to.Ptr(armcosmos.AnalyticalStorageSchemaTypeWellDefined),
			},
			BackupPolicy: &armcosmos.PeriodicModeBackupPolicy{
				Type: to.Ptr(armcosmos.BackupPolicyTypePeriodic),
				PeriodicModeProperties: &armcosmos.PeriodicModeProperties{
					BackupIntervalInMinutes:        to.Ptr[int32](240),
					BackupRetentionIntervalInHours: to.Ptr[int32](720),
					BackupStorageRedundancy:        to.Ptr(armcosmos.BackupStorageRedundancyLocal),
				},
			},
			Capacity: &armcosmos.Capacity{
				TotalThroughputLimit: to.Ptr[int32](2000),
			},
			ConsistencyPolicy: &armcosmos.ConsistencyPolicy{
				DefaultConsistencyLevel: to.Ptr(armcosmos.DefaultConsistencyLevelBoundedStaleness),
				MaxIntervalInSeconds:    to.Ptr[int32](10),
				MaxStalenessPrefix:      to.Ptr[int64](200),
			},
			DefaultIdentity:                      to.Ptr("FirstPartyIdentity"),
			EnableAnalyticalStorage:              to.Ptr(true),
			EnableBurstCapacity:                  to.Ptr(true),
			EnableFreeTier:                       to.Ptr(false),
			EnablePartitionMerge:                 to.Ptr(true),
			EnablePerRegionPerPartitionAutoscale: to.Ptr(true),
			IPRules: []*armcosmos.IPAddressOrRange{
				{
					IPAddressOrRange: to.Ptr("23.43.230.120"),
				},
				{
					IPAddressOrRange: to.Ptr("110.12.240.0/12"),
				}},
			IsVirtualNetworkFilterEnabled: to.Ptr(true),
			MinimalTLSVersion:             to.Ptr(armcosmos.MinimalTLSVersionTLS),
			NetworkACLBypass:              to.Ptr(armcosmos.NetworkACLBypassAzureServices),
			NetworkACLBypassResourceIDs: []*string{
				to.Ptr("/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName")},
			VirtualNetworkRules: []*armcosmos.VirtualNetworkRule{
				{
					ID:                               to.Ptr("/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
					IgnoreMissingVNetServiceEndpoint: to.Ptr(false),
				}},
		},
		Tags: map[string]*string{
			"dept": to.Ptr("finance"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DatabaseAccountGetResults = armcosmos.DatabaseAccountGetResults{
	// 	Name: to.Ptr("ddb1"),
	// 	Type: to.Ptr("Microsoft.DocumentDB/databaseAccounts"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"dept": to.Ptr("finance"),
	// 	},
	// 	Identity: &armcosmos.ManagedServiceIdentity{
	// 		Type: to.Ptr(armcosmos.ResourceIdentityTypeSystemAssignedUserAssigned),
	// 		PrincipalID: to.Ptr("52f4fef3-3c3f-4ff3-b52e-b5c9eeb68656"),
	// 		TenantID: to.Ptr("33e01921-4d64-4f8c-a055-5bdaffd5e33d"),
	// 		UserAssignedIdentities: map[string]*armcosmos.Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 			"/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": &armcosmos.Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties{
	// 				ClientID: to.Ptr("fbe75b66-01c5-4f87-a220-233af3270436"),
	// 				PrincipalID: to.Ptr("33e01921-4d64-4f8c-a055-5bdaffd5e33d"),
	// 			},
	// 		},
	// 	},
	// 	Kind: to.Ptr(armcosmos.DatabaseAccountKindGlobalDocumentDB),
	// 	Properties: &armcosmos.DatabaseAccountGetProperties{
	// 		AnalyticalStorageConfiguration: &armcosmos.AnalyticalStorageConfiguration{
	// 			SchemaType: to.Ptr(armcosmos.AnalyticalStorageSchemaTypeWellDefined),
	// 		},
	// 		APIProperties: &armcosmos.APIProperties{
	// 		},
	// 		BackupPolicy: &armcosmos.PeriodicModeBackupPolicy{
	// 			Type: to.Ptr(armcosmos.BackupPolicyTypePeriodic),
	// 			PeriodicModeProperties: &armcosmos.PeriodicModeProperties{
	// 				BackupIntervalInMinutes: to.Ptr[int32](240),
	// 				BackupRetentionIntervalInHours: to.Ptr[int32](720),
	// 				BackupStorageRedundancy: to.Ptr(armcosmos.BackupStorageRedundancyLocal),
	// 			},
	// 		},
	// 		Capacity: &armcosmos.Capacity{
	// 			TotalThroughputLimit: to.Ptr[int32](2000),
	// 		},
	// 		ConsistencyPolicy: &armcosmos.ConsistencyPolicy{
	// 			DefaultConsistencyLevel: to.Ptr(armcosmos.DefaultConsistencyLevelBoundedStaleness),
	// 			MaxIntervalInSeconds: to.Ptr[int32](10),
	// 			MaxStalenessPrefix: to.Ptr[int64](200),
	// 		},
	// 		Cors: []*armcosmos.CorsPolicy{
	// 		},
	// 		DatabaseAccountOfferType: to.Ptr("Standard"),
	// 		DefaultIdentity: to.Ptr("FirstPartyIdentity"),
	// 		DisableKeyBasedMetadataWriteAccess: to.Ptr(false),
	// 		DocumentEndpoint: to.Ptr("https://ddb1.documents.azure.com:443/"),
	// 		EnableAnalyticalStorage: to.Ptr(true),
	// 		EnableBurstCapacity: to.Ptr(true),
	// 		EnableFreeTier: to.Ptr(false),
	// 		EnablePartitionMerge: to.Ptr(true),
	// 		FailoverPolicies: []*armcosmos.FailoverPolicy{
	// 			{
	// 				FailoverPriority: to.Ptr[int32](0),
	// 				ID: to.Ptr("ddb1-eastus"),
	// 				LocationName: to.Ptr("East US"),
	// 		}},
	// 		IPRules: []*armcosmos.IPAddressOrRange{
	// 			{
	// 				IPAddressOrRange: to.Ptr("23.43.230.120"),
	// 			},
	// 			{
	// 				IPAddressOrRange: to.Ptr("110.12.240.0/12"),
	// 		}},
	// 		IsVirtualNetworkFilterEnabled: to.Ptr(true),
	// 		KeysMetadata: &armcosmos.DatabaseAccountKeysMetadata{
	// 			PrimaryMasterKey: &armcosmos.AccountKeyMetadata{
	// 				GenerationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-02-25T20:30:11.000Z"); return t}()),
	// 			},
	// 			PrimaryReadonlyMasterKey: &armcosmos.AccountKeyMetadata{
	// 				GenerationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-02-25T20:30:11.000Z"); return t}()),
	// 			},
	// 			SecondaryMasterKey: &armcosmos.AccountKeyMetadata{
	// 				GenerationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-02-25T20:30:11.000Z"); return t}()),
	// 			},
	// 			SecondaryReadonlyMasterKey: &armcosmos.AccountKeyMetadata{
	// 				GenerationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-02-25T20:30:11.000Z"); return t}()),
	// 			},
	// 		},
	// 		Locations: []*armcosmos.Location{
	// 			{
	// 				DocumentEndpoint: to.Ptr("https://ddb1-eastus.documents.azure.com:443/"),
	// 				FailoverPriority: to.Ptr[int32](0),
	// 				ID: to.Ptr("ddb1-eastus"),
	// 				LocationName: to.Ptr("East US"),
	// 				ProvisioningState: to.Ptr("Succeeded"),
	// 		}},
	// 		MinimalTLSVersion: to.Ptr(armcosmos.MinimalTLSVersionTLS),
	// 		NetworkACLBypass: to.Ptr(armcosmos.NetworkACLBypassAzureServices),
	// 		NetworkACLBypassResourceIDs: []*string{
	// 			to.Ptr("/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName")},
	// 			PrivateEndpointConnections: []*armcosmos.PrivateEndpointConnection{
	// 				{
	// 					ID: to.Ptr("/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1"),
	// 					Properties: &armcosmos.PrivateEndpointConnectionProperties{
	// 						PrivateEndpoint: &armcosmos.PrivateEndpointProperty{
	// 							ID: to.Ptr("/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"),
	// 						},
	// 						PrivateLinkServiceConnectionState: &armcosmos.PrivateLinkServiceConnectionStateProperty{
	// 							ActionsRequired: to.Ptr("None"),
	// 							Status: to.Ptr("Approved"),
	// 						},
	// 					},
	// 			}},
	// 			ProvisioningState: to.Ptr("Succeeded"),
	// 			ReadLocations: []*armcosmos.Location{
	// 				{
	// 					DocumentEndpoint: to.Ptr("https://ddb1-eastus.documents.azure.com:443/"),
	// 					FailoverPriority: to.Ptr[int32](0),
	// 					ID: to.Ptr("ddb1-eastus"),
	// 					LocationName: to.Ptr("East US"),
	// 					ProvisioningState: to.Ptr("Succeeded"),
	// 			}},
	// 			VirtualNetworkRules: []*armcosmos.VirtualNetworkRule{
	// 				{
	// 					ID: to.Ptr("/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"),
	// 					IgnoreMissingVNetServiceEndpoint: to.Ptr(false),
	// 			}},
	// 			WriteLocations: []*armcosmos.Location{
	// 				{
	// 					DocumentEndpoint: to.Ptr("https://ddb1-eastus.documents.azure.com:443/"),
	// 					FailoverPriority: to.Ptr[int32](0),
	// 					ID: to.Ptr("ddb1-eastus"),
	// 					LocationName: to.Ptr("East US"),
	// 					ProvisioningState: to.Ptr("Succeeded"),
	// 			}},
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { CosmosDBManagementClient } = require("@azure/arm-cosmosdb");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates the properties of an existing Azure Cosmos DB database account.
 *
 * @summary Updates the properties of an existing Azure Cosmos DB database account.
 * x-ms-original-file: specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2024-11-15/examples/CosmosDBDatabaseAccountPatch.json
 */
async function cosmosDbDatabaseAccountPatch() {
  const subscriptionId = process.env["COSMOSDB_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["COSMOSDB_RESOURCE_GROUP"] || "rg1";
  const accountName = "ddb1";
  const updateParameters = {
    analyticalStorageConfiguration: { schemaType: "WellDefined" },
    backupPolicy: {
      type: "Periodic",
      periodicModeProperties: {
        backupIntervalInMinutes: 240,
        backupRetentionIntervalInHours: 720,
        backupStorageRedundancy: "Local",
      },
    },
    capacity: { totalThroughputLimit: 2000 },
    consistencyPolicy: {
      defaultConsistencyLevel: "BoundedStaleness",
      maxIntervalInSeconds: 10,
      maxStalenessPrefix: 200,
    },
    defaultIdentity: "FirstPartyIdentity",
    enableAnalyticalStorage: true,
    enableBurstCapacity: true,
    enableFreeTier: false,
    enablePartitionMerge: true,
    enablePerRegionPerPartitionAutoscale: true,
    identity: {
      type: "SystemAssigned,UserAssigned",
      userAssignedIdentities: {
        "/subscriptions/fa5fc227A624475eB696Cdd604c735bc/resourceGroups/eu2cgroup/providers/MicrosoftManagedIdentity/userAssignedIdentities/id1":
          {},
      },
    },
    ipRules: [{ ipAddressOrRange: "23.43.230.120" }, { ipAddressOrRange: "110.12.240.0/12" }],
    isVirtualNetworkFilterEnabled: true,
    location: "westus",
    minimalTlsVersion: "Tls",
    networkAclBypass: "AzureServices",
    networkAclBypassResourceIds: [
      "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName",
    ],
    tags: { dept: "finance" },
    virtualNetworkRules: [
      {
        id: "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        ignoreMissingVNetServiceEndpoint: false,
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new CosmosDBManagementClient(credential, subscriptionId);
  const result = await client.databaseAccounts.beginUpdateAndWait(
    resourceGroupName,
    accountName,
    updateParameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
  "name": "ddb1",
  "location": "West US",
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "kind": "GlobalDocumentDB",
  "tags": {
    "dept": "finance"
  },
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "principalId": "52f4fef3-3c3f-4ff3-b52e-b5c9eeb68656",
    "tenantId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d",
    "userAssignedIdentities": {
      "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
        "principalId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d"
      }
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "documentEndpoint": "https://ddb1.documents.azure.com:443/",
    "databaseAccountOfferType": "Standard",
    "ipRules": [
      {
        "ipAddressOrRange": "23.43.230.120"
      },
      {
        "ipAddressOrRange": "110.12.240.0/12"
      }
    ],
    "isVirtualNetworkFilterEnabled": true,
    "disableKeyBasedMetadataWriteAccess": false,
    "consistencyPolicy": {
      "defaultConsistencyLevel": "BoundedStaleness",
      "maxIntervalInSeconds": 10,
      "maxStalenessPrefix": 200
    },
    "writeLocations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "readLocations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "locations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "failoverPolicies": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "failoverPriority": 0
      }
    ],
    "virtualNetworkRules": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "ignoreMissingVNetServiceEndpoint": false
      }
    ],
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
        "properties": {
          "privateEndpoint": {
            "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "actionsRequired": "None"
          }
        }
      }
    ],
    "cors": [],
    "defaultIdentity": "FirstPartyIdentity",
    "enableFreeTier": false,
    "apiProperties": {},
    "enableAnalyticalStorage": true,
    "enableBurstCapacity": true,
    "analyticalStorageConfiguration": {
      "schemaType": "WellDefined"
    },
    "backupPolicy": {
      "type": "Periodic",
      "periodicModeProperties": {
        "backupIntervalInMinutes": 240,
        "backupRetentionIntervalInHours": 720,
        "backupStorageRedundancy": "Local"
      }
    },
    "networkAclBypass": "AzureServices",
    "networkAclBypassResourceIds": [
      "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
    ],
    "capacity": {
      "totalThroughputLimit": 2000
    },
    "keysMetadata": {
      "primaryMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "secondaryMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "primaryReadonlyMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "secondaryReadonlyMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      }
    },
    "enablePartitionMerge": true,
    "minimalTlsVersion": "Tls"
  }
}

Definizioni

Nome	Descrizione
AccountKeyMetadata	Metadati correlati a una chiave di accesso per un determinato account di database.
AnalyticalStorageConfiguration	Proprietà specifiche dell'archiviazione analitica.
AnalyticalStorageSchemaType	Descrive i tipi di schema per l'archiviazione analitica.
ApiProperties
BackupPolicyMigrationState	Oggetto che rappresenta lo stato della migrazione tra i criteri di backup.
BackupPolicyMigrationStatus	Descrive lo stato della migrazione tra i tipi di criteri di backup.
BackupPolicyType	Descrive la modalità di backup.
BackupStorageRedundancy	Enumerazione per indicare il tipo di ridondanza dell'archiviazione di backup.
Capability	Oggetto funzionalità di Cosmos DB
Capacity	Oggetto che rappresenta tutte le proprietà correlate all'imposizione della capacità in un account.
ConnectorOffer	Tipo di offerta del connettore cassandra per l'account di database C* di Cosmos DB.
ConsistencyPolicy	Criteri di coerenza per l'account del database Cosmos DB.
ContinuousModeBackupPolicy	Oggetto che rappresenta i criteri di backup in modalità continua.
ContinuousModeProperties	Valori di configurazione per il backup in modalità periodica
ContinuousTier	Enumerazione per indicare il tipo di livello di backup continuo.
CorsPolicy	Criteri CORS per l'account del database Cosmos DB.
createdByType	Tipo di identità che ha creato la risorsa.
CreateMode	Enumerazione per indicare la modalità di creazione dell'account.
DatabaseAccountGetResults	Un account del database Azure Cosmos DB.
DatabaseAccountKeysMetadata	Metadati correlati a ogni chiave di accesso per l'account del database Cosmos DB specificato.
DatabaseAccountKind	Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database.
DatabaseAccountOfferType	Tipo di offerta per l'account del database Cosmos DB.
DatabaseAccountUpdateParameters	Parametri per l'applicazione di patch alle proprietà dell'account del database Azure Cosmos DB.
DatabaseRestoreResource	Database specifici da ripristinare.
DefaultConsistencyLevel	Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB.
FailoverPolicy	Criteri di failover per una determinata area di un account di database.
GremlinDatabaseRestoreResource	Database Gremlin specifici da ripristinare.
IpAddressOrRange	Oggetto IpAddressOrRange
Location	Area in cui viene distribuito l'account del database Azure Cosmos DB.
ManagedServiceIdentity	Identità per la risorsa.
MinimalTlsVersion	Indica la versione minima consentita di Tls. Il valore predefinito è Tls 1.2. Le API Cassandra e Mongo funzionano solo con Tls 1.2.
NetworkAclBypass	Indica quali servizi sono autorizzati a ignorare i controlli del firewall.
PeriodicModeBackupPolicy	Oggetto che rappresenta criteri di backup in modalità periodica.
PeriodicModeProperties	Valori di configurazione per il backup in modalità periodica
PrivateEndpointConnection	Una connessione endpoint privato
PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
PrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
PublicNetworkAccess	Indica se le richieste dalla rete pubblica sono consentite
ResourceIdentityType	Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.
RestoreMode	Descrive la modalità di ripristino.
RestoreParameters	Parametri per indicare le informazioni sul ripristino.
ServerVersion	Descrive la versione dell'account MongoDB.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentities	Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
VirtualNetworkRule	Oggetto Regola ACL di rete virtuale

AccountKeyMetadata

Metadati correlati a una chiave di accesso per un determinato account di database.

Nome	Tipo	Descrizione
generationTime	string	Ora di generazione in formato UTC della chiave in formato ISO-8601. Se il valore manca dall'oggetto, significa che l'ultima rigenerazione della chiave è stata attivata prima del 2022-06-18.

AnalyticalStorageConfiguration

Proprietà specifiche dell'archiviazione analitica.

Nome	Tipo	Descrizione
schemaType	AnalyticalStorageSchemaType	Descrive i tipi di schema per l'archiviazione analitica.

AnalyticalStorageSchemaType

Descrive i tipi di schema per l'archiviazione analitica.

Nome	Tipo	Descrizione
FullFidelity	string
WellDefined	string

ApiProperties

Nome	Tipo	Descrizione
serverVersion	ServerVersion	Descrive la versione dell'account MongoDB.

BackupPolicyMigrationState

Oggetto che rappresenta lo stato della migrazione tra i criteri di backup.

Nome	Tipo	Descrizione
startTime	string	Ora di avvio della migrazione dei criteri di backup (formato ISO-8601).
status	BackupPolicyMigrationStatus	Descrive lo stato della migrazione tra i tipi di criteri di backup.
targetType	BackupPolicyType	Descrive il tipo di criteri di backup di destinazione della migrazione dei criteri di backup.

BackupPolicyMigrationStatus

Descrive lo stato della migrazione tra i tipi di criteri di backup.

Nome	Tipo	Descrizione
Completed	string
Failed	string
InProgress	string
Invalid	string

BackupPolicyType

Descrive la modalità di backup.

Nome	Tipo	Descrizione
Continuous	string
Periodic	string

BackupStorageRedundancy

Enumerazione per indicare il tipo di ridondanza dell'archiviazione di backup.

Nome	Tipo	Descrizione
Geo	string
Local	string
Zone	string

Capability

Oggetto funzionalità di Cosmos DB

Nome	Tipo	Descrizione
name	string	Nome della funzionalità di Cosmos DB. Ad esempio, "name": "EnableCassandra". I valori correnti includono anche "EnableTable" e "EnableGremlin".

Capacity

Oggetto che rappresenta tutte le proprietà correlate all'imposizione della capacità in un account.

Nome	Tipo	Descrizione
totalThroughputLimit	integer	Limite totale di velocità effettiva imposto all'account. Un totaleThroughputLimit di 2000 impone un limite rigoroso di velocità effettiva massima di cui è possibile effettuare il provisioning su tale account per essere 2000. Un totaleThroughputLimit di -1 indica che non sono previsti limiti al provisioning della velocità effettiva.

ConnectorOffer

Tipo di offerta del connettore cassandra per l'account di database C* di Cosmos DB.

Nome	Tipo	Descrizione
Small	string

ConsistencyPolicy

Criteri di coerenza per l'account del database Cosmos DB.

Nome	Tipo	Descrizione
defaultConsistencyLevel	DefaultConsistencyLevel	Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB.
maxIntervalInSeconds	integer	Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta la quantità di tempo di decadimento (in secondi) tollerata. L'intervallo accettato per questo valore è 5 - 86400. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness".
maxStalenessPrefix	integer	Se usato con il livello di coerenza decadimento ristretto, questo valore rappresenta il numero di richieste non aggiornati tollerate. L'intervallo accettato per questo valore è 1 - 2.147.483.647. Obbligatorio quando defaultConsistencyPolicy è impostato su "BoundedStaleness".

ContinuousModeBackupPolicy

Oggetto che rappresenta i criteri di backup in modalità continua.

Nome	Tipo	Descrizione
continuousModeProperties	ContinuousModeProperties	Valori di configurazione per il backup in modalità continua
migrationState	BackupPolicyMigrationState	Oggetto che rappresenta lo stato della migrazione tra i criteri di backup.
type	string: Continuous	Descrive la modalità di backup.

ContinuousModeProperties

Valori di configurazione per il backup in modalità periodica

Nome	Tipo	Descrizione
tier	ContinuousTier	Enumerazione per indicare il tipo di modalità di backup continuo

ContinuousTier

Enumerazione per indicare il tipo di livello di backup continuo.

Nome	Tipo	Descrizione
Continuous30Days	string
Continuous7Days	string

CorsPolicy

Criteri CORS per l'account del database Cosmos DB.

Nome	Tipo	Descrizione
allowedHeaders	string	Intestazioni di richiesta che il dominio di origine può specificare nella richiesta CORS.
allowedMethods	string	I metodi (verbi di richiesta HTTP) che il dominio di origine può usare per una richiesta CORS.
allowedOrigins	string	Domini di origine autorizzati a effettuare una richiesta al servizio tramite CORS.
exposedHeaders	string	Intestazioni di risposta che possono essere inviate nella risposta alla richiesta CORS ed esposte dal browser all'emittente della richiesta.
maxAgeInSeconds	integer	Periodo massimo di tempo in cui un browser deve memorizzare nella cache la richiesta OPTIONS preliminare.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CreateMode

Enumerazione per indicare la modalità di creazione dell'account.

Nome	Tipo	Descrizione
Default	string
Restore	string

DatabaseAccountGetResults

Un account del database Azure Cosmos DB.

Nome	Tipo	Valore predefinito	Descrizione
id	string		Identificatore univoco della risorsa arm.
identity	ManagedServiceIdentity		Identità per la risorsa.
kind	DatabaseAccountKind	GlobalDocumentDB	Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database.
location	string		Posizione del gruppo di risorse a cui appartiene la risorsa.
name	string		Nome della risorsa arm.
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration		Proprietà specifiche dell'archiviazione analitica.
properties.apiProperties	ApiProperties		Proprietà specifiche dell'API.
properties.backupPolicy	BackupPolicy: ContinuousModeBackupPolicy PeriodicModeBackupPolicy		Oggetto che rappresenta i criteri per l'esecuzione di backup in un account.
properties.capabilities	Capability[]		Elenco delle funzionalità di Cosmos DB per l'account
properties.capacity	Capacity		Oggetto che rappresenta tutte le proprietà correlate all'imposizione della capacità in un account.
properties.connectorOffer	ConnectorOffer		Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB.
properties.consistencyPolicy	ConsistencyPolicy		Criteri di coerenza per l'account del database Cosmos DB.
properties.cors	CorsPolicy[]		Criteri CORS per l'account del database Cosmos DB.
properties.createMode	CreateMode	Default	Enumerazione per indicare la modalità di creazione dell'account.
properties.customerManagedKeyStatus	string		Indica lo stato della funzionalità Chiave gestita dal cliente nell'account. In caso di errori, la proprietà fornisce indicazioni per la risoluzione dei problemi.
properties.databaseAccountOfferType	DatabaseAccountOfferType		Tipo di offerta per l'account del database Cosmos DB. Valore predefinito: Standard.
properties.defaultIdentity	string		Identità predefinita per l'accesso all'insieme di credenziali delle chiavi usato nelle funzionalità come le chiavi gestite dal cliente. L'identità predefinita deve essere impostata in modo esplicito dagli utenti. Può essere "FirstPartyIdentity", "SystemAssignedIdentity" e altro ancora.
properties.disableKeyBasedMetadataWriteAccess	boolean		Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account
properties.disableLocalAuth	boolean		Rifiutare esplicitamente l'autenticazione locale e assicurarsi che solo MSI e AAD possano essere usati esclusivamente per l'autenticazione.
properties.documentEndpoint	string		Endpoint di connessione per l'account del database Cosmos DB.
properties.enableAnalyticalStorage	boolean		Flag per indicare se abilitare l'analisi dell'archiviazione.
properties.enableAutomaticFailover	boolean		Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account.
properties.enableBurstCapacity	boolean		Flag per indicare l'abilitazione/disabilitazione della funzionalità Capacità burst nell'account
properties.enableCassandraConnector	boolean		Abilita il connettore cassandra nell'account C* di Cosmos DB
properties.enableFreeTier	boolean		Flag per indicare se il livello gratuito è abilitato.
properties.enableMultipleWriteLocations	boolean		Consente all'account di scrivere in più posizioni
properties.enablePartitionMerge	boolean		Flag per indicare l'abilitazione/disabilitazione della funzionalità di merge partizione nell'account
properties.enablePerRegionPerPartitionAutoscale	boolean		Flag per indicare l'abilitazione/disabilitazione della funzionalità PerRegionPerPartitionAutoscale nell'account
properties.failoverPolicies	FailoverPolicy[]		Matrice che contiene le aree ordinate in base alle priorità di failover.
properties.instanceId	string		Identificatore univoco assegnato all'account del database
properties.ipRules	IpAddressOrRange[]		Elenco di IpRules.
properties.isVirtualNetworkFilterEnabled	boolean		Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale.
properties.keyVaultKeyUri	string		URI dell'insieme di credenziali delle chiavi
properties.keysMetadata	DatabaseAccountKeysMetadata		Oggetto che rappresenta i metadati per le chiavi dell'account Cosmos DB.
properties.locations	Location[]		Matrice che contiene tutte le posizioni abilitate per l'account Cosmos DB.
properties.minimalTlsVersion	MinimalTlsVersion		Indica la versione minima consentita di Tls. Il valore predefinito è Tls 1.2. Le API Cassandra e Mongo funzionano solo con Tls 1.2.
properties.networkAclBypass	NetworkAclBypass		Indica quali servizi sono autorizzati a ignorare i controlli del firewall.
properties.networkAclBypassResourceIds	string[]		Matrice che contiene gli ID risorsa per il bypass Acl di rete per l'account Cosmos DB.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco delle connessioni endpoint private configurate per l'account Cosmos DB.
properties.provisioningState	string		Stato dell'account Cosmos DB al momento della chiamata dell'operazione. Lo stato può essere uno dei seguenti. 'Creazione': viene creato l'account Cosmos DB. Quando un account è in Stato di creazione, vengono restituite solo le proprietà specificate come input per l'operazione Crea account Cosmos DB. 'Succeeded': l'account Cosmos DB è attivo per l'uso. 'Aggiornamento': l'account Cosmos DB viene aggiornato. 'Eliminazione': l'account Cosmos DB viene eliminato. 'Failed': creazione dell'account Cosmos DB non riuscita. 'DeletionFailed': l'eliminazione dell'account Cosmos DB non è riuscita.
properties.publicNetworkAccess	PublicNetworkAccess		Indica se le richieste dalla rete pubblica sono consentite
properties.readLocations	Location[]		Matrice che contiene i percorsi di lettura abilitati per l'account Cosmos DB.
properties.restoreParameters	RestoreParameters		Parametri per indicare le informazioni sul ripristino.
properties.virtualNetworkRules	VirtualNetworkRule[]		Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB.
properties.writeLocations	Location[]		Matrice che contiene il percorso di scrittura per l'account Cosmos DB.
systemData	systemData		Metadati di sistema relativi a questa risorsa.
tags	object		I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere usati per visualizzare e raggruppare questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non maggiore di 128 caratteri e un valore non maggiore di 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".
type	string		Tipo di risorsa di Azure.

DatabaseAccountKeysMetadata

Metadati correlati a ogni chiave di accesso per l'account del database Cosmos DB specificato.

Nome	Tipo	Descrizione
primaryMasterKey	AccountKeyMetadata	Metadati correlati alla chiave Read-Write primaria per l'account del database Cosmos DB specificato.
primaryReadonlyMasterKey	AccountKeyMetadata	Metadati correlati alla chiave Read-Only primaria per l'account del database Cosmos DB specificato.
secondaryMasterKey	AccountKeyMetadata	Metadati correlati alla chiave di Read-Write secondaria per l'account del database Cosmos DB specificato.
secondaryReadonlyMasterKey	AccountKeyMetadata	Metadati correlati alla chiave di Read-Only secondaria per l'account del database Cosmos DB specificato.

DatabaseAccountKind

Indica il tipo di account di database. Questa impostazione può essere impostata solo durante la creazione dell'account di database.

Nome	Tipo	Descrizione
GlobalDocumentDB	string
MongoDB	string
Parse	string

DatabaseAccountOfferType

Tipo di offerta per l'account del database Cosmos DB.

Nome	Tipo	Descrizione
Standard	string

DatabaseAccountUpdateParameters

Parametri per l'applicazione di patch alle proprietà dell'account del database Azure Cosmos DB.

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità per la risorsa.
location	string	Posizione del gruppo di risorse a cui appartiene la risorsa.
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration	Proprietà specifiche dell'archiviazione analitica.
properties.apiProperties	ApiProperties	Proprietà specifiche dell'API. Attualmente, supportato solo per l'API MongoDB.
properties.backupPolicy	BackupPolicy: ContinuousModeBackupPolicy PeriodicModeBackupPolicy	Oggetto che rappresenta i criteri per l'esecuzione di backup in un account.
properties.capabilities	Capability[]	Elenco delle funzionalità di Cosmos DB per l'account
properties.capacity	Capacity	Oggetto che rappresenta tutte le proprietà correlate all'imposizione della capacità in un account.
properties.connectorOffer	ConnectorOffer	Tipo di offerta del connettore cassandra per l'account C* del database Cosmos DB.
properties.consistencyPolicy	ConsistencyPolicy	Criteri di coerenza per l'account Cosmos DB.
properties.cors	CorsPolicy[]	Criteri CORS per l'account del database Cosmos DB.
properties.customerManagedKeyStatus	string	Indica lo stato della funzionalità Chiave gestita dal cliente nell'account. In caso di errori, la proprietà fornisce indicazioni per la risoluzione dei problemi.
properties.defaultIdentity	string	Identità predefinita per l'accesso all'insieme di credenziali delle chiavi usato nelle funzionalità come le chiavi gestite dal cliente. L'identità predefinita deve essere impostata in modo esplicito dagli utenti. Può essere "FirstPartyIdentity", "SystemAssignedIdentity" e altro ancora.
properties.disableKeyBasedMetadataWriteAccess	boolean	Disabilitare le operazioni di scrittura sulle risorse dei metadati (database, contenitori, velocità effettiva) tramite chiavi dell'account
properties.disableLocalAuth	boolean	Rifiutare esplicitamente l'autenticazione locale e assicurarsi che solo MSI e AAD possano essere usati esclusivamente per l'autenticazione.
properties.enableAnalyticalStorage	boolean	Flag per indicare se abilitare l'analisi dell'archiviazione.
properties.enableAutomaticFailover	boolean	Abilita il failover automatico dell'area di scrittura nel raro caso in cui l'area non sia disponibile a causa di un'interruzione del servizio. Il failover automatico comporterà una nuova area di scrittura per l'account e viene scelta in base alle priorità di failover configurate per l'account.
properties.enableBurstCapacity	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità Capacità burst nell'account
properties.enableCassandraConnector	boolean	Abilita il connettore cassandra nell'account C* di Cosmos DB
properties.enableFreeTier	boolean	Flag per indicare se il livello gratuito è abilitato.
properties.enableMultipleWriteLocations	boolean	Consente all'account di scrivere in più posizioni
properties.enablePartitionMerge	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità di merge partizione nell'account
properties.enablePerRegionPerPartitionAutoscale	boolean	Flag per indicare l'abilitazione/disabilitazione della funzionalità PerRegionPerPartitionAutoscale nell'account
properties.ipRules	IpAddressOrRange[]	Elenco di IpRules.
properties.isVirtualNetworkFilterEnabled	boolean	Flag per indicare se abilitare o disabilitare le regole ACL di rete virtuale.
properties.keyVaultKeyUri	string	URI dell'insieme di credenziali delle chiavi
properties.keysMetadata	DatabaseAccountKeysMetadata	Questa proprietà viene ignorata durante l'operazione di aggiornamento, perché i metadati sono di sola lettura. L'oggetto rappresenta i metadati per le chiavi account dell'account Cosmos DB.
properties.locations	Location[]	Matrice che contiene le posizioni di replica geografica abilitate per l'account Cosmos DB.
properties.minimalTlsVersion	MinimalTlsVersion	Indica la versione minima consentita di Tls. Il valore predefinito è Tls 1.2. Le API Cassandra e Mongo funzionano solo con Tls 1.2.
properties.networkAclBypass	NetworkAclBypass	Indica quali servizi sono autorizzati a ignorare i controlli del firewall.
properties.networkAclBypassResourceIds	string[]	Matrice che contiene gli ID risorsa per il bypass Acl di rete per l'account Cosmos DB.
properties.publicNetworkAccess	PublicNetworkAccess	Indica se le richieste dalla rete pubblica sono consentite
properties.virtualNetworkRules	VirtualNetworkRule[]	Elenco delle regole ACL di rete virtuale configurate per l'account Cosmos DB.
tags	object	I tag sono un elenco di coppie chiave-valore che descrivono la risorsa. Questi tag possono essere usati per visualizzare e raggruppare questa risorsa (tra gruppi di risorse). È possibile specificare un massimo di 15 tag per una risorsa. Ogni tag deve avere una chiave non maggiore di 128 caratteri e un valore non maggiore di 256 caratteri. Ad esempio, l'esperienza predefinita per un tipo di modello è impostata con "defaultExperience": "Cassandra". I valori correnti "defaultExperience" includono anche "Table", "Graph", "DocumentDB" e "MongoDB".

DatabaseRestoreResource

Database specifici da ripristinare.

Nome	Tipo	Descrizione
collectionNames	string[]	Nomi delle raccolte disponibili per il ripristino.
databaseName	string	Nome del database disponibile per il ripristino.

DefaultConsistencyLevel

Il livello di coerenza predefinito e le impostazioni di configurazione dell'account Cosmos DB.

Nome	Tipo	Descrizione
BoundedStaleness	string
ConsistentPrefix	string
Eventual	string
Session	string
Strong	string

FailoverPolicy

Criteri di failover per una determinata area di un account di database.

Nome	Tipo	Descrizione
failoverPriority	integer	Priorità di failover dell'area. Una priorità di failover pari a 0 indica un'area di scrittura. Valore massimo per una priorità di failover = (numero totale di aree - 1). I valori di priorità di failover devono essere univoci per ognuna delle aree in cui è presente l'account di database.
id	string	Identificatore univoco dell'area in cui viene replicato l'account del database. Esempio: <accountName>-<locationName>.
locationName	string	Nome dell'area in cui è presente l'account del database.

GremlinDatabaseRestoreResource

Database Gremlin specifici da ripristinare.

Nome	Tipo	Descrizione
databaseName	string	Nome del database gremlin disponibile per il ripristino.
graphNames	string[]	Nomi dei grafici disponibili per il ripristino.

IpAddressOrRange

Oggetto IpAddressOrRange

Nome	Tipo	Descrizione
ipAddressOrRange	string	Un singolo indirizzo IPv4 o un singolo intervallo di indirizzi IPv4 in formato CIDR. Gli indirizzi IP forniti devono essere formattati correttamente e non possono essere contenuti in uno degli intervalli seguenti: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0.0/16, perché non sono applicabili dal filtro di indirizzi IP. Esempio di input validi: "23.40.210.245" o "23.40.210.0/8".

Location

Area in cui viene distribuito l'account del database Azure Cosmos DB.

Nome	Tipo	Descrizione
documentEndpoint	string	Endpoint di connessione per l'area specifica. Esempio: https://<accountName>-<locationName>.documents.azure.com:443/
failoverPriority	integer	Priorità di failover dell'area. Una priorità di failover pari a 0 indica un'area di scrittura. Valore massimo per una priorità di failover = (numero totale di aree - 1). I valori di priorità di failover devono essere univoci per ognuna delle aree in cui è presente l'account di database.
id	string	Identificatore univoco dell'area all'interno dell'account del database. Esempio: <accountName>-<locationName>.
isZoneRedundant	boolean	Flag per indicare se questa area è un'area availabilityZone
locationName	string	Nome dell'area.
provisioningState	string	Stato dell'account Cosmos DB al momento della chiamata dell'operazione. Lo stato può essere uno dei seguenti. 'Creazione': viene creato l'account Cosmos DB. Quando un account è in Stato di creazione, vengono restituite solo le proprietà specificate come input per l'operazione Crea account Cosmos DB. 'Succeeded': l'account Cosmos DB è attivo per l'uso. 'Aggiornamento': l'account Cosmos DB viene aggiornato. 'Eliminazione': l'account Cosmos DB viene eliminato. 'Failed': creazione dell'account Cosmos DB non riuscita. 'DeletionFailed': l'eliminazione dell'account Cosmos DB non è riuscita.

ManagedServiceIdentity

Identità per la risorsa.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ResourceIdentityType	Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.
userAssignedIdentities	UserAssignedIdentities	Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

MinimalTlsVersion

Indica la versione minima consentita di Tls. Il valore predefinito è Tls 1.2. Le API Cassandra e Mongo funzionano solo con Tls 1.2.

Nome	Tipo	Descrizione
Tls	string
Tls11	string
Tls12	string

NetworkAclBypass

Indica quali servizi sono autorizzati a ignorare i controlli del firewall.

Nome	Tipo	Descrizione
AzureServices	string
None	string

PeriodicModeBackupPolicy

Oggetto che rappresenta criteri di backup in modalità periodica.

Nome	Tipo	Descrizione
migrationState	BackupPolicyMigrationState	Oggetto che rappresenta lo stato della migrazione tra i criteri di backup.
periodicModeProperties	PeriodicModeProperties	Valori di configurazione per il backup in modalità periodica
type	string: Periodic	Descrive la modalità di backup.

PeriodicModeProperties

Valori di configurazione per il backup in modalità periodica

Nome	Tipo	Descrizione
backupIntervalInMinutes	integer	Intero che rappresenta l'intervallo in minuti tra due backup
backupRetentionIntervalInHours	integer	Intero che rappresenta l'ora (in ore) di conservazione di ogni backup
backupStorageRedundancy	BackupStorageRedundancy	Enumerazione per indicare il tipo di residenza dei backup

PrivateEndpointConnection

Una connessione endpoint privato

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.groupId	string	ID gruppo dell'endpoint privato.
properties.privateEndpoint	PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
properties.provisioningState	string	Stato di provisioning dell'endpoint privato.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Endpoint privato a cui appartiene la connessione.

Nome	Tipo	Descrizione
id	string	ID risorsa dell'endpoint privato.

PrivateLinkServiceConnectionStateProperty

Stato della connessione dell'endpoint privato.

Nome	Tipo	Descrizione
actionsRequired	string	Qualsiasi azione necessaria oltre il flusso di lavoro di base (approvazione/rifiuto/disconnessione)
description	string	Descrizione della connessione al servizio di collegamento privato.
status	string	Stato della connessione al servizio collegamento privato.

PublicNetworkAccess

Indica se le richieste dalla rete pubblica sono consentite

Nome	Tipo	Descrizione
Disabled	string
Enabled	string
SecuredByPerimeter	string

ResourceIdentityType

Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

RestoreMode

Descrive la modalità di ripristino.

Nome	Tipo	Descrizione
PointInTime	string

RestoreParameters

Parametri per indicare le informazioni sul ripristino.

Nome	Tipo	Descrizione
databasesToRestore	DatabaseRestoreResource[]	Elenco di database specifici disponibili per il ripristino.
gremlinDatabasesToRestore	GremlinDatabaseRestoreResource[]	Elenco di database gremlin specifici disponibili per il ripristino.
restoreMode	RestoreMode	Descrive la modalità di ripristino.
restoreSource	string	ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}
restoreTimestampInUtc	string	Ora di ripristino dell'account (formato ISO-8601).
restoreWithTtlDisabled	boolean	Specifica se l'account ripristinato avrà time-To-Live disabilitato al termine del ripristino.
tablesToRestore	string[]	Elenco di tabelle specifiche disponibili per il ripristino.

ServerVersion

Descrive la versione dell'account MongoDB.

Nome	Tipo	Descrizione
3.2	string
3.6	string
4.0	string
4.2	string
5.0	string
6.0	string
7.0	string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentities

Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome	Tipo	Descrizione

VirtualNetworkRule

Oggetto Regola ACL di rete virtuale

Nome	Tipo	Descrizione
id	string	ID risorsa di una subnet, ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}.
ignoreMissingVNetServiceEndpoint	boolean	Creare una regola del firewall prima che la rete virtuale disponga dell'endpoint servizio di rete virtuale abilitato.

Condividi tramite

Database Accounts - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

CosmosDBDatabaseAccountPatch

Esempio di richiesta

Risposta di esempio

Definizioni

AccountKeyMetadata

AnalyticalStorageConfiguration

AnalyticalStorageSchemaType

ApiProperties

BackupPolicyMigrationState

BackupPolicyMigrationStatus

BackupPolicyType

BackupStorageRedundancy

Capability

Capacity

ConnectorOffer

ConsistencyPolicy

ContinuousModeBackupPolicy

ContinuousModeProperties

ContinuousTier

CorsPolicy

createdByType

CreateMode

DatabaseAccountGetResults

DatabaseAccountKeysMetadata

DatabaseAccountKind

DatabaseAccountOfferType

DatabaseAccountUpdateParameters

DatabaseRestoreResource

DefaultConsistencyLevel

FailoverPolicy

GremlinDatabaseRestoreResource

IpAddressOrRange

Location

ManagedServiceIdentity

MinimalTlsVersion

NetworkAclBypass

PeriodicModeBackupPolicy

PeriodicModeProperties

PrivateEndpointConnection

PrivateEndpointProperty

PrivateLinkServiceConnectionStateProperty

PublicNetworkAccess

ResourceIdentityType

RestoreMode

RestoreParameters

ServerVersion

systemData

UserAssignedIdentities

VirtualNetworkRule

Risorse aggiuntive