Sensitivity Settings - List

Reference

Služba:: Defender for Cloud

Verze rozhraní API:: 2023-02-15-preview

Získá seznam s jedním prostředkem nastavení citlivosti.

GET https://management.azure.com/providers/Microsoft.Security/sensitivitySettings?api-version=2023-02-15-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
api-version	query	True	string	Verze rozhraní API pro operaci

Odpovědi

Name	Typ	Description
200 OK	GetSensitivitySettingsListResponse	Úspěch seznamu nastavení citlivosti
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Get sensitivity settings list

Ukázkový požadavek

GET https://management.azure.com/providers/Microsoft.Security/sensitivitySettings?api-version=2023-02-15-preview


/**
 * Samples for SensitivitySettings List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2023-02-15-preview/examples/
     * SensitivitySettings/GetSensitivitySettingsList_example.json
     */
    /**
     * Sample code: Get sensitivity settings list.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void getSensitivitySettingsList(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.sensitivitySettings().listWithResponse(com.azure.core.util.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

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/preview/2023-02-15-preview/examples/SensitivitySettings/GetSensitivitySettingsList_example.json
func ExampleSensitivitySettingsClient_List() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewSensitivitySettingsClient().List(ctx, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.GetSensitivitySettingsListResponse = armsecurity.GetSensitivitySettingsListResponse{
	// 	Value: []*armsecurity.GetSensitivitySettingsResponse{
	// 		{
	// 			Name: to.Ptr("current"),
	// 			Type: to.Ptr("Microsoft.Security/sensitivitySettings"),
	// 			ID: to.Ptr("/providers/Microsoft.Security/sensitivitySettings"),
	// 			Properties: &armsecurity.GetSensitivitySettingsResponseProperties{
	// 				MipInformation: &armsecurity.GetSensitivitySettingsResponsePropertiesMipInformation{
	// 					BuiltInInfoTypes: []*armsecurity.BuiltInInfoType{
	// 						{
	// 							Name: to.Ptr("Http Authorization Header"),
	// 							Type: to.Ptr("Credentials"),
	// 							ID: to.Ptr("4d0d3eb6-619f-4c8c-810c-c16150c95278"),
	// 						},
	// 						{
	// 							Name: to.Ptr("User Login Credentials"),
	// 							Type: to.Ptr("Credentials"),
	// 							ID: to.Ptr("a98fde82-45b6-4b2c-afd0-ad579cd9f826"),
	// 						},
	// 						{
	// 							Name: to.Ptr("Credit card number"),
	// 							Type: to.Ptr("Finance"),
	// 							ID: to.Ptr("50842eb7-edc8-4019-85dd-5a5c1f2bb085"),
	// 						},
	// 						{
	// 							Name: to.Ptr("EU debit card number"),
	// 							Type: to.Ptr("Finance"),
	// 							ID: to.Ptr("0e9b3178-9678-47dd-a509-37222ca96b42"),
	// 					}},
	// 					CustomInfoTypes: []*armsecurity.InfoType{
	// 						{
	// 							Name: to.Ptr("User created custom info type 1"),
	// 							Description: to.Ptr("Custom info type description"),
	// 							ID: to.Ptr("c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b"),
	// 						},
	// 						{
	// 							Name: to.Ptr("User created custom info type 2"),
	// 							Description: to.Ptr("Custom info type description"),
	// 							ID: to.Ptr("a4fee2b6-5618-404b-a5e7-aa377cd67543"),
	// 						},
	// 						{
	// 							Name: to.Ptr("User created custom info type 3"),
	// 							Description: to.Ptr("Custom info type description"),
	// 							ID: to.Ptr("a355f11e-f87d-4f48-8490-ecf0873325b5"),
	// 					}},
	// 					Labels: []*armsecurity.Label{
	// 						{
	// 							Name: to.Ptr("Public"),
	// 							ID: to.Ptr("fdfb5435-124d-4651-a889-a4210fec6a77"),
	// 							Order: to.Ptr[float32](0),
	// 						},
	// 						{
	// 							Name: to.Ptr("Confidential"),
	// 							ID: to.Ptr("4c5447ec-f7f3-4345-a160-6a5850f2bf0c"),
	// 							Order: to.Ptr[float32](1),
	// 						},
	// 						{
	// 							Name: to.Ptr("Highly Confidential"),
	// 							ID: to.Ptr("f38ac75c-f42a-4c89-aa37-9c4e74101414"),
	// 							Order: to.Ptr[float32](2),
	// 					}},
	// 					MipIntegrationStatus: to.Ptr(armsecurity.MipIntegrationStatusOk),
	// 				},
	// 				SensitiveInfoTypesIDs: []*string{
	// 					to.Ptr("a98fde82-45b6-4b2c-afd0-ad579cd9f826"),
	// 					to.Ptr("4d0d3eb6-619f-4c8c-810c-c16150c95278"),
	// 					to.Ptr("0e9b3178-9678-47dd-a509-37222ca96b42"),
	// 					to.Ptr("c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b")},
	// 					SensitivityThresholdLabelOrder: to.Ptr[float32](1),
	// 				},
	// 		}},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets a list with a single sensitivity settings resource
 *
 * @summary Gets a list with a single sensitivity settings resource
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/preview/2023-02-15-preview/examples/SensitivitySettings/GetSensitivitySettingsList_example.json
 */
