Dela via

Database Vulnerability Assessments - List By Database

  • Referens
Tjänst:
SQL Database
API-version:
2021-11-01

Listor de principer för sårbarhetsbedömning som är associerade med en databas.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/vulnerabilityAssessments?api-version=2021-11-01

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
 path True

string

Namnet på databasen som principerna för sårbarhetsbedömning definieras för.
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

Det prenumerations-ID 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

DatabaseVulnerabilityAssessmentListResult

Databasprinciperna för sårbarhetsbedömning har hämtats.
Other Status Codes

Felsvar: ***

  • 400 InvalidStorageAccountName – det angivna lagringskontot är inte giltigt eller finns inte.

  • 400 InvalidStorageAccountCredentials – Den angivna signaturen för delad åtkomst för lagringskontot eller lagringsnyckeln för kontot är inte giltig.

  • 400 VulnerabilityAssessmentInvalidPolicy – inställningarna för sårbarhetsbedömning finns inte eller ogiltig lagring som anges i inställningarna.

  • 400 VulnerabilityAssessmentADSIsDisabled – Advanced Data Security bör aktiveras för att kunna använda sårbarhetsbedömning.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Sökvägen till lagringscontainern måste anges om den inte anges i servernivåprincipen

  • 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – Det gick inte att köra åtgärden Sårbarhetsbedömning eftersom databasen är pausad. Återuppta den.

  • 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – lagringskontot finns inte i listan över regler för utgående brandvägg.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 SourceDatabaseNotFound – källdatabasen finns inte.

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Genomsökningen av sårbarhetsbedömning pågår redan.

  • 500 DatabaseIsUnavailable – Inläsningen misslyckades. Försök igen senare.

Exempel

Get the database's vulnerability assessment policies

Exempelbegäran

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/vulnerabilityAssessments?api-version=2021-11-01

Exempelsvar

Statuskod:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/vulnerabilityAssessments/default",
      "name": "default",
      "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments",
      "properties": {
        "recurringScans": {
          "isEnabled": true,
          "emailSubscriptionAdmins": true,
          "emails": [
            "email1@mail.com",
            "email2@mail.com"
          ]
        }
      }
    }
  ]
}

Definitioner

Name Description
DatabaseVulnerabilityAssessment

En sårbarhetsbedömning av databasen.
DatabaseVulnerabilityAssessmentListResult

En lista över databasens sårbarhetsbedömningar.
VulnerabilityAssessmentRecurringScansProperties

Egenskaper för återkommande genomsökningar av en sårbarhetsbedömning.

DatabaseVulnerabilityAssessment

En sårbarhetsbedömning av databasen.

Name Typ Description
id

string

Resurs-ID.
name

string

Resursnamn.
properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

Inställningarna för återkommande genomsökningar
properties.storageAccountAccessKey

string

Anger ID-nyckeln för lagringskontot för genomsökningsresultat för sårbarhetsbedömning. Om "StorageContainerSasKey" inte har angetts krävs storageAccountAccessKey. Gäller endast om lagringskontot inte finns bakom ett virtuellt nätverk eller en brandvägg
properties.storageContainerPath

string

En sökväg till bloblagringscontainern för att lagra genomsökningsresultatet (t.ex. https://myStorage.blob.core.windows.net/VaScans/). Det krävs om principen för sårbarhetsbedömning på servernivå inte har angetts
properties.storageContainerSasKey

string

En signatur för delad åtkomst (SAS-nyckel) som har skrivåtkomst till blobcontainern som anges i parametern "storageContainerPath". Om "storageAccountAccessKey" inte har angetts krävs StorageContainerSasKey. Gäller endast om lagringskontot inte finns bakom ett virtuellt nätverk eller en brandvägg
type

string

Resurstyp.

DatabaseVulnerabilityAssessmentListResult

En lista över databasens sårbarhetsbedömningar.

Name Typ Description
nextLink

string

Länk för att hämta nästa sida med resultat.
value

DatabaseVulnerabilityAssessment[]

Matris med resultat.

VulnerabilityAssessmentRecurringScansProperties

Egenskaper för återkommande genomsökningar av en sårbarhetsbedömning.

Name Typ Standardvärde Description
emailSubscriptionAdmins

boolean

True

Anger att schemagenomsökningsmeddelandet skickas till prenumerationsadministratörerna.
emails

string[]

Anger en matris med e-postadresser som skanningsmeddelandet skickas till.
isEnabled

boolean

Tillstånd för återkommande genomsökningar.