Sensitivity Labels - Get

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

Obtient l’étiquette de confidentialité d’une colonne donnée

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/{sensitivityLabelSource}?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
columnName	path	True	string	Nom de la colonne.
databaseName	path	True	string	Nom de la base de données.
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.
schemaName	path	True	string	Nom du schéma.
sensitivityLabelSource	path	True	SensitivityLabelSource	Source de l’étiquette de confidentialité.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
tableName	path	True	string	Nom de la table.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	SensitivityLabel	L’étiquette de confidentialité a été récupérée.
Other Status Codes		Réponses d’erreur : *** 400 DatawarehouseDatabaseIsDeactivated : impossible d’exécuter l’opération de classification des données, car la base de données est suspendue. Veuillez la reprendre. 400 SensitivityLabelSourceNameNotSupported : la source de l’étiquette de confidentialité spécifiée n’est pas valide 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur ce serveur instance. 404 SensitivityLabelsLabelNotFound : l’étiquette de confidentialité spécifiée est introuvable 404 SensitivityLabelsSchemaNotFound : le schéma {0} est introuvable 404 SensitivityLabelsTableNotFound : la table {0} est introuvable dans le schéma {1} 404 SensitivityLabelsColumnNotFound : la colonne {0} est introuvable dans la table {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported : la source de l’étiquette de confidentialité « Recommandé » n’est pas encore prise en charge 501 SensitivityLabelRecommendedSourceNameNotSupported : la source de l’étiquette de confidentialité « Recommandé » n’est pas encore prise en charge

Nom

Type

Description

200 OK

SensitivityLabel

L’étiquette de confidentialité a été récupérée.

Other Status Codes

Réponses d’erreur : ***

400 DatawarehouseDatabaseIsDeactivated : impossible d’exécuter l’opération de classification des données, car la base de données est suspendue. Veuillez la reprendre.
400 SensitivityLabelSourceNameNotSupported : la source de l’étiquette de confidentialité spécifiée n’est pas valide
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur ce serveur instance.
404 SensitivityLabelsLabelNotFound : l’étiquette de confidentialité spécifiée est introuvable
404 SensitivityLabelsSchemaNotFound : le schéma {0} est introuvable
404 SensitivityLabelsTableNotFound : la table {0} est introuvable dans le schéma {1}
404 SensitivityLabelsColumnNotFound : la colonne {0} est introuvable dans la table {2}.{1}
501 SensitivityLabelRecommendedSourceNameNotSupported : la source de l’étiquette de confidentialité « Recommandé » n’est pas encore prise en charge
501 SensitivityLabelRecommendedSourceNameNotSupported : la source de l’étiquette de confidentialité « Recommandé » n’est pas encore prise en charge

Exemples

Gets the sensitivity label of a given column

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2021-11-01


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.SensitivityLabelSource;

/** Samples for SensitivityLabels Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ColumnSensitivityLabelGet.json
     */
    /**
     * Sample code: Gets the sensitivity label of a given column.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsTheSensitivityLabelOfAGivenColumn(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().getWithResponse("myRG", "myServer",
            "myDatabase", "dbo", "myTable", "myColumn", SensitivityLabelSource.CURRENT, 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/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Définitions

Nom	Description
SensitivityLabel	Étiquette de confidentialité.
SensitivityLabelRank
SensitivityLabelSource	Source de l’étiquette de confidentialité.

SensitivityLabel

Étiquette de confidentialité.

Nom	Type	Description
id	string	ID de la ressource
managedBy	string	Ressource qui gère l’étiquette de confidentialité.
name	string	Nom de la ressource.
properties.columnName	string	Nom de la colonne.
properties.informationType	string	Type d’informations.
properties.informationTypeId	string	ID du type d’informations.
properties.isDisabled	boolean	La recommandation de sensibilité est-elle 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 de l’étiquette.
properties.labelName	string	Nom de l'étiquette.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Nom de schéma.
properties.tableName	string	Nom de la table.
type	string	Type de ressource.

SensitivityLabelRank

Nom	Type	Description
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelSource

Source de l’étiquette de confidentialité.

Nom	Type	Description
current	string
recommended	string

Partager via

Sensitivity Labels - Get

Paramètres URI

Réponses

Exemples

Gets the sensitivity label of a given column

Exemple de requête

Exemple de réponse

Définitions

SensitivityLabel

SensitivityLabelRank

SensitivityLabelSource

Ressources supplémentaires