Sensitivity Labels - List Current By Database

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém as etiquetas de confidencialidade de uma determinada base de dados

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

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/currentSensitivityLabels?$skipToken={$skipToken}&$count={$count}&$filter={$filter}&api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.
$count	query		boolean
$filter	query		string	Uma expressão de filtro OData que filtra elementos na coleção.
$skipToken	query		string

Respostas

Name	Tipo	Description
200 OK	SensitivityLabelListResult	As etiquetas de confidencialidade foram obtidas com êxito.
Other Status Codes		Respostas de Erro: *** 400 DatawarehouseDatabaseIsDeactivated – não foi possível executar a operação de Classificação de Dados porque a base de dados está em pausa. Retome-o. 400 SensitivityLabelsInvalidODataQuery - A consulta OData especificada não é válida ou não é suportada 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 503 DatabaseUnavailable - A operação falhou porque a base de dados não está disponível.

Exemplos

Gets the current sensitivity labels of a given database

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/currentSensitivityLabels?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for SensitivityLabels ListCurrentByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * SensitivityLabelsListByDatabaseWithSourceCurrent.json
     */
    /**
     * Sample code: Gets the current sensitivity labels of a given database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheCurrentSensitivityLabelsOfAGivenDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().listCurrentByDatabase("myRG", "myServer",
            "myDatabase", null, null, null, 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

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn3/sensitivityLabels/current",
      "name": "current",
      "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
      "properties": {
        "schemaName": "dbo",
        "tableName": "myTable",
        "columnName": "myColumn3",
        "informationType": "Financial",
        "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
        "labelId": "05e6eaa1-075a-4fb4-a732-a92215a2444a",
        "labelName": "Sensitive",
        "rank": "Low"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn4/sensitivityLabels/current",
      "name": "current",
      "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
      "properties": {
        "schemaName": "dbo",
        "tableName": "myTable",
        "columnName": "myColumn4",
        "informationType": "Email",
        "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
        "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
        "labelName": "PII",
        "rank": "None"
      }
    }
  ]
}

Definições

Name	Description
SensitivityLabel	Uma etiqueta de confidencialidade.
SensitivityLabelListResult	Uma lista de etiquetas de confidencialidade.
SensitivityLabelRank

SensitivityLabel

Uma etiqueta de confidencialidade.

Name	Tipo	Description
id	string	ID do Recurso.
managedBy	string	Recurso que gere a etiqueta de confidencialidade.
name	string	Nome do recurso.
properties.columnName	string	O nome da coluna.
properties.informationType	string	O tipo de informação.
properties.informationTypeId	string	O ID do tipo de informação.
properties.isDisabled	boolean	A recomendação de confidencialidade está desativada. Aplicável apenas à etiqueta de confidencialidade recomendada. Especifica se a recomendação de confidencialidade nesta coluna está desativada (dispensada) ou não.
properties.labelId	string	O ID da etiqueta.
properties.labelName	string	O nome da etiqueta.
properties.rank	SensitivityLabelRank
properties.schemaName	string	O nome do esquema.
properties.tableName	string	O nome da tabela.
type	string	Tipo de recurso.

SensitivityLabelListResult

Uma lista de etiquetas de confidencialidade.

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	SensitivityLabel[]	Matriz de resultados.

SensitivityLabelRank

Name	Tipo	Description
Critical	string
High	string
Low	string
Medium	string
None	string