Compartilhar via


Workspaces - Get NSP

Obtém uma configuração de perímetro de segurança de rede.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/networkSecurityPerimeterConfigurations/{networkSecurityPerimeterConfigurationName}?api-version=2025-07-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
networkSecurityPerimeterConfigurationName
path True

string

minLength: 1
maxLength: 512
pattern: ^.*$

O nome de uma configuração de perímetro de segurança de rede

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

workspaceName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

O nome do espaço de trabalho.

api-version
query True

string

minLength: 1

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

Respostas

Nome Tipo Description
200 OK

NetworkSecurityPerimeterConfiguration

Recuperado com êxito a configuração.

Other Status Codes

ErrorResponse

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get NSP config by name for Scheduled Query Rule

Solicitação de exemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/exampleRG/providers/Microsoft.OperationalInsights/workspaces/someWorkspace/networkSecurityPerimeterConfigurations/somePerimeterConfiguration?api-version=2025-07-01

Resposta de exemplo

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/exampleRG/providers/Microsoft.OperationalInsights/workspaces/someWorkspace/networkSecurityPerimeterConfigurations/somePerimeterConfiguration",
  "name": "somePerimeterConfiguration",
  "type": "Microsoft.OperationalInsights/workspaces/networkSecurityPerimeterConfigurations",
  "properties": {
    "provisioningState": "Accepted",
    "networkSecurityPerimeter": {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1",
      "location": "japaneast"
    },
    "resourceAssociation": {
      "name": "assoc1",
      "accessMode": "Enforced"
    },
    "profile": {
      "name": "profile1",
      "accessRulesVersion": 0,
      "accessRules": [
        {
          "name": "rule1",
          "properties": {
            "direction": "Inbound",
            "addressPrefixes": [
              "148.0.0.0/8",
              "152.4.6.0/24"
            ]
          }
        }
      ]
    }
  }
}

Definições

Nome Description
AccessRule

Regra de acesso em um perfil de configuração de perímetro de segurança de rede

AccessRuleDirection

Regra de direção de acesso

AccessRuleProperties

Propriedades da regra de acesso

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

IssueType

Tipo de problema

NetworkSecurityPerimeter

Informações sobre um NSP (Perímetro de Segurança de Rede)

NetworkSecurityPerimeterConfiguration

Recurso de configuração de NSP (perímetro de segurança de rede)

NetworkSecurityPerimeterConfigurationProperties

Propriedades de configuração de segurança de rede.

NetworkSecurityPerimeterConfigurationProvisioningState

Estado de provisionamento de uma configuração de perímetro de segurança de rede que está sendo criada ou atualizada.

NetworkSecurityProfile

Perfil de configuração de perímetro de segurança de rede

ProvisioningIssue

Descreve um problema de provisionamento para uma configuração de perímetro de segurança de rede

ProvisioningIssueProperties

Detalhes de um problema de provisionamento para uma configuração de NSP (perímetro de segurança de rede). Os provedores de recursos devem gerar elementos de problema de provisionamento separados para cada problema separado detectado e incluir uma descrição significativa e distinta, bem como quaisquer suggestedResourceIds e suggestedAccessRules apropriados

ResourceAssociation

Informações sobre associação de recursos

ResourceAssociationAccessMode

Modo de acesso da associação de recursos

Severity

Gravidade do problema.

Subscriptions

Assinaturas para regras de entrada

systemData

Metadados relativos à criação e última modificação do recurso.

AccessRule

Regra de acesso em um perfil de configuração de perímetro de segurança de rede

Nome Tipo Description
name

string

Nome da regra de acesso

properties

AccessRuleProperties

Propriedades da regra de acesso

AccessRuleDirection

Regra de direção de acesso

Valor Description
Inbound

Aplica-se ao tráfego de rede de entrada para os recursos protegidos.

Outbound

Aplica-se ao tráfego de rede de saída dos recursos protegidos

AccessRuleProperties

Propriedades da regra de acesso

Nome Tipo Description
addressPrefixes

string[]

Prefixos de endereço no formato CIDR para regras de entrada

direction

AccessRuleDirection

Regra de direção de acesso

emailAddresses

string[]

Endereços de e-mail para regras de saída

fullyQualifiedDomainNames

string[]

Nomes de domínio totalmente qualificados (FQDN) para regras de saída

networkSecurityPerimeters

NetworkSecurityPerimeter[]

Perímetros de segurança de rede para regras de entrada

phoneNumbers

string[]

Números de telefone para regras de saída

subscriptions

Subscriptions[]

Assinaturas para regras de entrada

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

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

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

IssueType

Tipo de problema

Valor Description
Unknown

Tipo de problema desconhecido

ConfigurationPropagationFailure

Ocorreu um erro ao aplicar a configuração do NSP (perímetro de segurança de rede).

