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

Utwórz lub zaktualizuj element NetworkRuleSet dla przestrzeni nazw.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
namespaceName
path True

string

Nazwa przestrzeni nazw

resourceGroupName
path True

string

Nazwa grupy zasobów w ramach subskrypcji platformy Azure.

subscriptionId
path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Typ Opis
properties.defaultAction

DefaultAction

Domyślna akcja dla zestawu reguł sieci

properties.ipRules

NWRuleSetIpRules[]

Lista reguł IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona.

properties.trustedServiceAccessEnabled

boolean

Wartość wskazująca, czy dostęp do zaufanej usługi jest włączony, czy nie.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Wyświetlanie listy reguł sieci wirtualnej

Odpowiedzi

Nazwa Typ Opis
200 OK

NetworkRuleSet

Pomyślnie zwrócono przestrzeń nazw NetworkRuleSet.

Other Status Codes

ErrorResponse

Odpowiedź o błędzie serviceBus opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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"
      }
    ]
  }
}

Definicje

Nazwa Opis
createdByType

Typ tożsamości, która utworzyła zasób.

DefaultAction

Domyślna akcja dla zestawu reguł sieci

Error

Obiekt error.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorResponse

Odpowiedź na błąd zarządzania zasobami.

NetworkRuleIPAction

Akcja filtru IP

NetworkRuleSet

Opis zasobu NetworkRuleSet.

NWRuleSetIpRules

Opis zasobu NetWorkRuleSet — IpRules.

NWRuleSetVirtualNetworkRules

Opis zasobu VirtualNetworkRules — NetworkRules.

PublicNetworkAccessFlag

Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona.

Subnet

Właściwości podane dla podsieci

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultAction

Domyślna akcja dla zestawu reguł sieci

Nazwa Typ Opis
Allow

string

Deny

string

Error

Obiekt error.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorResponse[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd zarządzania zasobami.

Nazwa Typ Opis
error

Error

Obiekt error.

NetworkRuleIPAction

Akcja filtru IP

Nazwa Typ Opis
Allow

string

NetworkRuleSet

Opis zasobu NetworkRuleSet.

Nazwa Typ Wartość domyślna Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.defaultAction

DefaultAction

Domyślna akcja dla zestawu reguł sieci

properties.ipRules

NWRuleSetIpRules[]

Lista reguł IpRules

properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona.

properties.trustedServiceAccessEnabled

boolean

Wartość wskazująca, czy dostęp do zaufanej usługi jest włączony, czy nie.

properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Wyświetlanie listy reguł sieci wirtualnej

systemData

systemData

Metadane systemowe odnoszące się do tego zasobu.

type

string

Typ zasobu. Np. "Microsoft.EventHub/Namespaces" lub "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Opis zasobu NetWorkRuleSet — IpRules.

Nazwa Typ Wartość domyślna Opis
action

NetworkRuleIPAction

Allow

Akcja filtru IP

ipMask

string

Maska adresów IP

NWRuleSetVirtualNetworkRules

Opis zasobu VirtualNetworkRules — NetworkRules.

Nazwa Typ Opis
ignoreMissingVnetServiceEndpoint

boolean

Wartość wskazująca, czy ignorować brakujący punkt końcowy usługi sieci wirtualnej

subnet

Subnet

Właściwości podsieci

PublicNetworkAccessFlag

Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona.

Nazwa Typ Opis
Disabled

string

Enabled

string

Subnet

Właściwości podane dla podsieci

Nazwa Typ Opis
id

string

Identyfikator zasobu podsieci Virtual Network

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Typ tożsamości, która ostatnio zmodyfikowała zasób.

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.