Sensitivity Labels - Update

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Aktualizowanie etykiet poufności danej bazy danych przy użyciu partii operacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
operations	SensitivityLabelUpdate[]	Operacja aktualizacji etykiety poufności.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Pomyślnie zaktualizowano etykiety poufności.
Other Status Codes		Odpowiedzi na błędy: *** 400 DatawarehouseDatabaseIsDeactivated — nie można wykonać operacji klasyfikacji danych, ponieważ baza danych jest wstrzymana. Wznów go. 400 DatawarehouseDatabaseIsDeactivated — nie można wykonać operacji klasyfikacji danych, ponieważ baza danych jest wstrzymana. Wznów go. 400 SensitivityLabelSourceNameNotSupported — określone źródło etykiety poufności jest nieprawidłowe 400 InvalidSensitivityLabelsBatch — określona partia etykiet poufności jest nieprawidłowa. Podaj operacje wsadowe 400 SensitivityLabelsMissingSchema — Operacja[{0}]: Brak informacji o schemacie 400 SensitivityLabelsMissingTable — Operacja[{0}]: Brak informacji o tabeli 400 SensitivityLabelsMissingColumn — Operacja[{0}]: Brak informacji o kolumnie 400 SensitivityLabelsUpdateSameColumnMoreThanOnce — kolumna {0} nie może być aktualizowana więcej niż raz w jednym poleceniu 400 InvalidSensitivityLabelResource — określony zasób etykiety poufności jest nieprawidłowy 400 SensitivityLabelLabelNameAndInfoTypeNotProvided — należy określić co najmniej jedną z właściwości LabelName i InformationType 400 LabelNameTooLong — nazwa etykiety nie może przekraczać {0} znaków 400 InformationTypeTooLong — typ informacji nie może przekraczać {0} znaków 400 LabelIdMustBeGuid — podany identyfikator "labelId" jest nieprawidłowy. Wartość musi być identyfikatorem GUID 400 InformationTypeIdMustBeGuid — podany identyfikator "informationTypeId" jest nieprawidłowy. Wartość musi być identyfikatorem GUID 400 LabelMissing — wymagana jest etykieta. Należy podać co najmniej jedną z wartości "labelName" lub "labelId" 400 InformationTypeMissing — wymagany jest typ informacji. Należy podać co najmniej jedną z wartości "informationTypeId" lub "informationTypeId" 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera. 404 SensitivityLabelsLabelNotFound — nie można odnaleźć określonej etykiety poufności 404 SensitivityLabelsSchemaNotFound — nie można odnaleźć schematu {0} 404 SensitivityLabelsTableNotFound — nie można odnaleźć tabeli {0} w schemacie {1} 404 SensitivityLabelsColumnNotFound — nie można odnaleźć kolumny {0} w tabeli {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported — źródło etykiet poufności "Zalecane" nie jest jeszcze obsługiwane 501 SensitivityLabelRecommendedSourceNameNotSupported — źródło etykiet poufności "Zalecane" nie jest jeszcze obsługiwane 503 DatabaseUnavailable — operacja nie powiodła się, ponieważ baza danych jest niedostępna.

Przykłady

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

Przykładowe żądanie

HTTP

PATCH 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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelUpdateInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for SensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SensitivityLabelsCurrentUpdate.json
     */
    /**
     * Sample code: Update sensitivity labels of a given database using an operations batch.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateSensitivityLabelsOfAGivenDatabaseUsingAnOperationsBatch(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().updateWithResponse("myRG", "myServer",
            "myDatabase",
            new SensitivityLabelUpdateList().withOperations(Arrays.asList(new SensitivityLabelUpdateInner()
                .withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo").withTable("table1").withColumn("column1")
                .withSensitivityLabel(new SensitivityLabelInner().withLabelName("Highly Confidential")
                    .withLabelId("3A477B16-9423-432B-AA97-6069B481CEC3").withInformationType("Financial")
                    .withInformationTypeId("1D3652D6-422C-4115-82F1-65DAEBC665C8").withRank(SensitivityLabelRank.LOW)),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table2").withColumn("column2")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("PII")
                        .withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff").withInformationType("PhoneNumber")
                        .withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                        .withRank(SensitivityLabelRank.CRITICAL)),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.REMOVE).withSchema("dbo")
                    .withTable("Table1").withColumn("Column3"))),
            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

Przykładowa odpowiedź

Kod stanu:

200

Definicje

Nazwa	Opis
SensitivityLabel	Etykieta poufności.
SensitivityLabelRank
SensitivityLabelUpdate	Operacja aktualizacji etykiety poufności.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Lista operacji aktualizacji etykiet poufności.

SensitivityLabel

Etykieta poufności.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
managedBy	string	Zasób, który zarządza etykietą poufności.
name	string	Nazwa zasobu.
properties.columnName	string	Nazwa kolumny.
properties.informationType	string	Typ informacji.
properties.informationTypeId	string	Identyfikator typu informacji.
properties.isDisabled	boolean	Czy rekomendacja dotycząca poufności jest wyłączona. Dotyczy tylko zalecanej etykiety poufności. Określa, czy zalecenie dotyczące poufności w tej kolumnie jest wyłączone (odrzucone) czy nie.
properties.labelId	string	Identyfikator etykiety.
properties.labelName	string	Nazwa etykiety.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Nazwa schematu.
properties.tableName	string	Nazwa tabeli.
type	string	Typ zasobu.

SensitivityLabelRank

Nazwa	Typ	Opis
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelUpdate

Operacja aktualizacji etykiety poufności.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.column	string	Nazwa kolumny do zaktualizowania.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nazwa schematu kolumny do zaktualizowania.
properties.sensitivityLabel	SensitivityLabel	Informacje o etykiecie poufności do zastosowania w kolumnie.
properties.table	string	Nazwa tabeli kolumny do zaktualizowania.
type	string	Typ zasobu.

SensitivityLabelUpdateKind

Nazwa	Typ	Opis
remove	string
set	string

SensitivityLabelUpdateList

Lista operacji aktualizacji etykiet poufności.

Nazwa	Typ	Opis
operations	SensitivityLabelUpdate[]	Operacja aktualizacji etykiety poufności.