Delen via


Namespaces - Create Or Update Network Rule Set

NetworkRuleSet voor een naamruimte maken of bijwerken.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/networkRuleSets/default?api-version=2024-01-01

URI-parameters

Name In Vereist Type Description
namespaceName
path True

string

minLength: 6
maxLength: 50
pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$

De naam van de naamruimte

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Naam van de resourcegroep binnen het Azure-abonnement.

subscriptionId
path True

string

Abonnementsreferenties waarmee een Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

api-version
query True

string

Client-API-versie.

Aanvraagbody

Name Type Description
properties.defaultAction

DefaultAction

Standaardactie voor netwerkregelset

properties.ipRules

NWRuleSetIpRules[]

Lijst met IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Hiermee wordt bepaald of verkeer is toegestaan via een openbaar netwerk. Dit is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt inkomende en uitgaande communicatie beheerd door de netwerkbeveiligingsperimeter en de toegangsregels van het profiel.

properties.trustedServiceAccessEnabled

boolean

Waarde die aangeeft of vertrouwde servicetoegang is ingeschakeld of niet.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork-regels weergeven

Antwoorden

Name Type Description
200 OK

NetworkRuleSet

Naamruimte NetworkRuleSet is geretourneerd.

Other Status Codes

ErrorResponse

ServiceBus-foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

NameSpaceNetworkRuleSetCreate

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.EventHub/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2024-01-01

{
  "properties": {
    "defaultAction": "Deny",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        },
        "ignoreMissingVnetServiceEndpoint": false
      }
    ],
    "ipRules": [
      {
        "ipMask": "1.1.1.1",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.2",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.3",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.4",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.5",
        "action": "Allow"
      }
    ]
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/resourcegroupid/providers/Microsoft.EventHub/namespaces/sdk-Namespace-9659/networkruleset/default",
  "name": "default",
  "type": "Microsoft.EventHub/Namespaces/NetworkRuleSet",
  "properties": {
    "defaultAction": "Deny",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        },
        "ignoreMissingVnetServiceEndpoint": false
      }
    ],
    "ipRules": [
      {
        "ipMask": "1.1.1.1",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.2",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.3",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.4",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.5",
        "action": "Allow"
      }
    ]
  }
}

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

DefaultAction

Standaardactie voor netwerkregelset

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie geeft aan dat de Event Hub-service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.

NetworkRuleIPAction

De actie IP-filter

NetworkRuleSet

Beschrijving van onderwerpresource.

NWRuleSetIpRules

Het antwoord van de bewerking Lijstnaamruimte.

NWRuleSetVirtualNetworkRules

Het antwoord van de bewerking Lijstnaamruimte.

PublicNetworkAccessFlag

Hiermee wordt bepaald of verkeer is toegestaan via een openbaar netwerk. Dit is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt inkomende en uitgaande communicatie beheerd door de netwerkbeveiligingsperimeter en de toegangsregels van het profiel.

Subnet

Eigenschappen die zijn opgegeven voor subnet

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

DefaultAction

Standaardactie voor netwerkregelset

Waarde Description
Allow
Deny

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie geeft aan dat de Event Hub-service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.

Name Type Description
error

ErrorDetail

Het foutobject.

NetworkRuleIPAction

De actie IP-filter

Waarde Description
Allow

NetworkRuleSet

Beschrijving van onderwerpresource.

Name Type Default value Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.defaultAction

DefaultAction

Standaardactie voor netwerkregelset

properties.ipRules

NWRuleSetIpRules[]

Lijst met IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

Hiermee wordt bepaald of verkeer is toegestaan via een openbaar netwerk. Dit is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt inkomende en uitgaande communicatie beheerd door de netwerkbeveiligingsperimeter en de toegangsregels van het profiel.

properties.trustedServiceAccessEnabled

boolean

Waarde die aangeeft of vertrouwde servicetoegang is ingeschakeld of niet.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork-regels weergeven

systemData

systemData

De systeemmetagegevens met betrekking tot deze resource.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.EventHub/Namespaces' of 'Microsoft.EventHub/Namespaces/EventHubs'

NWRuleSetIpRules

Het antwoord van de bewerking Lijstnaamruimte.

Name Type Description
action

NetworkRuleIPAction

De actie IP-filter

ipMask

string

IP-masker

NWRuleSetVirtualNetworkRules

Het antwoord van de bewerking Lijstnaamruimte.

Name Type Description
ignoreMissingVnetServiceEndpoint

boolean

Waarde die aangeeft of ontbrekend VNet-service-eindpunt moet worden genegeerd

subnet

Subnet

Subneteigenschappen

PublicNetworkAccessFlag

Hiermee wordt bepaald of verkeer is toegestaan via een openbaar netwerk. Dit is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt inkomende en uitgaande communicatie beheerd door de netwerkbeveiligingsperimeter en de toegangsregels van het profiel.

Waarde Description
Disabled
Enabled
SecuredByPerimeter

Subnet

Eigenschappen die zijn opgegeven voor subnet

Name Type Description
id

string

Resource-id van Virtual Network subnet

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

Het type identiteit dat de resource het laatst heeft gewijzigd.

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.