Database Vulnerability Assessment Scans - Get

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Získá záznam kontroly 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/scans/{scanId}?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
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.
scanId	path	True	string	ID kontroly posouzení ohrožení zabezpečení kontroly, která se má načíst.
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	VulnerabilityAssessmentScanRecord	Záznam kontroly posouzení ohrožení zabezpečení databáze se úspěšně načetl.
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 – Aby bylo možné používat posouzení ohrožení zabezpečení, mělo by být povolené Advanced Data Security. 400 DatabaseVulnerabilityAssessmentMissingStorageContainerPath – Pokud není nastavená v zásadách na úrovni serveru, musí se zadat cesta ke kontejneru úložiště. 400 VulnerabilityAssessmentDatawarehouseDatabaseIsDeactivated – Nepodařilo se spustit operaci posouzení ohrožení zabezpečení, protože databáze je pozastavená. Obnovte ho prosím. 400 VulnerabilityAssessmentStorageOutboundFirewallNotAllowed – účet úložiště není v seznamu odchozích pravidel brány firewall. 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. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Kontrola posouzení ohrožení zabezpečení již probíhá. 500 DatabaseIsUnavailable – Načtení se nezdařilo. Zkuste to později.

Příklady

Gets a database vulnerability assessment scan record by scan ID

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6411/databases/testdb/vulnerabilityAssessments/default/scans/scan001?api-version=2021-11-01

Java

import com.azure.resourcemanager.sql.models.VulnerabilityAssessmentName;

/**
 * Samples for DatabaseVulnerabilityAssessmentScans Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * DatabaseVulnerabilityAssessmentScanRecordsGet.json
     */
    /**
     * Sample code: Gets a database vulnerability assessment scan record by scan ID.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsADatabaseVulnerabilityAssessmentScanRecordByScanID(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseVulnerabilityAssessmentScans().getWithResponse(
            "vulnerabilityassessmenttest-4711", "vulnerabilityassessmenttest-6411", "testdb",
            VulnerabilityAssessmentName.DEFAULT, "scan001", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityassessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityassessmenttest-6440/databases/testdb/vulnerabilityAssessments/default/scans/scan001",
  "name": "scan001",
  "type": "Microsoft.Sql/servers/databases/vulnerabilityAssessments/scans",
  "properties": {
    "scanId": "scan001",
    "triggerType": "OnDemand",
    "state": "Passed",
    "startTime": "2017-12-12T17:45:06Z",
    "endTime": "2017-12-12T17:47:06Z",
    "errors": [],
    "storageContainerPath": "https://myaccount.blob.core.windows.net/vulnerability-assessment",
    "numberOfFailedSecurityChecks": 9
  }
}

Definice

Name	Description
VulnerabilityAssessmentName	Název posouzení ohrožení zabezpečení.
VulnerabilityAssessmentScanError	Vlastnosti chyby kontroly posouzení ohrožení zabezpečení
VulnerabilityAssessmentScanRecord	Záznam kontroly posouzení ohrožení zabezpečení
VulnerabilityAssessmentScanState	Stav kontroly.
VulnerabilityAssessmentScanTriggerType	Typ triggeru kontroly.

VulnerabilityAssessmentName

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

Name	Typ	Description
default	string

VulnerabilityAssessmentScanError

Vlastnosti chyby kontroly posouzení ohrožení zabezpečení

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva

VulnerabilityAssessmentScanRecord

Záznam kontroly posouzení ohrožení zabezpečení

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.endTime	string	Čas ukončení kontroly (UTC)
properties.errors	VulnerabilityAssessmentScanError[]	Při kontrole došlo k chybám.
properties.numberOfFailedSecurityChecks	integer	Počet neúspěšných kontrol zabezpečení.
properties.scanId	string	ID kontroly.
properties.startTime	string	Čas zahájení kontroly (UTC)
properties.state	VulnerabilityAssessmentScanState	Stav kontroly.
properties.storageContainerPath	string	Výsledkem kontroly je cesta ke kontejneru úložiště.
properties.triggerType	VulnerabilityAssessmentScanTriggerType	Typ triggeru kontroly.
type	string	Typ prostředku.

VulnerabilityAssessmentScanState

Stav kontroly.

Name	Typ	Description
Failed	string
FailedToRun	string
InProgress	string
Passed	string

VulnerabilityAssessmentScanTriggerType

Typ triggeru kontroly.

Name	Typ	Description
OnDemand	string
Recurring	string