Cassandra Clusters - List Backups

Service:

Cosmos DB Resource Provider

API-versie:

2025-05-01-preview

Vermeld de back-ups van dit cluster die beschikbaar zijn om te herstellen.

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

URI-parameters

Name	In	Vereist	Type	Description
clusterName	path	True	string minLength: 1 maxLength: 100 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$	Naam van beheerde Cassandra-cluster.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	ListBackups	De lijst met herstelbare back-ups voor dit Cassandra-cluster is opgehaald.
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount nabootsen

Voorbeelden

CosmosDBManagedCassandraBackupsList

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

{
  "value": [
    {
      "backupId": "2517222701827037570",
      "backupState": "Initiated",
      "backupStartTimestamp": "2023-03-28T19:10:17.2962429+00:00",
      "backupExpiryTimestamp": "2023-03-28T20:10:17.2962429+00:00"
    },
    {
      "backupId": "2517222704776158382",
      "backupState": "InProgress",
      "backupStartTimestamp": "2023-03-28T19:05:22.3841617+00:00",
      "backupExpiryTimestamp": "2023-03-28T20:05:22.3841617+00:00"
    },
    {
      "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"
    },
    {
      "backupId": "2517222704776158384",
      "backupState": "Failed",
      "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"
    }
  ]
}

Definities

Name	Description
BackupResource	Een herstelbare back-up van een Cassandra-cluster.
BackupState	De huidige status van de back-up.
CloudError	Een foutreactie van de service.
ErrorResponse	Foutreactie.
ListBackups	Lijst met herstelbare back-ups voor een Cassandra-cluster.

BackupResource

Object

Een herstelbare back-up van een Cassandra-cluster.

Name	Type	Description
backupExpiryTimestamp	string (date-time)	Het tijdstip waarop de back-up verloopt.
backupId	string	De unieke id van de back-up.
backupStartTimestamp	string (date-time)	Het tijdstip waarop het back-upproces begint.
backupState	BackupState	De huidige status van de back-up.
backupStopTimestamp	string (date-time)	Het tijdstip waarop het back-upproces afloopt.

BackupState

Inventarisatie

De huidige status van de back-up.

Waarde	Description
Failed
InProgress
Initiated
Succeeded

CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	ErrorResponse	Foutreactie.

ErrorResponse

Object

Foutreactie.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ListBackups

Object

Lijst met herstelbare back-ups voor een Cassandra-cluster.

Name	Type	Description
value	BackupResource[]	Container voor matrix met back-ups.