Sql Resources - Retrieve Continuous Backup Information

Usługa:

Cosmos DB Resource Provider

Wersja interfejsu API:

2023-09-15

Pobiera informacje o ciągłej kopii zapasowej dla zasobu kontenera.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Nazwa konta bazy danych usługi Cosmos DB.
containerName	path	True	string	Nazwa kontenera usługi Cosmos DB.
databaseName	path	True	string	Nazwa bazy danych usługi Cosmos DB.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
location	string	Nazwa lokalizacji ciągłego przywracania kopii zapasowej.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	BackupInformation	Pomyślnie ukończono operację pobierania informacji o kopii zapasowej kontenera Sql.
202 Accepted		Operacja pobierania informacji o kopii zapasowej kontenera SQL zostanie ukończona asynchronicznie.
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	Personifikuj konto użytkownika

Przykłady

CosmosDBSqlContainerBackupInformation

Przykładowe żądanie

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/rgName/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/containers/containerName/retrieveContinuousBackupInformation?api-version=2023-09-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="subid",
    )

    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: specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2023-09-15/examples/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

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

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=2023-09-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=2023-09-15

Definicje

Nazwa	Opis
BackupInformation	Informacje o kopii zapasowej zasobu.
CloudError	Odpowiedź na błąd z usługi.
ContinuousBackupInformation	Informacje o stanie ciągłych kopii zapasowych.
ContinuousBackupRestoreLocation	Właściwości regionalnego konta możliwego do przywrócenia.
ErrorResponse	Odpowiedź na błąd.

BackupInformation

Objekt

Informacje o kopii zapasowej zasobu.

Nazwa	Typ	Opis
continuousBackupInformation	ContinuousBackupInformation	Informacje o stanie ciągłych kopii zapasowych.

CloudError

Objekt

Odpowiedź na błąd z usługi.

Nazwa	Typ	Opis
error	ErrorResponse	Odpowiedź na błąd.

ContinuousBackupInformation

Objekt

Informacje o stanie ciągłych kopii zapasowych.

Nazwa	Typ	Opis
latestRestorableTimestamp	string	Najnowszy znacznik czasu możliwy do przywrócenia dla zasobu.

ContinuousBackupRestoreLocation

Objekt

Właściwości regionalnego konta możliwego do przywrócenia.

Nazwa	Typ	Opis
location	string	Nazwa lokalizacji ciągłego przywracania kopii zapasowej.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.