Sql Resources - Retrieve Continuous Backup Information

Služba:

Cosmos DB Resource Provider

Verze rozhraní API:

2026-03-15

Načte informace o průběžném zálohování pro prostředek kontejneru.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/retrieveContinuousBackupInformation?api-version=2026-03-15

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Název účtu databáze Cosmos DB.
containerName	path	True	string	Název kontejneru Cosmos DB.
databaseName	path	True	string	Název databáze Cosmos DB
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
location	string	Název umístění průběžného obnovení zálohování.

Odpovědi

Name	Typ	Description
200 OK	BackupInformation	Operace Azure byla úspěšně dokončena.
202 Accepted		Operace prostředku byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

CosmosDBSqlContainerBackupInformation

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rgName/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/containers/containerName/retrieveContinuousBackupInformation?api-version=2026-03-15

{
  "location": "North Europe"
}

Python

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_sql_container_backup_information.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="SUBSCRIPTION_ID",
    )

    response = client.sql_resources.begin_retrieve_continuous_backup_information(
        resource_group_name="rgName",
        account_name="ddb1",
        database_name="databaseName",
        container_name="containerName",
        location={"location": "North Europe"},
    ).result()
    print(response)


# x-ms-original-file: 2026-03-15/CosmosDBSqlContainerBackupInformation.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

JavaScript

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

/**
 * This sample demonstrates how to retrieves continuous backup information for a container resource.
 *
 * @summary retrieves continuous backup information for a container resource.
 * x-ms-original-file: 2026-03-15/CosmosDBSqlContainerBackupInformation.json
 */
async function cosmosDBSqlContainerBackupInformation() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-1111-2222-3333-444444444444";
  const client = new CosmosDBManagementClient(credential, subscriptionId);
  const result = await client.sqlResources.retrieveContinuousBackupInformation(
    "rgName",
    "ddb1",
    "databaseName",
    "containerName",
    { location: "North Europe" },
  );
  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

Ukázková odpověď

Stavový kód:

200

{
  "continuousBackupInformation": {
    "latestRestorableTimestamp": "2021-02-05T02:40:50Z"
  }
}

Stavový kód:

202

Location: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2026-03-15
Azure-AsyncOperation: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2026-03-15

Definice

Name	Description
BackupInformation	Informace o zálohování prostředku
CloudError	Chybová odpověď ze služby.
ContinuousBackupInformation	Informace o stavu průběžných záloh
ContinuousBackupRestoreLocation	Vlastnosti místního obnovovatelného účtu.
ErrorResponse	Chybová odpověď.

BackupInformation

Objekt

Informace o zálohování prostředku

Name	Typ	Description
continuousBackupInformation	ContinuousBackupInformation	Informace o stavu průběžných záloh

CloudError

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
error	ErrorResponse	Chybová odpověď.

ContinuousBackupInformation

Objekt

Informace o stavu průběžných záloh

Name	Typ	Description
latestRestorableTimestamp	string	Nejnovější obnovitelné časové razítko zdroje.

ContinuousBackupRestoreLocation

Objekt

Vlastnosti místního obnovovatelného účtu.

Name	Typ	Description
location	string	Název umístění průběžného obnovení zálohování.

ErrorResponse

Objekt

Chybová odpověď.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.