Partilhar via

Security Standards - Get

  • Referência
Serviço:
Defender for Cloud
Versão da API:
2024-08-01

Obtenha um padrão de segurança específico para o escopo solicitado por standardId

GET https://management.azure.com/{scope}/providers/Microsoft.Security/securityStandards/{standardId}?api-version=2024-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
scope
 path True

string

O âmbito da norma de segurança. Os escopos válidos são: grupo de gerenciamento (formato: 'providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: 'subscriptions/{subscriptionId}') ou conector de segurança (formato: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName})'
standardId
 path True

string

A chave padrão de segurança - chave exclusiva para o tipo padrão

Padrão Regex: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$
api-version
 query True

string

A versão da API a ser usada para esta operação.

Respostas

Name Tipo Description
200 OK

SecurityStandard

Padrão de segurança criado com êxito
Other Status Codes

ErrorResponse

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 a security standard over management group scope
Get a security standard over security connector scope
Get a security standard over subscription scope

Get a security standard over management group scope

Pedido de amostra

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Resposta da amostra

Código de estado:
200 
{
  "id": "/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Get a security standard over security connector scope

Pedido de amostra

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Get a security standard over subscription scope

Pedido de amostra

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
  "type": "Microsoft.Security/securityStandards",
  "properties": {
    "displayName": "Cross cloud standard 1",
    "standardType": "Custom",
    "description": "Controls and security data implementing security recommendations defined in Azure Security",
    "assessments": [
      {
        "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
      },
      {
        "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
      }
    ],
    "cloudProviders": [
      "GCP"
    ],
    "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
    "metadata": {
      "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "createdOn": "2022-11-10T08:31:26.7993124Z",
      "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
      "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
    }
  }
}

Definições

Name Description
ErrorAdditionalInfo

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

O detalhe do erro.
ErrorResponse

Resposta de erro
PartialAssessmentProperties

Descreve as propriedades de uma avaliação relacionadas com a norma
SecurityStandard

Padrão de segurança em um recurso
StandardMetadata

Os metadados padrão
StandardSupportedCloud

A nuvem na qual o padrão é suportado.
standardType

Tipo padrão (Personalizado ou Padrão ou Conformidade somente atualmente)

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.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

PartialAssessmentProperties

Descreve as propriedades de uma avaliação relacionadas com a norma

Name Tipo Description
assessmentKey

string

A chave de avaliação

SecurityStandard

Padrão de segurança em um recurso

Name Tipo Description
id

string

ID do recurso
name

string

Nome do recurso
properties.assessments

PartialAssessmentProperties[]

Lista de chaves de avaliação a aplicar ao âmbito normalizado.
properties.cloudProviders

StandardSupportedCloud[]

Lista de todas as nuvens padrão suportadas.
properties.description

string

Descrição da norma
properties.displayName

string

Nome de exibição do padrão, equivalente ao standardId
properties.metadata

StandardMetadata

Os metadados padrão de segurança.
properties.policySetDefinitionId

string

A id de definição do conjunto de políticas associada ao padrão.
properties.standardType

standardType

Tipo padrão (Personalizado ou Padrão ou Conformidade somente atualmente)
type

string

Tipo de recurso

StandardMetadata

Os metadados padrão

Name Tipo Description
createdBy

string

Padrão Criado por ID de objeto (GUID)
createdOn

string

Data de criação padrão
lastUpdatedBy

string

Padrão atualizado pela última vez por ID do objeto (GUID)
lastUpdatedOn

string

Data padrão da última atualização

StandardSupportedCloud

A nuvem na qual o padrão é suportado.

Name Tipo Description
AWS

string

Azure

string

GCP

string

standardType

Tipo padrão (Personalizado ou Padrão ou Conformidade somente atualmente)

Name Tipo Description
Compliance

string

Custom

string

Default

string