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

Referência

Serviço:: Service Bus

Versão da API:: 2023-01-01-preview

Crie ou atualize NetworkRuleSet para um namespace.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
namespaceName	path	True	string	O nome do namespace
resourceGroupName	path	True	string	Nome do grupo de Recursos dentro da assinatura do Azure.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Corpo do Pedido

Name	Tipo	Description
properties.defaultAction	DefaultAction	Ação padrão para o conjunto de regras de rede
properties.ipRules	NWRuleSetIpRules[]	Lista de IpRules
properties.publicNetworkAccess	PublicNetworkAccessFlag	Isso determina se o tráfego é permitido na rede pública. Por padrão, ele está habilitado.
properties.trustedServiceAccessEnabled	boolean	Valor que indica se o Acesso ao Serviço Confiável está Habilitado ou não.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]	Listar regras do VirtualNetwork

Respostas

Name	Tipo	Description
200 OK	NetworkRuleSet	Namespace NetworkRuleSet retornado com êxito.
Other Status Codes	ErrorResponse	Resposta de erro do ServiceBus descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

NameSpaceNetworkRuleSetCreate

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2023-01-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"
      }
    ]
  }
}

Resposta da amostra

Código de estado:: 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 padrão para o conjunto de regras de rede
Error	O objeto de erro.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorResponse	A resposta de erro de gerenciamento de recursos.
NetworkRuleIPAction	A ação do filtro IP
NetworkRuleSet	Descrição do recurso NetworkRuleSet.
NWRuleSetIpRules	Descrição do recurso NetWorkRuleSet - IpRules.
NWRuleSetVirtualNetworkRules	Descrição do recurso VirtualNetworkRules - NetworkRules.
PublicNetworkAccessFlag	Isso determina se o tráfego é permitido na rede pública. Por padrão, ele está habilitado.
Subnet	Propriedades fornecidas para Sub-rede
systemData	Metadados referentes à 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 padrão para o conjunto de regras de rede

Name	Tipo	Description
Allow	string
Deny	string

Error

O objeto de erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorResponse

A resposta de erro de gerenciamento de recursos.

Name	Tipo	Description
error	Error	O objeto de erro.

NetworkRuleIPAction

A ação do filtro IP

Name	Tipo	Description
Allow	string

NetworkRuleSet

Descrição do recurso NetworkRuleSet.

Name	Tipo	Default value	Description
id	string		ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		A geolocalização onde o recurso vive
name	string		O nome do recurso
properties.defaultAction	DefaultAction		Ação padrão para o conjunto de regras de rede
properties.ipRules	NWRuleSetIpRules[]		Lista de IpRules
properties.publicNetworkAccess	PublicNetworkAccessFlag	Enabled	Isso determina se o tráfego é permitido na rede pública. Por padrão, ele está habilitado.
properties.trustedServiceAccessEnabled	boolean		Valor que indica se o Acesso ao Serviço Confiável está Habilitado ou não.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]		Listar regras do VirtualNetwork
systemData	systemData		Os metadados do sistema relacionados a este recurso.
type	string		O tipo do recurso. Por exemplo, "Microsoft.EventHub/Namespaces" ou "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Descrição do recurso NetWorkRuleSet - IpRules.

Name	Tipo	Default value	Description
action	NetworkRuleIPAction	Allow	A ação do filtro IP
ipMask	string		Máscara de IP

NWRuleSetVirtualNetworkRules

Descrição do recurso VirtualNetworkRules - NetworkRules.

Name	Tipo	Description
ignoreMissingVnetServiceEndpoint	boolean	Valor que indica se o ponto de extremidade do serviço VNet ausente deve ser ignorado
subnet	Subnet	Propriedades da sub-rede

PublicNetworkAccessFlag

Isso determina se o tráfego é permitido na rede pública. Por padrão, ele está habilitado.

Name	Tipo	Description
Disabled	string
Enabled	string

Subnet

Propriedades fornecidas para Sub-rede

Name	Tipo	Description
id	string	ID de recurso da sub-rede de rede virtual

systemData

Metadados referentes à 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.

Partilhar via