Firewall Rules - Create Or Update

Riferimento

Service:: SQL Database

API Version:: 2021-11-01

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
firewallRuleName	path	True	string	Nome della regola firewall.
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure 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	Aggiornata correttamente la regola del firewall.
201 Created	FirewallRule	È stata creata correttamente la regola del firewall.
Other Status Codes		Risposte agli errori: ** 400 InvalidResourceId - Identificatore di risorsa non valido. 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrispondeva alla sottoscrizione nell'URL. 400 MismatchingResourceGroupNameWithUrl: 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 le 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. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Nome

Tipo

Descrizione

200 OK

FirewallRule

Aggiornata correttamente la regola del firewall.

201 Created

FirewallRule

È stata creata correttamente la regola del firewall.

Other Status Codes

Risposte agli errori: **

400 InvalidResourceId - Identificatore di risorsa non valido.
400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrispondeva alla sottoscrizione nell'URL.
400 MismatchingResourceGroupNameWithUrl: 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 le 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.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre le richieste massime 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

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleCreate.json
     */
    /**
     * Sample code: Create a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new FirewallRuleInner().withStartIpAddress("0.0.0.3").withEndIpAddress("0.0.0.3"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

HTTP
Java

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new FirewallRuleInner().withStartIpAddress("0.0.0.1").withEndIpAddress("0.0.0.1"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Definizioni

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.

Firewall Rules - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create a firewall rule max/min

Sample Request

Sample Response

Update a firewall rule max/min

Sample Request

Sample Response

Definizioni

FirewallRule

Risorse aggiuntive