Accounts - Check Name Availability
Checks whether the specified account name is available or taken.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DataLakeAnalytics/locations/{location}/checkNameAvailability?api-version=2016-11-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
location
|
path | True |
string |
The resource location without whitespace. |
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. |
Request Body
Name | Required | Type | Description |
---|---|---|---|
name | True |
string |
The Data Lake Analytics name to check availability for. |
type | True |
enum:
Microsoft. |
The resource type. Note: This should not be set by the user, as the constant value is Microsoft.DataLakeAnalytics/accounts |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Successfully retrieved the Data Lake Analytics account name availability information. |
|
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
Checks whether the specified account name is available or taken
Sample Request
Sample Response
{
"nameAvailable": false,
"reason": "AlreadyExists",
"message": "An account named 'abc' already exists."
}
Definitions
Name | Description |
---|---|
Check |
Data Lake Analytics account name availability check parameters. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Name |
Data Lake Analytics account name availability result information. |
CheckNameAvailabilityParameters
Data Lake Analytics account name availability check parameters.
Name | Type | Description |
---|---|---|
name |
string |
The Data Lake Analytics name to check availability for. |
type |
enum:
Microsoft. |
The resource type. Note: This should not be set by the user, as the constant value is Microsoft.DataLakeAnalytics/accounts |
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. |
NameAvailabilityInformation
Data Lake Analytics account name availability result information.
Name | Type | Description |
---|---|---|
message |
string |
The message describing why the Data Lake Analytics account name is not available, if nameAvailable is false. |
nameAvailable |
boolean |
The Boolean value of true or false to indicate whether the Data Lake Analytics account name is available or not. |
reason |
string |
The reason why the Data Lake Analytics account name is not available, if nameAvailable is false. |