Sdílet prostřednictvím

Database Vulnerability Assessments - List By Database

  • Reference
Služba:
SQL Database
Verze rozhraní API:
2021-11-01

Seznamy zásady posouzení ohrožení zabezpečení přidružené k databázi.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
databaseName
 path True

string

Název databáze, pro kterou jsou definovány zásady posouzení ohrožení zabezpečení.
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName
 path True

string

Název serveru.
subscriptionId
 path True

string

ID předplatného, které identifikuje předplatné Azure.
api-version
 query True

string

Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name Typ Description
200 OK

DatabaseVulnerabilityAssessmentListResult

Zásady posouzení ohrožení zabezpečení databáze se úspěšně načetly.
Other Status Codes

Chybové odpovědi: ***

  • 400 InvalidStorageAccountName – zadaný účet úložiště není platný nebo neexistuje.

  • 400 InvalidStorageAccountCredentials – zadaný sdílený přístupový podpis účtu úložiště nebo klíč úložiště účtu není platný.

  • 400 VulnerabilityAssessmentInvalidPolicy – nastavení posouzení ohrožení zabezpečení neexistuje nebo je v nastavení zadané neplatné úložiště.

  • 400 VulnerabilityAssessmentADSIsDisabled – Rozšířené zabezpečení dat by mělo být povolené, aby bylo možné používat posouzení ohrožení zabezpečení.

  • 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Musí být zadána cesta ke kontejneru úložiště, pokud není nastavená v zásadách na úrovni serveru.

  • 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – Nelze spustit operaci posouzení ohrožení zabezpečení, protože databáze je pozastavená. Prosím, pokračujte v tom.

  • 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – účet úložiště není v seznamu odchozích pravidel brány firewall.

  • 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen.

  • 404 SourceDatabaseNotFound – zdrojová databáze neexistuje.

  • 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje.

  • 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – kontrola posouzení ohrožení zabezpečení již probíhá.

  • 500 DatabaseIsUnavailable – Načtení se nezdařilo. Zkuste to později.

Příklady

Get the database's vulnerability assessment policies

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
          ]
        }
      }
    }
  ]
}

Definice

Name Description
DatabaseVulnerabilityAssessment

Posouzení ohrožení zabezpečení databáze.
DatabaseVulnerabilityAssessmentListResult

Seznam posouzení ohrožení zabezpečení databáze.
VulnerabilityAssessmentRecurringScansProperties

Vlastnosti opakovaných kontrol posouzení ohrožení zabezpečení.

DatabaseVulnerabilityAssessment

Posouzení ohrožení zabezpečení databáze.

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku.
properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

Nastavení opakovaných kontrol
properties.storageAccountAccessKey

string

Určuje klíč identifikátoru účtu úložiště pro výsledky kontroly posouzení ohrožení zabezpečení. Pokud není zadaná hodnota StorageContainerSasKey, vyžaduje se storageAccountAccessKey. Platí jenom v případě, že účet úložiště není za virtuální sítí nebo bránou firewall.
properties.storageContainerPath

string

Cesta ke kontejneru úložiště objektů blob pro uložení výsledků kontroly (např. https://myStorage.blob.core.windows.net/VaScans/). Vyžaduje se, pokud se nenastaví zásady posouzení ohrožení zabezpečení na úrovni serveru.
properties.storageContainerSasKey

string

Sdílený přístupový podpis (klíč SAS), který má přístup k zápisu do kontejneru objektů blob zadaného v parametru storageContainerPath. Pokud není zadaný parametr storageAccountAccessKey, vyžaduje se StorageContainerSasKey. Platí jenom v případě, že účet úložiště není za virtuální sítí nebo bránou firewall.
type

string

Typ prostředku.

DatabaseVulnerabilityAssessmentListResult

Seznam posouzení ohrožení zabezpečení databáze.

Name Typ Description
nextLink

string

Odkaz na načtení další stránky výsledků
value

DatabaseVulnerabilityAssessment[]

Pole výsledků

VulnerabilityAssessmentRecurringScansProperties

Vlastnosti opakovaných kontrol posouzení ohrožení zabezpečení.

Name Typ Default value Description
emailSubscriptionAdmins

boolean

True

Určuje, že se správcům předplatného odešle oznámení o kontrole plánu.
emails

string[]

Určuje pole e-mailových adres, na které se odešle oznámení o kontrole.
isEnabled

boolean

Stav opakovaných kontrol.