Hyper VM achines - Get Machine

Serviço:

Azure Migrate

Versão da API:

2020-01-01

Método para obter a máquina.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/HyperVSites/{siteName}/machines/{machineName}?api-version=2020-01-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
machineName	path	True	string	Nome arm do computador.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
siteName	path	True	string	Nome do site.
subscriptionId	path	True	string	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	HyperVMachine	OK

Exemplos

Get machine.

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/4bd2aa0f-2bd2-4d67-91a8-5a4533d58600/resourceGroups/pajindTest/providers/Microsoft.OffAzure/HyperVSites/appliance1e39site/machines/96d27052-052b-48db-aa84-b9978eddbf5d?api-version=2020-01-01

Resposta da amostra

Código de estado:

200

{
  "id": "/subscriptions/4bd2aa0f-2bd2-4d67-91a8-5a4533d58600/resourceGroups/pajindTest/providers/Microsoft.OffAzure/HyperVSites/appliance1e39site/machines/96d27052-052b-48db-aa84-b9978eddbf5d",
  "name": "96d27052-052b-48db-aa84-b9978eddbf5d",
  "type": "Microsoft.OffAzure/HyperVSites/machines",
  "properties": {
    "hostFqdn": "BCDR-EWLAB-48.fareast.corp.microsoft.com",
    "hostId": "/subscriptions/4bd2aa0f-2bd2-4d67-91a8-5a4533d58600/resourceGroups/pajindTest/providers/Microsoft.OffAzure/HyperVSites/appliance1e39site/hosts/bcdr-ewlab-48-fareast-corp-micr-691cb67f-3474-55ee-b376-63a93b276ed6",
    "clusterFqdn": null,
    "clusterId": null,
    "managementServerType": "Host",
    "generation": 1,
    "version": "8.0",
    "highAvailability": "No",
    "maxMemoryMB": 1048576,
    "firmware": "BIOS",
    "isDynamicMemoryEnabled": false,
    "disks": [
      {
        "instanceId": "Microsoft:96D27052-052B-48DB-AA84-B9978EDDBF5D\\83F8638B-8DCA-4152-9EDA-2CA8B33039B4\\0\\0\\L",
        "vhdId": "4845656d-75b2-1246-bc8f-13d900000000",
        "maxSizeInBytes": 42949672960,
        "name": "14393.0.amd64fre.rs1_release.160715-1616_server_serverstandard_de-de",
        "diskType": "Dynamic",
        "lun": 0,
        "path": "D:\\VHDs\\14393.0.amd64fre.rs1_release.160715-1616_server_serverstandard_de-de.vhd"
      },
      {
        "instanceId": "Microsoft:96D27052-052B-48DB-AA84-B9978EDDBF5D\\523DA04B-C02E-451F-AF58-46925E56213D\\0\\0\\L",
        "vhdId": "5d45e8e9-7ab3-4999-915c-d62c70e5a39d",
        "maxSizeInBytes": 110595407872,
        "name": "22",
        "diskType": "Dynamic",
        "lun": 0,
        "path": "C:\\Users\\Public\\Documents\\Hyper-V\\Virtual hard disks\\22.vhdx"
      }
    ],
    "networkAdapters": [
      {
        "networkId": "QnJvYWRjb20gTmV0WHRyZW1lIEdpZ2FiaXQgRXRoZXJuZXQgLSBWaXJ0dWFsIFN3aXRjaA==",
        "subnetName": "Broadcom NetXtreme Gigabit Ethernet - Virtual Switch",
        "staticIpAddress": null,
        "nicType": "NicType",
        "nicId": "Microsoft:96D27052-052B-48DB-AA84-B9978EDDBF5D\\89DF59CE-0C5D-4204-BADF-F41E3EA37821",
        "macAddress": "00:15:5d:0c:92:7a",
        "ipAddressList": [
          "10.150.10.139",
          "fe80::e989:d351:54d7:42a6",
          "2404:f801:4800:25:e989:d351:54d7:42a6"
        ],
        "networkName": null,
        "ipAddressType": "Dynamic"
      }
    ],
    "displayName": "TestDeDe",
    "numberOfProcessorCore": 8,
    "allocatedMemoryInMB": 4096,
    "vmConfigurationFileLocation": "C:\\ProgramData\\Microsoft\\Windows\\Hyper-V\\Virtual Machines\\96D27052-052B-48DB-AA84-B9978EDDBF5D.vmcx",
    "operatingSystemDetails": {
      "osType": null,
      "osName": "Windows Server 2016 Standard",
      "osVersion": "10.0.14393"
    },
    "createdTimestamp": "2019-05-09T07:56:11.498307Z",
    "updatedTimestamp": "2019-05-14T07:01:18.4058859Z",
    "instanceUuid": "96d27052-052b-48db-aa84-b9978eddbf5d",
    "powerStatus": "Running",
    "biosSerialNumber": "5656-6486-4089-5091-2740-7319-66",
    "vmFqdn": "WIN-VDE4EPC5D52",
    "isDeleted": false,
    "errors": []
  }
}

