Namespaces - Network Rule Set - Create Or Update Network Rule Set

Creare o aggiornare NetworkRuleSet per uno spazio dei nomi.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
namespaceName
path True

string

Nome dello spazio dei nomi

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True

string

Versione API client.

Corpo della richiesta

Nome Tipo Descrizione
properties.defaultAction

DefaultAction

Azione predefinita per il set di regole di rete

properties.ipRules

NWRuleSetIpRules[]

Elenco di IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata.

properties.trustedServiceAccessEnabled

boolean

Valore che indica se l'accesso al servizio attendibile è abilitato o meno.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Elencare le regole di rete virtuale

Risposte

Nome Tipo Descrizione
200 OK

NetworkRuleSet

Spazio dei nomi NetworkRuleSet restituito correttamente.

Other Status Codes

ErrorResponse

Risposta di errore del bus di servizio che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

NameSpaceNetworkRuleSetCreate

Sample Request

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

{
  "properties": {
    "defaultAction": "Deny",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/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"
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-AustraliaEast/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-9659/networkruleset/default",
  "name": "default",
  "type": "Microsoft.ServiceBus/Namespaces/NetworkRuleSet",
  "properties": {
    "defaultAction": "Deny",
    "publicNetworkAccess": "Enabled",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/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"
      }
    ]
  }
}

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.

DefaultAction

Azione predefinita per il set di regole di rete

Error

Oggetto error.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorResponse

Risposta all'errore di gestione delle risorse.

NetworkRuleIPAction

Azione filtro IP

NetworkRuleSet

Descrizione della risorsa NetworkRuleSet.

NWRuleSetIpRules

Descrizione della risorsa NetWorkRuleSet - IpRules.

NWRuleSetVirtualNetworkRules

Descrizione della risorsa VirtualNetworkRules - NetworkRules.

PublicNetworkAccessFlag

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata.

Subnet

Proprietà fornite per subnet

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultAction

Azione predefinita per il set di regole di rete

Nome Tipo Descrizione
Allow

string

Deny

string

Error

Oggetto error.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorResponse[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta all'errore di gestione delle risorse.

Nome Tipo Descrizione
error

Error

Oggetto error.

NetworkRuleIPAction

Azione filtro IP

Nome Tipo Descrizione
Allow

string

NetworkRuleSet

Descrizione della risorsa NetworkRuleSet.

Nome Tipo Valore predefinito Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.defaultAction

DefaultAction

Azione predefinita per il set di regole di rete

properties.ipRules

NWRuleSetIpRules[]

Elenco di IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata.

properties.trustedServiceAccessEnabled

boolean

Valore che indica se l'accesso al servizio attendibile è abilitato o meno.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Elencare le regole di rete virtuale

systemData

systemData

Metadati di sistema relativi a questa risorsa.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.EventHub/Namespaces" o "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Descrizione della risorsa NetWorkRuleSet - IpRules.

Nome Tipo Valore predefinito Descrizione
action

NetworkRuleIPAction

Allow

Azione filtro IP

ipMask

string

Maschera IP

NWRuleSetVirtualNetworkRules

Descrizione della risorsa VirtualNetworkRules - NetworkRules.

Nome Tipo Descrizione
ignoreMissingVnetServiceEndpoint

boolean

Valore che indica se ignorare l'endpoint servizio di rete virtuale mancante

subnet

Subnet

Proprietà subnet

PublicNetworkAccessFlag

Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata.

Nome Tipo Descrizione
Disabled

string

Enabled

string

Subnet

Proprietà fornite per subnet

Nome Tipo Descrizione
id

string

ID risorsa della subnet Rete virtuale

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Tipo di identità che ha modificato l'ultima volta la risorsa.

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.