Ledger Digest Uploads - Create Or Update

Dienst:

SQL Database

API-Version:

2021-11-01

Aktiviert das Hochladen von Ledger-Digests in ein Azure Storage-Konto oder eine Azure Confidential Ledger-instance.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
ledgerDigestUploads	path	True	LedgerDigestUploadsName
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.digestStorageEndpoint	string	Der Digestspeicherendpunkt, der entweder ein Azure Blob Storage-Endpunkt oder ein URI für Azure Confidential Ledger sein muss.

Antworten

Name	Typ	Beschreibung
200 OK	LedgerDigestUploads	Die Uploadkonfiguration des Ledger-Digests wurde erfolgreich aktualisiert.
202 Accepted		Das Aktualisieren der Konfiguration des Ledger-Digest-Uploads wird ausgeführt.
Other Status Codes		Fehlerantworten: *** 400 LedgerInvalidDigestStorageTargetUpdateRequest: Die Uploadanforderung für den Datenbank-Ledger-Digestspeicher ist nicht vorhanden oder verfügt über kein Eigenschaftenobjekt. 400 InvalidDigestStorageEndpoint: Der angegebene DigestStorageEndpoint ist ungültig. Es muss sich um einen Azure Blob Storage- oder Azure Confidential Ledger-Endpunkt handeln. 400 MalformedDigestStorageEndpoint: Der angegebene Digestspeicherendpunkt ist ein fehlerhafter URI. 400 InvalidLedgerDigestUploadsName: Der Uploadname des Ledger-Digests wird nicht unterstützt. Verwenden Sie den Schlüsselnamen "current". 400 LedgerMissingDigestStorageEndPoint: Benutzer haben versucht, Ledger-Digestspeicher zu konfigurieren, ohne einen Endpunkt bereitzustellen 400 LedgerException: Beim Server ist eine unerwartete Ausnahme aufgetreten. 400 LedgerDigestUploadsNotSupportedOnGeoSecondary: Der Ledger-Digestspeicher kann nicht für sekundäre Datenbanken konfiguriert werden. 400 InsufficientStorageAccountPermissions: Lese- oder Schreibvorgänge sind für das Speicherkonto nicht zulässig. 400 StorageAccountIsDisabled: Das Speicherkonto ist deaktiviert. 400 InvalidStorageAccountName: Das angegebene Speicherkonto ist ungültig oder nicht vorhanden. 400 PreviousOperationInProgress: Das Hochladen von Ledger-Digests wird für die Datenbank aktiviert oder deaktiviert. Warten Sie, bis die vorherige Anforderung abgeschlossen ist. 400 NoServerIdentity: Für den angegebenen Server ist keine Identität konfiguriert. Informationen zum Konfigurieren einer Identität für den Server finden Sie unter https://go.microsoft.com/fwlink/?linkid=2156804 400 SubscriptionDoesNotHaveServer : Das Abonnement enthält keinen Server. 400 AdalGenericError: Der Vorgang konnte nicht abgeschlossen werden, da ein Azure Active Directory-Fehler aufgetreten ist. Die Fehlermeldung der Active Directory-Authentifizierungsbibliothek (Active Directory Authentication Library, ADAL) lautet {0}. 400 LedgerDigestUploadIsNotSupportedOnResourceType: Das Hochladen von Ledger-Digests wird für diesen Ressourcentyp derzeit nicht unterstützt. 400 InvalidOperationOnNamedReplicas: Der Ledger-Digestspeicher kann nicht für ein benanntes Replikat konfiguriert werden. 400 LedgerDigestUploadsNotSupportedOnGeoChaining: Der Benutzer hat versucht, den automatischen Upload des Ledger-Digests in einer Datenbank festzulegen, die mit Sekundärdatenbanken konfiguriert ist. 400 InvalidDigestStorageEndpoint: Der angegebene DigestStorageEndpoint ist ungültig. Es muss sich um einen Azure Blob Storage- oder Azure Confidential Ledger-Endpunkt handeln. 400 InvalidStorageAccountName: Das angegebene Speicherkonto ist ungültig oder nicht vorhanden. 404 SourceDatabaseNotFound: Die angegebene Datenbank ist nicht vorhanden. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Enables ledger digest upload configuration for a database

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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"
  }
}

Statuscode:

202

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

Definitionen

Name	Beschreibung
LedgerDigestUploads	Azure SQL Einstellungen für das Hochladen des Datenbank-Ledger-Digests.
LedgerDigestUploadsName
LedgerDigestUploadsState	Gibt den Status des Ledger-Digest-Uploads an.

LedgerDigestUploads

Azure SQL Einstellungen für das Hochladen des Datenbank-Ledger-Digests.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.digestStorageEndpoint	string	Der Digestspeicherendpunkt, der entweder ein Azure Blob Storage-Endpunkt oder ein URI für Azure Confidential Ledger sein muss.
properties.state	LedgerDigestUploadsState	Gibt den Status des Ledger-Digest-Uploads an.
type	string	Der Ressourcentyp.

LedgerDigestUploadsName

Name	Typ	Beschreibung
current	string

LedgerDigestUploadsState

Gibt den Status des Ledger-Digest-Uploads an.

Name	Typ	Beschreibung
Disabled	string
Enabled	string