Partilhar via


Information Protection Policies - Get

Detalhes da política de proteção de informações.

GET https://management.azure.com/{scope}/providers/Microsoft.Security/informationProtectionPolicies/{informationProtectionPolicyName}?api-version=2017-08-01-preview

Parâmetros do URI

Name Em Necessário Tipo Description
informationProtectionPolicyName
path True

InformationProtectionPolicyName

Nome da política de proteção de informações.

scope
path True

string

O escopo da consulta pode ser assinatura (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) ou grupo de gerenciamento (/providers/Microsoft.Management/managementGroups/mgName).

api-version
query True

string

Versão da API para a operação

Respostas

Name Tipo Description
200 OK

InformationProtectionPolicy

OK

Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Get the customized information protection policy for a management group
Get the effective information protection policy for a management group

Get the customized information protection policy for a management group

Pedido de amostra

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/custom?api-version=2017-08-01-preview

Resposta da amostra

{
  "id": "/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/custom",
  "name": "custom",
  "type": "Microsoft.Security/informationProtectionPolicies",
  "properties": {
    "labels": {
      "1345da73-bc5a-4a8f-b7dd-3820eb713da8": {
        "displayName": "Public",
        "order": 100,
        "enabled": true
      },
      "7aa516c7-5a53-4857-bc6e-6808c6acd542": {
        "displayName": "General",
        "order": 200,
        "enabled": true
      },
      "575739d2-3d53-4df0-9042-4c7772d5c7b1": {
        "displayName": "Confidential",
        "order": 300,
        "enabled": true
      }
    },
    "informationTypes": {
      "7fb9419d-2473-4ad8-8e11-b25cc8cf6a07": {
        "displayName": "Networking",
        "order": 100,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": false
          }
        ]
      },
      "3bf35491-99b8-41f2-86d5-c1200a7df658": {
        "displayName": "Custom",
        "order": 1400,
        "recommendedLabelId": "7aa516c7-5a53-4857-bc6e-6808c6acd542",
        "enabled": true,
        "custom": true,
        "keywords": [
          {
            "pattern": "%custom%",
            "custom": true,
            "canBeNumeric": true
          }
        ]
      }
    }
  }
}

Get the effective information protection policy for a management group

Pedido de amostra

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/effective?api-version=2017-08-01-preview

Resposta da amostra

{
  "id": "/providers/Microsoft.Management/managementGroups/148059f7-faf3-49a6-ba35-85122112291e/providers/Microsoft.Security/informationProtectionPolicies/effective",
  "name": "effective",
  "type": "Microsoft.Security/informationProtectionPolicies",
  "properties": {
    "labels": {
      "1345da73-bc5a-4a8f-b7dd-3820eb713da8": {
        "displayName": "Public",
        "order": 100,
        "enabled": true
      },
      "7aa516c7-5a53-4857-bc6e-6808c6acd542": {
        "displayName": "General",
        "order": 200,
        "enabled": true
      },
      "575739d2-3d53-4df0-9042-4c7772d5c7b1": {
        "displayName": "Confidential",
        "order": 300,
        "enabled": true
      }
    },
    "informationTypes": {
      "7fb9419d-2473-4ad8-8e11-b25cc8cf6a07": {
        "displayName": "Networking",
        "order": 100,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%ip%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "ip%address%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%mac%address%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": true,
            "excluded": true
          }
        ]
      },
      "5856f35c-8e08-4d08-9bf7-87a146150569": {
        "displayName": "Contact Info",
        "order": 200,
        "recommendedLabelId": "575739d2-3d53-4df0-9042-4c7772d5c7b1",
        "enabled": true,
        "custom": false,
        "keywords": [
          {
            "pattern": "%email%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%e-mail%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%addr%",
            "custom": false,
            "canBeNumeric": false
          },
          {
            "pattern": "%street%",
            "custom": false,
            "canBeNumeric": true
          },
          {
            "pattern": "%city%",
            "custom": false,
            "canBeNumeric": false
          }
        ]
      },
      "3bf35491-99b8-41f2-86d5-c1200a7df658": {
        "displayName": "Custom",
        "order": 1400,
        "recommendedLabelId": "7aa516c7-5a53-4857-bc6e-6808c6acd542",
        "enabled": true,
        "custom": true,
        "keywords": [
          {
            "pattern": "%networking%",
            "custom": true,
            "canBeNumeric": false
          }
        ]
      }
    }
  }
}

Definições

Name Description
CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

CloudErrorBody

O detalhe do erro.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

InformationProtectionKeyword

A palavra-chave do tipo de informação.

InformationProtectionPolicy

Política de proteção de informações.

InformationProtectionPolicyName

Nome da política de proteção de informações.

InformationType

O tipo de informação.

rank

A classificação do rótulo de sensibilidade.

SensitivityLabel

O rótulo de sensibilidade.

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

Name Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

error.code

string

O código de erro.

error.details

CloudErrorBody[]

Os detalhes do erro.

error.message

string

A mensagem de erro.

error.target

string

O destino do erro.

CloudErrorBody

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

CloudErrorBody[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

InformationProtectionKeyword

A palavra-chave do tipo de informação.

Name Tipo Description
canBeNumeric

boolean

Indica se a palavra-chave pode ser aplicada em tipos numéricos ou não.

custom

boolean

Indica se a palavra-chave é personalizada ou não.

excluded

boolean

Indica se a palavra-chave é excluída ou não.

pattern

string

O padrão de palavra-chave.

InformationProtectionPolicy

Política de proteção de informações.

Name Tipo Description
id

string

ID do recurso

name

string

Nome do recurso

properties.informationTypes

<string,  InformationType>

Os tipos de informações confidenciais.

properties.labels

<string,  SensitivityLabel>

Dicionário de rótulos de sensibilidade.

properties.lastModifiedUtc

string

Descreve a última hora UTC em que a política foi modificada.

properties.version

string

Descreve a versão da política.

type

string

Tipo de recurso

InformationProtectionPolicyName

Nome da política de proteção de informações.

Name Tipo Description
custom

string

effective

string

InformationType

O tipo de informação.

Name Tipo Description
custom

boolean

Indica se o tipo de informação é personalizado ou não.

description

string

A descrição do tipo de informação.

displayName

string

O nome do tipo de informação.

enabled

boolean

Indica se o tipo de informação está habilitado ou não.

keywords

InformationProtectionKeyword[]

As palavras-chave do tipo de informação.

order

integer

A ordem do tipo de informação.

recommendedLabelId

string

O ID de rótulo recomendado a ser associado a esse tipo de informação.

rank

A classificação do rótulo de sensibilidade.

Name Tipo Description
Critical

string

High

string

Low

string

Medium

string

None

string

SensitivityLabel

O rótulo de sensibilidade.

Name Tipo Description
description

string

A descrição do rótulo de sensibilidade.

displayName

string

O nome do rótulo de sensibilidade.

enabled

boolean

Indica se o rótulo está habilitado ou não.

order

integer

A ordem do rótulo de sensibilidade.

rank

rank

A classificação do rótulo de sensibilidade.