Ledger Digest Uploads - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Umožňuje nahrát přehledy registru do účtu služby Azure Storage nebo do instance registru důvěrného registru Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/ledgerDigestUploads/current?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
ledgerDigestUploads	path	True	LedgerDigestUploadsName
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
properties.digestStorageEndpoint	string	Koncový bod úložiště digest, který musí být buď koncovým bodem úložiště objektů blob Azure, nebo identifikátorem URI pro důvěrné registru Azure.

Odpovědi

Name	Typ	Description
200 OK	LedgerDigestUploads	Konfigurace nahrání hodnoty hash hlavní knihy byla úspěšně aktualizována.
202 Accepted		Probíhá aktualizace konfigurace nahrávání hodnoty hash registru.
Other Status Codes		Chybové odpovědi: *** 400 LedgerInvalidDigestStorageTargetUpdateRequest – Požadavek na nahrání úložiště digest registru databáze neexistuje nebo nemá žádný objekt vlastností. 400 InvalidDigestStorageEndpoint – zadaný parametr digestStorageEndpoint je neplatný. Musí se jednat o úložiště objektů blob Azure nebo koncový bod registru důvěrného registru Azure. 400 MalformedDigestStorageEndpoint – zadaný koncový bod úložiště digest je poškozený identifikátor URI. 400 InvalidLedgerDigestUploadsName – název nahrání hodnoty hash registru není podporován. Použijte název klíče "current". 400 LedgerMissingDigestStorageEndPoint – Uživatel se pokusil nakonfigurovat úložiště digest registru bez poskytnutí koncového bodu. 400 LedgerException – Server zjistil neočekávanou výjimku. 400 LedgerDigestUploadsNotSupportedOnGeoSecondary – Úložiště hodnot hash registru nelze konfigurovat v sekundárních databázích. 400 InsufficientStorageAccountPermissions – Operace čtení nebo zápisu nejsou v účtu úložiště povolené. 400 StorageAccountIsDisabled – Účet úložiště je zakázaný. 400 InvalidStorageAccountName – Zadaný účet úložiště není platný nebo neexistuje. 400 PreviousOperationInProgress – Nahrávání přehledů registru je povoleno nebo zakázáno pro databázi. Počkejte prosím na dokončení předchozího požadavku. 400 NoServerIdentity – pro zadaný server není nakonfigurována žádná identita. Informace o tom, jak nakonfigurovat identitu pro server, najdete v tématu https://go.microsoft.com/fwlink/?linkid=2156804 400 SubscriptionDoesNotHaveServer – Předplatné neobsahuje server. 400 AdalGenericError – Operaci nebylo možné dokončit, protože došlo k chybě Azure Active Directory. Chybová zpráva z knihovny ADAL (Active Directory Authentication Library) je {0}. 400 LedgerDigestUploadIsNotSupportedOnResourceType – Pro tento typ prostředku se v současné době nepodporuje nahrávání hodnot hash registru. 400 InvalidOperationOnNamedReplicas – Úložiště hodnoty digest registru nelze nakonfigurovat na pojmenované replice. 400 LedgerDigestUploadsNotSupportedOnGeoChaining – Uživatel se pokusil nastavit automatické nahrávání hodnot hash registru v databázi nakonfigurované s sekundárními soubory sekundárních souborů. 400 InvalidDigestStorageEndpoint – zadaný parametr digestStorageEndpoint je neplatný. Musí se jednat o úložiště objektů blob Azure nebo koncový bod registru důvěrného registru Azure. 400 InvalidStorageAccountName – Zadaný účet úložiště není platný nebo neexistuje. 404 SourceDatabaseNotFound – Zadaná databáze neexistuje. 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled - Operace byla zrušena uživatelem. 409 OperationInterrupted – operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací na stejném prostředku. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat. 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Enables ledger digest upload configuration for a database

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/ledgertestrg/providers/Microsoft.Sql/servers/ledgertestserver/databases/testdb/ledgerDigestUploads/current?api-version=2021-11-01

{
  "properties": {
    "digestStorageEndpoint": "https://MyAccount.blob.core.windows.net"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.LedgerDigestUploadsInner;
import com.azure.resourcemanager.sql.models.LedgerDigestUploadsName;

/**
 * Samples for LedgerDigestUploadsOperation CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LedgerDigestUploadsEnable.json
     */
    /**
     * Sample code: Enables ledger digest upload configuration for a database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        enablesLedgerDigestUploadConfigurationForADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLedgerDigestUploadsOperations().createOrUpdate("ledgertestrg",
            "ledgertestserver", "testdb", LedgerDigestUploadsName.CURRENT,
            new LedgerDigestUploadsInner().withDigestStorageEndpoint("https://MyAccount.blob.core.windows.net"),
            com.azure.core.util.Context.NONE);
    }
}

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

Ukázková odpověď

Stavový kód:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/ledgertestrg/providers/Microsoft.Sql/servers/ledgertestserver/databases/testdb/ledgerDigestUpload/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/ledgerDigestUploads",
  "properties": {
    "digestStorageEndpoint": "https://mystorage.blob.core.windows.net",
    "state": "Enabled"
  }
}

Stavový kód:

202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/ledgertestrg/providers/Microsoft.Sql/locations/eastus/ledgerDigestUploadOperationResults/11111111-1111-1111-1111-111111111111

Definice

Name	Description
LedgerDigestUploads	Nastavení nahrání hodnoty hash registru služby Azure SQL Database
LedgerDigestUploadsName
LedgerDigestUploadsState	Určuje stav nahrávání hodnot hash registru.

LedgerDigestUploads

Objekt

Nastavení nahrání hodnoty hash registru služby Azure SQL Database

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku
properties.digestStorageEndpoint	string	Koncový bod úložiště digest, který musí být buď koncovým bodem úložiště objektů blob Azure, nebo identifikátorem URI pro důvěrné registru Azure.
properties.state	LedgerDigestUploadsState	Určuje stav nahrávání hodnot hash registru.
type	string	Typ zdroje.

LedgerDigestUploadsName

Výčet

Hodnota	Description
current

LedgerDigestUploadsState

Výčet

Určuje stav nahrávání hodnot hash registru.

Hodnota	Description
Disabled
Enabled