Vmm Servers - Get

Serviço:: Azure Arc enabled SCVMM

Versão da API:: 2025-03-13

Obtém um VMMServer.
Implementa o método GET do VmmServer.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ScVmm/vmmServers/{vmmServerName}?api-version=2025-03-13

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
vmmServerName	path	True	string minLength: 1 maxLength: 54 pattern: [a-zA-Z0-9-_\.]	Nome do VmmServer.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Nome	Tipo	Description
200 OK	VmmServer	A operação do Azure foi concluída com êxito.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

VmmServers_Get_MaximumSet

VmmServers_Get_MinimumSet

VmmServers_Get_MaximumSet

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/vmmServers/.?api-version=2025-03-13

Resposta de exemplo

Código de status:: 200

{
  "properties": {
    "credentials": {
      "username": "jbuoltypmrgqfi"
    },
    "fqdn": "pvzcjaqrswbvptgx",
    "port": 4,
    "connectionStatus": "vlmrrigzmutgbzrgjtolnamfxm",
    "errorMessage": "ndkzeiipz",
    "uuid": "vmwbukuqbuz",
    "version": "tawfjzbqrlkqzqyomxiahnfqg",
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "tags": {
    "key4834": "vycgfkzjcyyuotwwq"
  },
  "location": "hslxkyzktvwpqbypvs",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
  "name": "gyoxmcbnbbfajvzygtffpaufxxjzs",
  "type": "nwiimbcjryiggdcbpvrqdnlrklcwbr",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

VmmServers_Get_MinimumSet

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/79332E5A-630B-480F-A266-A941C015AB19/resourceGroups/rgscvmm/providers/Microsoft.ScVmm/vmmServers/D?api-version=2025-03-13

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
  "extendedLocation": {},
  "location": "hslxkyzktvwpqbypvs"
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	O local estendido.
ProvisioningState	O estado de provisionamento do recurso.
systemData	Metadados relativos à criação e última modificação do recurso.
VmmCredential	Credenciais para se conectar ao VmmServer.
VmmServer	A definição de recurso VmmServers.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Objeto

O local estendido.

Nome	Tipo	Description
name	string (arm-id)	O nome do local estendido.
type	string	O tipo de local estendido.

ProvisioningState

Enumeração

O estado de provisionamento do recurso.

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Provisioning	O recurso está sendo provisionado.
Updating	O recurso está sendo atualizado.
Deleting	O recurso está sendo excluído.
Accepted	O recurso foi aceito.
Created	O recurso foi criado.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

VmmCredential

Objeto

Credenciais para se conectar ao VmmServer.

Nome	Tipo	Description
password	string (password)	Senha a ser usada para se conectar ao VmmServer.
username	string	Nome de usuário a ser usado para se conectar ao VmmServer.

VmmServer

Objeto

A definição de recurso VmmServers.

Nome	Tipo	Description
extendedLocation	ExtendedLocation	O local estendido.
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties.connectionStatus	string	Obtém o status da conexão para o vmmServer.
properties.credentials	VmmCredential	Credenciais para se conectar ao VmmServer.
properties.errorMessage	string	Obtém qualquer mensagem de erro se a conexão com o vmmServer estiver tendo algum problema.
properties.fqdn	string minLength: 1	Fqdn é o nome do host/ip do vmmServer.
properties.port	integer (int32) minimum: 1 maximum: 65535	A porta é a porta na qual o vmmServer está escutando.
properties.provisioningState	ProvisioningState	Estado de provisionamento do recurso.
properties.uuid	string	ID exclusiva do vmmServer.
properties.version	string	A versão é a versão do vmmSever.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags	object	Marcas de recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

Compartilhar via

Vmm Servers - Get

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

VmmServers_Get_MaximumSet

Solicitação de exemplo

Resposta de exemplo

VmmServers_Get_MinimumSet

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ProvisioningState

systemData

VmmCredential

VmmServer