Sql Server Instances - run Managed Instance Link Assessment

Služba:: Arc Data

Verze rozhraní API:: 2026-01-01

Spouští hodnocení Managed Instance Link pro instanci SQL Server

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureArcData/sqlServerInstances/{sqlServerInstanceName}/runManagedInstanceLinkAssessment?api-version=2026-01-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
sqlServerInstanceName	path	True	string	Název instance SQL Server
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
sqlServerInstanceManagedInstanceLinkAssessmentRequest	SqlServerInstanceManagedInstanceLinkAssessmentRequest	Obsahuje parametry pro spuštění hodnocení MI linku instance SQL Server.

Odpovědi

Name	Typ	Description
200 OK	SqlServerInstanceManagedInstanceLinkAssessmentResponse	OK
202 Accepted		Probíhá hodnocení spojení Arc SQL Server MI. Hlavičky Retry-After: integer Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Chybové odpovědi: ***

Name

Typ

Description

200 OK

SqlServerInstanceManagedInstanceLinkAssessmentResponse

202 Accepted

Probíhá hodnocení spojení Arc SQL Server MI.

Hlavičky

Retry-After: integer
Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

Příklady

Runs Managed Instance Link Assessments and retrieves the results

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.AzureArcData/sqlServerInstances/testsqlserver/runManagedInstanceLinkAssessment?api-version=2026-01-01

{
  "azureManagedInstanceResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testmi",
  "azureManagedInstanceRole": "Secondary",
  "databaseNames": [
    "testdb",
    "testdb2",
    "testdb3"
  ],
  "availabilityGroupName": "AG_testdb",
  "distributedAvailabilityGroupName": "MiLinkDag",
  "assessmentCategories": [
    "SqlInstance",
    "ManagedInstance",
    "ManagedInstanceCrossValidation",
    "DagCrossValidation"
  ],
  "sqlServerIpAddress": "192.168.1.2"
}

Ukázková odpověď

Stavový kód:: 200

{
  "assessments": [
    {
      "name": "MicrosoftPkiCertificate",
      "category": "Certificates",
      "status": "Success",
      "information": "Microsoft PKI certificate trust configured",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "DatabaseMirroringEndpoint",
      "category": "SqlInstance",
      "status": "Success",
      "information": "Database Mirroring Endpoint present",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "DatabaseMirroringEndpointAuthentication",
      "category": "SqlInstance",
      "status": "Success",
      "information": "Database Mirroring Endpoint secured with a certificate",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "DatabaseMirroringEndpointEncryption",
      "category": "SqlInstance",
      "status": "Success",
      "information": "Database Mirroring Endpoint encryption enabled",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "DatabaseMirroringEndpointEncryptionAlgorithm",
      "category": "SqlInstance",
      "status": "Success",
      "information": "Database Mirroring Endpoint encryption algorithm is AES",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "AlwaysOn",
      "category": "SqlInstance",
      "status": "Failure",
      "information": "Always-On Availability Groups enabled",
      "additionalInformation": "Placeholder additional information"
    },
    {
      "name": "DatabaseNameNotInUse",
      "category": "ManagedInstanceDatabase",
      "status": "Failure",
      "information": "Database name not already in use",
      "additionalInformation": "There must not already be a database with the same name as any of the SQL Server databases selected for MI Link.",
      "failingDbs": [
        "testdb2"
      ]
    }
  ]
}

Stavový kód:: 202

Retry-After: 10
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.AzureArcData/locations/eastus2euap/operationStatuses/5abb198d-cc4b-46bd-9e6c-e3f0ba22015d?api-version=2026-01-01
Location: https://management.azure.com/providers/Microsoft.AzureArcData/locations/eastus2euap/operationStatuses/5abb198d-cc4b-46bd-9e6c-e3f0ba22015d?api-version=2026-01-01

Definice

