Partilhar via

Nodes - Get Node Remote Login Settings

Serviço:
Batch Service
Versão API:
2025-06-01

Obtém as definições necessárias para iniciar sessão remotamente num Nó de Computação.
Antes de poder iniciar sessão remotamente num Nó de Computação usando as definições de login remoto, deve criar uma Conta de utilizador no Nó de Computação e configurar portas de acesso para SSH e RDP. Para mais informações, consulte https://learn.microsoft.com/azure/batch/pool-endpoint-configuration

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?api-version=2025-06-01
Com parâmetros opcionais: 
GET {endpoint}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?api-version=2025-06-01&timeOut={timeOut}

Parâmetros URI

Nome Em Necessário Tipo Descrição
endpoint
 path True

string (uri)

Ponto de extremidade da conta em lote (por exemplo: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

O ID do Nó de Computação para o qual obter as definições de login remoto.
poolId
 path True

string

A ID do Pool que contém o Nó de Computação.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.
timeOut
 query

integer (int32)

O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for superior a 30, será usado o padrão em vez disso.".

Cabeçalho de Pedido

Nome Necessário Tipo Descrição
client-request-id

string

A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Se o servidor deve retornar o client-request-id na resposta.
ocp-date

string (date-time-rfc7231)

A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Respostas

Nome Tipo Descrição
200 OK

BatchNodeRemoteLoginSettings

O pedido foi bem-sucedido.

Cabeçalhos

  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

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

Alcances

Nome Descrição
https://batch.core.windows.net//.default

Exemplos

Get batch node Dual Stack Networking Remote
Node get remote login settings

Get batch node Dual Stack Networking Remote

Pedido de exemplo

GET {endpoint}/pools/dualstackpool/nodes/tvmps_5d8adec89961dcc011329b38df999a841f6cc815a5710678b741f04b33556ed2_d/remoteloginsettings?api-version=2025-06-01

Resposta de exemplo

Código de estado:
200 
{
  "remoteLoginIPAddress": "１.1.1.1",
  "remoteLoginPort": 40000,
  "ipv6RemoteLoginIPAddress": "fd00::1",
  "ipv6RemoteLoginPort": 40000
}

Node get remote login settings

Pedido de exemplo

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/remoteloginsettings?api-version=2025-06-01

Resposta de exemplo

Código de estado:
200 
{
  "remoteLoginIPAddress": "1.1.1.1",
  "remoteLoginPort": 50000
}

Definições

Nome Descrição
BatchError

Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
BatchErrorMessage

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
BatchNodeRemoteLoginSettings

As configurações de login remoto para um nó de computação.

BatchError

Objetivo

Uma resposta de erro recebida do serviço Batch do Azure.

Nome Tipo Descrição
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message

BatchErrorMessage

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values

BatchErrorDetail[]

Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

BatchErrorDetail

Objetivo

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

Nome Tipo Descrição
key

string

Um identificador que especifica o significado da propriedade Value.
value

string

As informações adicionais incluídas com a resposta de erro.

BatchErrorMessage

Objetivo

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

Nome Tipo Descrição
lang

string

O código da linguagem da mensagem de erro.
value

string

O texto da mensagem.

BatchNodeRemoteLoginSettings

Objetivo

As configurações de login remoto para um nó de computação.

Nome Tipo Descrição
ipv6RemoteLoginIPAddress

string

O endereço IPv6 usado para login remoto no nó de computação.
ipv6RemoteLoginPort

integer (int32)

A porta usada para o login remoto no nó de computação.
remoteLoginIPAddress

string

O endereço IP usado para o login remoto no nó de computação.
remoteLoginPort

integer (int32)

A porta usada para o login remoto no nó de computação.