Machines - List By Resource Group

Wyświetla listę wszystkich maszyn hybrydowych w określonej grupie zasobów.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines?api-version=2020-08-02

Parametry identyfikatora URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nazwa grupy zasobów.

subscriptionId
path True
  • string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True
  • string

Wersja interfejsu API klienta.

Odpowiedzi

Name Type Description
200 OK

OK

Other Status Codes

Odpowiedź na błąd z opisem przyczyny niepowodzenia operacji.

Zabezpieczenia

azure_auth

Azure Active Directory przepływ OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Personifikuj konto użytkownika

Przykłady

List Machines by resource group

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines?api-version=2020-08-02

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine",
      "name": "myMachine",
      "location": "eastus2euap",
      "tags": null,
      "identity": {
        "type": "SystemAssigned",
        "principalId": "f7a068cc-b0b8-46e8-a203-22f301a62a8f",
        "tenantId": "c4098cc-91b8-46c2-a205-d82ab1a62a8f"
      },
      "type": "Microsoft.HybridCompute/machines",
      "properties": {
        "provisioningState": "Succeeded",
        "agentVersion": null,
        "status": null,
        "lastStatusChange": null,
        "errorDetails": null,
        "displayName": null,
        "machineFqdn": null,
        "vmUuid": null,
        "osSku": null,
        "domainName": null,
        "adFqdn": null,
        "dnsFqdn": null,
        "osName": null,
        "osVersion": null,
        "osProfile": {
          "computerName": null
        },
        "vmId": "b7a098cc-b0b8-46e8-a205-62f301a62a8f",
        "locationData": {
          "name": "Redmond"
        },
        "clientPublicKey": "string"
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine2",
      "name": "myMachine2",
      "location": "westus2",
      "tags": null,
      "identity": {
        "type": "SystemAssigned",
        "principalId": "e7a068cc-b0b8-46e8-a203-22f301a62a8f",
        "tenantId": "c4098cc-91b8-46c2-a205-d82ab1a62a8f"
      },
      "type": "Microsoft.HybridCompute/machines",
      "properties": {
        "provisioningState": "Succeeded",
        "agentVersion": null,
        "status": null,
        "lastStatusChange": null,
        "errorDetails": null,
        "displayName": null,
        "machineFqdn": null,
        "osName": null,
        "osVersion": null,
        "osProfile": {
          "computerName": null
        },
        "vmId": "a4a098cc-b0b8-46e8-a205-62f301a62a8f",
        "locationData": {
          "name": "Redmond"
        },
        "clientPublicKey": "string"
      }
    }
  ],
  "nextLink": null
}

Definicje

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd.

Identity

Tożsamość zarządzana.

locationData

Metadane odnoszące się do lokalizacji geograficznej zasobu.

Machine

Opisuje maszynę hybrydową.

MachineExtensionInstanceView

Opisuje widok wystąpienia rozszerzenia maszyny.

MachineListResult

Odpowiedź na listę operacji maszyny hybrydowej.

OsProfile

Określa ustawienia systemu operacyjnego dla maszyny hybrydowej.

Status

Stan widoku wystąpienia.

StatusLevelTypes

Kod poziomu.

StatusTypes

Stan agenta maszyny hybrydowej.

ErrorDetail

Szczegóły błędu.

Name Type Description
code
  • string

Kod błędu.

details

Dodatkowe szczegóły błędu.

message
  • string

Komunikat o błędzie możliwy do odczytania przez człowieka.

target
  • string

Wskazuje, która Właściwość żądania jest odpowiedzialna za błąd.

ErrorResponse

Odpowiedź na błąd.

Name Type Description
error

Szczegóły błędu.
Szczegóły błędu.

Identity

Tożsamość zarządzana.

Name Type Description
principalId
  • string

Identyfikator podmiotu zabezpieczeń tożsamości.

tenantId
  • string

Identyfikator dzierżawy tożsamości.

type
  • string

Typ tożsamości.

locationData