Definições

Name	Description
Application	Aplicação na máquina virtual convidada.
AppsAndRoles	AppsAndRoles na máquina virtual convidada.
BizTalkServer	BizTalkServer na máquina virtual convidada.
ExchangeServer	ExchangeServer na máquina virtual convidada.
Feature	Funcionalidade na máquina virtual convidada.
GuestOSDetails	Dados relacionados com o sistema operativo de uma máquina. Serializado e armazenado como parte do objeto Rest da Máquina.
HealthErrorDetails	Contrato de erro devolvido quando ocorre alguma exceção na API Rest.
HighlyAvailable	Valor que indica se a VM é de elevada disponibilidade.
HyperVDisk	Objeto de segundo nível devolvido como parte do recurso REST da Máquina.
HyperVMachine	Recurso REST do Computador.
HyperVMachineProperties	Classe para propriedades do computador.
HyperVNetworkAdapter	Objeto de segundo nível representado em respostas como parte do recurso REST da Máquina.
OperatingSystem	Objeto de segundo nível devolvido como parte do recurso REST da Máquina.
OtherDatabase	OtherDatabase na máquina virtual convidada.
SharePointServer	SharePointServer na máquina virtual convidada.
SQLServer	SQLServer na máquina virtual convidada.
SystemCenter	SystemCenter na máquina virtual convidada.
WebApplication	WebApplication na máquina virtual convidada.

Application

Aplicação na máquina virtual convidada.

Name	Tipo	Description
name	string	Nome da Aplicação.
provider	string	Fornecedor da Aplicação.
version	string	Versão da Aplicação.

AppsAndRoles

AppsAndRoles na máquina virtual convidada.

Name	Tipo	Description
applications	Application[]	Aplicações das AplicaçõesAndRoles.
bizTalkServers	BizTalkServer[]	BizTalkServers das AplicaçõesAndRoles.
exchangeServers	ExchangeServer[]	ExchangeServers das AplicaçõesAndRoles.
features	Feature[]	Funcionalidades das AplicaçõesAndRoles.
otherDatabases	OtherDatabase[]	OtherDatabaseServers das AplicaçõesAndRoles.
sharePointServers	SharePointServer[]	SharePointServers das AplicaçõesAndRoles.
sqlServers	SQLServer[]	SQLServers das AplicaçõesAndRoles.
systemCenters	SystemCenter[]	SystemCenters das AplicaçõesAndRoles.
webApplications	WebApplication[]	WebApplications das AplicaçõesAndRoles.

BizTalkServer

BizTalkServer na máquina virtual convidada.

Name	Tipo	Description
productName	string	ProductName do BizTalkServer.
status	string	Estado do BizTalkServer.

ExchangeServer

ExchangeServer na máquina virtual convidada.

Name	Tipo	Description
edition	string	Edição do ExchangeServer.
productName	string	ProductName do ExchangeServer.
roles	string	Funções do ExchangeServer.
servicePack	string	ServicePack do ExchangeServer.
version	string	Versão do ExchangeServer.

Feature

Funcionalidade na máquina virtual convidada.

Name	Tipo	Description
featureType	string	FeatureType da Funcionalidade.
name	string	Nome da Funcionalidade.
parent	string	Principal da Funcionalidade.
status	string	Estado da Funcionalidade.

GuestOSDetails

Dados relacionados com o sistema operativo de uma máquina. Serializado e armazenado como parte do objeto Rest da Máquina.

Name	Tipo	Description
osName	string	Nome do sistema operativo.
osType	string	Tipo do sistema operativo.
osVersion	string	Versão do sistema operativo.

HealthErrorDetails

Contrato de erro devolvido quando ocorre alguma exceção na API Rest.

Name	Tipo	Description
code	string	Nome do erro.
id	integer	ID do Erro.
message	string	Mensagem de erro.
messageParameters	object	Parâmetros de mensagens.
possibleCauses	string	Possíveis causas de erro.
recommendedAction	string	Ação recomendada para resolver o erro.
severity	string	Gravidade do erro.
source	string	Origem do erro.
summaryMessage	string	Mensagem de resumo do erro.

HighlyAvailable

Valor que indica se a VM é de elevada disponibilidade.

Name	Tipo	Description
No	string
Unknown	string
Yes	string

HyperVDisk

Objeto de segundo nível devolvido como parte do recurso REST da Máquina.

Name	Tipo	Description
diskType	string	Tipo do disco.
instanceId	string	ID do disco.
lun	integer	LUN do disco.
maxSizeInBytes	integer	Bytes alocados para o disco.
name	string	Nome do disco.
path	string	Caminho do disco.
vhdId	string	ID de VHD do disco.

HyperVMachine

Recurso REST do Computador.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome dos Sites.
properties	HyperVMachineProperties	Propriedades aninhadas.
type	string	Tipo de recurso. Type = Microsoft.OffAzure/HyperVSites/Machines.

