Accounts - Get
Gets details of the specified Data Lake Analytics account.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeAnalytics/accounts/{accountName}?api-version=2016-11-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
The name of the Data Lake Analytics account. |
resource
|
path | True |
string |
The name of the Azure resource group. |
subscription
|
path | True |
string |
Get subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client Api Version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Successfully retrieved the details of the specified account. |
|
Other Status Codes |
Security
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
Gets details of the specified Data Lake Analytics account.
Sample Request
Sample Response
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rgaba12041/providers/Microsoft.DataLakeAnalytics/accounts/testaba15818",
"name": "test_account",
"type": "Microsoft.DataLakeAnalytics/accounts",
"properties": {
"accountId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
"provisioningState": "Succeeded",
"state": "Active",
"creationTime": "2017-04-14T13:21:56.6819037-07:00",
"lastModifiedTime": "2017-04-14T13:21:56.6819037-07:00",
"endpoint": "test_endpoint",
"defaultDataLakeStoreAccount": "test_adls",
"dataLakeStoreAccounts": [
{
"id": "test_adls_id",
"name": "test_adls",
"type": "test_type",
"properties": {
"suffix": "test_suffix"
}
}
],
"publicDataLakeStoreAccounts": [
{
"id": "test_adls_id",
"name": "test_adls",
"type": "test_type",
"properties": {
"suffix": "test_suffix"
}
}
],
"storageAccounts": [
{
"id": "test_storage_id",
"name": "test_storage",
"type": "test_type",
"properties": {
"suffix": "test_suffix"
}
}
],
"computePolicies": [
{
"id": "test_policy_id",
"name": "test_policy",
"type": "test_type",
"properties": {
"objectId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
"objectType": "User",
"maxDegreeOfParallelismPerJob": 1,
"minPriorityPerJob": 1
}
}
],
"firewallRules": [
{
"id": "test_firewall_id",
"name": "test_rule",
"type": "test_type",
"properties": {
"startIpAddress": "1.1.1.1",
"endIpAddress": "2.2.2.2"
}
}
],
"firewallState": "Enabled",
"firewallAllowAzureIps": "Enabled",
"newTier": "Consumption",
"currentTier": "Consumption",
"maxJobCount": 3,
"systemMaxJobCount": 1,
"maxDegreeOfParallelism": 30,
"systemMaxDegreeOfParallelism": 1,
"maxDegreeOfParallelismPerJob": 1,
"minPriorityPerJob": 1,
"queryStoreRetention": 30
}
}
Definitions
Name | Description |
---|---|
AADObject |
The type of AAD object the object identifier refers to. |
Compute |
Data Lake Analytics compute policy information. |
Data |
A Data Lake Analytics account object, containing all information associated with the named Data Lake Analytics account. |
Data |
The state of the Data Lake Analytics account. |
Data |
The provisioning status of the Data Lake Analytics account. |
Data |
Data Lake Store account information. |
Debug |
The current state of the DebugDataAccessLevel for this account. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Firewall |
The current state of allowing or disallowing IPs originating within Azure through the firewall. If the firewall is disabled, this is not enforced. |
Firewall |
Data Lake Analytics firewall rule information. |
Firewall |
The current state of the IP address firewall for this account. |
Hive |
|
Nested |
The current state of the NestedResourceProvisioning for this account. |
Storage |
Azure Storage account information. |
Tier |
The commitment tier for the next month. |
Virtual |
Data Lake Analytics VirtualNetwork Rule information. |
Virtual |
The current state of the VirtualNetworkRule for this account. |
AADObjectType
The type of AAD object the object identifier refers to.
Name | Type | Description |
---|---|---|
Group |
string |
|
ServicePrincipal |
string |
|
User |
string |
ComputePolicy
Data Lake Analytics compute policy information.
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.maxDegreeOfParallelismPerJob |
integer |
The maximum degree of parallelism per job this user can use to submit jobs. |
properties.minPriorityPerJob |
integer |
The minimum priority per job this user can use to submit jobs. |
properties.objectId |
string |
The AAD object identifier for the entity to create a policy for. |
properties.objectType |
The type of AAD object the object identifier refers to. |
|
type |
string |
The resource type. |
DataLakeAnalyticsAccount
A Data Lake Analytics account object, containing all information associated with the named Data Lake Analytics account.
Name | Type | Default Value | Description |
---|---|---|---|
id |
string |
The resource identifier. |
|
location |
string |
The resource location. |
|
name |
string |
The resource name. |
|
properties.accountId |
string |
The unique identifier associated with this Data Lake Analytics account. |
|
properties.computePolicies |
The list of compute policies associated with this account. |
||
properties.creationTime |
string |
The account creation time. |
|
properties.currentTier |
The commitment tier in use for the current month. |
||
properties.dataLakeStoreAccounts |
The list of Data Lake Store accounts associated with this account. |
||
properties.debugDataAccessLevel |
The current state of the DebugDataAccessLevel for this account. |
||
properties.defaultDataLakeStoreAccount |
string |
The default Data Lake Store account associated with this account. |
|
properties.endpoint |
string |
The full CName endpoint for this account. |
|
properties.firewallAllowAzureIps |
The current state of allowing or disallowing IPs originating within Azure through the firewall. If the firewall is disabled, this is not enforced. |
||
properties.firewallRules |
The list of firewall rules associated with this account. |
||
properties.firewallState |
The current state of the IP address firewall for this account. |
||
properties.hiveMetastores |
The list of hiveMetastores associated with this account. |
||
properties.lastModifiedTime |
string |
The account last modified time. |
|
properties.maxActiveJobCountPerUser |
integer |
The maximum supported active jobs under the account at the same time. |
|
properties.maxDegreeOfParallelism |
integer |
30 |
The maximum supported degree of parallelism for this account. |
properties.maxDegreeOfParallelismPerJob |
integer |
The maximum supported degree of parallelism per job for this account. |
|
properties.maxJobCount |
integer |
3 |
The maximum supported jobs running under the account at the same time. |
properties.maxJobRunningTimeInMin |
integer |
The maximum supported active jobs under the account at the same time. |
|
properties.maxQueuedJobCountPerUser |
integer |
The maximum supported jobs queued under the account at the same time. |
|
properties.minPriorityPerJob |
integer |
The minimum supported priority per job for this account. |
|
properties.newTier |
The commitment tier for the next month. |
||
properties.provisioningState |
The provisioning status of the Data Lake Analytics account. |
||
properties.publicDataLakeStoreAccounts |
The list of Data Lake Store accounts associated with this account. |
||
properties.queryStoreRetention |
integer |
30 |
The number of days that job metadata is retained. |
properties.state |
The state of the Data Lake Analytics account. |
||
properties.storageAccounts |
The list of Azure Blob Storage accounts associated with this account. |
||
properties.systemMaxDegreeOfParallelism |
integer |
The system defined maximum supported degree of parallelism for this account, which restricts the maximum value of parallelism the user can set for the account. |
|
properties.systemMaxJobCount |
integer |
The system defined maximum supported jobs running under the account at the same time, which restricts the maximum number of running jobs the user can set for the account. |
|
properties.virtualNetworkRules |
The list of virtualNetwork rules associated with this account. |
||
tags |
object |
The resource tags. |
|
type |
string |
The resource type. |
DataLakeAnalyticsAccountState
The state of the Data Lake Analytics account.
Name | Type | Description |
---|---|---|
Active |
string |
|
Suspended |
string |
DataLakeAnalyticsAccountStatus
The provisioning status of the Data Lake Analytics account.
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Patching |
string |
|
Resuming |
string |
|
Running |
string |
|
Succeeded |
string |
|
Suspending |
string |
|
Undeleting |
string |
DataLakeStoreAccountInformation
Data Lake Store account information.
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.suffix |
string |
The optional suffix for the Data Lake Store account. |
type |
string |
The resource type. |
DebugDataAccessLevel
The current state of the DebugDataAccessLevel for this account.
Name | Type | Description |
---|---|---|
All |
string |
|
Customer |
string |
|
None |
string |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
FirewallAllowAzureIpsState
The current state of allowing or disallowing IPs originating within Azure through the firewall. If the firewall is disabled, this is not enforced.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
FirewallRule
Data Lake Analytics firewall rule information.
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.endIpAddress |
string |
The end IP address for the firewall rule. This can be either ipv4 or ipv6. Start and End should be in the same protocol. |
properties.startIpAddress |
string |
The start IP address for the firewall rule. This can be either ipv4 or ipv6. Start and End should be in the same protocol. |
type |
string |
The resource type. |
FirewallState
The current state of the IP address firewall for this account.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
HiveMetastore
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.databaseName |
string |
The databaseName for the Hive MetaStore |
properties.nestedResourceProvisioningState |
The current state of the NestedResource |
|
properties.password |
string |
The password for the Hive MetaStore |
properties.runtimeVersion |
string |
The runtimeVersion for the Hive MetaStore |
properties.serverUri |
string |
The serverUri for the Hive MetaStore |
properties.userName |
string |
The userName for the Hive MetaStore |
type |
string |
The resource type. |
NestedResourceProvisioningState
The current state of the NestedResourceProvisioning for this account.
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
Succeeded |
string |
StorageAccountInformation
Azure Storage account information.
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.suffix |
string |
The optional suffix for the storage account. |
type |
string |
The resource type. |
TierType
The commitment tier for the next month.
Name | Type | Description |
---|---|---|
Commitment_100000AUHours |
string |
|
Commitment_10000AUHours |
string |
|
Commitment_1000AUHours |
string |
|
Commitment_100AUHours |
string |
|
Commitment_500000AUHours |
string |
|
Commitment_50000AUHours |
string |
|
Commitment_5000AUHours |
string |
|
Commitment_500AUHours |
string |
|
Consumption |
string |
VirtualNetworkRule
Data Lake Analytics VirtualNetwork Rule information.
Name | Type | Description |
---|---|---|
id |
string |
The resource identifier. |
name |
string |
The resource name. |
properties.subnetId |
string |
The resource identifier for the subnet |
properties.virtualNetworkRuleState |
The current state of the VirtualNetwork Rule |
|
type |
string |
The resource type. |
VirtualNetworkRuleState
The current state of the VirtualNetworkRule for this account.
Name | Type | Description |
---|---|---|
Active |
string |
|
Failed |
string |
|
NetworkSourceDeleted |
string |