Freigeben über

Firewall Rules - List By Server

Dienst:
SQL Database
API-Version:
2025-01-01

Ruft eine Liste der Firewallregeln ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
serverName
 path True

string

Name des Servers
subscriptionId
 path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

FirewallRuleListResult

Azure-Operation erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

List Firewall Rules

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "name": "firewallrulecrudtest-2304",
      "type": "Microsoft.Sql/servers/firewallRules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-2304",
      "properties": {
        "endIpAddress": "0.0.0.0",
        "startIpAddress": "0.0.0.0"
      }
    },
    {
      "name": "firewallrulecrudtest-3927",
      "type": "Microsoft.Sql/servers/firewallRules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
      "properties": {
        "endIpAddress": "0.0.0.1",
        "startIpAddress": "0.0.0.1"
      }
    },
    {
      "name": "firewallrulecrudtest-5370",
      "type": "Microsoft.Sql/servers/firewallRules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
      "properties": {
        "endIpAddress": "0.0.0.3",
        "startIpAddress": "0.0.0.3"
      }
    },
    {
      "name": "firewallrulecrudtest-5767",
      "type": "Microsoft.Sql/servers/firewallRules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5767",
      "properties": {
        "endIpAddress": "0.0.0.2",
        "startIpAddress": "0.0.0.2"
      }
    }
  ]
}

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort
FirewallRule

Eine Serverfirewallregel.
FirewallRuleListResult

Die Antwort eines FirewallRule-Listenvorgangs.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

FirewallRule

Objekt

Eine Serverfirewallregel.

Name Typ Beschreibung
id

string

Ressourcen-ID
name

string

Ressourcenname.
properties.endIpAddress

string

Die IP-Endadresse der Firewallregel. Muss das IPv4-Format sein. Muss größer oder gleich "startIpAddress" sein. Verwendungswert '0.0.0.0' für alle Azure-internen IP-Adressen.
properties.startIpAddress

string

Die Start-IP-Adresse der Firewallregel. Muss das IPv4-Format sein. Verwendungswert '0.0.0.0' für alle Azure-internen IP-Adressen.
type

string

Ressourcentyp.

FirewallRuleListResult

Objekt

Die Antwort eines FirewallRule-Listenvorgangs.

Name Typ Beschreibung
nextLink

string (uri)

Der Link zur nächsten Seite der Elemente
value

FirewallRule[]

Die FirewallRule-Elemente auf dieser Seite