async function getSensitivitySettingsList() {
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.sensitivitySettings.list();
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Security/sensitivitySettings",
      "name": "current",
      "type": "Microsoft.Security/sensitivitySettings",
      "properties": {
        "sensitiveInfoTypesIds": [
          "a98fde82-45b6-4b2c-afd0-ad579cd9f826",
          "4d0d3eb6-619f-4c8c-810c-c16150c95278",
          "0e9b3178-9678-47dd-a509-37222ca96b42",
          "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b"
        ],
        "sensitivityThresholdLabelOrder": 1,
        "mipInformation": {
          "mipIntegrationStatus": "Ok",
          "labels": [
            {
              "name": "Public",
              "id": "fdfb5435-124d-4651-a889-a4210fec6a77",
              "order": 0
            },
            {
              "name": "Confidential",
              "id": "4c5447ec-f7f3-4345-a160-6a5850f2bf0c",
              "order": 1
            },
            {
              "name": "Highly Confidential",
              "id": "f38ac75c-f42a-4c89-aa37-9c4e74101414",
              "order": 2
            }
          ],
          "customInfoTypes": [
            {
              "name": "User created custom info type 1",
              "id": "c5f9b9a1-2b9a-4a3a-8c5b-1f3d1d9d9c9b",
              "description": "Custom info type description"
            },
            {
              "name": "User created custom info type 2",
              "id": "a4fee2b6-5618-404b-a5e7-aa377cd67543",
              "description": "Custom info type description"
            },
            {
              "name": "User created custom info type 3",
              "id": "a355f11e-f87d-4f48-8490-ecf0873325b5",
              "description": "Custom info type description"
            }
          ],
          "builtInInfoTypes": [
            {
              "name": "Http Authorization Header",
              "type": "Credentials",
              "id": "4d0d3eb6-619f-4c8c-810c-c16150c95278"
            },
            {
              "name": "User Login Credentials",
              "type": "Credentials",
              "id": "a98fde82-45b6-4b2c-afd0-ad579cd9f826"
            },
            {
              "name": "Credit card number",
              "type": "Finance",
              "id": "50842eb7-edc8-4019-85dd-5a5c1f2bb085"
            },
            {
              "name": "EU debit card number",
              "type": "Finance",
              "id": "0e9b3178-9678-47dd-a509-37222ca96b42"
            }
          ]
        }
      }
    }
  ]
}

Definice

