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 |
|---|---|---|---|---|
|
network
|
path | True |
string minLength: 1maxLength: 512 pattern: ^.*$ |
O nome de uma configuração de perímetro de segurança de rede |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
A ID da assinatura de destino. |
|
workspace
|
path | True |
string minLength: 4maxLength: 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 |
Recuperado com êxito a configuração. |
|
| Other Status Codes |
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 |
|---|---|
|
Access |
Regra de acesso em um perfil de configuração de perímetro de segurança de rede |
|
Access |
Regra de direção de acesso |
|
Access |
Propriedades da regra de acesso |
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Issue |
Tipo de problema |
|
Network |
Informações sobre um NSP (Perímetro de Segurança de Rede) |
|
Network |
Recurso de configuração de NSP (perímetro de segurança de rede) |
|
Network |
Propriedades de configuração de segurança de rede. |
|
Network |
Estado de provisionamento de uma configuração de perímetro de segurança de rede que está sendo criada ou atualizada. |
|
Network |
Perfil de configuração de perímetro de segurança de rede |
|
Provisioning |
Descreve um problema de provisionamento para uma configuração de perímetro de segurança de rede |
|
Provisioning |
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 |
|
Resource |
Informações sobre associação de recursos |
|
Resource |
Modo de acesso da associação de recursos |
| Severity |
Gravidade do problema. |
| Subscriptions |
Assinaturas para regras de entrada |
|
system |
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 |
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 |
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 |
Perímetros de segurança de rede para regras de entrada |
|
| phoneNumbers |
string[] |
Números de telefone para regras de saída |
| 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 |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
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 |
Propriedades de configuração de segurança de rede. |
|
| 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 |
Informações sobre um NSP (Perímetro de Segurança de Rede) |
|
| profile |
Perfil de configuração de perímetro de segurança de rede |
|
| provisioningIssues |
Lista de problemas de provisionamento, se houver |
|
| provisioningState |
Estado de provisionamento de uma configuração de perímetro de segurança de rede que está sendo criada ou atualizada. |
|
| 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 |
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 |
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 |
Tipo de problema |
|
| severity |
Gravidade do problema. |
|
| suggestedAccessRules |
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 |
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |