Dela via


Nsp Access Rules - Create Or Update

Skapar eller uppdaterar en regel för nätverksåtkomst.

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

URI-parametrar

Name I Obligatorisk Typ Description
accessRuleName
path True

string

Namnet på NSP-åtkomstregeln.

networkSecurityPerimeterName
path True

string

Namnet på nätverkssäkerhetsperimetern.

profileName
path True

string

Namnet på NSP-profilen.

resourceGroupName
path True

string

Namnet på resursgruppen.

subscriptionId
path True

string

Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

api-version
query True

string

Klient-API-version.

Begärandetext

Name Typ Description
location

string

Resursplats.

name

string

Namnet på åtkomstregeln som är unik i en profil. Det här namnet kan användas för att komma åt resursen.

properties.addressPrefixes

string[]

Inkommande adressprefix (IPv4/IPv6)

properties.direction

AccessRuleDirection

Riktning som anger om åtkomstreglerna är inkommande/utgående.

properties.emailAddresses

string[]

E-postadressformat för utgående regler.

properties.fullyQualifiedDomainNames

string[]

Utgående regler fullständigt kvalificerat domännamnsformat.

properties.phoneNumbers

string[]

Utgående regler telefonnummerformat.

properties.subscriptions

SubscriptionId[]

Lista över prenumerations-ID:t

tags

object

Resurstaggar.

Svar

Name Typ Description
200 OK

NspAccessRule

Uppdaterad – Den befintliga åtkomstregeln uppdateras. Returnerar resursen.

201 Created

NspAccessRule

Skapa – returnerar NspAccessRule-resursen som skapats.

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

NspAccessRulePut

Exempelbegäran

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

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

Exempelsvar

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/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": []
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/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": []
  }
}

Definitioner

Name Description
AccessRuleDirection

Riktning som anger om åtkomstreglerna är inkommande/utgående.

CloudError

Ett felsvar från tjänsten.

CloudErrorBody

Ett felsvar från tjänsten.

NspAccessRule

NSP-åtkomstregelresursen

nspProvisioningState

Etableringstillståndet för resursen för omfångstilldelning.

PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

Riktning som anger om åtkomstreglerna är inkommande/utgående.

Name Typ Description
Inbound

string

Outbound

string

CloudError

Ett felsvar från tjänsten.

Name Typ Description
error

CloudErrorBody

Molnfeltext.

CloudErrorBody

Ett felsvar från tjänsten.

Name Typ Description
code

string

En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.

details

CloudErrorBody[]

En lista med ytterligare information om felet.

message

string

Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.

target

string

Målet för det specifika felet. Till exempel namnet på egenskapen i fel.

NspAccessRule

NSP-åtkomstregelresursen

Name Typ Description
id

string

NSP-åtkomstregelidentifierare.

location

string

Resursplats.

name

string

Namnet på åtkomstregeln som är unik i en profil. Det här namnet kan användas för att komma åt resursen.

properties.addressPrefixes

string[]

Inkommande adressprefix (IPv4/IPv6)

properties.direction

AccessRuleDirection

Riktning som anger om åtkomstreglerna är inkommande/utgående.

properties.emailAddresses

string[]

E-postadressformat för utgående regler.

properties.fullyQualifiedDomainNames

string[]

Utgående regler fullständigt kvalificerat domännamnsformat.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regel som anges av perimeter-ID:t.

properties.phoneNumbers

string[]

Utgående regler telefonnummerformat.

properties.provisioningState

nspProvisioningState

Etableringstillståndet för resursen för omfångstilldelning.

properties.subscriptions

SubscriptionId[]

Lista över prenumerations-ID:t

tags

object

Resurstaggar.

type

string

Resurstyp.

nspProvisioningState

Etableringstillståndet för resursen för omfångstilldelning.

Name Typ Description
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

PerimeterBasedAccessRule

Name Typ Description
id

string

NSP-ID i ARM-ID-format.

location

string

Plats för den angivna NSP:n.

perimeterGuid

string

Resurs-GUID för angiven NSP.

SubscriptionId

Name Typ Description
id

string

Prenumerations-ID i ARM-ID-format.