Name	Description
BuiltInInfoType	Předkonfigurovaný typ citlivých informací
CloudError	Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
CloudErrorBody	Podrobnosti o chybě.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
GetSensitivitySettingsListResponse	Seznam s jedním prostředkem nastavení citlivosti
GetSensitivitySettingsResponse	Nastavení citlivosti dat pro zjišťování citlivých dat
InfoType	Vlastní typ informací definovaný uživatelem
Label	Popisek citlivosti microsoftu pro ochranu informací
MipInformation	Předdefinované a vlastní typy informací, popisky a stav integrace služby Microsoft Information Protection
MipIntegrationStatus	Stav integrace služby Microsoft Information Protection
Properties	Vlastnosti nastavení citlivosti

BuiltInInfoType

Předkonfigurovaný typ citlivých informací

Name	Typ	Description
id	string	ID typu informací
name	string	Zobrazovaný název typu informací
type	string	Kategorie integrovaného informačního typu

CloudError

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
error.code	string	Kód chyby.
error.details	CloudErrorBody[]	Podrobnosti o chybě.
error.message	string	Chybová zpráva.
error.target	string	Cíl chyby.

CloudErrorBody

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	CloudErrorBody[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

GetSensitivitySettingsListResponse

Seznam s jedním prostředkem nastavení citlivosti

Name	Typ	Description
value	GetSensitivitySettingsResponse[]	Nastavení citlivosti dat pro zjišťování citlivých dat

GetSensitivitySettingsResponse

Nastavení citlivosti dat pro zjišťování citlivých dat

Name	Typ	Description
id	string	ID nastavení citlivosti
name	string	Název nastavení citlivosti
properties	Properties	Vlastnosti nastavení citlivosti
type	string	Typ nastavení citlivosti

InfoType

Vlastní typ informací definovaný uživatelem

Name	Typ	Description
description	string	Popis typu informací
id	string	ID typu informací
name	string	Zobrazovaný název typu informací

Label

Popisek citlivosti microsoftu pro ochranu informací

Name	Typ	Description
id	string	ID popisku
name	string	Zobrazovaný název popisku
order	number	Popisky jsou seřazené podle úrovně citlivosti. Čím vyšší je pořadí popisku, tím citlivější je.

MipInformation

Předdefinované a vlastní typy informací, popisky a stav integrace služby Microsoft Information Protection

Name	Typ	Description
builtInInfoTypes	BuiltInInfoType[]	Seznam předem nakonfigurovaných typů citlivých informací
customInfoTypes	InfoType[]	Seznam vlastních uživatelsky definovaných typů informací
labels	Label[]	Seznam popisků citlivosti microsoftu pro ochranu informací
mipIntegrationStatus	MipIntegrationStatus	Stav integrace služby Microsoft Information Protection

MipIntegrationStatus

Stav integrace služby Microsoft Information Protection

Name	Typ	Description
Ok	string
noAutoLabelingRules	string
noConsent	string
noMipLabels	string

Properties

Vlastnosti nastavení citlivosti

Name	Typ	Description
mipInformation	MipInformation	Předdefinované a vlastní typy informací, popisky a stav integrace služby Microsoft Information Protection
sensitiveInfoTypesIds	string[]	Seznam ID vybraných typů citlivých informací
sensitivityThresholdLabelId	string	ID popisku prahové hodnoty citlivosti. Každý popisek na tomto pořadí nebo nad tímto pořadím se bude považovat za citlivý.
sensitivityThresholdLabelOrder	number	Pořadí popisku prahové hodnoty citlivosti Každý popisek v této objednávce nebo nad touto objednávkou bude považován za citlivý. Pokud je nastavená hodnota -1, citlivost podle popisků je vypnutá.

Sdílet prostřednictvím

Sensitivity Settings - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Get sensitivity settings list

Ukázkový požadavek

Ukázková odpověď

Definice

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsListResponse

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

Další materiály