Microsoft.ContainerInstance (stable:2020-11-01)

2025/09/26 • 16 new, 16 deleted methods

ContainerGroups_List (new)
Description Get a list of container groups in the specified subscription. This operation returns properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/containerGroups
{
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
string ,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_ListByResourceGroup (new)
Description Get a list of container groups in a specified subscription and resource group. This operation returns properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
}

⚐ Response (200)

{
value:
[
string ,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Get (new)
Description Gets the properties of the specified container group in the specified subscription and resource group. The operation returns the properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_CreateOrUpdate (new)
Description Create or update container groups with specified configurations.
Reference Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerGroup: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (201)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Update (new)
Description Updates container group tags with specified values.
Reference Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
Resource:
{
id: string ,
name: string ,
type: string ,
location: string ,
tags: object ,
}
,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Delete (new)
Description Delete the specified container group in the specified subscription and resource group. The operation does not delete other resources provided by the user, such as volumes.
Reference Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (202)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Restart (new)
Description Restarts all containers in a container group in place. If container image has updates, new image will be downloaded.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/restart
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Stop (new)
Description Stops all containers in a container group. Compute resources will be deallocated and billing will stop.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/stop
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Start (new)
Description Starts all containers in a container group. Compute resources will be allocated and billing will start.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/start
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Operations_List (new)
Description List the operations for Azure Container Instance service.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.ContainerInstance/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
provider: string ,
resource: string ,
operation: string ,
description: string ,
}
,
properties: object ,
origin: enum ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListUsage (new)
Description Get the usage for a subscription
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
unit: string ,
currentValue: integer ,
limit: integer ,
name:
{
value: string ,
localizedValue: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_ListLogs (new)
Description Get the logs for a specified container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/logs
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
tail: integer ,
timestamps: boolean ,
}

⚐ Response (200)

{
content: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_ExecuteCommand (new)
Description Executes a command for a specific container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/exec
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
containerExecRequest:
{
command: string ,
terminalSize:
{
rows: integer ,
cols: integer ,
}
,
}
,
}

⚐ Response (200)

{
webSocketUri: string ,
password: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_Attach (new)
Description Attach to the output stream of a specific container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/attach
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
}

⚐ Response (200)

{
webSocketUri: string ,
password: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListCachedImages (new)
Description Get the list of cached images on specific OS type for a subscription in a region.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
osType: string ,
image: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListCapabilities (new)
Description Get the list of CPU/memory/GPU capabilities of a region.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/capabilities
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
resourceType: string ,
osType: string ,
location: string ,
ipAddressType: string ,
gpu: string ,
capabilities:
{
maxMemoryInGB: number ,
maxCpu: number ,
maxGpuCount: number ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_List (removed)
Description Get a list of container groups in the specified subscription. This operation returns properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/containerGroups
{
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
string ,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_ListByResourceGroup (removed)
Description Get a list of container groups in a specified subscription and resource group. This operation returns properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
}

⚐ Response (200)

{
value:
[
string ,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Get (removed)
Description Gets the properties of the specified container group in the specified subscription and resource group. The operation returns the properties of each container group including containers, image registry credentials, restart policy, IP address type, OS type, state, and volumes.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_CreateOrUpdate (removed)
Description Create or update container groups with specified configurations.
Reference Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerGroup: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (201)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Update (removed)
Description Updates container group tags with specified values.
Reference Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
Resource:
{
id: string ,
name: string ,
type: string ,
location: string ,
tags: object ,
}
,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Delete (removed)
Description Delete the specified container group in the specified subscription and resource group. The operation does not delete other resources provided by the user, such as volumes.
Reference Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (200)

{
$schema: string ,
}

⚐ Response (202)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Restart (removed)
Description Restarts all containers in a container group in place. If container image has updates, new image will be downloaded.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/restart
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Stop (removed)
Description Stops all containers in a container group. Compute resources will be deallocated and billing will stop.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/stop
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
ContainerGroups_Start (removed)
Description Starts all containers in a container group. Compute resources will be allocated and billing will start.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/start
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Operations_List (removed)
Description List the operations for Azure Container Instance service.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.ContainerInstance/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
provider: string ,
resource: string ,
operation: string ,
description: string ,
}
,
properties: object ,
origin: enum ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListUsage (removed)
Description Get the usage for a subscription
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
unit: string ,
currentValue: integer ,
limit: integer ,
name:
{
value: string ,
localizedValue: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_ListLogs (removed)
Description Get the logs for a specified container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/logs
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
tail: integer ,
timestamps: boolean ,
}

⚐ Response (200)

{
content: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_ExecuteCommand (removed)
Description Executes a command for a specific container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/exec
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
containerExecRequest:
{
command: string ,
terminalSize:
{
rows: integer ,
cols: integer ,
}
,
}
,
}

⚐ Response (200)

{
webSocketUri: string ,
password: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Containers_Attach (removed)
Description Attach to the output stream of a specific container instance in a specified resource group and container group.
Reference Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/containers/{containerName}/attach
{
subscriptionId: string ,
api-version: string ,
resourceGroupName: string ,
containerGroupName: string ,
containerName: string ,
}

⚐ Response (200)

{
webSocketUri: string ,
password: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListCachedImages (removed)
Description Get the list of cached images on specific OS type for a subscription in a region.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
osType: string ,
image: string ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}
Location_ListCapabilities (removed)
Description Get the list of CPU/memory/GPU capabilities of a region.
Reference Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/capabilities
{
subscriptionId: string ,
location: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
resourceType: string ,
osType: string ,
location: string ,
ipAddressType: string ,
gpu: string ,
capabilities:
{
maxMemoryInGB: number ,
maxCpu: number ,
maxGpuCount: number ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
}
,
}