Cassandra Clusters - Get Backup

Service:

Cosmos DB Resource Provider

Version d'API:

2025-05-01-preview

Obtenez les propriétés d’une sauvegarde individuelle de ce cluster disponible pour la restauration.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/cassandraClusters/{clusterName}/backups/{backupId}?api-version=2025-05-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
backupId	path	True	string minLength: 1 maxLength: 15 pattern: ^[0-9]+$	ID d’une sauvegarde pouvant être restaurée d’un cluster Cassandra.
clusterName	path	True	string minLength: 1 maxLength: 100 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$	Nom du cluster Cassandra managé.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	BackupResource	A récupéré avec succès les propriétés de la sauvegarde.
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper votre compte d'utilisateur

Exemples

CosmosDBManagedCassandraBackup

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/cassandra-prod-rg/providers/Microsoft.DocumentDB/cassandraClusters/cassandra-prod/backups/1611250348?api-version=2025-05-01-preview

Exemple de réponse

Code d’état:

200

{
  "backupId": "2517222704776158383",
  "backupState": "Succeeded",
  "backupStartTimestamp": "2023-03-28T19:05:22.3841617+00:00",
  "backupStopTimestamp": "2023-03-28T19:05:22.3841617+00:00",
  "backupExpiryTimestamp": "2023-03-28T20:05:22.3841617+00:00"
}

Définitions

Nom	Description
BackupResource	Sauvegarde pouvant être restaurée d’un cluster Cassandra.
BackupState	État actuel de la sauvegarde.
CloudError	Réponse d’erreur du service.
ErrorResponse	Réponse d’erreur.

BackupResource

Object

Sauvegarde pouvant être restaurée d’un cluster Cassandra.

Nom	Type	Description
backupExpiryTimestamp	string (date-time)	Heure à laquelle la sauvegarde expire.
backupId	string	Identificateur unique de la sauvegarde.
backupStartTimestamp	string (date-time)	Heure à laquelle le processus de sauvegarde commence.
backupState	BackupState	État actuel de la sauvegarde.
backupStopTimestamp	string (date-time)	Heure à laquelle le processus de sauvegarde se termine.

BackupState

Énumération

État actuel de la sauvegarde.

Valeur	Description
Failed
InProgress
Initiated
Succeeded

CloudError

Object

Réponse d’erreur du service.

Nom	Type	Description
error	ErrorResponse	Réponse d’erreur.

ErrorResponse

Object

Réponse d’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.