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 |
|---|---|---|---|---|
|
access
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
O nome da regra de acesso NSP. |
|
network
|
path | True |
string maxLength: 80pattern: (^[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. |
|
profile
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
O nome do perfil NSP. |
|
resource
|
path | True |
string |
O nome do grupo de recursos. |
|
subscription
|
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 |
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 |
Lista de IDs de assinatura |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Atualizado - A regra de acesso existente é atualizada. Retorna o recurso. |
|
| 201 Created |
Create - Retorna o recurso NspAccessRule criado. |
|
| 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
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 |
|---|---|
|
Access |
Direção que especifica se as regras de acesso são de entrada/saída. |
|
Cloud |
Uma resposta de erro do serviço. |
|
Cloud |
Uma resposta de erro do serviço. |
|
created |
O tipo de identidade que criou o recurso. |
|
Nsp |
O recurso de regra de acesso NSP |
|
nsp |
O estado de provisionamento do recurso de atribuição de escopo. |
|
Perimeter |
|
|
Subscription |
|
|
system |
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 |
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 |
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 |
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 |
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 |
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 |
Lista de IDs de assinatura |
|
| 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 |
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. |