Managed Instance Operations - List By Managed Instance

Riferimento

Servizio:: SQL Database

Versione API:: 2023-08-01

Ottiene un elenco di operazioni eseguite nell'istanza gestita.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/operations?api-version=2023-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
managedInstanceName	path	True	string	Nome dell'istanza gestita.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedInstanceOperationListResult	La richiesta di recupero delle operazioni dell'istanza gestita è stata eseguita correttamente.
Other Status Codes	ErrorResponse	Risposte di errore: 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Nome

Tipo

Descrizione

200 OK

ManagedInstanceOperationListResult

La richiesta di recupero delle operazioni dell'istanza gestita è stata eseguita correttamente.

Other Status Codes

ErrorResponse

Risposte di errore:

400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto
400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

Esempio

List the managed instance management operations

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ListManagedInstanceOperations.json
// this example is just showing the usage of "ManagedInstanceOperations_ListByManagedInstance" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedInstanceResource created on azure
// for more information of creating ManagedInstanceResource, please refer to the document of ManagedInstanceResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
string managedInstanceName = "sqlcrudtest-4645";
ResourceIdentifier managedInstanceResourceId = ManagedInstanceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName);
ManagedInstanceResource managedInstance = client.GetManagedInstanceResource(managedInstanceResourceId);

// get the collection of this ManagedInstanceOperationResource
ManagedInstanceOperationCollection collection = managedInstance.GetManagedInstanceOperations();

