Machines - List By Resource Group

Service:: Hybrid Compute

API Version:: 2020-08-02

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	MachineListResult	OK
Other Status Codes	ErrorResponse	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

Status code:: 200

{
  "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	ErrorDetail[]	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	ErrorDetail	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	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	ErrorDetail[]	Szczegóły dotyczące stanu błędu.
properties.extensions	MachineExtensionInstanceView[]	Informacje o rozszerzeniach maszyn
properties.lastStatusChange	string	Godzina ostatniej zmiany stanu.
properties.locationData	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	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	StatusTypes	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	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	Machine[]	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	StatusLevelTypes	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