Compartilhar 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 de URI

Nome Em Obrigatório Tipo Description
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. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Corpo da solicitação

Nome Tipo Description
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 no formato de endereço de email. No momento, esse tipo de regra de acesso não está disponível para uso.

properties.fullyQualifiedDomainNames

string[]

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

properties.phoneNumbers

string[]

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

properties.serviceTags

string[]

Regras de entrada da marca de serviço de tipo. No momento, esse tipo de regra de acesso não está disponível para uso.

properties.subscriptions

SubscriptionId[]

Lista de IDs de assinatura

Respostas

Nome Tipo Description
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 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

NspAccessRulePut

Solicitação 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 Description
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 relativos à 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 Description
Inbound
Outbound

CloudError

Uma resposta de erro do serviço.

Nome Tipo Description
error

CloudErrorBody

Corpo do erro da nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

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

target

string

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

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

NspAccessRule

O recurso de regra de acesso NSP

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.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 no formato de endereço de email. No momento, esse tipo de regra de acesso não está disponível para uso.

properties.fullyQualifiedDomainNames

string[]

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

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regra especificada pela ID do perímetro.

properties.phoneNumbers

string[]

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

properties.provisioningState

nspProvisioningState

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

properties.serviceTags

string[]

Regras de entrada da marca de serviço de tipo. No momento, esse tipo de regra de acesso não está disponível para uso.

properties.subscriptions

SubscriptionId[]

Lista de IDs de assinatura

systemData

systemData

Metadados do Azure Resource Manager que contêm 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 Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

Nome Tipo Description
id

string (arm-id)

NSP no formato de ID do ARM.

location

string

Localização do NSP fornecido.

perimeterGuid

string

Guia de recursos do NSP fornecido.

SubscriptionId

Nome Tipo Description
id

string (arm-id)

ID da assinatura no formato de ID do ARM.

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.