Delen via

Namespaces - Create Or Update Network Rule Set

  • Referentie
Service:
Event Hubs
API-versie:
2024-01-01

NetworkRuleSet maken of bijwerken voor een naamruimte.

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 serviceoproep.
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 via een openbaar netwerk is toegestaan. Deze functie is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt binnenkomende 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-foutantwoord 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

Statuscode:
200 
{
  "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 is opgegeven in het foutbericht.
NetworkRuleIPAction

De IP-filteractie
NetworkRuleSet

Beschrijving van onderwerpresource.
NWRuleSetIpRules

Het antwoord van de bewerking Lijstnaamruimte.
NWRuleSetVirtualNetworkRules

Het antwoord van de bewerking Lijstnaamruimte.
PublicNetworkAccessFlag

Hiermee wordt bepaald of verkeer via een openbaar netwerk is toegestaan. Deze functie is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt binnenkomende 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 de laatste wijziging van de resource.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

DefaultAction

Inventarisatie

Standaardactie voor netwerkregelset

Waarde Description
Allow
Deny

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

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

Name Type Description
error

ErrorDetail

Het foutobject.

NetworkRuleIPAction

Inventarisatie

De IP-filteractie

Waarde Description
Allow

NetworkRuleSet

Object

Beschrijving van onderwerpresource.

Name Type Default value Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /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 via een openbaar netwerk is toegestaan. Deze functie is standaard ingeschakeld. Als de waarde SecuredByPerimeter is, wordt binnenkomende 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

Object

Het antwoord van de bewerking Lijstnaamruimte.

Name Type Description
action

NetworkRuleIPAction

De IP-filteractie
ipMask

string

IP-masker

NWRuleSetVirtualNetworkRules

Object

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

Inventarisatie

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

Waarde Description
Disabled
Enabled
SecuredByPerimeter

Subnet

Object

Eigenschappen die zijn opgegeven voor subnet

Name Type Description
id

string

Resource-id van subnet van virtueel netwerk

systemData

Object

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

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

Het type identiteit dat de resource voor het laatst heeft gewijzigd.
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.