Aracılığıyla paylaş

Firewall Rules - Create Or Update

  • Başvuru
Hizmet:
SQL Database
API Sürümü:
2023-08-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=2023-08-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

ErrorResponse

Hata Yanıtları: ***

  • 400 ManagedInstanceStoppingOrStopped - Örnek durdurulmuş/durdurulmuş durumdayken gönderilen çakışan işlem

  • 400 ManagedInstanceStarting - Örnek başlatma durumundayken gönderilen çakışan işlem

  • 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 genel ağ arabirimini etkinleştirin.

  • 400 FirewallRuleNameInvalid - Sağlanan güvenlik duvarı kuralı adı özel karakterler içeriyor.

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

  • 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı

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

  • 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki 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

Örnek isteği

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"
  }
}

Örnek yanıt

Durum kodu:
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"
  }
}
Durum kodu:
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

Örnek isteği

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"
  }
}

Örnek yanıt

Durum kodu:
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"
  }
}
Durum kodu:
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

Name Description
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Hata yanıtı
FirewallRule

Sunucu güvenlik duvarı kuralı.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

FirewallRule

Object

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ü.