Partilhar via


Network Security Perimeter Access Rules - Create Or Update

Cria ou atualiza uma regra de acesso à rede.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2025-03-01

Parâmetros URI

Nome Em Necessário Tipo Descrição
accessRuleName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

O nome da regra de acesso NSP.

networkSecurityPerimeterName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

O nome do perímetro de segurança de rede.

profileName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

O nome do perfil NSP.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

As credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Órgão do Pedido

Nome Tipo Descrição
properties.addressPrefixes

string[]

Prefixos de endereço de entrada (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direção que especifica se as regras de acesso são de entrada/saída.

properties.emailAddresses

string[]

Regras de saída em formato de endereço de e-mail. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.fullyQualifiedDomainNames

string[]

Regras de saída em formato de nome de domínio totalmente qualificado.

properties.phoneNumbers

string[]

Regras de saída em formato de número de telefone. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.serviceTags

string[]

Regras de entrada do tipo service tag. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.subscriptions

SubscriptionId[]

Lista de IDs de subscrição

Respostas

Nome Tipo Descrição
200 OK

NspAccessRule

Atualizado - A regra de acesso existente é atualizada. Retorna o recurso.

201 Created

NspAccessRule

Create - Retorna o recurso NspAccessRule criado.

Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

NspAccessRulePut

Pedido de exemplo

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2025-03-01

{
  "properties": {
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ]
  }
}

Resposta de exemplo

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}

Definições

Nome Descrição
AccessRuleDirection

Direção que especifica se as regras de acesso são de entrada/saída.

CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

createdByType

O tipo de identidade que criou o recurso.

NspAccessRule

O recurso de regra de acesso NSP

nspProvisioningState

O estado de provisionamento do recurso de atribuição de escopo.

PerimeterBasedAccessRule
SubscriptionId
systemData

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

AccessRuleDirection

Direção que especifica se as regras de acesso são de entrada/saída.

Valor Descrição
Inbound
Outbound

CloudError

Uma resposta de erro do serviço.

Nome Tipo Descrição
error

CloudErrorBody

Corpo do erro na nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Nome Tipo Descrição
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

NspAccessRule

O recurso de regra de acesso NSP

Nome Tipo Descrição
id

string (arm-id)

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

name

string

O nome do recurso

properties.addressPrefixes

string[]

Prefixos de endereço de entrada (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direção que especifica se as regras de acesso são de entrada/saída.

properties.emailAddresses

string[]

Regras de saída em formato de endereço de e-mail. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.fullyQualifiedDomainNames

string[]

Regras de saída em formato de nome de domínio totalmente qualificado.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regra especificada pelo id do perímetro.

properties.phoneNumbers

string[]

Regras de saída em formato de número de telefone. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.provisioningState

nspProvisioningState

O estado de provisionamento do recurso de atribuição de escopo.

properties.serviceTags

string[]

Regras de entrada do tipo service tag. Esse tipo de regra de acesso não está disponível para uso no momento.

properties.subscriptions

SubscriptionId[]

Lista de IDs de subscrição

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

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

nspProvisioningState

O estado de provisionamento do recurso de atribuição de escopo.

Valor Descrição
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

Nome Tipo Descrição
id

string (arm-id)

ID NSP no formato ID ARM.

location

string

Localização do PNS fornecido.

perimeterGuid

string

Guia de recursos do PNS fornecido.

SubscriptionId

Nome Tipo Descrição
id

string (arm-id)

ID da subscrição no formato de ID ARM.

systemData

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

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