Information Protection Policies - List

Serviço:: Defender for Cloud

Versão API:: 2017-08-01-preview

Políticas de proteção de informações de um grupo de gerenciamento específico.

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

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
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

Nome	Tipo	Descrição
200 OK	InformationProtectionPolicyList	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
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

Get information protection policies

Pedido de exemplo

HTTP

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

Resposta de exemplo

Código de estado:: 200

{
  "value": [
    {
      "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
              }
            ]
          },
          "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
              }
            ]
          }
        }
      }
    },
    {
      "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
              }
            ]
          }
        }
      }
    }
  ]
}

Definições

Nome	Descrição
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.
InformationProtectionPolicyList	Resposta às políticas 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

Objetivo

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.)

Nome	Tipo	Descrição
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

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
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

Objetivo

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

Nome	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

InformationProtectionKeyword

Objetivo

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

Nome	Tipo	Descrição
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

Objetivo

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

Nome	Tipo	Descrição
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 (date-time)	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

InformationProtectionPolicyList

Objetivo

Resposta às políticas de proteção de informações.

Nome	Tipo	Descrição
nextLink	string	O URI para buscar a próxima página.
value	InformationProtectionPolicy[]	Lista de políticas de proteção de informações.

InformationType

Objetivo

O tipo de informação.

Nome	Tipo	Descrição
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 (int32)	A ordem do tipo de informação.
recommendedLabelId	string (uuid)	O ID de rótulo recomendado a ser associado a esse tipo de informação.

rank

Enumeração

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

Valor	Descrição
None
Low
Medium
High
Critical

SensitivityLabel

Objetivo

O rótulo de sensibilidade.

Nome	Tipo	Descrição
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 (int32)	A ordem do rótulo de sensibilidade.
rank	rank	A classificação do rótulo de sensibilidade.

Partilhar via

Information Protection Policies - List

Parâmetros URI

Respostas

Segurança

azure_auth

Alcances

Exemplos

Get information protection policies

Pedido de exemplo

Resposta de exemplo

Definições

CloudError

CloudErrorBody

ErrorAdditionalInfo

InformationProtectionKeyword

InformationProtectionPolicy

InformationProtectionPolicyList

InformationType

rank

SensitivityLabel