Freigeben über

Cassandra Clusters - Get Backup

  • Referenz
Dienst:
Cosmos DB Resource Provider
API-Version:
2025-05-01-preview

Dient zum Abrufen der Eigenschaften einer einzelnen Sicherung dieses Clusters, die zum Wiederherstellen verfügbar ist.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
backupId
 path True

string

minLength: 1
maxLength: 15
pattern: ^[0-9]+$

ID einer wiederherstellbaren Sicherung eines Cassandra-Clusters.
clusterName
 path True

string

minLength: 1
maxLength: 100
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$

Verwalteter Cassandra-Clustername.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

BackupResource

Die Eigenschaften der Sicherung wurden erfolgreich abgerufen.
Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

CosmosDBManagedCassandraBackup

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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"
}

Definitionen

Name Beschreibung
BackupResource

Eine wiederherstellbare Sicherung eines Cassandra-Clusters.
BackupState

Der aktuelle Zustand der Sicherung.
CloudError

Eine Fehlerantwort des Diensts.
ErrorResponse

Fehlerantwort.

BackupResource

Objekt

Eine wiederherstellbare Sicherung eines Cassandra-Clusters.

Name Typ Beschreibung
backupExpiryTimestamp

string (date-time)

Der Zeitpunkt, zu dem die Sicherung abläuft.
backupId

string

Der eindeutige Bezeichner der Sicherung.
backupStartTimestamp

string (date-time)

Der Zeitpunkt, zu dem der Sicherungsvorgang beginnt.
backupState

BackupState

Der aktuelle Zustand der Sicherung.
backupStopTimestamp

string (date-time)

Der Zeitpunkt, zu dem der Sicherungsvorgang endet.

BackupState

Enumeration

Der aktuelle Zustand der Sicherung.

Wert Beschreibung
Failed
InProgress
Initiated
Succeeded

CloudError

Objekt

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort.

ErrorResponse

Objekt

Fehlerantwort.

Name Typ Beschreibung
code

string

Fehlercode.
message

string

Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.