你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Applications - Get
获取指定应用程序的属性。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HDInsight/clusters/{clusterName}/applications/{applicationName}?api-version=2021-06-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
application
|
path | True |
string |
应用程序名称的常量值。 |
cluster
|
path | True |
string |
群集的名称。 |
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
HDInsight 客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
没问题。 请求已成功。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Get application on HDInsight cluster creation in progress |
Get application on HDInsight cluster successfully created. |
Get application on HDInsight cluster creation in progress
Sample Request
Sample Response
{
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.HDInsight/clusters/cluster1/applications/app",
"name": "app",
"type": "Microsoft.HDInsight/clusters/applications",
"etag": "2C128F8E-BB26-4637-99E4-18EBC39FD51F",
"tags": {
"key1": "val1"
},
"properties": {
"computeProfile": {
"roles": [
{
"name": "edgenode",
"targetInstanceCount": 1,
"hardwareProfile": {
"vmSize": "Standard_D3"
}
}
]
},
"installScriptActions": [
{
"name": "app-Install",
"uri": "https://app.com/azure/app_install.sh",
"roles": [
"edgenode"
]
}
],
"uninstallScriptActions": [],
"httpsEndpoints": [
{
"accessModes": [
"WebPage"
],
"location": "location",
"destinationPort": 18630,
"publicPort": 443
}
],
"sshEndpoints": [],
"provisioningState": "InProgress",
"applicationState": "AzureVMConfiguration",
"createdDate": "2017-03-28T02:01:25.107",
"applicationType": "CustomApplication",
"marketplaceIdentifier": "id"
}
}
Get application on HDInsight cluster successfully created.
Sample Request
Sample Response
{
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.HDInsight/clusters/cluster1/applications/app",
"name": "app",
"type": "Microsoft.HDInsight/clusters/applications",
"etag": "CF938302-6B4D-44A0-A6D2-C0D67E847AEC",
"tags": {
"key1": "val1"
},
"properties": {
"computeProfile": {
"roles": [
{
"name": "edgenode",
"targetInstanceCount": 1,
"hardwareProfile": {
"vmSize": "Standard_D12_v2"
}
}
]
},
"installScriptActions": [
{
"name": "app-install",
"uri": "http://app.com/public/hdi-app/20170301/app-install.sh",
"roles": [
"edgenode"
]
}
],
"uninstallScriptActions": [],
"httpsEndpoints": [
{
"accessModes": [
"WebPage"
],
"location": "https://cluster1.apps.azurehdinsight.net:443",
"destinationPort": 20000,
"publicPort": 443
}
],
"sshEndpoints": [
{
"location": "cluster1-ssh.azurehdinsight.net:22",
"destinationPort": 22,
"publicPort": 22
}
],
"provisioningState": "Succeeded",
"applicationState": "Running",
"createdDate": "2017-03-22T21:34:39.293",
"applicationType": "CustomApplication",
"marketplaceIdentifier": "appMarketId"
}
}
定义
名称 | 说明 |
---|---|
Application |
HDInsight 群集应用程序 |
Application |
获取应用程序 SSH 终结点 |
Application |
获取应用程序 HTTP 终结点。 |
Application |
HDInsight 群集应用程序 GET 响应。 |
Autoscale |
自动缩放请求参数 |
Autoscale |
基于负载的自动缩放请求参数 |
Autoscale |
基于计划的自动缩放请求参数 |
Autoscale |
基于计划的自动缩放规则的参数,由一组天 + 一个时间和容量组成 |
Autoscale |
时间和容量请求参数 |
Compute |
描述计算配置文件。 |
created |
创建资源的标识类型。 |
Data |
角色的数据磁盘组。 |
Days |
基于计划的自动缩放规则的星期几 |
Error |
描述错误响应的格式。 |
Errors |
与群集创建关联的错误消息。 |
Hardware |
硬件配置文件。 |
IPConfiguration |
专用链接服务的 IP 配置。 |
Linux |
ssh 用户名、密码和 ssh 公钥。 |
Os |
Linux 操作系统配置文件。 |
Private |
分配专用 IP 地址的方法。 |
Private |
专用链接配置。 |
Private |
专用链接配置预配状态,该状态仅显示在响应中。 |
Resource |
Azure 资源 ID。 |
Role |
描述群集上的角色。 |
Runtime |
描述正在运行的群集上的脚本操作。 |
Script |
描述群集上角色的脚本操作。 |
Ssh |
SSH 公钥的列表。 |
Ssh |
群集节点的 SSH 公钥。 |
system |
与资源的创建和上次修改相关的元数据。 |
Virtual |
虚拟网络属性。 |
Application
HDInsight 群集应用程序
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
应用程序的 ETag |
id |
string |
资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
资源的名称 |
properties |
应用程序的属性。 |
|
systemData |
与资源的创建和上次修改相关的元数据。 |
|
tags |
object |
应用程序的标记。 |
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
ApplicationGetEndpoint
获取应用程序 SSH 终结点
名称 | 类型 | 说明 |
---|---|---|
destinationPort |
integer |
要连接到的目标端口。 |
location |
string |
终结点的位置。 |
privateIPAddress |
string |
终结点的专用 IP 地址。 |
publicPort |
integer |
要连接到的公共端口。 |
ApplicationGetHttpsEndpoint
获取应用程序 HTTP 终结点。
名称 | 类型 | 说明 |
---|---|---|
accessModes |
string[] |
应用程序的访问模式列表。 |
destinationPort |
integer |
要连接到的目标端口。 |
disableGatewayAuth |
boolean |
值指示是否禁用 GatewayAuth。 |
location |
string |
终结点的位置。 |
privateIPAddress |
string |
终结点的专用 IP 地址。 |
publicPort |
integer |
要连接到的公共端口。 |
subDomainSuffix |
string |
应用程序的子域后缀。 |
ApplicationProperties
HDInsight 群集应用程序 GET 响应。
名称 | 类型 | 说明 |
---|---|---|
applicationState |
string |
应用程序状态。 |
applicationType |
string |
应用程序类型。 |
computeProfile |
群集中的角色列表。 |
|
createdDate |
string |
应用程序创建日期时间。 |
errors |
Errors[] |
错误列表。 |
httpsEndpoints |
应用程序 HTTPS 终结点的列表。 |
|
installScriptActions |
安装脚本操作的列表。 |
|
marketplaceIdentifier |
string |
市场标识符。 |
privateLinkConfigurations |
专用链接配置。 |
|
provisioningState |
string |
应用程序的预配状态。 |
sshEndpoints |
应用程序 SSH 终结点的列表。 |
|
uninstallScriptActions |
卸载脚本操作的列表。 |
Autoscale
自动缩放请求参数
名称 | 类型 | 说明 |
---|---|---|
capacity |
基于负载的自动缩放的参数 |
|
recurrence |
基于计划的自动缩放的参数 |
AutoscaleCapacity
基于负载的自动缩放请求参数
名称 | 类型 | 说明 |
---|---|---|
maxInstanceCount |
integer |
群集的最大实例计数 |
minInstanceCount |
integer |
群集的最小实例计数 |
AutoscaleRecurrence
基于计划的自动缩放请求参数
名称 | 类型 | 说明 |
---|---|---|
schedule |
基于计划的自动缩放规则数组 |
|
timeZone |
string |
自动缩放计划时间的时区 |
AutoscaleSchedule
基于计划的自动缩放规则的参数,由一组天 + 一个时间和容量组成
名称 | 类型 | 说明 |
---|---|---|
days |
基于计划的自动缩放规则的星期几 |
|
timeAndCapacity |
基于计划的自动缩放规则的时间和容量 |
AutoscaleTimeAndCapacity
时间和容量请求参数
名称 | 类型 | 说明 |
---|---|---|
maxInstanceCount |
integer |
群集的最大实例计数 |
minInstanceCount |
integer |
群集的最小实例计数 |
time |
string |
24 小时时间,格式为 xx:xx |
ComputeProfile
描述计算配置文件。
名称 | 类型 | 说明 |
---|---|---|
roles |
Role[] |
群集中的角色列表。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataDisksGroups
角色的数据磁盘组。
名称 | 类型 | 说明 |
---|---|---|
diskSizeGB |
integer |
ReadOnly。 DiskSize(以 GB 为单位)。 请勿设置此值。 |
disksPerNode |
integer |
每个节点的磁盘数。 |
storageAccountType |
string |
ReadOnly。 存储帐户类型。 请勿设置此值。 |
DaysOfWeek
基于计划的自动缩放规则的星期几
名称 | 类型 | 说明 |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
ErrorResponse
描述错误响应的格式。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码 |
message |
string |
指示操作失败原因的错误消息。 |
Errors
与群集创建关联的错误消息。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
message |
string |
错误消息。 |
HardwareProfile
硬件配置文件。
名称 | 类型 | 说明 |
---|---|---|
vmSize |
string |
VM 的大小 |
IPConfiguration
专用链接服务的 IP 配置。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
专用链接 IP 配置 ID。 |
name |
string |
专用链接 IP 配置的名称。 |
properties.primary |
boolean |
指示此 IP 配置是否是相应 NIC 的主配置。 |
properties.privateIPAddress |
string |
IP 地址。 |
properties.privateIPAllocationMethod |
分配专用 IP 地址的方法。 |
|
properties.provisioningState |
专用链接配置预配状态,该状态仅显示在响应中。 |
|
properties.subnet |
子网资源 ID。 |
|
type |
string |
专用链接 IP 配置的类型。 |
LinuxOperatingSystemProfile
ssh 用户名、密码和 ssh 公钥。
名称 | 类型 | 说明 |
---|---|---|
password |
string |
密码。 |
sshProfile |
SSH 配置文件。 |
|
username |
string |
用户名。 |
OsProfile
Linux 操作系统配置文件。
名称 | 类型 | 说明 |
---|---|---|
linuxOperatingSystemProfile |
Linux OS 配置文件。 |
PrivateIPAllocationMethod
分配专用 IP 地址的方法。
名称 | 类型 | 说明 |
---|---|---|
dynamic |
string |
|
static |
string |
PrivateLinkConfiguration
专用链接配置。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
专用链接配置 ID。 |
name |
string |
专用链接配置的名称。 |
properties.groupId |
string |
要向其应用专用链接配置的 HDInsight 专用可链接子资源名称。 例如,“headnode”、“gateway”、“edgenode”。 |
properties.ipConfigurations |
专用链接服务的 IP 配置。 |
|
properties.provisioningState |
专用链接配置预配状态,该状态仅显示在响应中。 |
|
type |
string |
专用链接配置的类型。 |
PrivateLinkConfigurationProvisioningState
专用链接配置预配状态,该状态仅显示在响应中。
名称 | 类型 | 说明 |
---|---|---|
Canceled |
string |
|
Deleting |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
ResourceId
Azure 资源 ID。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
Azure 资源 ID。 |
Role
描述群集上的角色。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
VMGroupName |
string |
虚拟机组的名称。 |
|
autoscale |
自动缩放配置。 |
||
dataDisksGroups |
角色的数据磁盘组。 |
||
encryptDataDisks |
boolean |
False |
指示是否加密数据磁盘。 |
hardwareProfile |
硬件配置文件。 |
||
minInstanceCount |
integer |
群集的最小实例计数。 |
|
name |
string |
角色的名称。 |
|
osProfile |
操作系统配置文件。 |
||
scriptActions |
角色上的脚本操作列表。 |
||
targetInstanceCount |
integer |
群集的实例计数。 |
|
virtualNetworkProfile |
虚拟网络配置文件。 |
RuntimeScriptAction
描述正在运行的群集上的脚本操作。
名称 | 类型 | 说明 |
---|---|---|
applicationName |
string |
脚本操作的应用程序名称(如果有)。 |
name |
string |
脚本操作的名称。 |
parameters |
string |
脚本的参数 |
roles |
string[] |
将执行脚本的角色列表。 |
uri |
string |
脚本的 URI。 |
ScriptAction
描述群集上角色的脚本操作。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
脚本操作的名称。 |
parameters |
string |
提供的脚本的参数。 |
uri |
string |
脚本的 URI。 |
SshProfile
SSH 公钥的列表。
名称 | 类型 | 说明 |
---|---|---|
publicKeys |
SSH 公钥的列表。 |
SshPublicKey
群集节点的 SSH 公钥。
名称 | 类型 | 说明 |
---|---|---|
certificateData |
string |
SSH 证书。 |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源的创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |
VirtualNetworkProfile
虚拟网络属性。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
虚拟网络的 ID。 |
subnet |
string |
子网的名称。 |