Partilhar via

IP Firewall ll Rules - Create Or Update

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

Cria ou atualiza uma regra de firewall IPv6.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/ipv6FirewallRules/{firewallRuleName}?api-version=2021-11-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. 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
name

string

Nome do recurso.
properties.endIPv6Address

string

O endereço IP final da regra de firewall. Tem de ser o formato IPv6. Tem de ser maior ou igual a startIpAddress.
properties.startIPv6Address

string

O endereço IP inicial da regra de firewall. Tem de ser o formato IPv6.

Respostas

Name Tipo Description
200 OK

IPv6FirewallRule

A regra de firewall IPv6 foi atualizada com êxito.
201 Created

IPv6FirewallRule

Criou com êxito a regra de firewall IPv6.
Other Status Codes

Respostas de Erro: ***

  • 400 InvalidResourceId - Identificador de recurso inválido.

  • 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não corresponde à 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 InvalidIPv6ServerFirewallRuleResourceRequest – o pedido de recurso da regra de firewall do servidor IPv6 é inválido.

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

  • 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 gerir regras de firewall ao nível do servidor ou da base de dados, ative a interface de rede pública.

  • 400 IPv6FirewallRuleNameEmpty - O nome da regra de firewall IPv6 fornecido está vazio

  • 400 FirewallRuleNotIPv6Address - O endereço da regra de firewall fornecido não é IPv6

  • 400 IPv6FirewallRuleNameTooLong - O nome da regra de firewall IPv6 fornecido é demasiado longo

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

  • 400 TooManyIPv6FirewallRules – as regras de firewall IPv6 fornecidas ultrapassam o limite.

  • 400 IPv6EndpointDisabled - O ponto final IPv6 está desativado.

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

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

Exemplos

Create an IPv6 firewall rule max/min
Update an IPv6 firewall rule max/min

Create an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-5370?api-version=2021-11-01

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Update an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-3927?api-version=2021-11-01

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Resposta da amostra

Código de estado:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}
Código de estado:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Definições

IPv6FirewallRule

Object

Uma regra de firewall do servidor IPv6.

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.endIPv6Address

string

O endereço IP final da regra de firewall. Tem de ser o formato IPv6. Tem de ser maior ou igual a startIpAddress.
properties.startIPv6Address

string

O endereço IP inicial da regra de firewall. Tem de ser o formato IPv6.
type

string

Tipo de recurso.