// invoke the operation and iterate over the result
await foreach (ManagedInstanceOperationResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ManagedInstanceOperationData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "properties": {
        "managedInstanceName": "sqlcrudtest-4645",
        "operation": "UpsertManagedServer",
        "operationFriendlyName": "UPDATE MANAGED SERVER",
        "percentComplete": 100,
        "startTime": "2019-12-06T11:08:44.49Z",
        "state": "Cancelled",
        "isCancellable": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/11111111-1111-1111-1111-111111111111",
      "name": "11111111-1111-1111-1111-111111111111",
      "type": "Microsoft.Sql/managedInstances/operations"
    },
    {
      "properties": {
        "managedInstanceName": "sqlcrudtest-4645",
        "operation": "UpsertManagedServer",
        "operationFriendlyName": "UPDATE MANAGED SERVER",
        "percentComplete": 50,
        "startTime": "2019-12-06T11:08:44.49Z",
        "state": "InProgress",
        "isCancellable": true,
        "operationParameters": {
          "currentParameters": {
            "family": "Gen4",
            "tier": "GeneralPurpose",
            "vCores": 8,
            "storageSizeInGB": 32
          },
          "requestedParameters": {
            "family": "Gen4",
            "tier": "BusinessCritical",
            "vCores": 8,
            "storageSizeInGB": 128
          }
        },
        "operationSteps": {
          "totalSteps": "3",
          "currentStep": 3,
          "stepsList": [
            {
              "order": 1,
              "name": "Request validation",
              "status": "Completed",
              "stepEndTime": "2019-12-06T11:08:45.57Z",
              "stepStartTime": "2019-12-06T11:08:44.49Z",
              "timeElapsed": "0"
            },
            {
              "order": 2,
              "name": "Virtual Cluster resize/creation",
              "status": "Completed",
              "stepEndTime": "2019-12-06T11:22:47.35Z",
              "stepStartTime": "2019-12-06T11:08:46.15Z",
              "timeElapsed": "14"
            },
            {
              "order": 3,
              "name": "New SQL Instance Startup",
              "status": "InProgress",
              "stepEndTime": "2019-12-06T11:24:50.51Z",
              "stepStartTime": "2019-12-06T11:22:47.42Z",
              "timeElapsed": "2"
            }
          ]
        }
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/22222222-2222-2222-2222-222222222222",
      "name": "22222222-2222-2222-2222-222222222222",
      "type": "Microsoft.Sql/managedInstances/operations"
    },
    {
      "properties": {
        "managedInstanceName": "sqlcrudtest-4645",
        "operation": "UpsertManagedServer",
        "operationFriendlyName": "UPDATE MANAGED SERVER",
        "percentComplete": 100,
        "startTime": "2019-12-06T14:48:34.583Z",
        "state": "Failed",
        "errorCode": 45157,
        "errorDescription": "Server 'sqlcrudtest-4645' is busy with another operation. Please try your operation later.",
        "errorSeverity": 16,
        "isUserError": true,
        "isCancellable": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/33333333-3333-3333-3333-333333333333",
      "name": "33333333-3333-3333-3333-333333333333",
      "type": "Microsoft.Sql/managedInstances/operations"
    },
    {
      "properties": {
        "managedInstanceName": "sqlcrudtest-4645",
        "operation": "MakeAllManagedDatabasesAccessible",
        "operationFriendlyName": "MAKE ALL MANAGED DBS ACCESSIBLE",
        "percentComplete": 100,
        "startTime": "2019-12-04T09:00:08.1Z",
        "state": "Failed",
        "operationSteps": {
          "totalSteps": "1",
          "currentStep": 1,
          "stepsList": [
            {
              "order": 1,
              "name": "Request validation",
              "status": "Failed",
              "stepEndTime": "2019-12-04T09:01:00.57Z",
              "stepStartTime": "2019-12-04T09:00:30.15Z",
              "timeElapsed": "0"
            }
          ]
        }
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/44444444-4444-4444-4444-444444444444",
      "name": "44444444-4444-4444-4444-444444444444",
      "type": "Microsoft.Sql/managedInstances/operations"
    }
  ]
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedInstanceOperation	Operazione dell'istanza gestita.
ManagedInstanceOperationListResult	Risposta a una richiesta di operazioni dell'istanza gestita di elenco
ManagedInstanceOperationParametersPair	Parametri di un'operazione di istanza gestita.
ManagedInstanceOperationSteps	Passaggi di un'operazione di istanza gestita.
ManagementOperationState	Stato dell'operazione.
ManagementOperationStepState
UpsertManagedServerOperationParameters
UpsertManagedServerOperationStepWithEstimatesAndDuration

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedInstanceOperation

Object

Operazione dell'istanza gestita.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.description	string	Descrizione dell'operazione.
properties.errorCode	integer (int32)	Codice di errore dell'operazione.
properties.errorDescription	string	Descrizione dell'errore dell'operazione.
properties.errorSeverity	integer (int32)	Gravità dell'errore dell'operazione.
properties.estimatedCompletionTime	string (date-time)	Tempo di completamento stimato dell'operazione.
properties.isCancellable	boolean	Indica se l'operazione può essere annullata.
properties.isUserError	boolean	Indica se l'errore è un errore dell'utente.
properties.managedInstanceName	string	Nome dell'istanza gestita in cui viene eseguita l'operazione.
properties.operation	string	Nome dell'operazione.
properties.operationFriendlyName	string	Nome descrittivo dell'operazione.
properties.operationParameters	ManagedInstanceOperationParametersPair	Parametri dell'operazione.
properties.operationSteps	ManagedInstanceOperationSteps	Passaggi dell'operazione.
properties.percentComplete	integer (int32)	Percentuale dell'operazione completata.
properties.startTime	string (date-time)	Ora di inizio dell'operazione.
properties.state	ManagementOperationState	Stato dell'operazione.
type	string	Tipo di risorsa.

ManagedInstanceOperationListResult

Object

Risposta a una richiesta di operazioni dell'istanza gestita di elenco

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ManagedInstanceOperation[]	Matrice di risultati.

ManagedInstanceOperationParametersPair

Object

Parametri di un'operazione di istanza gestita.

Nome	Tipo	Descrizione
currentParameters	UpsertManagedServerOperationParameters	Parametri correnti.
requestedParameters	UpsertManagedServerOperationParameters	Parametri richiesti.

ManagedInstanceOperationSteps

Object

Passaggi di un'operazione di istanza gestita.

Nome	Tipo	Descrizione
currentStep	integer (int32)	Numero di passaggi correnti dell'operazione.
stepsList	UpsertManagedServerOperationStepWithEstimatesAndDuration[]	Elenco dei passaggi dell'operazione.
totalSteps	string	Numero totale di passaggi dell'operazione.

ManagementOperationState

Enumerazione

Stato dell'operazione.

Valore	Descrizione
CancelInProgress
Cancelled
Failed
InProgress
Pending
Succeeded

ManagementOperationStepState

Enumerazione

Valore	Descrizione
Canceled
Completed
Failed
InProgress
NotStarted
SlowedDown

UpsertManagedServerOperationParameters

Object

Nome	Tipo	Descrizione
family	string
storageSizeInGB	integer (int32)
tier	string
vCores	integer (int32)

UpsertManagedServerOperationStepWithEstimatesAndDuration

Object

Nome	Tipo	Descrizione
name	string
order	integer (int32)
status	ManagementOperationStepState
stepEndTime	string (date-time)
stepStartTime	string (date-time)
timeElapsed	string

Condividi tramite

Managed Instance Operations - List By Managed Instance

Parametri dell'URI

Risposte

Esempio

List the managed instance management operations

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedInstanceOperation

ManagedInstanceOperationListResult

ManagedInstanceOperationParametersPair

ManagedInstanceOperationSteps

ManagementOperationState

ManagementOperationStepState

UpsertManagedServerOperationParameters

UpsertManagedServerOperationStepWithEstimatesAndDuration