Partilhar via

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

  • Referência
Service:
Service Bus
API Version:
2022-10-01-preview

Criar ou atualizar NetworkRuleSet para um Espaço de Nomes.

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

Parâmetros do URI

Name Em Necessário Tipo Description
namespaceName
 path True

string

O nome do espaço de nomes
resourceGroupName
 path True

string

Nome do Grupo de recursos na subscrição do Azure.
subscriptionId
 path True

string

Credenciais de subscrição que identificam exclusivamente uma subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version
 query True

string

Versão da API de Cliente.

Corpo do Pedido

Name Tipo Description
properties.defaultAction

DefaultAction

Ação Predefinida para Conjunto de Regras de Rede
properties.ipRules

NWRuleSetIpRules[]

Lista de IpRules
properties.publicNetworkAccess

PublicNetworkAccessFlag

Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativado.
properties.trustedServiceAccessEnabled

boolean

Valor que indica se o Acesso de Serviço Fidedigno está Ativado ou não.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Listar Regras de VirtualNetwork

Respostas

Name Tipo Description
200 OK

NetworkRuleSet

O Espaço de Nomes NetworkRuleSet foi devolvido com êxito.
Other Status Codes

ErrorResponse

Resposta de erro do ServiceBus que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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

Status code:
200 
{
  "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"
      }
    ]
  }
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.
DefaultAction

Ação Predefinida para Conjunto de Regras de Rede
Error

O objeto de erro.
ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.
ErrorResponse

A resposta ao erro de gestão de recursos.
NetworkRuleIPAction

A ação filtro ip
NetworkRuleSet

Descrição do recurso NetworkRuleSet.
NWRuleSetIpRules

Descrição do recurso NetWorkRuleSet - IpRules.
NWRuleSetVirtualNetworkRules

Descrição do recurso VirtualNetworkRules – NetworkRules.
PublicNetworkAccessFlag

Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativado.
Subnet

Propriedades fornecidas para Sub-rede
systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultAction

Ação Predefinida para Conjunto de Regras de Rede

Name Tipo Description
Allow

string

Deny

string

Error

O objeto de erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorResponse[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorResponse

A resposta ao erro de gestão de recursos.

Name Tipo Description
error

Error

O objeto de erro.

NetworkRuleIPAction

A ação filtro ip

Name Tipo Description
Allow

string

NetworkRuleSet

Descrição do recurso NetworkRuleSet.

Name Tipo Valor Predefinido Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

A localização geográfica onde o recurso se encontra
name

string

O nome do recurso
properties.defaultAction

DefaultAction

Ação Predefinida para Conjunto de Regras de Rede
properties.ipRules

NWRuleSetIpRules[]

Lista de IpRules
properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativado.
properties.trustedServiceAccessEnabled

boolean

Valor que indica se o Acesso de Serviço Fidedigno está Ativado ou não.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Listar Regras de VirtualNetwork
systemData

systemData

Os metadados do sistema relacionados com este recurso.
type

string

O tipo de recurso. Por exemplo, "Microsoft.EventHub/Namespaces" ou "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Descrição do recurso NetWorkRuleSet - IpRules.

Name Tipo Valor Predefinido Description
action

NetworkRuleIPAction

Allow

A ação filtro ip
ipMask

string

Máscara de IP

NWRuleSetVirtualNetworkRules

Descrição do recurso VirtualNetworkRules – NetworkRules.

Name Tipo Description
ignoreMissingVnetServiceEndpoint

boolean

Valor que indica se deve ignorar o Ponto Final de Serviço da VNet em falta
subnet

Subnet

Propriedades da sub-rede

PublicNetworkAccessFlag

Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativado.

Name Tipo Description
Disabled

string

Enabled

string

Subnet

Propriedades fornecidas para Sub-rede

Name Tipo Description
id

string

ID de Recurso da Sub-rede do Rede Virtual

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string

O tipo de identidade que modificou o recurso pela última vez.
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.