Managed Instance Vulnerability Assessments - Create Or Update

  • Riferimento
Service:
SQL Database
API Version:
2021-11-01

Crea o aggiorna la valutazione della vulnerabilità dell'istanza gestita. Altre informazioni sull'impostazione della valutazione della vulnerabilità SQL con l'identità gestita - https://docs.microsoft.com/azure/azure-sql/database/sql-database-vulnerability-assessment-storage

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/vulnerabilityAssessments/default?api-version=2021-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
managedInstanceName
 path True

string

Nome dell'istanza gestita per cui viene definita la valutazione della vulnerabilità.
resourceGroupName
 path True

string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
subscriptionId
 path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.
vulnerabilityAssessmentName
 path True

VulnerabilityAssessmentName

Nome della valutazione della vulnerabilità.
api-version
 query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Necessario Tipo Descrizione
properties.storageContainerPath True

string

Percorso del contenitore di archiviazione BLOB per contenere i risultati dell'analisi , ad esempio https://myStorage.blob.core.windows.net/VaScans/.
properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

Impostazioni di analisi ricorrenti
properties.storageAccountAccessKey

string

Specifica la chiave identificatore dell'account di archiviazione per i risultati dell'analisi della valutazione della vulnerabilità. Se 'StorageContainerSasKey' non è specificato, è necessario storageAccountAccessKey. Si applica solo se l'account di archiviazione non è dietro una rete virtuale o un firewall
properties.storageContainerSasKey

string

Firma di accesso condiviso (chiave di firma di accesso condiviso) con accesso in scrittura al contenitore BLOB specificato nel parametro 'storageContainerPath'. Se 'storageAccountAccessKey' non è specificato, è necessario StorageContainerSasKey. Si applica solo se l'account di archiviazione non è dietro una rete virtuale o un firewall

Risposte

Nome Tipo Descrizione
200 OK

ManagedInstanceVulnerabilityAssessment

Impostare correttamente la valutazione della vulnerabilità.
201 Created

ManagedInstanceVulnerabilityAssessment

È stata creata correttamente la valutazione della vulnerabilità.
Other Status Codes

Risposte agli errori: **

  • 400 InvalidStorageAccountName: l'account di archiviazione fornito non è valido o non esiste.

  • 400 InvalidStorageAccountCredentials: la firma di accesso condiviso dell'account di archiviazione o la chiave di archiviazione dell'account fornita non è valida.

  • 400 VulnerabilitàAssessmentADSIsDisabled - La sicurezza avanzata dei dati deve essere abilitata per l'uso della valutazione delle vulnerabilità.

  • 400 VulnerabilitàAssessmentStorageOutboundFirewallNotAllowed - L'account di archiviazione non è nell'elenco delle regole del firewall in uscita.

  • 400 VulnerabilitàAssessmentInsufficientStorageAccountPermissions - Autorizzazioni insufficienti per l'account di archiviazione fornito.

  • 400 VulnerabilitàAssessmentStorageAccountIsDisabled- L'account di archiviazione fornito è disabilitato.

  • 400 InvalidVulnerabilityAssessmentOperationRequest - La richiesta di operazione di valutazione della vulnerabilità non esiste o non ha alcun oggetto proprietà.

  • 400 DataSecurityInvalidUserSuppliedParameter - Un valore di parametro non valido è stato fornito dal client.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Esempio

Create a managed instance's vulnerability assessment with all parameters
Create a managed instance's vulnerability assessment with minimal parameters, when storageAccountAccessKey is specified
Create a managed instance's vulnerability assessment with minimal parameters, when storageContainerSasKey is specified

Create a managed instance's vulnerability assessment with all parameters

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default?api-version=2021-11-01

{
  "properties": {
    "storageContainerPath": "https://myStorage.blob.core.windows.net/vulnerability-assessment/",
    "storageContainerSasKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": true,
      "emails": [
        "email1@mail.com",
        "email2@mail.com"
      ]
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": true,
      "emails": [
        "email1@mail.com",
        "email2@mail.com"
      ]
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": true,
      "emails": [
        "email1@mail.com",
        "email2@mail.com"
      ]
    }
  }
}

Create a managed instance's vulnerability assessment with minimal parameters, when storageAccountAccessKey is specified

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default?api-version=2021-11-01

{
  "properties": {
    "storageContainerPath": "https://myStorage.blob.core.windows.net/vulnerability-assessment/",
    "storageAccountAccessKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": false,
      "emails": []
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": false,
      "emails": []
    }
  }
}

Create a managed instance's vulnerability assessment with minimal parameters, when storageContainerSasKey is specified

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default?api-version=2021-11-01

{
  "properties": {
    "storageContainerPath": "https://myStorage.blob.core.windows.net/vulnerability-assessment/",
    "storageContainerSasKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": false,
      "emails": []
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/managedInstances/vulnerabilityaseessmenttest-6440/vulnerabilityAssessments/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/vulnerabilityAssessments",
  "properties": {
    "recurringScans": {
      "isEnabled": true,
      "emailSubscriptionAdmins": false,
      "emails": []
    }
  }
}

Definizioni

Nome Descrizione
ManagedInstanceVulnerabilityAssessment

Valutazione della vulnerabilità dell'istanza gestita.
VulnerabilityAssessmentName

Nome della valutazione della vulnerabilità.
VulnerabilityAssessmentRecurringScansProperties

Proprietà di analisi ricorrenti della valutazione della vulnerabilità.

ManagedInstanceVulnerabilityAssessment

Valutazione della vulnerabilità dell'istanza gestita.

Nome Tipo Descrizione
id

string

ID risorsa.
name

string

Nome risorsa.
properties.recurringScans

VulnerabilityAssessmentRecurringScansProperties

Impostazioni di analisi ricorrenti
properties.storageAccountAccessKey

string

Specifica la chiave identificatore dell'account di archiviazione per i risultati dell'analisi della valutazione della vulnerabilità. Se 'StorageContainerSasKey' non è specificato, è necessario storageAccountAccessKey. Si applica solo se l'account di archiviazione non è dietro una rete virtuale o un firewall
properties.storageContainerPath

string

Percorso del contenitore di archiviazione BLOB per contenere i risultati dell'analisi , ad esempio https://myStorage.blob.core.windows.net/VaScans/.
properties.storageContainerSasKey

string

Firma di accesso condiviso (chiave di firma di accesso condiviso) con accesso in scrittura al contenitore BLOB specificato nel parametro 'storageContainerPath'. Se 'storageAccountAccessKey' non è specificato, è necessario StorageContainerSasKey. Si applica solo se l'account di archiviazione non è dietro una rete virtuale o un firewall
type

string

Tipo di risorsa.

VulnerabilityAssessmentName

Nome della valutazione della vulnerabilità.

Nome Tipo Descrizione
default

string

VulnerabilityAssessmentRecurringScansProperties

Proprietà di analisi ricorrenti della valutazione della vulnerabilità.

Nome Tipo Valore predefinito Descrizione
emailSubscriptionAdmins

boolean

True

Specifica che la notifica di analisi della pianificazione verrà inviata agli amministratori della sottoscrizione.
emails

string[]

Specifica una matrice di indirizzi di posta elettronica a cui viene inviata la notifica di analisi.
isEnabled

boolean

Stato delle analisi ricorrenti.