Listar todos os perfis de avaliação de linhas de base de segurança

Artigo
04/26/2024

Aplica-se a:

Quer experimentar Gestão de vulnerabilidades do Microsoft Defender? Saiba mais sobre como se pode inscrever na Gestão de vulnerabilidades do Microsoft Defender avaliação de pré-visualização pública.

1. Obter perfis de avaliação de linhas de base de segurança

Esta API obtém uma lista de todos os perfis de avaliação de linhas de base de segurança criados pela organização.

1.1 Parâmetros

Suporta consultas OData V4.
Operadores suportados pelo OData:
- $filter em : id, name, operatingSystem, operatingSystemVersion, status, settingsNumber, passedDevices, totalDevices
- $top com o valor máximo de 10 000.
- $skip.

Pedido HTTP 1.2

GET:/api/baselineProfiles

1.3 Cabeçalhos de pedido

Name	Tipo	Descrição
Autorização	Cadeia	Portador {token}. Obrigatório.

1.4 Propriedades

Propriedade	Tipo	Descrição
ID	Cadeia	Identificador exclusivo para o perfil de linha de base específico.
nome	Cadeia	O nome do perfil.
descrição	Cadeia	A descrição do perfil.
referência	Cadeia	A referência de perfil.
versão	Cadeia	A versão do perfil.
operatingSystem	Cadeia	O sistema operativo aplicável do perfil.
operatingSystemVersion	Cadeia	A versão do sistema operativo aplicável do perfil.
estado	Booleano	Indica se o perfil está ativo ou não
complianceLevel	Cadeia	O nível de conformidade escolhido para o perfil.
settingsNumber	Int	Número de configurações selecionadas no perfil.
createdBy	Cadeia	O utilizador que criou este perfil.
lastUpdatedBy	DateTime	O último utilizador a modificar este perfil.
createdOnTimeOffset	DateTime	A data e hora em que o perfil foi criado.
lastUpdateTimeOffset	DateTime	A data e hora em que o perfil foi atualizado pela última vez.
passedDevices	Int	O número de dispositivos aplicáveis a este perfil que estão em conformidade com todas as configurações do perfil.
totalDispositivos	Int	Número de dispositivos aplicáveis a este perfil.

1.5 Exemplo

1.5.1 Exemplo de pedido

GET https://api.securitycenter.microsoft.com/api/baselineProfiles

1.6.2 Exemplo de resposta

{
    "@odata.context": "https:// api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.PublicBaselineProfileDto)",
    "value":
    [
        {
            "id": "02bcbb9d-d197-479e-811e-1cd5a6f9f8fa",
            "name": "Windows 10 build 1909 CIS profile",
            "description": "important",
            "benchmark": "CIS",
            "version": "1.0.0",
            "operatingSystem": "Windows 10",
            "operatingSystemVersion": "1909",
            "status": true,
            "complianceLevel": "Level 1 (L1) - Corporate/Enterprise Environment (general use)",
            "settingsNumber": 51,
            "createdBy": "user@org.net",
            "lastUpdatedBy": null,
            "createdOnTimestampUTC": "0001-01-01T00:00:00Z",
            "lastUpdateTimestampUTC": "0001-01-01T00:00:00Z",
            "passedDevices": 0,
            "totalDevices": 10
        }
     ]
}

Consulte também

Sugestão

Quer saber mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.

Partilhar via