Sensitivity Settings - List

Referens

Tjänst:: Defender for Cloud

API-version:: 2023-02-15-preview

Hämtar en lista med en enskild resurs för känslighetsinställningar

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
api-version	query	True	string	API-version för åtgärden

Svar

Name	Typ	Description
200 OK	GetSensitivitySettingsListResponse	Lyckad lista över känslighetsinställningar hämtas
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Get sensitivity settings list

Exempelbegäran

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

Exempelsvar

Statuskod:: 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"
            }
          ]
        }
      }
    }
  ]
}

Definitioner

Name	Description
BuiltInInfoType	Förkonfigurerad typ av känslig information
CloudError	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
CloudErrorBody	Felinformationen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
GetSensitivitySettingsListResponse	En lista med en enskild resurs för känslighetsinställningar
GetSensitivitySettingsResponse	Inställningar för datakänslighet för identifiering av känsliga data
InfoType	Anpassad användardefinierad informationstyp
Label	Känslighetsetikett för Microsoft Information Protection
MipInformation	Inbyggda och anpassade informationstyper, etiketter och integreringsstatus för Microsoft Information Protection.
MipIntegrationStatus	Integreringsstatus för Microsoft Information Protection
Properties	Egenskaperna för känslighetsinställningar

BuiltInInfoType

Förkonfigurerad typ av känslig information

Name	Typ	Description
id	string	ID för informationstypen
name	string	Visningsnamn för informationstypen
type	string	Kategori för den inbyggda informationstypen

CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
error.code	string	Felkoden.
error.details	CloudErrorBody[]	Felinformationen.
error.message	string	Felmeddelandet.
error.target	string	Felmålet.

CloudErrorBody

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	CloudErrorBody[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

GetSensitivitySettingsListResponse

En lista med en enskild resurs för känslighetsinställningar

Name	Typ	Description
value	GetSensitivitySettingsResponse[]	Inställningar för datakänslighet för identifiering av känsliga data

GetSensitivitySettingsResponse

Inställningar för datakänslighet för identifiering av känsliga data

Name	Typ	Description
id	string	ID för känslighetsinställningarna
name	string	Namnet på känslighetsinställningarna
properties	Properties	Egenskaperna för känslighetsinställningar
type	string	Typ av känslighetsinställningar

InfoType

Anpassad användardefinierad informationstyp

Name	Typ	Description
description	string	Beskrivning av informationstypen
id	string	ID för informationstypen
name	string	Visningsnamn för informationstypen

Label

Känslighetsetikett för Microsoft Information Protection

Name	Typ	Description
id	string	Etikettens ID
name	string	Etikettens visningsnamn
order	number	Etiketter sorteras efter känslighetsnivå. Ju högre ordning etiketten är, desto känsligare är den.

MipInformation

Inbyggda och anpassade informationstyper, etiketter och integreringsstatus för Microsoft Information Protection.

Name	Typ	Description
builtInInfoTypes	BuiltInInfoType[]	Lista över förkonfigurerade typer av känslig information
customInfoTypes	InfoType[]	Lista över anpassade användardefinierade informationstyper
labels	Label[]	Lista över känslighetsetiketter för Microsoft Information Protection
mipIntegrationStatus	MipIntegrationStatus	Integreringsstatus för Microsoft Information Protection

MipIntegrationStatus

Integreringsstatus för Microsoft Information Protection

Name	Typ	Description
Ok	string
noAutoLabelingRules	string
noConsent	string
noMipLabels	string

Properties

Egenskaperna för känslighetsinställningar

Name	Typ	Description
mipInformation	MipInformation	Inbyggda och anpassade informationstyper, etiketter och integreringsstatus för Microsoft Information Protection.
sensitiveInfoTypesIds	string[]	Lista över valda ID:er för känsliga informationstyper.
sensitivityThresholdLabelId	string	ID för känslighetströskeletiketten. Alla etiketter vid eller över den här rangordningen betraktas som känsliga.
sensitivityThresholdLabelOrder	number	Ordningen på känslighetströskeletiketten. Alla etiketter vid eller ovanför den här ordningen betraktas som känsliga. Om värdet är -1 inaktiveras känsligheten för etiketter

Dela via

Sensitivity Settings - List

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Get sensitivity settings list

Exempelbegäran

Exempelsvar

Definitioner

BuiltInInfoType

CloudError

CloudErrorBody

ErrorAdditionalInfo

GetSensitivitySettingsListResponse

GetSensitivitySettingsResponse

InfoType

Label

MipInformation

MipIntegrationStatus

Properties

Ytterligare resurser