Dela via


Network Security Perimeter Configurations - Reconcile

Stämma av nätverkssäkerhetsperimeterkonfiguration för SQL-resursprovider

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/networkSecurityPerimeterConfigurations/{nspConfigName}/reconcile?api-version=2023-05-01-preview

URI-parametrar

Name I Obligatorisk Typ Description
nspConfigName
path True

string

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Prenumerations-ID:t som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Svar

Name Typ Description
200 OK

NetworkSecurityPerimeterConfiguration

Stämma av NSP-konfigurationsåtgärden lyckades

202 Accepted

NSP-konfigurationsåtgärden har godkänts

Other Status Codes

Felsvar: ***

  • 404 ResourceNotFound – Den begärda resursen hittades inte.

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 404 AssociationNotFound – den här SQL Server är inte associerad med någon NSP

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 409 OnlyOneAssociationPerServer – en SQL Server kan bara associeras med en NSP

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Reconcile NSP Config

Exempelbegäran

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-7398/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1/reconcile?api-version=2023-05-01-preview

Exempelsvar

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1",
  "name": "00000001-2222-3333-4444-111144444444.assoc1",
  "type": "Microsoft.Sql/servers/networkSecurityPerimeterConfigurations",
  "properties": {
    "provisioningState": "Accepted",
    "networkSecurityPerimeter": {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1",
      "location": "japaneast"
    },
    "resourceAssociation": {
      "name": "assoc1",
      "accessMode": "Enforced"
    },
    "profile": {
      "name": "profile1",
      "accessRulesVersion": "0",
      "accessRules": [
        {
          "name": "rule1",
          "properties": {
            "direction": "Inbound",
            "addressPrefixes": [
              "148.0.0.0/8",
              "152.4.6.0/24"
            ]
          }
        }
      ]
    }
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/locations/japaneast/networkSecurityPerimeterReconciliationOperationResults/11111111-1111-1111-1111-111111111111

Definitioner

Name Description
NetworkSecurityPerimeterConfiguration

NSP-konfiguration för en server.

NSPConfigAccessRule
NSPConfigAccessRuleProperties
NSPConfigAssociation
NSPConfigNetworkSecurityPerimeterRule
NSPConfigPerimeter
NSPConfigProfile
NSPProvisioningIssue
NSPProvisioningIssueProperties

NetworkSecurityPerimeterConfiguration

NSP-konfiguration för en server.

Name Typ Description
id

string

Resurs-ID.

name

string

Resursnamn.

properties.networkSecurityPerimeter

NSPConfigPerimeter

properties.profile

NSPConfigProfile

properties.provisioningIssues

NSPProvisioningIssue[]

properties.provisioningState

string

properties.resourceAssociation

NSPConfigAssociation

type

string

Resurstyp.

NSPConfigAccessRule

Name Typ Description
name

string

properties

NSPConfigAccessRuleProperties

NSPConfigAccessRuleProperties

Name Typ Description
addressPrefixes

string[]

direction

string

fullyQualifiedDomainNames

string[]

networkSecurityPerimeters

NSPConfigNetworkSecurityPerimeterRule[]

subscriptions

string[]

NSPConfigAssociation

Name Typ Description
accessMode

string

name

string

NSPConfigNetworkSecurityPerimeterRule

Name Typ Description
id

string

location

string

perimeterGuid

string

NSPConfigPerimeter

Name Typ Description
id

string

location

string

perimeterGuid

string

NSPConfigProfile

Name Typ Description
accessRules

NSPConfigAccessRule[]

accessRulesVersion

string

name

string

NSPProvisioningIssue

Name Typ Description
name

string

properties

NSPProvisioningIssueProperties

NSPProvisioningIssueProperties

Name Typ Description
description

string

issueType

string

severity

string

suggestedAccessRules

string[]

suggestedResourceIds

string[]