Sdílet prostřednictvím

Managed Database Vulnerability Assessments - List By Database

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

Seznamy posouzení ohrožení zabezpečení spravované databáze.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/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 je definováno posouzení ohrožení zabezpečení.
managedInstanceName
 path True

string

Název spravované instance.
resourceGroupName
 path True

string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
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

Úspěšně se načetla posouzení ohrožení zabezpečení databáze.
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 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Pokud není nastavená v zásadách na úrovni serveru, musí se zadat cesta ke kontejneru úložiště.

  • 400 VulnerabilityAssessmentUnsupportedStorageAccount – zadaný účet úložiště není podporovaný.

  • 400 VulnerabilityAssessmentADSIsDisabled – Aby bylo možné používat posouzení ohrožení zabezpečení, mělo by být povolené Advanced Data Security.

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

  • 400 VulnerabilityAssessmentInsufficientStorageAccountPermissions – Nedostatečná oprávnění k zadanému účtu úložiště.

  • 400 VulnerabilityAssessmentStorageAccountIsDisabled – zadaný účet úložiště je zakázaný.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel.

  • 404 SourceDatabaseNotFound – zdrojová databáze neexistuje.

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

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

Příklady

Get a database's vulnerability assessments list

Ukázkový požadavek

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/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/managedInstances/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ý parametr 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ásada posouzení ohrožení zabezpečení na úrovni serveru.
properties.storageContainerSasKey

string

Sdílený přístupový podpis (klíč SAS), který má oprávnění 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 naplánované kontrole.
emails

string[]

Určuje pole e-mailových adres, na které je odesláno oznámení o kontrole.
isEnabled

boolean

Stav opakovaných kontrol.