Compartilhar via


Restorable Sql Databases - List

Mostrar o feed de eventos de todas as mutações feitas em todos os bancos de dados SQL do Azure Cosmos DB na conta restaurável. Isso ajuda no cenário em que o banco de dados foi excluído acidentalmente para obter o tempo de exclusão. Essa API requer a permissão 'Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read'

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlDatabases?api-version=2024-05-15

Parâmetros de URI

Nome Em Obrigatório Tipo Description
instanceId
path True

string

O GUID instanceId de uma conta de banco de dados restaurável.

location
path True

string

Região do Cosmos DB, com espaços entre palavras e cada palavra em maiúscula.

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

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

Respostas

Nome Tipo Description
200 OK

RestorableSqlDatabasesListResult

A operação foi concluída com sucesso.

Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation Representar sua conta de usuário

Exemplos

CosmosDBRestorableSqlDatabaseList

Solicitação de exemplo

GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases?api-version=2024-05-15

Resposta de exemplo

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/36f09704-6be3-4f33-aa05-17b73e504c75/restorableSqlDatabases/59c21367-b98b-4a8e-abb7-b6f46600decc",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "59c21367-b98b-4a8e-abb7-b6f46600decc",
      "properties": {
        "resource": {
          "_rid": "DLB14gAAAA==",
          "eventTimestamp": "2020-09-02T19:45:03Z",
          "ownerId": "Database1",
          "ownerResourceId": "3fu-hg==",
          "operationType": "Create",
          "canUndelete": "invalid",
          "database": {
            "id": "Database1",
            "_rid": "3fu-hg==",
            "_self": "dbs/3fu-hg==/",
            "_etag": "\"0000c20a-0000-0700-0000-5f4ff63f0000\"",
            "_colls": "colls/",
            "_users": "users/"
          }
        }
      }
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases/8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "8456cb17-cdb0-4c6a-8db8-d0ff3f886257",
      "properties": {
        "resource": {
          "_rid": "ESXNLAAAAA==",
          "eventTimestamp": "2020-09-02T19:53:42Z",
          "ownerId": "Database1",
          "ownerResourceId": "3fu-hg==",
          "database": {
            "id": "Database1",
            "_rid": "3fu-hg==",
            "_self": "dbs/3fu-hg==/",
            "_etag": "\"0000c20a-0000-0700-0000-5f4ff63f0000\"",
            "_colls": "colls/",
            "_users": "users/",
            "_ts": 1599075903
          },
          "operationType": "Delete",
          "canUndelete": "notRestorable",
          "canUndeleteReason": "Database already exists. Only deleted resources can be restored within same account."
        }
      }
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlDatabases/2c07991b-9c7c-4e85-be68-b18c1f2ff326",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableSqlDatabases",
      "name": "2c07991b-9c7c-4e85-be68-b18c1f2ff326",
      "properties": {
        "resource": {
          "_rid": "aXFqUQAAAA==",
          "eventTimestamp": "2020-09-02T19:53:15Z",
          "ownerId": "Database2",
          "ownerResourceId": "0SziSg==",
          "database": {
            "id": "Database2",
            "_rid": "0SziSg==",
            "_self": "dbs/0SziSg==/",
            "_etag": "\"0000ca0a-0000-0700-0000-5f4ff82b0000\"",
            "_colls": "colls/",
            "_users": "users/"
          },
          "operationType": "Create",
          "canUndelete": "invalid"
        }
      }
    }
  ]
}

Definições

Nome Description
CloudError

Uma resposta de erro do serviço.

CreateMode

Enumeração para indicar o modo de criação da conta.

Database

Objeto de recurso do banco de dados SQL do Cosmos DB

ErrorResponse

Resposta de erro.

OperationType

Enumeração para indicar o tipo de operação do evento.

Resource

O recurso de um evento de banco de dados SQL do Azure Cosmos DB

ResourceRestoreParameters

Parâmetros para indicar as informações sobre a restauração.

RestorableSqlDatabaseGetResult

Um evento de banco de dados SQL do Azure Cosmos DB

RestorableSqlDatabasesListResult

A resposta da operação Lista, que contém os eventos do banco de dados SQL e suas propriedades.

CloudError

Uma resposta de erro do serviço.

Nome Tipo Description
error

ErrorResponse

Resposta de erro.

CreateMode

Enumeração para indicar o modo de criação da conta.

Nome Tipo Description
Default

string

Restore

string

Database

Objeto de recurso do banco de dados SQL do Cosmos DB

Nome Tipo Valor padrão Description
_colls

string

Uma propriedade gerada pelo sistema que especificou o caminho endereçável do recurso de coleções.

_etag

string

Uma propriedade gerada pelo sistema que representa a etag de recurso necessária para o controle de simultaneidade otimista.

_rid

string

Uma propriedade gerada pelo sistema. Um identificador exclusivo.

_self

string

Uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de banco de dados.

_ts

number

Uma propriedade gerada pelo sistema que indica o último carimbo de data/hora atualizado do recurso.

_users

string

Uma propriedade gerada pelo sistema que especifica o caminho endereçável do recurso de usuários.

createMode

CreateMode

Default

Enumeração para indicar o modo de criação de recursos.

id

string

Nome do banco de dados SQL do Cosmos DB

restoreParameters

ResourceRestoreParameters

Parâmetros para indicar as informações sobre a restauração

ErrorResponse

Resposta de erro.

Nome Tipo Description
code

string

Código do erro.

message

string

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

OperationType

Enumeração para indicar o tipo de operação do evento.

Nome Tipo Description
Create

string

Delete

string

Recreate

string

Replace

string

SystemOperation

string

Resource

O recurso de um evento de banco de dados SQL do Azure Cosmos DB

Nome Tipo Description
_rid

string

Uma propriedade gerada pelo sistema. Um identificador exclusivo.

canUndelete

string

Um estado desse banco de dados para identificar se esse banco de dados é restaurável na mesma conta.

canUndeleteReason

string

O motivo pelo qual esse banco de dados não pode ser restaurado na mesma conta.

database

Database

Objeto de recurso do banco de dados SQL do Cosmos DB

eventTimestamp

string

A hora em que esse evento de banco de dados ocorreu.

operationType

OperationType

O tipo de operação do evento de banco de dados.

ownerId

string

O nome do banco de dados SQL.

ownerResourceId

string

A ID do recurso do banco de dados SQL.

ResourceRestoreParameters

Parâmetros para indicar as informações sobre a restauração.

Nome Tipo Description
restoreSource

string

A ID da conta de banco de dados restaurável da qual a restauração deve ser iniciada. Por exemplo: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}

restoreTimestampInUtc

string

Hora em que a conta precisa ser restaurada (formato ISO-8601).

RestorableSqlDatabaseGetResult

Um evento de banco de dados SQL do Azure Cosmos DB

Nome Tipo Description
id

string

O identificador de recurso exclusivo do recurso arm.

name

string

O nome do recurso arm.

properties.resource

Resource

O recurso de um evento de banco de dados SQL do Azure Cosmos DB

type

string

O tipo de recurso do Azure.

RestorableSqlDatabasesListResult

A resposta da operação Lista, que contém os eventos do banco de dados SQL e suas propriedades.

Nome Tipo Description
value

RestorableSqlDatabaseGetResult[]

Lista de eventos do banco de dados SQL e suas propriedades.