Application - List
Lists all of the applications in the specified account.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications?api-version=2024-02-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications?maxresults={maxresults}&api-version=2024-02-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
The name of the Batch account. Regex pattern: |
resource
|
path | True |
string |
The name of the resource group that contains the Batch account. |
subscription
|
path | True |
string |
The Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000) |
api-version
|
query | True |
string |
The API version to be used with the HTTP request. |
maxresults
|
query |
integer int32 |
The maximum number of items to return in the response. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
The operation was successful. The response contains a list of the application entities associated with the specified account. |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
azure_auth
Microsoft Entra OAuth 2.0 auth code flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
ApplicationList
Sample Request
Sample Response
{
"value": [
{
"type": "Microsoft.Batch/batchAccounts/applications",
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/applications/app1",
"name": "app1",
"etag": "W/\"0x8D64F91A9089879\"",
"properties": {
"allowUpdates": false,
"defaultVersion": "1"
}
},
{
"type": "Microsoft.Batch/batchAccounts/applications",
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/applications/app2",
"name": "app1",
"etag": "W/\"0x8D64F91A9089879\"",
"properties": {
"allowUpdates": false,
"defaultVersion": "2.0",
"displayName": "myAppName"
}
}
]
}
Definitions
Name | Description |
---|---|
Application |
Contains information about an application in a Batch account. |
Cloud |
An error response from the Batch service. |
Cloud |
An error response from the Batch service. |
List |
The result of performing list applications. |
Application
Contains information about an application in a Batch account.
Name | Type | Description |
---|---|---|
etag |
string |
The ETag of the resource, used for concurrency statements. |
id |
string |
The ID of the resource. |
name |
string |
The name of the resource. |
properties.allowUpdates |
boolean |
A value indicating whether packages within the application may be overwritten using the same version string. |
properties.defaultVersion |
string |
The package to use if a client requests the application but does not specify a version. This property can only be set to the name of an existing package. |
properties.displayName |
string |
The display name for the application. |
type |
string |
The type of the resource. |
CloudError
An error response from the Batch service.
Name | Type | Description |
---|---|---|
error |
The body of the error response. |
CloudErrorBody
An error response from the Batch service.
Name | Type | Description |
---|---|---|
code |
string |
An identifier for the error. Codes are invariant and are intended to be consumed programmatically. |
details |
A list of additional details about the error. |
|
message |
string |
A message describing the error, intended to be suitable for display in a user interface. |
target |
string |
The target of the particular error. For example, the name of the property in error. |
ListApplicationsResult
The result of performing list applications.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of results. |
value |
The list of applications. |