Partilhar via

Cassandra Clusters - List Backups

  • Referência
Serviço:
Cosmos DB Resource Provider
Versão da API:
2025-05-01-preview

Liste os backups desse cluster que estão disponíveis para restauração.

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

Parâmetros do URI

Name Em Necessário Tipo Description
clusterName
 path True

string

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

Nome do cluster Cassandra gerenciado.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

ListBackups

Recuperada com êxito a lista de backups restauráveis para este cluster Cassandra.
Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation Personificar a sua conta de utilizador

Exemplos

CosmosDBManagedCassandraBackupsList

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
    }
  ]
}

Definições

Name Description
BackupResource

Um backup restaurável de um cluster Cassandra.
BackupState

O estado atual do backup.
CloudError

Uma resposta de erro do serviço.
ErrorResponse

Resposta de erro.
ListBackups

Lista de backups restauráveis para um cluster Cassandra.

BackupResource

Object

Um backup restaurável de um cluster Cassandra.

Name Tipo Description
backupExpiryTimestamp

string (date-time)

O momento em que o backup expirará.
backupId

string

O identificador exclusivo do backup.
backupStartTimestamp

string (date-time)

O momento em que o processo de backup começa.
backupState

BackupState

O estado atual do backup.
backupStopTimestamp

string (date-time)

O momento em que o processo de backup termina.

BackupState

Enumeração

O estado atual do backup.

Valor Description
Failed
InProgress
Initiated
Succeeded

CloudError

Object

Uma resposta de erro do serviço.

Name Tipo Description
error

ErrorResponse

Resposta de erro.

ErrorResponse

Object

Resposta de erro.

Name Tipo Description
code

string

Código de erro.
message

string

Mensagem de erro indicando por que a operação falhou.

ListBackups

Object

Lista de backups restauráveis para um cluster Cassandra.

Name Tipo Description
value

BackupResource[]

Contêiner para matriz de backups.