Restorable Sql Resources - List

Referência

Service:: Cosmos DB Resource Provider

API Version:: 2024-05-15

Devolva uma lista da base de dados e da combinação de contentor que existe na conta no carimbo de data/hora e na localização especificados. Isto ajuda em cenários para validar que recursos existem num determinado carimbo de data/hora e localização. 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-05-15

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2024-05-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 base de dados recuperá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	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.
restoreLocation	query		string	A localização onde estão localizados os recursos restauráveis.
restoreTimestampInUtc	query		string	O carimbo de data/hora quando os recursos restauráveis existiam.

Respostas

Name	Tipo	Description
200 OK	RestorableSqlResourcesListResult	A operação foi concluída com êxito.
Other Status Codes	CloudError	Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	Representar a sua conta de utilizador

Exemplos

CosmosDBRestorableSqlResourceList

Sample Request

HTTP

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-05-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56

Sample Response

Status code:: 200

{
  "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 a Erros.
RestorableSqlResourcesGetResult	Bases de Dados Específicas a restaurar.
RestorableSqlResourcesListResult	A resposta da operação Lista, que contém os recursos SQL restauráveis.

CloudError

Uma resposta de erro do serviço.

Name	Tipo	Description
error	ErrorResponse	Resposta a Erros.

ErrorResponse

Resposta a Erros.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

RestorableSqlResourcesGetResult

Bases de Dados Específicas a restaurar.

Name	Tipo	Description
collectionNames	string[]	Os nomes das coleções disponíveis para restauro.
databaseName	string	O nome da base de dados disponível para restauro.
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.