HyperVMachineProperties

Classe para propriedades do computador.

Name	Tipo	Description
allocatedMemoryInMB	number	Memória Alocada em MB.
appsAndRoles	AppsAndRoles	Aplicações e Funções da VM.
biosGuid	string	GUID do BIOS do Computador.
biosSerialNumber	string	Número de série do BIOS do computador.
clusterFqdn	string	FQDN/IPAddress do cluster.
clusterId	string	ID arm do cluster.
createdTimestamp	string	Carimbo de data/hora a marcar a criação da máquina.
disks	HyperVDisk[]	Discos ligados à máquina virtual.
displayName	string	Nome a apresentar do computador.
errors	HealthErrorDetails[]	Erros da máquina virtual.
firmware	string	Firmware da máquina.
generation	integer	Geração da máquina virtual.
guestDetailsDiscoveryTimestamp	string	A última vez em que os Detalhes do Convidado da máquina foram detetados.
guestOSDetails	GuestOSDetails	Detalhes do Sistema Operativo extraídos do convidado ao executar o script dentro da VM convidada.
highAvailability	HighlyAvailable	Valor que indica se a VM é de elevada disponibilidade.
hostFqdn	string	FQDN/IPAddress do anfitrião.
hostId	string	ID arm do anfitrião.
instanceUuid	string	UUID da Instância no local do computador.
isDeleted	boolean	Valor que indica se a VM foi eliminada.
isDynamicMemoryEnabled	boolean	Valor que indica se a memória dinâmica está ativada para a VM.
isGuestDetailsDiscoveryInProgress	boolean	Se Atualizar Detalhes do Convidado do Esquema de Recursos de Infraestrutura já foi concluído uma vez. O portal mostrará a deteção em curso, se este valor for verdadeiro.
managementServerType	string	Tipo de servidor de gestão do computador. É Anfitrião ou Cluster.
maxMemoryMB	integer	Memória máxima da máquina virtual em MB.
networkAdapters	HyperVNetworkAdapter[]	Adaptadores de rede ligados à máquina.
numberOfApplications	integer	Número de aplicações instaladas na VM convidada.
numberOfProcessorCore	integer	Número de Núcleos de Processador alocados para o computador.
operatingSystemDetails	OperatingSystem	Detalhes do Sistema Operativo instalados no computador.
powerStatus	string	Estado de energia da máquina.
updatedTimestamp	string	Carimbo de data/hora a marcar a última atualização no computador.
version	string	Versão da VM.
vmConfigurationFileLocation	string	Localização raiz do ficheiro de configuração da VM.
vmFqdn	string	FQDN do Computador.

HyperVNetworkAdapter

Objeto de segundo nível representado em respostas como parte do recurso REST da Máquina.

Name	Tipo	Description
ipAddressList	string[]	Endereços IP do computador.
ipAddressType	string	Tipo de endereço IP.
macAddress	string	Endereço Mac da NIC.
networkId	string	ID de Rede.
networkName	string	Nome da Rede.
nicId	string	ID nic.
nicType	string	Endereço Mac da NIC.
staticIpAddress	string	Endereço IP estático.
subnetName	string	Nome da sub-rede da VM na rede virtual à qual o NIC está anexado.

OperatingSystem

Objeto de segundo nível devolvido como parte do recurso REST da Máquina.

Name	Tipo	Description
osName	string	Nome do sistema operativo.
osType	string	Tipo do sistema operativo.
osVersion	string	Versão do sistema operativo.

OtherDatabase

OtherDatabase na máquina virtual convidada.

Name	Tipo	Description
databaseType	string	DatabaseType do OtherDatabase.
instance	string	Instância do OtherDatabase.
version	string	Versão do OtherDatabase.

SharePointServer

SharePointServer na máquina virtual convidada.

Name	Tipo	Description
isEnterprise	boolean	Valor que indica se o SharePointServer é Enterprise.
productName	string	ProductName do SharePointServer.
status	string	Estado do SharePointServer.
version	string	Versão do SharePointServer.

SQLServer

SQLServer na máquina virtual convidada.

Name	Tipo	Description
clusterName	string	ClusterName do SQLServer.
clustered	string	Agrupado do SQLServer.
edition	string	Edição do SQLServer.
name	string	Nome do SQLServer.
servicePack	string	ServicePack do SQLServer.
version	string	Versão do SQLServer.

SystemCenter

SystemCenter na máquina virtual convidada.

Name	Tipo	Description
productName	string	ProductName do SystemCenter.
status	string	Estado do SystemCenter.
version	string	Versão do SystemCenter.

WebApplication

WebApplication na máquina virtual convidada.

Name	Tipo	Description
applicationPool	string	ApplicationPool da WebApplication.
groupName	string	GroupName da WebApplication.
name	string	Nome da WebApplication.
platform	string	Plataforma da WebApplication.
status	string	Estado da WebApplication.
webServer	string	WebServer da WebApplication.