Partilhar via


Restorable Sql Resources - List

Retorna uma lista de combinação de banco de dados e contêiner que existem na conta no carimbo de data/hora e no local determinados. Isso ajuda em cenários para validar quais recursos existem em determinado carimbo de data/hora e local. Esta API requer a permissão 'Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read'.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2024-11-15
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2024-11-15&restoreLocation={restoreLocation}&restoreTimestampInUtc={restoreTimestampInUtc}

Parâmetros do URI

Name Em Necessá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úsculas.

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.

restoreLocation
query

string

O local onde os recursos restauráveis estão localizados.

restoreTimestampInUtc
query

string

O carimbo de data/hora quando os recursos restauráveis existiram.

Respostas

Name Tipo Description
200 OK

RestorableSqlResourcesListResult

A operação foi concluída com êxito.

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

CosmosDBRestorableSqlResourceList

Pedido de amostra

GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlResources?api-version=2024-11-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56

Resposta da amostra

{
  "value": [
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database1",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database1",
      "databaseName": "Database1",
      "collectionNames": [
        "Container1"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database2",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database2",
      "databaseName": "Database2",
      "collectionNames": [
        "Container1",
        "Container2"
      ]
    },
    {
      "id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database3",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
      "name": "Database3",
      "databaseName": "Database3",
      "collectionNames": []
    }
  ]
}

Definições

Name Description
CloudError

Uma resposta de erro do serviço.

ErrorResponse

Resposta de erro.

RestorableSqlResourcesGetResult

Bases de Dados específicas para restaurar.

RestorableSqlResourcesListResult

A resposta da operação List, que contém os recursos SQL restauráveis.

CloudError

Uma resposta de erro do serviço.

Name Tipo Description
error

ErrorResponse

Resposta de erro.

ErrorResponse

Resposta de erro.

Name Tipo Description
code

string

Código de erro.

message

string

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

RestorableSqlResourcesGetResult

Bases de Dados específicas para restaurar.

Name Tipo Description
collectionNames

string[]

Os nomes das coleções disponíveis para restauração.

databaseName

string

O nome do banco de dados disponível para restauração.

id

string

O identificador de recurso exclusivo do recurso ARM.

name

string

O nome do recurso ARM.

type

string

O tipo de recurso do Azure.

RestorableSqlResourcesListResult

A resposta da operação List, que contém os recursos SQL restauráveis.

Name Tipo Description
value

RestorableSqlResourcesGetResult[]

Lista de recursos SQL restauráveis, incluindo o banco de dados e nomes de coleção.