Partager via


Databases - Update

Met à jour une base de données existante.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2025-01-01

Paramètres URI

Nom Dans Obligatoire Type Description
databaseName
path True

string

Nom de la base de données.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

serverName
path True

string

Le nom du serveur

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
identity

DatabaseIdentity

Identité de base de données

properties.autoPauseDelay

integer (int32)

Durée en minutes après laquelle la base de données est automatiquement suspendue. Une valeur de -1 signifie que la pause automatique est désactivée

properties.catalogCollation

CatalogCollationType

Classement du catalogue de métadonnées.

properties.collation

string

Classement de la base de données.

properties.createMode

CreateMode

Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.

properties.elasticPoolId

string (arm-id)

Identificateur de ressource du pool élastique contenant cette base de données.

properties.encryptionProtector

string

URI du coffre de clés Azure de la base de données s’il est configuré avec les clés gérées par le client de base de données.

properties.encryptionProtectorAutoRotation

boolean

Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données.

properties.federatedClientId

string (uuid)

ID client utilisé pour le scénario CMK entre locataires par base de données

properties.freeLimitExhaustionBehavior

FreeLimitExhaustionBehavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois.

BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

properties.highAvailabilityReplicaCount

integer (int32)

Nombre de réplicas secondaires associés à la base de données Critique pour l’entreprise, Premium ou Hyperscale qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.isLedgerOn

boolean

Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.

properties.keys

<string,  DatabaseKey>

ID de ressource des identités affectées par l’utilisateur à utiliser

properties.licenseType

DatabaseLicenseType

Type de licence à appliquer pour cette base de données. LicenseIncluded si vous avez besoin d’un permis, ou BasePrice si vous en avez un et êtes éligible au Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données.

properties.maintenanceConfigurationId

string

ID de configuration de maintenance affecté à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent.

properties.manualCutover

boolean

Indique si le basculement manuel contrôlé par le client doit être effectué pendant l’opération de mise à jour de la base de données vers le niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.

properties.maxSizeBytes

integer (int64)

Taille maximale de la base de données exprimée en octets.

properties.minCapacity

number (double)

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue

properties.performCutover

boolean

Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche le basculement et effectue une modification de rôle vers la base de données Hyperscale.

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS.

properties.readScale

DatabaseReadScale

État du routage en lecture seule. Si activées, les connexions dont l’intention d’application est réglée en lecture seule dans leur chaîne de connexion peuvent être acheminées vers une réplique secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.recoverableDatabaseId

string (arm-id)

Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette base de données.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificateur de ressource de la base de données supprimée pouvant être restaurée associée à l’opération de création de cette base de données.

properties.restorePointInTime

string (date-time)

Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données.

properties.sampleName

SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

properties.secondaryType

SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

properties.sourceDatabaseDeletionDate

string (date-time)

Spécifie l’heure à laquelle la base de données a été supprimée.

properties.sourceDatabaseId

string (arm-id)

Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données.

properties.useFreeLimit

boolean

Indique si la base de données utilise des limites mensuelles gratuites ou non. Autorisé sur une base de données dans un abonnement.

properties.zoneRedundant

boolean

Indique si cette base de données est redondante interzone, ce qui signifie que les réplicas de cette base de données seront répartis entre plusieurs zones de disponibilité.

sku

Sku

Nom et niveau de la référence SKU.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

Database

Opération Azure terminée avec succès.

202 Accepted

Demande de mise à jour de ressource acceptée.

En-têtes

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Assigns maintenance window to a database.
Patch a database with database-level customer managed keys.
Resets maintenance window of a database to default.
Updates a database with Default enclave type.
Updates a database with VBS enclave type.
Updates a database.

