Firewall Rules - Create Or Update

  • Başvuru
Service:
SQL Database
API Version:
2021-11-01

Güvenlik duvarı kuralı oluşturur veya güncelleştirir.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
firewallRuleName
 path True

string

Güvenlik duvarı kuralının adı.
resourceGroupName
 path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName
 path True

string

Sunucunun adı.
subscriptionId
 path True

string

Azure aboneliğini tanımlayan abonelik kimliği.
api-version
 query True

string

İstek için kullanılacak API sürümü.

İstek Gövdesi

Name Tür Description
name

string

Kaynak adı.
properties.endIpAddress

string

Güvenlik duvarı kuralının bitiş IP adresi. IPv4 biçimi olmalıdır. startIpAddress değerinden büyük veya buna eşit olmalıdır. Tüm Azure iç IP adresleri için '0.0.0.0' değerini kullanın.
properties.startIpAddress

string

Güvenlik duvarı kuralının başlangıç IP adresi. IPv4 biçimi olmalıdır. Tüm Azure iç IP adresleri için '0.0.0.0' değerini kullanın.

Yanıtlar

Name Tür Description
200 OK

FirewallRule

Güvenlik duvarı kuralı başarıyla güncelleştirildi.
201 Created

FirewallRule

Güvenlik duvarı kuralı başarıyla oluşturuldu.
Other Status Codes

Hata Yanıtları: **

  • 400 InvalidResourceId - Geçersiz kaynak tanımlayıcısı.

  • 400 MismatchingSubscriptionWithUrl - Sağlanan abonelik Url'deki abonelikle eşleşmedi.

  • 400 MismatchingResourceGroupNameWithUrl - Sağlanan kaynak grubu adı Url'deki adla eşleşmedi.

  • 400 MismatchingServerNameWithUrl - Sağlanan sunucu adı Url'deki adla eşleşmedi.

  • 400 InvalidServerFirewallRuleResourceRequest - Sunucu güvenlik duvarı kuralı kaynak isteği geçersiz.

  • 400 InvalidServerFirewallRuleResourceParameters - Sunucu güvenlik duvarı kuralı kaynak parametresi geçersiz.

  • 400 FirewallRuleNotIPv4Address - Sağlanan güvenlik duvarı kuralı adresi IPv4 değil

  • 400 TooManyFirewallRules - Sağlanan güvenlik duvarı kuralları sınırı aşıyor.

  • 400 FirewallRuleInvalidRange - Belirtilen güvenlik duvarı kural aralığı geçersiz.

  • 400 FirewallRuleNameTooLong - Sağlanan güvenlik duvarı kuralı adı çok uzun

  • 400 FirewallRuleNameEmpty - Sağlanan güvenlik duvarı kuralı adı boş

  • 400 DenyPublicEndpointEnabled - Sunucu için genel ağ arabirimi devre dışı bırakıldığında güvenlik duvarı kuralları oluşturulamıyor veya değiştirilemiyor. Sunucu veya veritabanı düzeyinde güvenlik duvarı kurallarını yönetmek için lütfen ortak ağ arabirimini etkinleştirin.

  • 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı

  • 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler.

  • 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

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

Create a firewall rule max/min

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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"
  }
}

Tanımlar

FirewallRule

Sunucu güvenlik duvarı kuralı.

Name Tür Description
id

string

Kaynak Kimliği.
name

string

Kaynak adı.
properties.endIpAddress

string

Güvenlik duvarı kuralının bitiş IP adresi. IPv4 biçimi olmalıdır. startIpAddress değerinden büyük veya buna eşit olmalıdır. Tüm Azure iç IP adresleri için '0.0.0.0' değerini kullanın.
properties.startIpAddress

string

Güvenlik duvarı kuralının başlangıç IP adresi. IPv4 biçimi olmalıdır. Tüm Azure iç IP adresleri için '0.0.0.0' değerini kullanın.
type

string

Kaynak türü.