Metadane odnoszące się do lokalizacji geograficznej zasobu.

Name Type Description
city
  • string

Miasto lub miejscowość, w której znajduje się zasób.

countryOrRegion
  • string

Kraj lub region, w którym znajduje się zasób

district
  • string

Region, stan lub Prowincja, w której znajduje się zasób.

name
  • string

Nazwa kanoniczna lokalizacji geograficznej lub fizycznej.

Machine

Opisuje maszynę hybrydową.

Name Type Description
id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. /Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity
location
  • string

Lokalizacja geograficzna, w której przebywa zasób

name
  • string

Nazwa zasobu

properties.adFqdn
  • string

Określa w pełni kwalifikowaną nazwę wyświetlaną usługi AD.

properties.agentVersion
  • string

Pełna wersja agenta maszyny hybrydowej.

properties.clientPublicKey
  • string

Klucz publiczny, który ma być używany przez klienta podczas początkowego dołączania do zasobów

properties.displayName
  • string

Określa nazwę wyświetlaną maszyny hybrydowej.

properties.dnsFqdn
  • string

Określa w pełni kwalifikowaną nazwę wyświetlaną DNS.

properties.domainName
  • string

Określa nazwę domeny systemu Windows.

properties.errorDetails

Szczegóły dotyczące stanu błędu.

properties.extensions

Informacje o rozszerzeniach maszyn

properties.lastStatusChange
  • string

Godzina ostatniej zmiany stanu.

properties.locationData

Metadane odnoszące się do lokalizacji geograficznej zasobu.

properties.machineFqdn
  • string

Określa nazwę FQDN maszyny hybrydowej.

properties.osName
  • string

System operacyjny działający na maszynie hybrydowej.

properties.osProfile

Określa ustawienia systemu operacyjnego dla maszyny hybrydowej.

properties.osSku
  • string

Określa jednostkę SKU produktu systemu operacyjnego.

properties.osVersion
  • string

Wersja systemu operacyjnego działającego na maszynie hybrydowej.

properties.provisioningState
  • string

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

properties.status

Stan agenta maszyny hybrydowej.

properties.vmId
  • string

Określa unikatowy identyfikator maszyny hybrydowej.

properties.vmUuid
  • string

Określa unikatowy identyfikator SMBIOS maszyny Arc

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu. Na przykład "Microsoft. COMPUTE/virtualMachines" lub "Microsoft. Storage/storageAccounts"

MachineExtensionInstanceView

Opisuje widok wystąpienia rozszerzenia maszyny.

Name Type Description
name
  • string

Nazwa rozszerzenia maszyny.

status

Stan widoku wystąpienia.

type
  • string

Określa typ rozszerzenia; Przykładem jest "CustomScriptExtension".

typeHandlerVersion
  • string

Określa wersję programu obsługi skryptów.

MachineListResult

Odpowiedź na listę operacji maszyny hybrydowej.

Name Type Description
nextLink
  • string

Identyfikator URI umożliwiający pobranie następnej strony maszyn. Wywołaj ListNext () przy użyciu tego identyfikatora URI, aby pobrać następną stronę maszyn hybrydowych.

value

Lista maszyn hybrydowych.

OsProfile

Określa ustawienia systemu operacyjnego dla maszyny hybrydowej.

Name Type Description
computerName
  • string

Określa nazwę systemu operacyjnego hosta maszyny hybrydowej.

Status

Stan widoku wystąpienia.

Name Type Description
code
  • string

Kod stanu.

displayStatus
  • string

Krótka lokalizowalna etykieta dla stanu.

level

Kod poziomu.

message
  • string

Szczegółowy komunikat o stanie, w tym dotyczące alertów i komunikatów o błędach.

time
  • string

Godzina stanu.

StatusLevelTypes

Kod poziomu.

Name Type Description
Error
  • string
Info
  • string
Warning
  • string

StatusTypes

Stan agenta maszyny hybrydowej.

Name Type Description
Connected
  • string
Disconnected
  • string
Error
  • string