Name	Description
assessmentStatus	Stav požadavku.
azureManagedInstanceRole	Role spravované instance ve skupině distribuované dostupnosti může být primární nebo sekundární.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
miLinkAssessmentCategory	Kategorie validace pro hodnocení předpokladů MI Link.
SqlServerInstanceManagedInstanceLinkAssessment	Seznam výsledků hodnocení MI Link.
SqlServerInstanceManagedInstanceLinkAssessmentRequest	Obsahuje parametry pro spuštění hodnocení MI linku instance SQL Server.
SqlServerInstanceManagedInstanceLinkAssessmentResponse	Odpověď obsahující výsledky hodnocení MI Link.

assessmentStatus

Výčet

Stav požadavku.

Hodnota	Description
Success
Warning
Failure

azureManagedInstanceRole

Výčet

Role spravované instance ve skupině distribuované dostupnosti může být primární nebo sekundární.

Hodnota	Description
Primary
Secondary

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.

miLinkAssessmentCategory

Výčet

Kategorie validace pro hodnocení předpokladů MI Link.

Hodnota	Description
SqlInstance	Hodnocení dané instance na on-premise SQL Server (box).
SqlInstanceDatabase	Hodnocení databáze(ů) na dané instanci na on-premise SQL Server (box).
ManagedInstance	Hodnocení Managed Instance.
ManagedInstanceDatabase	Hodnocení databáze(ů) na Managed Instance.
ManagedInstanceCrossValidation	Hodnocení, která využívají data jak z Managed Instance, tak z dané instance on-premise SQL Server (box) pro validace.
Certificates	Hodnocení konfigurace potřebných certifikátů.
BoxToMiNetworkConnectivity	Hodnocení síťové konektivity z on-premise SQL Server (box) do Managed Instance.
MiToBoxNetworkConnectivity	Hodnocení síťové konektivity z Managed Instance na on-premise SQL Server (box).
SqlInstanceAg	Hodnocení vybrané skupiny dostupnosti.
DagCrossValidation	Hodnocení zvolené skupiny distribuované dostupnosti.

SqlServerInstanceManagedInstanceLinkAssessment

Objekt

Seznam výsledků hodnocení MI Link.

Name	Typ	Description
additionalInformation	string	Další podrobnosti o kontrole, včetně doporučených kroků.
category	miLinkAssessmentCategory	Kategorie validace pro hodnocení předpokladů MI Link.
failingDbs	string[]	Seznam jmen databází, které nesplňují dané hodnocení.
information	string	Informační text o požadavcích.
name	string	Název požadavku.
status	assessmentStatus	Stav požadavku.

SqlServerInstanceManagedInstanceLinkAssessmentRequest

Objekt

Obsahuje parametry pro spuštění hodnocení MI linku instance SQL Server.

Name	Typ	Description
assessmentCategories	miLinkAssessmentCategory[]	Pole řetězců, kde každá hodnota představuje kategorii hodnocení, které má být provedeno. Pokud toto pole není uvedeno, budou spuštěny všechny hodnotící kategorie.
availabilityGroupName	string	Název skupiny dostupnosti, která má být použita pro replikaci databáze.
azureManagedInstanceResourceId	string (arm-id)	ID zdroje Azure SQL Managed Instance pro propojení s instancí SQL Server.
azureManagedInstanceRole	azureManagedInstanceRole	Role spravované instance ve skupině distribuované dostupnosti může být primární nebo sekundární.
databaseNames	string[]	Pole řetězců, kde každá hodnota představuje název databáze, která má být replikována do Azure SQL Managed Instance.
distributedAvailabilityGroupName	string	Název DAG, který má být použit pro replikaci databáze. Také označované jako Link Name.
sqlServerIpAddress	string	IP adresa instance SQL Server.

SqlServerInstanceManagedInstanceLinkAssessmentResponse

Objekt

Odpověď obsahující výsledky hodnocení MI Link.

Name	Typ	Description
assessments	SqlServerInstanceManagedInstanceLinkAssessment[]	Seznam výsledků hodnocení MI Link.