Compute Node - Get Remote Login Settings
Возвращает параметры, необходимые для удаленного входа в вычислительный узел.
Прежде чем удаленно войти в вычислительный узел с помощью параметров удаленного входа, необходимо создать учетную запись пользователя на вычислительном узле. Этот API можно вызывать только в пулах, созданных со свойством конфигурации виртуальной машины. Сведения о пулах, созданных с помощью конфигурации облачной службы, см. в api GetRemoteDesktop.
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?api-version=2022-01-01.15.0
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?timeout={timeout}&api-version=2022-01-01.15.0
Параметры URI
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
batch
|
path | True |
|
Базовый URL-адрес для всех запросов на обслуживание пакетная служба Azure. |
|
node
|
path | True |
|
Идентификатор вычислительного узла, для которого необходимо получить параметры удаленного входа. |
|
pool
|
path | True |
|
Идентификатор пула, содержащего вычислительный узел. |
|
api-version
|
query | True |
|
Версия КЛИЕНТСКОго API. |
|
timeout
|
query |
|
Максимальное время, затрачивается сервером на обработку запроса в секундах. По умолчанию это 30 секунд. |
Заголовок запроса
Media Types: "application/json; odata=minimalmetadata"
| Name | Required | Type | Description |
|---|---|---|---|
| client-request-id |
|
Удостоверение запроса, созданное вызывающим абонентом, в виде GUID без оформления, например фигурных скобок, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
| return-client-request-id |
|
Должен ли сервер возвращать идентификатор client-request-id в ответе. |
|
| ocp-date |
|
Время выдачи запроса. Клиентские библиотеки обычно задают для текущего системного времени часов; задайте его явным образом, если вы вызываете REST API напрямую. |
Ответы
| Name | Type | Description |
|---|---|---|
| 200 OK |
Ответ, содержащий параметры входа. Headers
|
|
| Other Status Codes |
Ошибка пакетной службы. |
Безопасность
azure_auth
Flow OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name | Description |
|---|---|
| user_impersonation | Олицетворение учетной записи пользователя |
Authorization
Type:
apiKey
In:
header
Примеры
Node get remote login settings
Sample Request
GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/remoteloginsettings?api-version=2022-01-01.15.0
Sample Response
{
"remoteLoginIPAddress": "1.1.1.1",
"remoteLoginPort": 50000
}
Определения
|
Batch |
Ответ об ошибке, полученный от службы пакетная служба Azure. |
|
Batch |
Элемент дополнительных сведений, включенных в ответ на ошибку пакетная служба Azure. |
|
Compute |
Параметры удаленного входа для вычислительного узла. |
|
Error |
Сообщение об ошибке, полученное в ответе на ошибку пакетная служба Azure. |
BatchError
Ответ об ошибке, полученный от службы пакетная служба Azure.
| Name | Type | Description |
|---|---|---|
| code |
|
Идентификатор ошибки. Коды инвариантны и предназначены для программного использования. |
| message |
Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе. |
|
| values |
Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке. |
BatchErrorDetail
Элемент дополнительных сведений, включенных в ответ на ошибку пакетная служба Azure.
| Name | Type | Description |
|---|---|---|
| key |
|
Идентификатор, указывающий значение свойства Value. |
| value |
|
Дополнительные сведения, включенные в ответ на ошибку. |
ComputeNodeGetRemoteLoginSettingsResult
Параметры удаленного входа для вычислительного узла.
| Name | Type | Description |
|---|---|---|
| remoteLoginIPAddress |
|
IP-адрес, используемый для удаленного входа в вычислительный узел. |
| remoteLoginPort |
|
Порт, используемый для удаленного входа на вычислительный узел. |
ErrorMessage
Сообщение об ошибке, полученное в ответе на ошибку пакетная служба Azure.
| Name | Type | Description |
|---|---|---|
| lang |
|
Код языка сообщения об ошибке |
| value |
|
Текст сообщения. |