Managed Database Sensitivity Labels - Update

Mettez à jour les étiquettes de confidentialité d’une base de données donnée à l’aide d’un lot d’opérations.

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

Paramètres URI

Nom Dans Obligatoire Type Description
databaseName
path True

string

Nom de la base de données.

managedInstanceName
path True

string

Nom de l’instance managée.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

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
operations

SensitivityLabelUpdate[]

Opération de mise à jour d’étiquette de confidentialité.

Réponses

Nom Type Description
200 OK

La demande a réussi.

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

Update sensitivity labels of a given database using an operations batch.

Exemple de requête

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/currentSensitivityLabels?api-version=2025-01-01

{
  "operations": [
    {
      "properties": {
        "schema": "dbo",
        "column": "column1",
        "op": "set",
        "sensitivityLabel": {
          "properties": {
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "labelName": "Highly Confidential"
          }
        },
        "table": "table1"
      }
    },
    {
      "properties": {
        "schema": "dbo",
        "column": "column2",
        "op": "set",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII"
          }
        },
        "table": "table2"
      }
    },
    {
      "properties": {
        "schema": "dbo",
        "column": "Column3",
        "op": "remove",
        "table": "Table1"
      }
    }
  ]
}

Exemple de réponse

Définitions

Nom Description
ClientClassificationSource
createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

SensitivityLabel

Étiquette de confidentialité.

SensitivityLabelRank
SensitivityLabelUpdate

Opération de mise à jour d’étiquette de confidentialité.

SensitivityLabelUpdateKind
SensitivityLabelUpdateList

Liste des opérations de mise à jour d’étiquettes de confidentialité.

systemData

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

ClientClassificationSource

Valeur Description
None

Aucun

Native

Natif

Recommended

Recommandé

MIP

MIP

createdByType

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

Valeur Description
User
Application
ManagedIdentity
Key

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.

SensitivityLabel

Étiquette de confidentialité.

Nom Type Description
id

string (arm-id)

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

managedBy

string

Ressource qui gère l’étiquette de confidentialité.

name

string

Nom de la ressource

properties.clientClassificationSource

ClientClassificationSource

properties.columnName

string

Nom de la colonne.

properties.informationType

string

Type d’informations.

properties.informationTypeId

string

ID de type d’informations.

properties.isDisabled

boolean

La recommandation de confidentialité est désactivée. Applicable uniquement pour l’étiquette de confidentialité recommandée. Spécifie si la recommandation de confidentialité sur cette colonne est désactivée (ignorée) ou non.

properties.labelId

string

ID d’étiquette.

properties.labelName

string

Nom de l’étiquette.

properties.rank

SensitivityLabelRank

properties.schemaName

string

Nom du schéma.

properties.tableName

string

Nom de la table.

systemData

systemData

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

type

string

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

SensitivityLabelRank

Valeur Description
None

Aucun

Low

Low

Medium

Moyenne

High

Élevé

Critical

Essentiel

SensitivityLabelUpdate

Opération de mise à jour d’étiquette de confidentialité.

Nom Type Description
id

string (arm-id)

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

name

string

Nom de la ressource

properties.column

string

Nom de colonne à mettre à jour.

properties.op

SensitivityLabelUpdateKind

properties.schema

string

Nom du schéma de la colonne à mettre à jour.

properties.sensitivityLabel

SensitivityLabel

Informations d’étiquette de confidentialité à appliquer sur une colonne.

properties.table

string

Nom de la table de la colonne à mettre à jour.

systemData

systemData

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

type

string

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

SensitivityLabelUpdateKind

Valeur Description
set

set

remove

supprimer

SensitivityLabelUpdateList

Liste des opérations de mise à jour d’étiquettes de confidentialité.

Nom Type Description
operations

SensitivityLabelUpdate[]

Opération de mise à jour d’étiquette de confidentialité.

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.