Assigns maintenance window to a database.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  },
  "sku": {
    "name": "BC_Gen5_4"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user,vcore",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "currentSku": {
      "name": "BC_Gen5",
      "capacity": 4,
      "tier": "BusinessCritical"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "isInfraEncryptionEnabled": false,
    "isLedgerOn": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "maxLogSizeBytes": 104857600,
    "maxSizeBytes": 1073741824,
    "readScale": "Enabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "BC_Gen5",
    "capacity": 4,
    "tier": "BusinessCritical"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Patch a database with database-level customer managed keys.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/Default-SQL-SouthEastAsia/providers/Microsoft.ManagedIdentity/userAssignedIdentities/umi": {},
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/Default-SQL-SouthEastAsia/providers/Microsoft.ManagedIdentity/userAssignedIdentities/umiToDelete": null
    }
  },
  "properties": {
    "encryptionProtector": "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion",
    "keys": {
      "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion": {},
      "https://your-key-vault-name.vault.azure.net/yourKey2/yourKey2VersionToDelete": null
    }
  },
  "sku": {
    "name": "S0",
    "tier": "Standard"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user,vcore",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "currentSku": {
      "name": "BC_Gen4",
      "capacity": 4,
      "tier": "BusinessCritical"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "isInfraEncryptionEnabled": false,
    "isLedgerOn": false,
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "maxSizeBytes": 1073741824,
    "readScale": "Enabled",
    "requestedBackupStorageRedundancy": "Local",
    "requestedServiceObjectiveName": "BC_Gen4_2",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "BC_Gen4",
    "capacity": 4,
    "tier": "BusinessCritical"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Resets maintenance window of a database to default.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  },
  "sku": {
    "name": "BC_Gen5_4"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user,vcore",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "BC_Gen5_4",
    "currentSku": {
      "name": "BC_Gen5",
      "capacity": 4,
      "tier": "BusinessCritical"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "isInfraEncryptionEnabled": false,
    "isLedgerOn": false,
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "maxSizeBytes": 1073741824,
    "readScale": "Enabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "BC_Gen5_4",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "BC_Gen5",
    "capacity": 4,
    "tier": "BusinessCritical"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Updates a database with Default enclave type.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "properties": {
    "preferredEnclaveType": "Default"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "currentSku": {
      "name": "Standard",
      "capacity": 10,
      "tier": "Standard"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 268435456000,
    "preferredEnclaveType": "Default",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "Standard",
    "capacity": 10,
    "tier": "Standard"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Updates a database with VBS enclave type.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "properties": {
    "preferredEnclaveType": "VBS"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "currentSku": {
      "name": "Standard",
      "capacity": 10,
      "tier": "Standard"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 268435456000,
    "preferredEnclaveType": "VBS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "Standard",
    "capacity": 10,
    "tier": "Standard"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Updates a database.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2025-01-01

{
  "properties": {
    "licenseType": "LicenseIncluded",
    "maxSizeBytes": 1073741824
  },
  "sku": {
    "name": "BC_Gen4_4"
  }
}

Exemple de réponse

{
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "kind": "v12.0,user,vcore",
  "location": "southeastasia",
  "properties": {
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "currentSku": {
      "name": "BC_Gen4",
      "capacity": 4,
      "tier": "BusinessCritical"
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "isInfraEncryptionEnabled": false,
    "isLedgerOn": false,
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "maxSizeBytes": 1073741824,
    "readScale": "Enabled",
    "requestedBackupStorageRedundancy": "Local",
    "requestedServiceObjectiveName": "BC_Gen4_2",
    "status": "Online",
    "zoneRedundant": false
  },
  "sku": {
    "name": "BC_Gen4",
    "capacity": 4,
    "tier": "BusinessCritical"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/southeastasia/databaseOperationResults/11111111-1111-1111-1111-111111111111

Définitions

Nom Description
AlwaysEncryptedEnclaveType

Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS.

AvailabilityZoneType

Spécifie la zone de disponibilité à laquelle la base de données est épinglée.

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

CatalogCollationType

Classement du catalogue de métadonnées.

createdByType

Type d’identité qui a créé la ressource.

CreateMode

Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.

Database

Ressource de base de données.

DatabaseIdentity

Configuration d’identité Azure Active Directory pour une ressource.

DatabaseIdentityType

Type d’identité

DatabaseKey

Clé de niveau base de données utilisée pour le chiffrement au repos.

DatabaseKeyType

Type de clé de base de données. Seule la valeur prise en charge est « AzureKeyVault ».

DatabaseLicenseType

Type de licence à appliquer pour cette base de données. LicenseIncluded si vous avez besoin d’un permis, ou BasePrice si vous en avez un et êtes éligible au Azure Hybrid Benefit.

DatabaseReadScale

État du routage en lecture seule. Si activées, les connexions dont l’intention d’application est réglée en lecture seule dans leur chaîne de connexion peuvent être acheminées vers une réplique secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

DatabaseStatus

État de la base de données.

DatabaseUpdate

Ressource de mise à jour de base de données.

DatabaseUserIdentity

Configuration d’identité Azure Active Directory pour une ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

FreeLimitExhaustionBehavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois.

BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

Sku

Référence SKU de ressource ARM.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

AlwaysEncryptedEnclaveType

Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS.

Valeur Description
Default

Par défaut

VBS

VBS

AvailabilityZoneType

Spécifie la zone de disponibilité à laquelle la base de données est épinglée.

Valeur Description
NoPreference

Sans préférence

1

1

2

2

3

3

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

Valeur Description
Geo

Zone géographique

Local

Local

Zone

Zone

GeoZone

GeoZone

CatalogCollationType

Classement du catalogue de métadonnées.

Valeur Description
DATABASE_DEFAULT

DATABASE_DEFAULT

SQL_Latin1_General_CP1_CI_AS

SQL_Latin1_General_CP1_CI_AS

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

CreateMode

Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.

Valeur Description
Default

Par défaut

Copy

Copy

Secondary

Secondaire

PointInTimeRestore

PointInTimeRestore

Restore

Restaurer

Recovery

Récupération

RestoreExternalBackup

RestoreExternalBackup

RestoreExternalBackupSecondary

RestaurerSauvegardeExterneSecondaire

RestoreLongTermRetentionBackup

RestoreLongtermRetentionBackup

OnlineSecondary

Secondaire en ligne

Database

Ressource de base de données.

Nom Type Description
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

identity

DatabaseIdentity

L’identité Azure Active Directory de la base de données.

kind

string

Type de base de données. Ce sont des métadonnées utilisées pour l’expérience du portail Azure.

location

string

Emplacement géographique où réside la ressource

managedBy

string

Ressource qui gère la base de données.

name

string

Nom de la ressource

properties.autoPauseDelay

integer (int32)

Durée en minutes après laquelle la base de données est automatiquement suspendue. Une valeur de -1 signifie que la pause automatique est désactivée

properties.availabilityZone

AvailabilityZoneType

Spécifie la zone de disponibilité à laquelle la base de données est épinglée.

properties.catalogCollation

CatalogCollationType

Classement du catalogue de métadonnées.

properties.collation

string

Classement de la base de données.

properties.createMode

CreateMode

Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.

properties.creationDate

string (date-time)

Date de création de la base de données (format ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

properties.currentServiceObjectiveName

string

Nom de l’objectif de niveau de service actuel de la base de données.

properties.currentSku

Sku

Nom et niveau de la référence SKU.

properties.databaseId

string (uuid)

ID de la base de données.

properties.defaultSecondaryLocation

string

Région secondaire par défaut pour cette base de données.

properties.earliestRestoreDate

string (date-time)

Cela enregistre la date et l’heure de début les plus anciennes disponibles pour cette base de données (format ISO8601).

properties.elasticPoolId

string (arm-id)

Identificateur de ressource du pool élastique contenant cette base de données.

properties.encryptionProtector

string

URI du coffre de clés Azure de la base de données s’il est configuré avec les clés gérées par le client de base de données.

properties.encryptionProtectorAutoRotation

boolean

Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données.

properties.failoverGroupId

string

Identificateur de ressource de groupe de basculement auquel appartient cette base de données.

properties.federatedClientId

string (uuid)

ID client utilisé pour le scénario CMK entre locataires par base de données

properties.freeLimitExhaustionBehavior

FreeLimitExhaustionBehavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois.

BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

properties.highAvailabilityReplicaCount

integer (int32)

Nombre de réplicas secondaires associés à la base de données Critique pour l’entreprise, Premium ou Hyperscale qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.isInfraEncryptionEnabled

boolean

Le chiffrement infra est activé pour cette base de données.

properties.isLedgerOn

boolean

Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.

properties.keys

<string,  DatabaseKey>

ID de ressource des identités affectées par l’utilisateur à utiliser

properties.licenseType

DatabaseLicenseType

Type de licence à appliquer pour cette base de données. LicenseIncluded si vous avez besoin d’un permis, ou BasePrice si vous en avez un et êtes éligible au Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données.

properties.maintenanceConfigurationId

string

ID de configuration de maintenance affecté à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent.

properties.manualCutover

boolean

Indique si le basculement manuel contrôlé par le client doit être effectué pendant l’opération de mise à jour de la base de données vers le niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.

properties.maxLogSizeBytes

integer (int64)

Taille maximale du journal pour cette base de données.

properties.maxSizeBytes

integer (int64)

Taille maximale de la base de données exprimée en octets.

properties.minCapacity

number (double)

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue

properties.pausedDate

string (date-time)

Date à laquelle la base de données a été suspendue par configuration utilisateur ou action(ISO8601 format). Null si la base de données est prête.

properties.performCutover

boolean

Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche le basculement et effectue une modification de rôle vers la base de données Hyperscale.

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS.

properties.readScale

DatabaseReadScale

État du routage en lecture seule. Si activées, les connexions dont l’intention d’application est réglée en lecture seule dans leur chaîne de connexion peuvent être acheminées vers une réplique secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.recoverableDatabaseId

string (arm-id)

Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette base de données.

properties.requestedServiceObjectiveName

string

Nom de l’objectif de niveau de service demandé de la base de données.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificateur de ressource de la base de données supprimée pouvant être restaurée associée à l’opération de création de cette base de données.

properties.restorePointInTime

string (date-time)

Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données.

properties.resumedDate

string (date-time)

Date à laquelle la base de données a été reprise par l’action de l’utilisateur ou la connexion à la base de données (format ISO8601). Null si la base de données est suspendue.

properties.sampleName

SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

properties.secondaryType

SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

properties.sourceDatabaseDeletionDate

string (date-time)

Spécifie l’heure à laquelle la base de données a été supprimée.

properties.sourceDatabaseId

string (arm-id)

Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données.

properties.sourceResourceId

string (arm-id)

Identificateur de ressource de la source associée à l’opération de création de cette base de données.

Cette propriété est uniquement prise en charge pour l’édition DataWarehouse et permet la restauration entre les abonnements.

Lorsque sourceResourceId est spécifié, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId et sourceDatabaseDeletionDate ne doivent pas être spécifiés et CreateMode doit être PointInTimeRestore, Restore ou Recover.

Lorsque createMode est PointInTimeRestore, sourceResourceId doit être l’ID de ressource de la base de données existante ou du pool sql existant, et restorePointInTime doit être spécifié.

Lorsque createMode est Restore, sourceResourceId doit être l’ID de ressource de la base de données supprimée pouvant être restaurée ou du pool sql supprimé pouvant être restauré.

Lorsque createMode est Recover, sourceResourceId doit être l’ID de ressource d’une base de données récupérable ou d’un pool sql récupérable.

Lorsque l’abonnement source appartient à un locataire différent de l’abonnement cible, l’en-tête « x-ms-authorization-auxiliaire » doit contenir un jeton d’authentification pour le locataire source. Pour plus d’informations sur l’en-tête « x-ms-authorization-auxiliaire », consultez https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

État de la base de données.

properties.useFreeLimit

boolean

Indique si la base de données utilise des limites mensuelles gratuites ou non. Autorisé sur une base de données dans un abonnement.

properties.zoneRedundant

boolean

Indique si cette base de données est redondante interzone, ce qui signifie que les réplicas de cette base de données seront répartis entre plusieurs zones de disponibilité.

sku

Sku

Référence SKU de base de données.

La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les SKU (y compris le nom du SKU, le paier/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API REST Capabilities_ListByLocation ou l’une des commandes suivantes :

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
systemData

systemData

Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts"

DatabaseIdentity

Configuration d’identité Azure Active Directory pour une ressource.

Nom Type Description
tenantId

string (uuid)

L’identifiant du locataire Azure Active Directory.

type

DatabaseIdentityType

Type d’identité

userAssignedIdentities

<string,  DatabaseUserIdentity>

ID de ressource des identités affectées par l’utilisateur à utiliser

DatabaseIdentityType

Type d’identité

Valeur Description
None

Aucun

UserAssigned

UserAssigned

DatabaseKey

Clé de niveau base de données utilisée pour le chiffrement au repos.

Nom Type Description
creationDate

string (date-time)

Date de création de la clé de base de données.

keyVersion

string

Version de la clé de base de données.

subregion

string

Sous-région de la clé de serveur.

thumbprint

string

Empreinte numérique de la clé de base de données.

type

DatabaseKeyType

Type de clé de base de données. Seule la valeur prise en charge est « AzureKeyVault ».

DatabaseKeyType

Type de clé de base de données. Seule la valeur prise en charge est « AzureKeyVault ».

Valeur Description
AzureKeyVault

AzureKeyVault

DatabaseLicenseType

Type de licence à appliquer pour cette base de données. LicenseIncluded si vous avez besoin d’un permis, ou BasePrice si vous en avez un et êtes éligible au Azure Hybrid Benefit.

Valeur Description
LicenseIncluded

LicenceInclus

BasePrice

BasePrice

DatabaseReadScale

État du routage en lecture seule. Si activées, les connexions dont l’intention d’application est réglée en lecture seule dans leur chaîne de connexion peuvent être acheminées vers une réplique secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

Valeur Description
Enabled

Activé

Disabled

Désactivé

DatabaseStatus

État de la base de données.

Valeur Description
Online

En ligne

Restoring

Restauration

RecoveryPending

RécupérationEn attente

Recovering

la récupération

Suspect

Soupçonner

Offline

Hors ligne

Standby

Standby (Réserve)

Shutdown

Arrêt

EmergencyMode

Mode d’urgence

AutoClosed

AutoFermé

Copying

Copie

Creating

Création

Inaccessible

Inaccessible

OfflineSecondary

Hors ligneSecondaire

Pausing

En cours de pause

Paused

Suspendu(e)

Resuming

Reprendre

Scaling

Croissance

OfflineChangingDwPerformanceTiers

OfflineChangingDwPerformanceTiers

OnlineChangingDwPerformanceTiers

OnlineChangingDwPerformanceTiers

Disabled

Désactivé

Stopping

Arrêt

Stopped

Arrêté

Starting

Démarrage

DatabaseUpdate

Ressource de mise à jour de base de données.

Nom Type Description
identity

DatabaseIdentity

Identité de base de données

properties.autoPauseDelay

integer (int32)

Durée en minutes après laquelle la base de données est automatiquement suspendue. Une valeur de -1 signifie que la pause automatique est désactivée

properties.catalogCollation

CatalogCollationType

Classement du catalogue de métadonnées.

properties.collation

string

Classement de la base de données.

properties.createMode

CreateMode

Spécifie le mode de création de base de données.

Valeur par défaut : création régulière de la base de données.

Copie : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde à un point dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restauration : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimé pouvant être restauré et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en effectuant une restauration à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource de point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.

properties.creationDate

string (date-time)

Date de création de la base de données (format ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

properties.currentServiceObjectiveName

string

Nom de l’objectif de niveau de service actuel de la base de données.

properties.currentSku

Sku

Nom et niveau de la référence SKU.

properties.databaseId

string (uuid)

ID de la base de données.

properties.defaultSecondaryLocation

string

Région secondaire par défaut pour cette base de données.

properties.earliestRestoreDate

string (date-time)

Cela enregistre la date et l’heure de début les plus anciennes disponibles pour cette base de données (format ISO8601).

properties.elasticPoolId

string (arm-id)

Identificateur de ressource du pool élastique contenant cette base de données.

properties.encryptionProtector

string

URI du coffre de clés Azure de la base de données s’il est configuré avec les clés gérées par le client de base de données.

properties.encryptionProtectorAutoRotation

boolean

Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données.

properties.failoverGroupId

string

Identificateur de ressource de groupe de basculement auquel appartient cette base de données.

properties.federatedClientId

string (uuid)

ID client utilisé pour le scénario CMK entre locataires par base de données

properties.freeLimitExhaustionBehavior

FreeLimitExhaustionBehavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois.

BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

properties.highAvailabilityReplicaCount

integer (int32)

Nombre de réplicas secondaires associés à la base de données Critique pour l’entreprise, Premium ou Hyperscale qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.isInfraEncryptionEnabled

boolean

Le chiffrement infra est activé pour cette base de données.

properties.isLedgerOn

boolean

Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.

properties.keys

<string,  DatabaseKey>

ID de ressource des identités affectées par l’utilisateur à utiliser

properties.licenseType

DatabaseLicenseType

Type de licence à appliquer pour cette base de données. LicenseIncluded si vous avez besoin d’un permis, ou BasePrice si vous en avez un et êtes éligible au Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données.

properties.maintenanceConfigurationId

string

ID de configuration de maintenance affecté à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent.

properties.manualCutover

boolean

Indique si le basculement manuel contrôlé par le client doit être effectué pendant l’opération de mise à jour de la base de données vers le niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.

properties.maxLogSizeBytes

integer (int64)

Taille maximale du journal pour cette base de données.

properties.maxSizeBytes

integer (int64)

Taille maximale de la base de données exprimée en octets.

properties.minCapacity

number (double)

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue

properties.pausedDate

string (date-time)

Date à laquelle la base de données a été suspendue par configuration utilisateur ou action(ISO8601 format). Null si la base de données est prête.

properties.performCutover

boolean

Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau Critique pour l’entreprise/Usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche le basculement et effectue une modification de rôle vers la base de données Hyperscale.

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS.

properties.readScale

DatabaseReadScale

État du routage en lecture seule. Si activées, les connexions dont l’intention d’application est réglée en lecture seule dans leur chaîne de connexion peuvent être acheminées vers une réplique secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique.

properties.recoverableDatabaseId

string (arm-id)

Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette base de données.

properties.requestedServiceObjectiveName

string

Nom de l’objectif de niveau de service demandé de la base de données.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificateur de ressource de la base de données supprimée pouvant être restaurée associée à l’opération de création de cette base de données.

properties.restorePointInTime

string (date-time)

Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données.

properties.resumedDate

string (date-time)

Date à laquelle la base de données a été reprise par l’action de l’utilisateur ou la connexion à la base de données (format ISO8601). Null si la base de données est suspendue.

properties.sampleName

SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

properties.secondaryType

SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

properties.sourceDatabaseDeletionDate

string (date-time)

Spécifie l’heure à laquelle la base de données a été supprimée.

properties.sourceDatabaseId

string (arm-id)

Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données.

properties.status

DatabaseStatus

État de la base de données.

properties.useFreeLimit

boolean

Indique si la base de données utilise des limites mensuelles gratuites ou non. Autorisé sur une base de données dans un abonnement.

properties.zoneRedundant

boolean

Indique si cette base de données est redondante interzone, ce qui signifie que les réplicas de cette base de données seront répartis entre plusieurs zones de disponibilité.

sku

Sku

Nom et niveau de la référence SKU.

tags

object

Balises de ressource.

DatabaseUserIdentity

Configuration d’identité Azure Active Directory pour une ressource.

Nom Type Description
clientId

string (uuid)

L’ID client Azure Active Directory.

principalId

string (uuid)

L’ID principal d’Azure Active Directory.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

FreeLimitExhaustionBehavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois.

BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

Valeur Description
AutoPause

Autopause

BillOverUsage

BillOverUsage

SampleName

Nom de l’exemple de schéma à appliquer lors de la création de cette base de données.

Valeur Description
AdventureWorksLT

AdventureWorksLT

WideWorldImportersStd

WideWorldImportersStd

WideWorldImportersFull

LargeWorldImportersFull

SecondaryType

Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont geo, nommées et de secours.

Valeur Description
Geo

Zone géographique

Named

Nommé

Standby

Standby (Réserve)

Sku

Référence SKU de ressource ARM.

Nom Type Description
capacity

integer (int32)

Capacité de la référence SKU particulière.

family

string

Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici.

name

string

Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3.

size

string

Taille de la référence SKU particulière

tier

string

Niveau ou édition de la référence SKU particulière, par exemple De base, Premium.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.