MissingPerimeterConfiguration

Um problema de conectividade de rede está ocorrendo no recurso que pode ser resolvido adicionando novos recursos ao NSP (perímetro de segurança de rede) ou modificando as regras de acesso.

MissingIdentityConfiguration

Uma identidade gerenciada não foi associada ao recurso. O recurso ainda poderá validar o tráfego de entrada do NSP (perímetro de segurança de rede) ou das regras de acesso de entrada correspondentes, mas não poderá executar o acesso de saída como membro do NSP.

NetworkSecurityPerimeter

Informações sobre um NSP (Perímetro de Segurança de Rede)

Nome Tipo Description
id

string (arm-id)

ID de recurso do Azure totalmente qualificada do recurso NSP

location

string

Localização do perímetro de segurança de rede

perimeterGuid

string (uuid)

ID exclusivo universal (UUID) do perímetro de segurança de rede

NetworkSecurityPerimeterConfiguration

Recurso de configuração de NSP (perímetro de segurança de rede)

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties

NetworkSecurityPerimeterConfigurationProperties

Propriedades de configuração de segurança de rede.

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

NetworkSecurityPerimeterConfigurationProperties

Propriedades de configuração de segurança de rede.

Nome Tipo Description
networkSecurityPerimeter

NetworkSecurityPerimeter

Informações sobre um NSP (Perímetro de Segurança de Rede)

profile

NetworkSecurityProfile

Perfil de configuração de perímetro de segurança de rede

provisioningIssues

ProvisioningIssue[]

Lista de problemas de provisionamento, se houver

provisioningState

NetworkSecurityPerimeterConfigurationProvisioningState

Estado de provisionamento de uma configuração de perímetro de segurança de rede que está sendo criada ou atualizada.

resourceAssociation

ResourceAssociation

Informações sobre associação de recursos

NetworkSecurityPerimeterConfigurationProvisioningState

Estado de provisionamento de uma configuração de perímetro de segurança de rede que está sendo criada ou atualizada.

Valor Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed
Canceled

NetworkSecurityProfile

Perfil de configuração de perímetro de segurança de rede

Nome Tipo Description
accessRules

AccessRule[]

Lista de regras de acesso

accessRulesVersion

integer (int32)

Versão das regras de acesso atuais

diagnosticSettingsVersion

integer (int32)

Versão atual das configurações de diagnóstico

enabledLogCategories

string[]

Lista de categorias de log habilitadas

name

string

Nome do perfil

ProvisioningIssue

Descreve um problema de provisionamento para uma configuração de perímetro de segurança de rede

Nome Tipo Description
name

string

Nome do problema

properties

ProvisioningIssueProperties

Detalhes de um problema de provisionamento para uma configuração de NSP (perímetro de segurança de rede). Os provedores de recursos devem gerar elementos de problema de provisionamento separados para cada problema separado detectado e incluir uma descrição significativa e distinta, bem como quaisquer suggestedResourceIds e suggestedAccessRules apropriados

ProvisioningIssueProperties

Detalhes de um problema de provisionamento para uma configuração de NSP (perímetro de segurança de rede). Os provedores de recursos devem gerar elementos de problema de provisionamento separados para cada problema separado detectado e incluir uma descrição significativa e distinta, bem como quaisquer suggestedResourceIds e suggestedAccessRules apropriados

Nome Tipo Description
description

string

Descrição do problema

issueType

IssueType

Tipo de problema

severity

Severity

Gravidade do problema.

suggestedAccessRules

AccessRule[]

Regras de acesso que podem ser adicionadas ao NSP (perfil de segurança de rede) para corrigir o problema.

suggestedResourceIds

string[] (arm-id)

IDs de recursos totalmente qualificados de recursos sugeridos que podem ser associados ao NSP (perímetro de segurança de rede) para corrigir o problema.

ResourceAssociation

Informações sobre associação de recursos

Nome Tipo Description
accessMode

ResourceAssociationAccessMode

Modo de acesso da associação de recursos

name

string

Nome da associação de recursos

ResourceAssociationAccessMode

Modo de acesso da associação de recursos

Valor Description
Enforced

Modo de acesso imposto - o tráfego para o recurso que falhou nas verificações de acesso está bloqueado

Learning

Modo de acesso de aprendizagem - o tráfego para o recurso está habilitado para análise, mas não bloqueado

Audit

Modo de acesso de auditoria - o tráfego para o recurso que falha nas verificações de acesso é registrado, mas não bloqueado

Severity

Gravidade do problema.

Valor Description
Warning
Error

Subscriptions

Assinaturas para regras de entrada

Nome Tipo Description
id

string (arm-id)

A ID de recurso do Azure totalmente qualificada da assinatura, por exemplo, ('/subscriptions/00000000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.