Managed Instance Operations - Get

Layanan:: SQL Database

Versi API:: 2025-01-01

Mendapatkan operasi manajemen pada instans terkelola.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
managedInstanceName	path	True	string	Nama instans terkelola.
operationId	path	True	string (uuid)
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagedInstanceOperation	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Gets the managed instance management operation

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/00000000-1111-2222-3333-444444444444?api-version=2025-01-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/SQL/stable/2025-01-01/examples/GetManagedInstanceOperation.json
// this example is just showing the usage of "ManagedInstanceOperations_Get" 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 ManagedInstanceOperationResource created on azure
// for more information of creating ManagedInstanceOperationResource, please refer to the document of ManagedInstanceOperationResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
string managedInstanceName = "sqlcrudtest-4645";
Guid operationId = Guid.Parse("00000000-1111-2222-3333-444444444444");
ResourceIdentifier managedInstanceOperationResourceId = ManagedInstanceOperationResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, managedInstanceName, operationId);
ManagedInstanceOperationResource managedInstanceOperation = client.GetManagedInstanceOperationResource(managedInstanceOperationResourceId);

// invoke the operation
ManagedInstanceOperationResource result = await managedInstanceOperation.GetAsync();

// the variable result 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 = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Respon sampel

Kode status:: 200

{
  "name": "11111111-1111-1111-1111-111111111111",
  "type": "Microsoft.Sql/managedInstances/operations",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/operations/11111111-1111-1111-1111-111111111111",
  "properties": {
    "isCancellable": false,
    "managedInstanceName": "sqlcrudtest-4645",
    "operation": "UpsertManagedServer",
    "operationFriendlyName": "UPDATE MANAGED SERVER",
    "operationSteps": {
      "currentStep": 2,
      "stepsList": [
        {
          "name": "Request validation",
          "order": 1,
          "status": "Completed",
          "stepEndTime": "2019-12-06T11:08:45.57Z",
          "stepStartTime": "2019-12-06T11:08:44.49Z",
          "timeElapsed": "0"
        },
        {
          "name": "Virtual Cluster resize/creation",
          "order": 2,
          "status": "Completed",
          "stepEndTime": "2019-12-06T11:23:05.47Z",
          "stepStartTime": "2019-12-06T11:08:46.05Z",
          "timeElapsed": "14"
        },
        {
          "name": "New SQL Instance Startup",
          "order": 3,
          "status": "Canceled",
          "stepEndTime": "2019-12-06T11:23:11.51Z",
          "stepStartTime": "2019-12-06T11:23:05.55Z",
          "timeElapsed": "0"
        },
        {
          "name": "Seeding database files",
          "order": 4,
          "status": "NotStarted"
        },
        {
          "name": "Preparing Failover and Failover",
          "order": 5,
          "status": "NotStarted"
        },
        {
          "name": "Old SQL Instance cleanup",
          "order": 6,
          "status": "NotStarted"
        }
      ],
      "totalSteps": "6"
    },
    "percentComplete": 100,
    "startTime": "2019-12-06T11:08:44.49Z",
    "state": "Cancelled"
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ManagedInstanceOperation	Operasi instans terkelola.
ManagedInstanceOperationParametersPair	Parameter operasi instans terkelola.
ManagedInstanceOperationSteps	Langkah-langkah operasi instans terkelola.
ManagementOperationState	Status operasi.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UpsertManagedServerOperationParameters
UpsertManagedServerOperationStepWithEstimatesAndDuration
UpsertManagedServerOperationStepWithEstimatesAndDurationStatus

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ManagedInstanceOperation

Objek

Operasi instans terkelola.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties.description	string	Deskripsi operasi.
properties.errorCode	integer (int32)	Kode kesalahan operasi.
properties.errorDescription	string	Deskripsi kesalahan operasi.
properties.errorSeverity	integer (int32)	Tingkat keparahan kesalahan operasi.
properties.estimatedCompletionTime	string (date-time)	Perkiraan waktu penyelesaian operasi.
properties.isCancellable	boolean	Apakah operasi dapat dibatalkan.
properties.isUserError	boolean	Apakah kesalahan tersebut adalah kesalahan pengguna atau tidak.
properties.managedInstanceName	string	Nama instans terkelola tempat operasi sedang dilakukan.
properties.operation	string	Nama operasi.
properties.operationFriendlyName	string	Nama operasi yang ramah.
properties.operationParameters	ManagedInstanceOperationParametersPair	Parameter operasi.
properties.operationSteps	ManagedInstanceOperationSteps	Langkah-langkah operasi.
properties.percentComplete	integer (int32)	Persentase operasi selesai.
properties.startTime	string (date-time)	Waktu mulai operasi.
properties.state	ManagementOperationState	Status operasi.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

ManagedInstanceOperationParametersPair

Objek

Parameter operasi instans terkelola.

Nama	Jenis	Deskripsi
currentParameters	UpsertManagedServerOperationParameters	Parameter saat ini.
requestedParameters	UpsertManagedServerOperationParameters	Parameter yang diminta.

ManagedInstanceOperationSteps

Objek

Langkah-langkah operasi instans terkelola.

Nama	Jenis	Deskripsi
currentStep	integer (int32)	Jumlah langkah operasi saat ini.
stepsList	UpsertManagedServerOperationStepWithEstimatesAndDuration[]	Daftar langkah-langkah operasi.
totalSteps	string	Jumlah total langkah operasi.

ManagementOperationState

Enumerasi

Status operasi.

Nilai	Deskripsi
Pending	Menunggu
InProgress	InProgress
Succeeded	Berhasil
Failed	Kegagalan
CancelInProgress	BatalSedang Berlangsung
Cancelled	Dibatalkan

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UpsertManagedServerOperationParameters

Objek

Nama	Jenis	Deskripsi
family	string
storageSizeInGB	integer (int32)
tier	string
vCores	integer (int32)

UpsertManagedServerOperationStepWithEstimatesAndDuration

Objek

Nama	Jenis	Deskripsi
name	string
order	integer (int32)
status	UpsertManagedServerOperationStepWithEstimatesAndDurationStatus
stepEndTime	string (date-time)
stepStartTime	string (date-time)
timeElapsed	string

UpsertManagedServerOperationStepWithEstimatesAndDurationStatus

Enumerasi

Nilai	Deskripsi
NotStarted	Belum Mulai
InProgress	InProgress
SlowedDown	Melambat
Completed	Selesai
Failed	Kegagalan
Canceled	Dibatalkan