Sdílet prostřednictvím

Database Vulnerability Assessments - Get

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

Získá posouzení ohrožení zabezpečení databáze.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/vulnerabilityAssessments/default?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í.
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.
vulnerabilityAssessmentName
 path True

VulnerabilityAssessmentName

Název posouzení ohrožení zabezpečení.
api-version
 query True

string

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

Odpovědi

Name Typ Description
200 OK

DatabaseVulnerabilityAssessment

Posouzení ohrožení zabezpečení databáze se úspěšně načetla.
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 – Musí být zadána cesta ke kontejneru úložiště, pokud není nastavená v zásadách na úrovni serveru.

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

  • 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 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 nebyl nalezen.

  • 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 assessment

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/default?api-version=2021-11-01

Ukázková odpověď

Stavový kód:
200 
{
  "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.
VulnerabilityAssessmentName

Název posouzení ohrožení zabezpečení.
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.

VulnerabilityAssessmentName

Název posouzení ohrožení zabezpečení.

Name Typ Description
default

string

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.