Cloud Services - Get Instance View

Szolgáltatás:: Compute

API-verzió:: 2024-11-04

Lekéri egy felhőszolgáltatás állapotát.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/instanceView?api-version=2024-11-04

URI-paraméterek

Name	In	Kötelező	Típus	Description
cloudServiceName	path	True	string	A felhőszolgáltatás neve.
resourceGroupName	path	True	string	Az erőforráscsoport neve.
subscriptionId	path	True	string	Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Ügyfél API-verziója.

Válaszok

Name	Típus	Description
200 OK	CloudServiceInstanceView	OKÉ
Other Status Codes	CloudError	Error

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get Cloud Service Instance View with Multiple Roles

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/instanceView?api-version=2024-11-04

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/Cloudservice/stable/2024-11-04/examples/CloudService_Get_InstanceViewWithMultiRole.json
// this example is just showing the usage of "CloudServices_GetInstanceView" 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 CloudServiceResource created on azure
// for more information of creating CloudServiceResource, please refer to the document of CloudServiceResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "ConstosoRG";
string cloudServiceName = "{cs-name}";
ResourceIdentifier cloudServiceResourceId = CloudServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, cloudServiceName);
CloudServiceResource cloudService = client.GetCloudServiceResource(cloudServiceResourceId);

// invoke the operation
CloudServiceInstanceView result = await cloudService.GetInstanceViewAsync();

Console.WriteLine($"Succeeded: {result}");

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

Mintaválasz

Állapotkód:: 200

{
  "roleInstance": {
    "statusesSummary": [
      {
        "code": "ProvisioningState/succeeded",
        "count": 4
      },
      {
        "code": "PowerState/started",
        "count": 4
      },
      {
        "code": "RoleState/RoleStateStarted",
        "count": 4
      }
    ]
  },
  "sdkVersion": "2.9.6496.3",
  "privateIds": [
    "3491bc0c-1f6c-444f-b1d0-ec0751a74e3e"
  ],
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2021-01-12T16:50:07.0953535+05:30"
    },
    {
      "code": "PowerState/started",
      "level": "Info",
      "displayStatus": "Started",
      "time": "2021-01-12T16:50:07.0953535+05:30"
    },
    {
      "code": "CurrentUpgradeDomain/-1",
      "level": "Info",
      "displayStatus": "Current Upgrade Domain of cloud service is -1."
    },
    {
      "code": "MaxUpgradeDomain/1",
      "level": "Info",
      "displayStatus": "Max Upgrade Domain of cloud service is 1."
    }
  ]
}

Definíciók

Name	Description
ApiError	API-hiba.
ApiErrorBase	API hibabázis.
CloudError	Hibaválasz a számítási szolgáltatástól.
CloudServiceInstanceView	A CloudService egészének InstanceView
InnerError	Belső hiba részletei.
InstanceViewStatusesSummary	Példánynézet állapotai.
ResourceInstanceViewStatus	Példánynézet állapota.
StatusCodeCount	A felhőszolgáltatás-példány állapotkódja és száma nézetállapotok
StatusLevelTypes	A szintkód.

ApiError

Tárgy

API-hiba.

Name	Típus	Description
code	string	A hibakód.
details	ApiErrorBase[]	Az API-hiba részletei
innererror	InnerError	Az API belső hibája
message	string	A hibaüzenet.
target	string	Az adott hiba célja.

ApiErrorBase

Tárgy

API hibabázis.

Name	Típus	Description
code	string	A hibakód.
message	string	A hibaüzenet.
target	string	Az adott hiba célja.

CloudError

Tárgy

Hibaválasz a számítási szolgáltatástól.

Name	Típus	Description
error	ApiError	API-hiba.

CloudServiceInstanceView

Tárgy

A CloudService egészének InstanceView

Name	Típus	Description
privateIds	string[]	A felhőszolgáltatáshoz belsőleg létrehozott egyedi azonosítók listáját adja meg. MEGJEGYZÉS: Ha Azure Diagnostics bővítményt használ, ez a tulajdonság "DeploymentId" néven használható a részletek lekérdezéséhez.
roleInstance	InstanceViewStatusesSummary	Példánynézet állapotai.
sdkVersion	string	Az SDK azon verziója, amely a felhőszolgáltatás csomagjának létrehozásához használt.
statuses	ResourceInstanceViewStatus[]	Példánynézet állapota.

InnerError

Tárgy

Belső hiba részletei.

Name	Típus	Description
errordetail	string	A belső hibaüzenet vagy kivételkép.
exceptiontype	string	A kivétel típusa.

InstanceViewStatusesSummary

Tárgy

Példánynézet állapotai.

Name	Típus	Description
statusesSummary	StatusCodeCount[]	Az összefoglaló.

ResourceInstanceViewStatus

Tárgy

Példánynézet állapota.

Name	Típus	Description
code	string	Az állapotkód.
displayStatus	string	Az állapot rövid honosítható címkéje.
level	StatusLevelTypes	A szintkód.
message	string	A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.
time	string (date-time)	Az állapot időpontja.

StatusCodeCount

Tárgy

A felhőszolgáltatás-példány állapotkódja és száma nézetállapotok

Name	Típus	Description
code	string	A példánynézet állapotkódja
count	integer (int32)	Az ezzel az állapotkóddal rendelkező példányok száma

StatusLevelTypes

Felsorolás

A szintkód.

Érték	Description
Info
Warning
Error