Partilhar via

Firewall Rules - Create Or Update

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

Cria ou atualiza uma regra de firewall.

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

Parâmetros do URI

Name Em Necessário Tipo Description
firewallRuleName
 path True

string

O nome da regra de firewall.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou 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 do Pedido

Name Tipo Description
name

string

Nome do recurso.
properties.endIpAddress

string

O endereço IP final da regra de firewall. Deve ser 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 formato IPv4. Use o valor '0.0.0.0' para todos os endereços IP internos do Azure.

Respostas

Name Tipo Description
200 OK

FirewallRule

Atualizada com êxito a regra de firewall.
201 Created

FirewallRule

Criada com êxito a regra de firewall.
Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está no estado de parada/parada

  • 400 ManagedInstanceStarting - Operação conflitante enviada enquanto a instância está no estado inicial

  • 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 correspondia 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 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 é 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 a interface de rede pública para o servidor está desativada. Para gerenciar regras de firewall no nível do servidor ou do banco de dados, habilite a interface de rede pública.

  • 400 FirewallRuleNameInvalid - O nome da regra de firewall fornecido contém caracteres especiais.

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

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

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Create a firewall rule max/min
Update a firewall rule max/min

Create a firewall rule max/min

Pedido de amostra

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

{
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

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:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

Update a firewall rule max/min

Pedido de amostra

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

{
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

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-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

Definições

Name Description
ErrorAdditionalInfo

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

O detalhe do erro.
ErrorResponse

Resposta de erro
FirewallRule

Uma regra de firewall do servidor.

ErrorAdditionalInfo

Object

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.

ErrorDetail

Object

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Object

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

FirewallRule

Object

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. Deve ser 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 formato IPv4. Use o valor '0.0.0.0' para todos os endereços IP internos do Azure.
type

string

Tipo de recurso.