Restorable Tables - List

Referencia

Service:: Cosmos DB Resource Provider

API Version:: 2024-05-15

Az összes Azure Cosmos DB-táblán végrehajtott összes mutáció eseménycsatornájának megjelenítése. Ez segít abban az esetben, ha a táblát véletlenül törölték. Ehhez az API-hoz "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read" engedély szükséges

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

With optional parameters:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
instanceId	path	True	string	Visszaállítható adatbázisfiók instanceId GUID azonosítója.
location	path	True	string	Cosmos DB-régió, a szavak és az egyes szavak közötti szóközök nagybetűvel.
subscriptionId	path	True	string	A cél-előfizetés azonosítója.
api-version	query	True	string	A művelethez használandó API-verzió.
endTime	query		string	A helyreállítható táblák eseménycsatorna-befejezési időpontja.
startTime	query		string	Visszaállítható táblák eseménycsatorna kezdési időpontja.

Válaszok

Name	Típus	Description
200 OK	RestorableTablesListResult	A művelet sikeresen befejeződött.
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	A felhasználói fiók megszemélyesítése

Példák

CosmosDBRestorableTableList

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables?api-version=2024-05-15

from azure.identity import DefaultAzureCredential

from azure.mgmt.cosmosdb import CosmosDBManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cosmosdb
# USAGE
    python cosmos_db_restorable_table_list.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CosmosDBManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.restorable_tables.list(
        location="WestUS",
        instance_id="98a570f2-63db-4117-91f0-366327b7b353",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2024-05-15/examples/CosmosDBRestorableTableList.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables/79609a98-3394-41f8-911f-cfab0c075c86",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables",
      "name": "79609a98-3394-41f8-911f-cfab0c075c86",
      "properties": {
        "resource": {
          "_rid": "zAyAPQAAAA==",
          "eventTimestamp": "2020-10-13T04:56:42Z",
          "ownerId": "Table1",
          "ownerResourceId": "V18LoLrv-qA=",
          "operationType": "Create",
          "canUndelete": "invalid"
        }
      }
    },
    {
      "id": "/subscriptions/subid/providers/Microsoft.DocumentDb/locations/westus/restorableDatabaseAccounts/98a570f2-63db-4117-91f0-366327b7b353/restorableTables/79609a98-3394-41f8-911f-cfab0c075c86",
      "type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorableTables",
      "name": "79609a98-3394-41f8-911f-cfab0c075c86",
      "properties": {
        "resource": {
          "_rid": "zAyAPQAAAA==",
          "eventTimestamp": "2020-10-13T04:56:42Z",
          "ownerId": "Table1",
          "ownerResourceId": "V18LoLrv-qA=",
          "operationType": "Delete",
          "canUndelete": "notRestorable",
          "canUndeleteReason": "Collection with same name already exist as live collection."
        }
      }
    }
  ]
}

Definíciók

Name	Description
CloudError	Hibaválasz a szolgáltatástól.
ErrorResponse	Hibaválasz.
OperationType	Szám az esemény művelettípusának jelzéséhez.
Resource	Egy Azure Cosmos DB Table-esemény erőforrása
RestorableTableGetResult	Azure Cosmos DB Table-esemény
RestorableTablesListResult	A Táblaeseményeket és azok tulajdonságait tartalmazó List művelet válasza.

CloudError

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	ErrorResponse	Hibaválasz.

ErrorResponse

Hibaválasz.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet jelzi, hogy a művelet miért nem sikerült.

OperationType

Szám az esemény művelettípusának jelzéséhez.

Name	Típus	Description
Create	string
Delete	string
Recreate	string
Replace	string
SystemOperation	string

Resource

Egy Azure Cosmos DB Table-esemény erőforrása

Name	Típus	Description
_rid	string	Rendszer által létrehozott tulajdonság. Egyedi azonosító.
canUndelete	string	A tábla állapota annak megállapításához, hogy a tábla visszaállítható-e ugyanabban a fiókban.
canUndeleteReason	string	Ez az oka annak, hogy ez a tábla nem állítható vissza ugyanabban a fiókban.
eventTimestamp	string	A táblaesemény bekövetkezésének időpontja.
operationType	OperationType	A táblaesemény művelettípusa.
ownerId	string	A tábla neve.
ownerResourceId	string	A tábla erőforrás-azonosítója.

RestorableTableGetResult

Azure Cosmos DB Table-esemény

Name	Típus	Description
id	string	Az ARM-erőforrás egyedi azonosítója.
name	string	Az ARM-erőforrás neve.
properties.resource	Resource	Egy Azure Cosmos DB Table-esemény erőforrása
type	string	Az Azure-erőforrás típusa.