Ledger Digest Uploads - Create Or Update

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

Permet de charger des synthèses de registre sur un compte stockage Azure ou un registre confidentiel Azure instance.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
ledgerDigestUploads	path	True	LedgerDigestUploadsName
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
properties.digestStorageEndpoint	string	Point de terminaison de stockage digest, qui doit être un point de terminaison de stockage d’objets blob Azure ou un URI pour Azure Confidential Ledger.

Réponses

Nom	Type	Description
200 OK	LedgerDigestUploads	Mise à jour réussie de la configuration de chargement du digest du registre
202 Accepted		La mise à jour de la configuration de chargement du digest du registre est en cours.
Other Status Codes		Réponses d’erreur : *** 400 LedgerInvalidDigestStorageTargetUpdateRequest : la demande de téléchargement du stockage digest du registre de base de données n’existe pas ou n’a pas d’objet de propriétés. 400 InvalidDigestStorageEndpoint : le digestStorageEndpoint spécifié n’est pas valide. Il doit s’agir d’un stockage blob Azure ou d’un point de terminaison du registre confidentiel Azure. 400 MalformedDigestStorageEndpoint : le point de terminaison de stockage digest spécifié est un URI mal formé. 400 InvalidLedgerDigestUploadsName : le nom de chargement du digest du registre n’est pas pris en charge. Utilisez le nom de clé « current ». 400 LedgerMissingDigestStorageEndPoint : l’utilisateur a tenté de configurer le stockage digest du registre sans fournir de point de terminaison 400 LedgerException : le serveur a rencontré une exception inattendue 400 LedgerDigestUploadsNotSupportedOnGeoSecondary : le stockage digest du registre ne peut pas être configuré sur les bases de données secondaires. 400 InsufficientStorageAccountPermissions - Les opérations de lecture ou d’écriture ne sont pas autorisées sur le compte de stockage. 400 StorageAccountIsDisabled : le compte de stockage est désactivé. 400 InvalidStorageAccountName : le compte de stockage spécifié n’est pas valide ou n’existe pas. 400 PreviousOperationInProgress : le chargement des synthèses de registre est activé ou désactivé pour la base de données. Attendez la fin de la demande précédente. 400 NoServerIdentity : aucune identité n’est configurée pour le serveur spécifié. Pour plus d’informations sur la configuration d’une identité pour le serveur, consultez https://go.microsoft.com/fwlink/?linkid=2156804 400 SubscriptionDoesNotHaveServer : l’abonnement ne contient pas de serveur. 400 AdalGenericError : l’opération n’a pas pu être terminée, car une erreur Azure Active Directory a été rencontrée. Le message d’erreur de la bibliothèque d’authentification Active Directory (ADAL) est {0}. 400 LedgerDigestUploadIsNotSupportedOnResourceType : le chargement des synthèses de registre n’est actuellement pas pris en charge pour ce type de ressource. 400 InvalidOperationOnNamedReplicas : le stockage digest du registre ne peut pas être configuré sur un réplica nommé. 400 LedgerDigestUploadsNotSupportedOnGeoChaining : l’utilisateur a tenté de définir le chargement automatique de la synthèse du registre dans la base de données configurée avec des secondaires de secondaires. 400 InvalidDigestStorageEndpoint : le digestStorageEndpoint spécifié n’est pas valide. Il doit s’agir d’un stockage blob Azure ou d’un point de terminaison du registre confidentiel Azure. 400 InvalidStorageAccountName : le compte de stockage spécifié n’est pas valide ou n’existe pas. 404 SourceDatabaseNotFound : la base de données spécifiée n’existe pas. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Nom

Type

Description

200 OK

LedgerDigestUploads

Mise à jour réussie de la configuration de chargement du digest du registre

202 Accepted

La mise à jour de la configuration de chargement du digest du registre est en cours.

Other Status Codes

Réponses d’erreur : ***

