Condividi tramite


Firewall Rules - Create Or Update

Crea o aggiorna una regola del firewall.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
firewallRuleName
path True

string

Nome della regola del firewall.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Tipo Descrizione
name

string

Nome risorsa.

properties.endIpAddress

string

Indirizzo IP finale della regola del firewall. Deve essere formato IPv4. Deve essere maggiore o uguale a startIpAddress. Usare il valore '0.0.0.0'' per tutti gli indirizzi IP interni di Azure.

properties.startIpAddress

string

Indirizzo IP iniziale della regola del firewall. Deve essere formato IPv4. Usare il valore '0.0.0.0'' per tutti gli indirizzi IP interni di Azure.

Risposte

Nome Tipo Descrizione
200 OK

FirewallRule

Aggiornamento corretto della regola del firewall.

201 Created

FirewallRule

Creazione della regola del firewall completata.

Other Status Codes

ErrorResponse

Risposte di errore:

  • 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto

  • 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio

  • 400 InvalidResourceId - Identificatore di risorsa non valido.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL.

  • 400 Mancata corrispondenzaResourceGroupNameWithUrl- Il nome del gruppo di risorse specificato non corrisponde al nome nell'URL.

  • 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL.

  • 400 InvalidServerFirewallRuleResourceRequest- La richiesta di risorsa della regola del firewall del server non è valida.

  • 400 InvalidServerFirewallRuleResourceParameters - Il parametro della risorsa della regola del firewall del server non è valido.

  • 400 FirewallRuleNotIPv4Address - L'indirizzo della regola del firewall specificato non è IPv4

  • 400 TooManyFirewallRules - Le regole del firewall fornite superano il limite.

  • 400 FirewallRuleInvalidRange- L'intervallo di regole del firewall specificato non è valido.

  • 400 FirewallRuleNameTooLong - Il nome della regola del firewall specificato è troppo lungo

  • 400 FirewallRuleNameEmpty - Il nome della regola del firewall specificato è vuoto

  • 400 DenyPublicEndpointEnabled - Impossibile creare o modificare regole del firewall quando l'interfaccia di rete pubblica per il server è disabilitata. Per gestire le regole del firewall a livello di server o di database, abilitare l'interfaccia di rete pubblica.

  • 400 FirewallRuleNameInvalid: il nome della regola del firewall specificato contiene caratteri speciali.

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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

Create a firewall rule max/min

Esempio di richiesta

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

Risposta di esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

FirewallRule

Regola del firewall del server.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

FirewallRule

Regola del firewall del server.

Nome Tipo Descrizione
id

string

ID risorsa.

name

string

Nome risorsa.

properties.endIpAddress

string

Indirizzo IP finale della regola del firewall. Deve essere formato IPv4. Deve essere maggiore o uguale a startIpAddress. Usare il valore '0.0.0.0'' per tutti gli indirizzi IP interni di Azure.

properties.startIpAddress

string

Indirizzo IP iniziale della regola del firewall. Deve essere formato IPv4. Usare il valore '0.0.0.0'' per tutti gli indirizzi IP interni di Azure.

type

string

Tipo di risorsa.