Virtual Network Rules - Create Or Update
Tworzy lub aktualizuje istniejącą regułę sieci wirtualnej.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/virtualNetworkRules/{virtualNetworkRuleName}?api-version=2025-01-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
server
|
path | True |
string |
Nazwa serwera. |
|
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
|
virtual
|
path | True |
string |
Nazwa reguły sieci wirtualnej. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| properties.virtualNetworkSubnetId | True |
string |
Identyfikator zasobu usługi ARM podsieci sieci wirtualnej. |
| properties.ignoreMissingVnetServiceEndpoint |
boolean |
Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Aktualizacja zasobu 'VirtualNetworkRule' zakończyła się sukcesem |
|
| 201 Created |
Operacja tworzenia zasobu 'VirtualNetworkRule' zakończyła się sukcesem Nagłówki
|
|
| 202 Accepted |
Zaakceptowano operację zasobu. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
Create or update a virtual network rule
Przykładowe żądanie
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule?api-version=2025-01-01
{
"properties": {
"ignoreMissingVnetServiceEndpoint": false,
"virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
}
}
Przykładowa odpowiedź
{
"name": "vnet-firewall-rule",
"type": "Microsoft.Sql/servers/virtualNetworkRules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule",
"properties": {
"ignoreMissingVnetServiceEndpoint": false,
"virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
}
}
{
"name": "vnet-firewall-rule",
"type": "Microsoft.Sql/servers/virtualNetworkRules",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule",
"properties": {
"ignoreMissingVnetServiceEndpoint": false,
"virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
}
}
Definicje
| Nazwa | Opis |
|---|---|
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
Virtual |
Reguła sieci wirtualnej. |
|
Virtual |
Virtual Network Rule State |
createdByType
Typ tożsamości, która utworzyła zasób.
| Wartość | Opis |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Błąd dodatkowe informacje. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
| createdBy |
string |
Tożsamość, która utworzyła zasób. |
| createdByType |
Typ tożsamości, która utworzyła zasób. |
|
| lastModifiedAt |
string (date-time) |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
| lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
| lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
VirtualNetworkRule
Reguła sieci wirtualnej.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nazwa zasobu |
| properties.ignoreMissingVnetServiceEndpoint |
boolean |
Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej. |
| properties.state |
Virtual Network Rule State |
|
| properties.virtualNetworkSubnetId |
string |
Identyfikator zasobu usługi ARM podsieci sieci wirtualnej. |
| systemData |
Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
| type |
string |
Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts" |
VirtualNetworkRuleState
Virtual Network Rule State
| Wartość | Opis |
|---|---|
| Initializing |
Inicjowanie |
| InProgress |
W toku |
| Ready |
Ready |
| Failed |
Niepowodzenie |
| Deleting |
Usuwanie |
| Unknown |
Unknown |