400 LedgerInvalidDigestStorageTargetUpdateRequest : la demande de téléchargement du stockage digest du registre de base de données n’existe pas ou n’a pas d’objet de propriétés.
400 InvalidDigestStorageEndpoint : le digestStorageEndpoint spécifié n’est pas valide. Il doit s’agir d’un stockage blob Azure ou d’un point de terminaison du registre confidentiel Azure.
400 MalformedDigestStorageEndpoint : le point de terminaison de stockage digest spécifié est un URI mal formé.
400 InvalidLedgerDigestUploadsName : le nom de chargement du digest du registre n’est pas pris en charge. Utilisez le nom de clé « current ».
400 LedgerMissingDigestStorageEndPoint : l’utilisateur a tenté de configurer le stockage digest du registre sans fournir de point de terminaison
400 LedgerException : le serveur a rencontré une exception inattendue
400 LedgerDigestUploadsNotSupportedOnGeoSecondary : le stockage digest du registre ne peut pas être configuré sur les bases de données secondaires.
400 InsufficientStorageAccountPermissions - Les opérations de lecture ou d’écriture ne sont pas autorisées sur le compte de stockage.
400 StorageAccountIsDisabled : le compte de stockage est désactivé.
400 InvalidStorageAccountName : le compte de stockage spécifié n’est pas valide ou n’existe pas.
400 PreviousOperationInProgress : le chargement des synthèses de registre est activé ou désactivé pour la base de données. Attendez la fin de la demande précédente.
400 NoServerIdentity : aucune identité n’est configurée pour le serveur spécifié. Pour plus d’informations sur la configuration d’une identité pour le serveur, consultez https://go.microsoft.com/fwlink/?linkid=2156804
400 SubscriptionDoesNotHaveServer : l’abonnement ne contient pas de serveur.
400 AdalGenericError : l’opération n’a pas pu être terminée, car une erreur Azure Active Directory a été rencontrée. Le message d’erreur de la bibliothèque d’authentification Active Directory (ADAL) est {0}.
400 LedgerDigestUploadIsNotSupportedOnResourceType : le chargement des synthèses de registre n’est actuellement pas pris en charge pour ce type de ressource.
400 InvalidOperationOnNamedReplicas : le stockage digest du registre ne peut pas être configuré sur un réplica nommé.
400 LedgerDigestUploadsNotSupportedOnGeoChaining : l’utilisateur a tenté de définir le chargement automatique de la synthèse du registre dans la base de données configurée avec des secondaires de secondaires.
400 InvalidDigestStorageEndpoint : le digestStorageEndpoint spécifié n’est pas valide. Il doit s’agir d’un stockage blob Azure ou d’un point de terminaison du registre confidentiel Azure.
400 InvalidStorageAccountName : le compte de stockage spécifié n’est pas valide ou n’existe pas.
404 SourceDatabaseNotFound : la base de données spécifiée n’existe pas.
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 OperationIdNotFound : l’opération avec ID n’existe pas.
409 OperationCancelled : l’opération a été annulée par l’utilisateur.
409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.
500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération.
503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Enables ledger digest upload configuration for a database

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


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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 202

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

Définitions

Nom	Description
LedgerDigestUploads	Azure SQL paramètres de chargement de la synthèse du registre de base de données.
LedgerDigestUploadsName
LedgerDigestUploadsState	Spécifie l’état du chargement de la synthèse du registre.

LedgerDigestUploads

Object

Azure SQL paramètres de chargement de la synthèse du registre de base de données.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.digestStorageEndpoint	string	Point de terminaison de stockage digest, qui doit être un point de terminaison de stockage d’objets blob Azure ou un URI pour Azure Confidential Ledger.
properties.state	LedgerDigestUploadsState	Spécifie l’état du chargement de la synthèse du registre.
type	string	Type de ressource.

LedgerDigestUploadsName

Enumeration

Valeur	Description
current

LedgerDigestUploadsState

Enumeration

Spécifie l’état du chargement de la synthèse du registre.

Valeur	Description
Disabled
Enabled

Partager via

Ledger Digest Uploads - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Enables ledger digest upload configuration for a database

Exemple de requête

Exemple de réponse

Définitions

LedgerDigestUploads

LedgerDigestUploadsName

LedgerDigestUploadsState

Ressources supplémentaires