Firewall Rules - Create Or Update

Szolgáltatás:

SQL Database

API-verzió:

2021-11-01

Tűzfalszabályt hoz létre vagy frissít.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
firewallRuleName	path	True	string	A tűzfalszabály neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
name	string	Erőforrás neve.
properties.endIpAddress	string	A tűzfalszabály záró IP-címe. IPv4 formátumúnak kell lennie. A startIpAddress értéknél nagyobbnak vagy egyenlőnek kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
properties.startIpAddress	string	A tűzfalszabály kezdő IP-címe. IPv4 formátumúnak kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.

Válaszok

Name	Típus	Description
200 OK	FirewallRule	A tűzfalszabály frissítése sikerült.
201 Created	FirewallRule	A tűzfalszabály létrehozása sikerült.
Other Status Codes		Hibaválaszok: *** 400 InvalidResourceId – Érvénytelen erőforrás-azonosító. 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett meg az URL-címben szereplő előfizetéssel. 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett meg az URL-címben megadott névvel. 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett meg az URL-címben megadott névvel. 400 InvalidServerFirewallRuleResourceRequest – A kiszolgálói tűzfalszabály erőforrás-kérése érvénytelen. 400 InvalidServerFirewallRuleResourceParameters – A kiszolgálói tűzfalszabály erőforrás-paramétere érvénytelen. 400 FirewallRuleNotIPv4Address – A megadott tűzfalszabály-cím nem IPv4 400 TooManyFirewallRules – A megadott tűzfalszabályok túllépik a korlátot. 400 FirewallRuleInvalidRange – A megadott tűzfalszabály-tartomány érvénytelen. 400 FirewallRuleNameTooLong – A megadott tűzfalszabály neve túl hosszú 400 FirewallRuleNameEmpty – A megadott tűzfalszabály neve üres 400 DenyPublicEndpointEnabled – Nem lehet tűzfalszabályokat létrehozni vagy módosítani, ha a kiszolgáló nyilvános hálózati adaptere le van tiltva. A kiszolgáló- vagy adatbázisszintű tűzfalszabályok kezeléséhez engedélyezze a nyilvános hálózati adaptert. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Create a firewall rule max/min

Update a firewall rule max/min

Create a firewall rule max/min

Mintakérelem

HTTP

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

Java

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"),
            com.azure.core.util.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

Mintaválasz

Állapotkód:

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

Állapotkód:

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

Mintakérelem

HTTP

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

Java

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"),
            com.azure.core.util.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

Mintaválasz

Állapotkód:

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

Állapotkód:

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

Definíciók

FirewallRule

Kiszolgálói tűzfalszabály.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.endIpAddress	string	A tűzfalszabály záró IP-címe. IPv4 formátumúnak kell lennie. A startIpAddress értéknél nagyobbnak vagy egyenlőnek kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
properties.startIpAddress	string	A tűzfalszabály kezdő IP-címe. IPv4 formátumúnak kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
type	string	Erőforrástípus.