Database Sql Vulnerability Assessments Settings - Get

Služba:

SQL Database

Verze rozhraní API:

2024-05-01-preview

Získá zásady posouzení ohrožení zabezpečení SQL pro databázi.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments/default?api-version=2024-05-01-preview

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á obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo 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	SqlVulnerabilityAssessmentName	Název posouzení ohrožení zabezpečení SQL
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	SqlVulnerabilityAssessment	Zásady posouzení ohrožení zabezpečení SQL pro databázi byly úspěšně načteny.
Other Status Codes	ErrorResponse	Chybové odpovědi: *** 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter – klient zadal neplatnou hodnotu parametru. 400 InvalidSqlVulnerabilityAssessmentBaselineInput – Vstup standardních hodnot posouzení ohrožení zabezpečení SQL je null nebo prázdný. 400 InvalidSqlVulnerabilityAssessmentSettingsInput – Vstup nastavení posouzení ohrožení zabezpečení SQL je null nebo prázdný. 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet – Výsledky posouzení ohrožení zabezpečení SQL ještě nejsou k dispozici, zkuste to prosím znovu později. 400 SqlVulnerabilityAssessmentInvalidRuleId – ID pravidla posouzení ohrožení zabezpečení SQL je neplatné. 400 SqlVulnerabilityAssessmentScanDoesNotExist – Kontrola posouzení ohrožení zabezpečení SQL neexistuje. 400 SqlVulnerabilityAssessmentNoBaseline – v prostředku nebyly nalezeny žádné standardní hodnoty pro nejnovější kontrolu. 400 SqlVulnerabilityAssessmentNoRuleBaseline – Nebyl nalezen žádný směrný plán posouzení ohrožení zabezpečení SQL 400 SqlVulnerabilityAssessmentBaselineNoScanResults – Pro ID pravidla nebyly nalezeny žádné výsledky kontroly. Pokud chcete nastavit směrný plán, musí být výsledky pro toto pravidlo v nejnovější dostupné kontrole. 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat – Vstup pro binární pravidlo není logická reprezentace 400 SqlVulnerabilityAssessmentBadRuleFormat - Zadané výsledky nevyhovují skutečnému rozložení výsledků kontroly 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - Zadané výsledky nevyhovují skutečnému rozložení výsledků kontroly 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat – Vstup pro binární pravidlo není logická reprezentace 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId – pro jedno z pravidel nebyly nalezeny žádné výsledky kontroly. Pokud chcete nastavit směrný plán, musí být výsledky pro toto pravidlo v nejnovější dostupné kontrole. 400 SqlVulnerabilityAssessmentEmptyBaseline – směrný plán není nastavený, protože výsledky jsou null nebo prázdné 400 SqlVulnerabilityAssessmentIsDisabled – Funkce posouzení ohrožení zabezpečení SQL je zakázaná. Před spuštěním dalších operací posouzení ohrožení zabezpečení SQL tuto funkci povolte. 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 SourceDatabaseNotFound – Zdrojová databáze neexistuje. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který v této instanci serveru neexistuje. 409 SqlVulnerabilityAssessmentStoragelApiIsEnabled – Posouzení ohrožení zabezpečení je povoleno na tomto serveru nebo v některé z jejích podkladových databází s nekompatibilní verzí. Další informace o řešení potíží najdete https://aka.ms/SQLVAStoragelessDocumentation. 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress – Kontrola posouzení ohrožení zabezpečení SQL už probíhá 500 DatabaseIsUnavailable – Načtení se nezdařilo. Zkuste to prosím znovu později.

Příklady

Get SQL Vulnerability Assessment policy for database

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/default?api-version=2024-05-01-preview

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python database_sql_vulnerability_assessment_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-1111-2222-3333-444444444444",
    )

    response = client.database_sql_vulnerability_assessments_settings.get(
        resource_group_name="vulnerabilityaseessmenttest-4799",
        server_name="vulnerabilityaseessmenttest-6440",
        database_name="testdb",
        vulnerability_assessment_name="default",
    )
    print(response)


# x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2024-05-01-preview/examples/DatabaseSqlVulnerabilityAssessmentGet.json
if __name__ == "__main__":
    main()

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/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments",
  "properties": {
    "state": "Enabled"
  }
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
SqlVulnerabilityAssessment	Posouzení ohrožení zabezpečení SQL
SqlVulnerabilityAssessmentName	Název posouzení ohrožení zabezpečení SQL
SqlVulnerabilityAssessmentState	Určuje stav posouzení ohrožení zabezpečení SQL bez ohledu na to, jestli je povolená nebo zakázaná, nebo stav ještě nebyl použit na konkrétní databázi nebo serveru.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

SqlVulnerabilityAssessment

Objekt

Posouzení ohrožení zabezpečení SQL

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku
properties.state	SqlVulnerabilityAssessmentState	Určuje stav posouzení ohrožení zabezpečení SQL bez ohledu na to, jestli je povolená nebo zakázaná, nebo stav ještě nebyl použit na konkrétní databázi nebo serveru.
systemData	systemData	SystemData of SqlVulnerabilityAssessmentResource.
type	string	Typ zdroje.

SqlVulnerabilityAssessmentName

Výčet

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

Hodnota	Description
default

SqlVulnerabilityAssessmentState

Výčet

Určuje stav posouzení ohrožení zabezpečení SQL bez ohledu na to, jestli je povolená nebo zakázaná, nebo stav ještě nebyl použit na konkrétní databázi nebo serveru.

Hodnota	Description
Disabled
Enabled

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.