Partilhar via

Firewall Rules - Replace

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Substitui todas as regras de firewall no servidor.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/firewallRules?api-version=2021-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

O ID da subscrição que identifica uma subscrição do Azure.
api-version
 query True

string

A versão da API a utilizar para o pedido.

Corpo do Pedido

Name Tipo Description
values

FirewallRule[]

Uma regra de firewall do servidor.

Respostas

Name Tipo Description
200 OK

FirewallRule

As regras da firewall foram atualizadas com êxito.
202 Accepted

A criação ou atualização das Regras de Firewall do Servidor está em curso.
Other Status Codes

Respostas de Erro: ***

  • 400 InvalidResourceId – identificador de recurso inválido.

  • 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não correspondeu à subscrição no URL.

  • 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no URL.

  • 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no URL.

  • 400 InvalidServerFirewallRuleResourceRequest – o pedido de recurso da regra de firewall do servidor é inválido.

  • 400 InvalidServerFirewallRuleResourceParameters – o parâmetro de recurso da regra de firewall do servidor é inválido.

  • 400 FirewallRuleNotIPv4Address – o endereço da regra de firewall fornecido não é IPv4

  • 400 TooManyFirewallRules – as regras de firewall fornecidas estão acima do limite.

  • 400 FirewallRuleInvalidRange – o intervalo de regras de firewall especificado é inválido.

  • 400 FirewallRuleNameTooLong – o nome da regra de firewall fornecido é demasiado longo

  • 400 FirewallRuleNameEmpty – o nome da regra de firewall fornecido está vazio

  • 400 DenyPublicEndpointEnabled – não é possível criar ou modificar regras de firewall quando a interface de rede pública do servidor está desativada. Para gerir regras de firewall ao nível do servidor ou da base de dados, ative a interface de rede pública.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

  • 404 OperationIdNotFound – a operação com o ID não existe.

  • 409 OperationCancelled - A operação foi cancelada pelo utilizador.

  • 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

  • 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Replace firewall rules

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules?api-version=2021-11-01

{
  "values": [
    {
      "name": "firewallrulecrudtest-5370 ",
      "properties": {
        "startIpAddress": "0.0.0.0",
        "endIpAddress": "100.0.0.0"
      }
    }
  ]
}

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}
Código de estado:
202

Definições

Name Description
FirewallRule

Uma regra de firewall do servidor.
FirewallRuleList

Uma lista de regras de firewall do servidor.

FirewallRule

Uma regra de firewall do servidor.

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.endIpAddress

string

O endereço IP final da regra de firewall. Tem de ter o formato IPv4. Tem de ser maior ou igual a startIpAddress. Utilize o valor "0.0.0.0" para todos os endereços IP internos do Azure.
properties.startIpAddress

string

O endereço IP inicial da regra de firewall. Tem de ter o formato IPv4. Utilize o valor "0.0.0.0" para todos os endereços IP internos do Azure.
type

string

Tipo de recurso.

FirewallRuleList

Uma lista de regras de firewall do servidor.

Name Tipo Description
values

FirewallRule[]

Uma regra de firewall do servidor.