Compartilhar 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 de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Tipo Description
values

FirewallRule[]

Uma regra de firewall do servidor.

Respostas

Nome Tipo Description
200 OK

FirewallRule

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

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

Respostas de erro: ***

  • 400 InvalidResourceId – Identificador de recurso inválido.

  • 400 MismatchingSubscriptionWithUrl – A assinatura fornecida não correspondeu à assinatura na URL.

  • 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL.

  • 400 MismatchingServerNameWithUrl – O nome do servidor fornecido não correspondeu ao nome na URL.

  • 400 InvalidServerFirewallRuleResourceRequest - A solicitação de recurso de regra de firewall do servidor é inválida.

  • 400 InvalidServerFirewallRuleResourceParameters – o parâmetro de recurso de 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 é muito 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 o adaptador de rede pública para o servidor está desabilitado. Para gerenciar regras de firewall no nível do servidor ou do banco de dados, habilite o adaptador de rede pública.

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

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 OperationIdNotFound – A operação com id não existe.

  • 409 OperationCancelled – A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Replace firewall rules

Solicitação de exemplo

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 de exemplo

Código de status:
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 status:
202

Definições

Nome Description
FirewallRule

Uma regra de firewall do servidor.
FirewallRuleList

Uma lista de regras de firewall do servidor.

FirewallRule

Uma regra de firewall do servidor.

Nome Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.endIpAddress

string

O endereço IP final da regra de firewall. Deve ser o formato IPv4. Deve ser maior ou igual a startIpAddress. Use 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. Deve ser o formato IPv4. Use 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.

Nome Tipo Description
values

FirewallRule[]

Uma regra de firewall do servidor.