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 |
---|---|---|---|---|
namespace
|
path | True |
string |
Nome dello spazio dei nomi |
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione di Azure. |
subscription
|
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 |
Azione predefinita per il set di regole di rete |
|
properties.ipRules |
Elenco di IpRules |
|
properties.publicNetworkAccess |
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 |
Elencare le regole di rete virtuale |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Spazio dei nomi NetworkRuleSet restituito correttamente. |
|
Other Status Codes |
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 |
---|---|
created |
Tipo di identità che ha creato la risorsa. |
Default |
Azione predefinita per il set di regole di rete |
Error |
Oggetto error. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Risposta all'errore di gestione delle risorse. |
Network |
Azione filtro IP |
Network |
Descrizione della risorsa NetworkRuleSet. |
NWRule |
Descrizione della risorsa NetWorkRuleSet - IpRules. |
NWRule |
Descrizione della risorsa VirtualNetworkRules - NetworkRules. |
Public |
Ciò determina se il traffico è consentito sulla rete pubblica. Per impostazione predefinita, è abilitata. |
Subnet |
Proprietà fornite per subnet |
system |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
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 |
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 |
Azione predefinita per il set di regole di rete |
||
properties.ipRules |
Elenco di IpRules |
||
properties.publicNetworkAccess | 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 |
Elencare le regole di rete virtuale |
||
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 | 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 |
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 |
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 |
Tipo di identità che ha modificato l'ultima volta la risorsa. |