Container Groups - Create Or Update
Creare o aggiornare gruppi di contenitori con configurazioni specificate.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}?api-version=2025-09-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
container
|
path | True |
string |
Nome del gruppo di contenitori. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| properties.containers | True |
Contenitori all'interno del gruppo di contenitori. |
|
| identity |
Identità del gruppo di contenitori, se configurata. |
||
| location |
string |
Percorso della risorsa. |
|
| properties.confidentialComputeProperties |
Proprietà per il gruppo di contenitori riservati |
||
| properties.containerGroupProfile |
Proprietà del profilo del gruppo di contenitori di riferimento. |
||
| properties.diagnostics |
Informazioni di diagnostica per un gruppo di contenitori. |
||
| properties.dnsConfig |
Informazioni di configurazione DNS per un gruppo di contenitori. |
||
| properties.encryptionProperties |
Proprietà di crittografia per un gruppo di contenitori. |
||
| properties.extensions |
estensioni usate da kubelet virtuale |
||
| properties.identityAcls |
Livelli di controllo di accesso delle identità. |
||
| properties.imageRegistryCredentials |
Credenziali del Registro immagini da cui viene creato il gruppo di contenitori. |
||
| properties.initContainers |
Contenitori init per un gruppo di contenitori. |
||
| properties.ipAddress |
Tipo di indirizzo IP del gruppo di contenitori. |
||
| properties.osType |
Tipo di sistema operativo richiesto dai contenitori nel gruppo di contenitori. |
||
| properties.priority |
Priorità del gruppo di contenitori. |
||
| properties.restartPolicy |
Criteri di riavvio per tutti i contenitori all'interno del gruppo di contenitori.
|
||
| properties.secretReferences |
Riferimenti al segreto a cui verrà fatto riferimento all'interno del gruppo di contenitori. |
||
| properties.sku |
SKU per un gruppo di contenitori. |
||
| properties.standbyPoolProfile |
Proprietà del profilo del pool di standby di riferimento. |
||
| properties.subnetIds |
ID risorsa subnet per un gruppo di contenitori. |
||
| properties.volumes |
Volume[] |
Elenco di volumi che possono essere montati da contenitori in questo gruppo di contenitori. |
|
| tags |
object |
Tag di risorsa. |
|
| zones |
string[] |
Zone di disponibilità. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione di aggiornamento 'ContainerGroup' risorsa riuscita |
|
| 201 Created |
Risorsa 'ContainerGroup' crea operazione con successo Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
ConfidentialContainerGroup
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"location": "westeurope",
"properties": {
"confidentialComputeProperties": {
"ccePolicy": "eyJhbGxvd19hbGwiOiB0cnVlLCAiY29udGFpbmVycyI6IHsibGVuZ3RoIjogMCwgImVsZW1lbnRzIjogbnVsbH19"
},
"containers": [
{
"name": "accdemo",
"properties": {
"command": [],
"environmentVariables": [],
"image": "confiimage",
"ports": [
{
"port": 8000
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
},
"securityContext": {
"capabilities": {
"add": [
"CAP_NET_ADMIN"
]
},
"privileged": false
}
}
}
],
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 8000,
"protocol": "TCP"
}
]
},
"osType": "Linux",
"sku": "Confidential"
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "westeurope",
"properties": {
"confidentialComputeProperties": {
"ccePolicy": "eyJhbGxvd19hbGwiOiB0cnVlLCAiY29udGFpbmVycyI6IHsibGVuZ3RoIjogMCwgImVsZW1lbnRzIjogbnVsbH19"
},
"containers": [
{
"name": "accdemo",
"properties": {
"command": [],
"environmentVariables": [],
"image": "confiimage",
"ports": [
{
"port": 8000
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
},
"securityContext": {
"capabilities": {
"add": [
"CAP_NET_ADMIN"
]
},
"privileged": false
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Running"
},
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 8000,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"sku": "Confidential"
}
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "westeurope",
"properties": {
"confidentialComputeProperties": {
"ccePolicy": "eyJhbGxvd19hbGwiOiB0cnVlLCAiY29udGFpbmVycyI6IHsibGVuZ3RoIjogMCwgImVsZW1lbnRzIjogbnVsbH19"
},
"containers": [
{
"name": "accdemo",
"properties": {
"command": [],
"environmentVariables": [],
"image": "confiimage",
"ports": [
{
"port": 8000
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
},
"securityContext": {
"capabilities": {
"add": [
"CAP_NET_ADMIN"
]
},
"privileged": false
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Running"
},
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 8000,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"sku": "Confidential"
}
}
ContainerGroupCreateOrUpdateWithStandbyPool
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"location": "west us",
"properties": {
"containerGroupProfile": {
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroupProfiles/democgp",
"revision": 1
},
"containers": [
{
"name": "demo1",
"properties": {
"configMap": {
"keyValuePairs": {
"Newkey": "value"
}
}
}
}
],
"standbyPoolProfile": {
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.StandbyPool/standbyContainerGroupPools/demopool"
}
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus2",
"properties": {
"containerGroupProfile": {
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroupProfiles/democgp",
"revision": 1
},
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"configMap": {
"keyValuePairs": {
"Newkey": "value"
}
},
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Running"
},
"isCreatedFromStandbyPool": true,
"osType": "Linux",
"provisioningState": "Succeeded",
"sku": "Standard"
}
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus2",
"properties": {
"containerGroupProfile": {
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroupProfiles/democgp",
"revision": 1
},
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"configMap": {
"keyValuePairs": {
"Newkey": "value"
}
},
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Running"
},
"isCreatedFromStandbyPool": true,
"osType": "Linux",
"provisioningState": "Succeeded",
"sku": "Standard"
}
}
ContainerGroupCreateWithExtensions
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Private",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"osType": "Linux",
"subnetIds": [
{
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-rg-vnet/subnets/test-subnet"
}
],
"extensions": [
{
"name": "kube-proxy",
"properties": {
"extensionType": "kube-proxy",
"protectedSettings": {
"kubeConfig": "<kubeconfig encoded string>"
},
"settings": {
"clusterCidr": "10.240.0.0/16",
"kubeVersion": "v1.9.10"
},
"version": "1.0"
}
},
{
"name": "vk-realtime-metrics",
"properties": {
"extensionType": "realtime-metrics",
"version": "1.0"
}
}
]
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Pending"
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Pending",
"sku": "Standard",
"subnetIds": [
{
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-rg-vnet/subnets/test-subnet"
}
],
"extensions": [
{
"name": "kube-proxy",
"properties": {
"extensionType": "kube-proxy",
"settings": {
"clusterCidr": "10.240.0.0/16",
"kubeVersion": "v1.9.10"
},
"version": "1.0"
}
},
{
"name": "vk-realtime-metrics",
"properties": {
"extensionType": "realtime-metrics",
"version": "1.0"
}
}
]
}
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Running"
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Pending",
"sku": "Standard",
"subnetIds": [
{
"id": "/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-rg-vnet/subnets/test-subnet"
}
],
"extensions": [
{
"name": "kube-proxy",
"properties": {
"extensionType": "kube-proxy",
"settings": {
"clusterCidr": "10.240.0.0/16",
"kubeVersion": "v1.9.10"
},
"version": "1.0"
}
},
{
"name": "vk-realtime-metrics",
"properties": {
"extensionType": "realtime-metrics",
"version": "1.0"
}
}
]
}
}
ContainerGroupsCreateOrUpdate
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"identity": {
"type": "SystemAssigned, UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name": {}
}
},
"location": "west us",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"diagnostics": {
"logAnalytics": {
"logType": "ContainerInsights",
"metadata": {
"test-key": "test-metadata-value"
},
"workspaceId": "workspaceid",
"workspaceKey": "workspaceKey",
"workspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/microsoft.operationalinsights/workspaces/workspace"
}
},
"dnsConfig": {
"nameServers": [
"1.1.1.1"
],
"options": "ndots:2",
"searchDomains": "cluster.local svc.cluster.local"
},
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"osType": "Linux",
"subnetIds": [
{
"id": "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('vnetName'), parameters('subnetName'))]"
}
],
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountKey": "accountKey",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {
"secretKey1": "SecretValue1InBase64",
"secretKey2": "SecretValue2InBase64"
}
}
]
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "WestUs",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"diagnostics": {
"logAnalytics": {
"workspaceId": "workspaceid"
}
},
"dnsConfig": {
"nameServers": [
"1.1.1.1"
],
"options": "ndots:2",
"searchDomains": "cluster.local svc.cluster.local"
},
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"fqdn": "dnsnamelabel1.azure-container.io",
"ip": "10.0.0.1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {}
}
]
},
"zones": [
"1"
]
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "WestUs",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"dnsConfig": {
"nameServers": [
"1.1.1.1"
]
},
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"fqdn": "dnsnamelabel1.azure-container.io",
"ip": "10.0.0.1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {}
}
]
},
"zones": [
"1"
]
}
ContainerGroupsCreateOrUpdateSecretReference
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name": {}
}
},
"location": "west us",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [
{
"name": "envSecret",
"secureValueReference": "envSecretRef"
}
],
"image": "privateRegistryImage",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"diagnostics": {
"logAnalytics": {
"logType": "ContainerInsights",
"metadata": {
"test-key": "test-metadata-value"
},
"workspaceId": "workspaceid",
"workspaceKey": "workspaceKey",
"workspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/microsoft.operationalinsights/workspaces/workspace"
}
},
"dnsConfig": {
"nameServers": [
"1.1.1.1"
],
"options": "ndots:2",
"searchDomains": "cluster.local svc.cluster.local"
},
"imageRegistryCredentials": [
{
"passwordReference": "privateRegistryKeyRef",
"server": "demoregistry.azurecr.io",
"username": "registryUserName"
}
],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"osType": "Linux",
"secretReferences": [
{
"name": "envSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/envSecret"
},
{
"name": "accountKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/accountKey"
},
{
"name": "volumeSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/volumeSecret"
},
{
"name": "privateRegistryKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/privateRegistryKey"
}
],
"subnetIds": [
{
"id": "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('vnetName'), parameters('subnetName'))]"
}
],
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountKeyReference": "accountKeyRef",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {
"secretKey1": "SecretValue1InBase64"
},
"secretReference": {
"secretKey2": "volumeSecretRef"
}
}
]
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"identity": {
"type": "UserAssigned",
"tenantId": "00000000-0000-0000-0000-000000000000",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name": {
"clientId": "00000000-0000-0000-0000-000000000000",
"principalId": "00000000-0000-0000-0000-000000000000"
}
}
},
"location": "WestUs",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [
{
"name": "envSecret",
"secureValueReference": "envSecretRef"
}
],
"image": "privateRegistryImage",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"diagnostics": {
"logAnalytics": {
"workspaceId": "workspaceid"
}
},
"dnsConfig": {
"nameServers": [
"1.1.1.1"
],
"options": "ndots:2",
"searchDomains": "cluster.local svc.cluster.local"
},
"imageRegistryCredentials": [
{
"passwordReference": "privateRegistryKeyRef",
"server": "demoregistry.azurecr.io",
"username": "registryUserName"
}
],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"fqdn": "dnsnamelabel1.azure-container.io",
"ip": "10.0.0.1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"secretReferences": [
{
"name": "envSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/envSecret"
},
{
"name": "accountKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/accountKey"
},
{
"name": "volumeSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/volumeSecret"
},
{
"name": "privateRegistryKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/privateRegistryKey"
}
],
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountKeyReference": "accountKeyRef",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {},
"secretReference": {
"secretKey2": "volumeSecretRef"
}
}
]
},
"zones": [
"1"
]
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subid/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"identity": {
"type": "UserAssigned",
"tenantId": "00000000-0000-0000-0000-000000000000",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name": {
"clientId": "00000000-0000-0000-0000-000000000000",
"principalId": "00000000-0000-0000-0000-000000000000"
}
}
},
"location": "WestUs",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [
{
"name": "envSecret",
"secureValueReference": "envSecretRef"
}
],
"image": "privateRegistryImage",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"gpu": {
"count": 1,
"sku": "K80"
},
"memoryInGB": 1.5
}
},
"volumeMounts": [
{
"name": "volume1",
"mountPath": "/mnt/volume1",
"readOnly": false
},
{
"name": "volume2",
"mountPath": "/mnt/volume2",
"readOnly": false
},
{
"name": "volume3",
"mountPath": "/mnt/volume3",
"readOnly": true
}
]
}
}
],
"dnsConfig": {
"nameServers": [
"1.1.1.1"
]
},
"imageRegistryCredentials": [
{
"passwordReference": "privateRegistryKeyRef",
"server": "demoregistry.azurecr.io",
"username": "registryUserName"
}
],
"ipAddress": {
"type": "Public",
"autoGeneratedDomainNameLabelScope": "Unsecure",
"dnsNameLabel": "dnsnamelabel1",
"fqdn": "dnsnamelabel1.azure-container.io",
"ip": "10.0.0.1",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Succeeded",
"secretReferences": [
{
"name": "envSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/envSecret"
},
{
"name": "accountKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/accountKey"
},
{
"name": "volumeSecretRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/volumeSecret"
},
{
"name": "privateRegistryKeyRef",
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name",
"secretReferenceUri": "https://keyvaultname.vault.azure.net/secrets/privateRegistryKey"
}
],
"volumes": [
{
"name": "volume1",
"azureFile": {
"shareName": "shareName",
"storageAccountKeyReference": "accountKeyRef",
"storageAccountName": "accountName"
}
},
{
"name": "volume2",
"emptyDir": {}
},
{
"name": "volume3",
"secret": {},
"secretReference": {
"secretKey2": "volumeSecretRef"
}
}
]
},
"zones": [
"1"
]
}
ContainerGroupsCreateWithPriority
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"location": "eastus",
"properties": {
"containers": [
{
"name": "test-container-001",
"properties": {
"command": [
"/bin/sh",
"-c",
"sleep 10"
],
"image": "alpine:latest",
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1
}
}
}
}
],
"osType": "Linux",
"priority": "Spot",
"restartPolicy": "Never",
"sku": "Standard"
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subId/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus",
"properties": {
"containers": [
{
"name": "test-container-001",
"properties": {
"command": [
"/bin/sh",
"-c",
"sleep 10"
],
"environmentVariables": [],
"image": "alpine:latest",
"ports": [],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1
}
}
}
}
],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Succeeded"
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"priority": "Spot",
"provisioningState": "Succeeded",
"restartPolicy": "Never",
"sku": "Standard"
}
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/subId/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"location": "eastus",
"properties": {
"containers": [
{
"name": "test-container-001",
"properties": {
"command": [
"/bin/sh",
"-c",
"sleep 10"
],
"environmentVariables": [],
"image": "alpine:latest",
"ports": [],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1
}
}
}
}
],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Created"
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"priority": "Spot",
"provisioningState": "Created",
"restartPolicy": "Never",
"sku": "Standard"
}
}
ContainerGroupWithEncryptionProperties
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/demo1?api-version=2025-09-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity": {}
}
},
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"encryptionProperties": {
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity",
"keyName": "test-key",
"keyVersion": "<key version>",
"vaultBaseUrl": "https://testkeyvault.vault.azure.net"
},
"imageRegistryCredentials": [],
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"osType": "Linux"
}
}
Risposta di esempio
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"identity": {
"type": "UserAssigned",
"tenantId": "<tenant id>",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity": {
"clientId": "<client id>",
"principalId": "<principal id>"
}
}
},
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"encryptionProperties": {
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity",
"keyName": "test-key",
"keyVersion": "<key version>",
"vaultBaseUrl": "https://testkeyvault.vault.azure.net/"
},
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Pending"
},
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Pending",
"sku": "Standard"
}
}
{
"name": "demo1",
"type": "Microsoft.ContainerInstance/containerGroups",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ContainerInstance/containerGroups/demo1",
"identity": {
"type": "UserAssigned",
"tenantId": "<tenant id>",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity": {
"clientId": "<client id>",
"principalId": "<principal id>"
}
}
},
"location": "eastus2",
"properties": {
"containers": [
{
"name": "demo1",
"properties": {
"command": [],
"environmentVariables": [],
"image": "nginx",
"ports": [
{
"port": 80
}
],
"resources": {
"requests": {
"cpu": 1,
"memoryInGB": 1.5
}
}
}
}
],
"encryptionProperties": {
"identity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/container-group-identity",
"keyName": "test-key",
"keyVersion": "key version",
"vaultBaseUrl": "https://testkeyvault.vault.azure.net/"
},
"imageRegistryCredentials": [],
"initContainers": [],
"instanceView": {
"events": [],
"state": "Pending"
},
"ipAddress": {
"type": "Public",
"ports": [
{
"port": 80,
"protocol": "TCP"
}
]
},
"isCreatedFromStandbyPool": false,
"osType": "Linux",
"provisioningState": "Running",
"sku": "Standard"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Azure |
Proprietà del volume file di Azure. Le condivisioni file di Azure vengono montate come volumi. |
|
Cloud |
Risposta di errore del servizio Istanza contenitore. |
|
Cloud |
Risposta di errore del servizio Istanza contenitore. |
|
Confidential |
Proprietà per il gruppo di contenitori riservati |
|
Config |
La mappa di configurazione del container. |
| Container |
Istanza del contenitore. |
|
Container |
Comando di esecuzione del contenitore, per il probe di attività o idoneità |
|
Container |
Gruppo di contenitori. |
|
Container |
Informazioni di diagnostica del gruppo di contenitori. |
|
Container |
Identità per il gruppo di contenitori. |
|
Container |
Specifica se l'indirizzo IP è esposto alla rete Internet pubblica o alla rete virtuale privata. |
|
Container |
Protocollo associato alla porta. |
|
Container |
Priorità del gruppo di contenitori. |
|
Container |
Riferimento al profilo del gruppo di contenitori. |
|
Container |
Visualizzazione dell'istanza del gruppo di contenitori. Valido solo in risposta. |
|
Container |
Criteri di riavvio per tutti i contenitori all'interno del gruppo di contenitori.
|
|
Container |
SKU del gruppo di contenitori. |
|
Container |
Informazioni sulla subnet del gruppo di contenitori. |
|
Container |
Impostazioni Http Get del contenitore per il probe di attività o idoneità |
|
Container |
Protocollo associato alla porta. |
|
Container |
Porta esposta nell'istanza del contenitore. |
|
Container |
Probe del contenitore, per attività o idoneità |
|
Container |
Visualizzazione dell'istanza dell'istanza del contenitore. Valido solo in risposta. |
|
Container |
Stato dell'istanza del contenitore. |
|
Deployment |
Sidecar di estensione da aggiungere alla distribuzione. |
|
Dns |
Configurazione DNS per il gruppo di contenitori. |
|
Dns |
Valore che rappresenta l'enumerazione di sicurezza. Il valore "Non protetto" è il valore predefinito se non è selezionato e indica che l'etichetta del nome di dominio dell'oggetto non è protetta dall'acquisizione del sottodominio. Il valore "TenantReuse" è il valore predefinito se selezionato e indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso tenant. Il valore "SubscriptionReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno della stessa sottoscrizione. Il valore "ResourceGroupReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso gruppo di risorse. Il valore 'NoReuse' indica che l'etichetta del nome di dominio dell'oggetto non può essere riutilizzata all'interno dello stesso gruppo di risorse, sottoscrizione o tenant. |
|
Encryption |
Proprietà di crittografia del gruppo di contenitori. |
|
Environment |
Variabile di ambiente da impostare all'interno dell'istanza del contenitore. |
| Event |
Un gruppo di contenitori o un evento di istanza del contenitore. |
|
Git |
Rappresenta un volume popolato con il contenuto di un repository Git |
|
Gpu |
Risorsa GPU. |
|
Gpu |
SKU della risorsa GPU. |
|
Http |
Intestazione HTTP. |
|
Identity |
Controllo di accesso per un'identità |
|
Identity |
Livello di accesso di un'identità. |
|
Identity |
Livelli di controllo di accesso delle identità. |
|
Image |
Credenziali del Registro di sistema delle immagini. |
|
Init |
Definizione del contenitore init. |
|
Init |
Visualizzazione dell'istanza del contenitore init. Valido solo in risposta. |
|
Ip |
Indirizzo IP per il gruppo di contenitori. |
|
Log |
Informazioni di Log Analytics del gruppo di contenitori. |
|
Log |
Tipo di log da utilizzare. |
|
Operating |
Tipo di sistema operativo richiesto dai contenitori nel gruppo di contenitori. |
| Port |
Porta esposta nel gruppo di contenitori. |
|
Resource |
Tipo di identità usato per il gruppo di contenitori. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal gruppo di contenitori. |
|
Resource |
Limiti delle risorse. |
|
Resource |
Richieste di risorse. |
|
Resource |
Requisiti delle risorse. |
| Scheme |
Schema. |
|
Secret |
Riferimento a un segreto |
|
Security |
Funzionalità da aggiungere o eliminare da un contenitore. |
|
Security |
Contesto di sicurezza per il contenitore. |
|
Standby |
Riferimento al profilo del pool di standby. |
|
User |
Elenco di identità utente associate al gruppo di contenitori. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
| Volume |
Proprietà del volume. |
|
Volume |
Proprietà del montaggio del volume. |
AzureFileVolume
Proprietà del volume file di Azure. Le condivisioni file di Azure vengono montate come volumi.
| Nome | Tipo | Descrizione |
|---|---|---|
| readOnly |
boolean |
Flag che indica se l'Azure File condiviso montato come volume è di sola lettura. |
| shareName |
string |
Nome della condivisione file Azure da montare come volume. |
| storageAccountKey |
string (password) |
Chiave di accesso dell'account di archiviazione usata per accedere alla condivisione file Azure. |
| storageAccountKeyReference |
string |
Riferimento alla chiave di accesso dell'account di archiviazione usata per accedere alla condivisione file di Azure. |
| storageAccountName |
string |
Nome dell'account di archiviazione che contiene l'Azure condivisione file. |
CloudError
Risposta di errore del servizio Istanza contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Risposta di errore del servizio Istanza contenitore. |
CloudErrorBody
Risposta di errore del servizio Istanza contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice. |
| details |
Elenco di dettagli aggiuntivi sull'errore. |
|
| message |
string |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
| target |
string |
Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore. |
ConfidentialComputeProperties
Proprietà per il gruppo di contenitori riservati
| Nome | Tipo | Descrizione |
|---|---|---|
| ccePolicy |
string |
Criteri di imposizione del confidential compute codificati in base64 |
ConfigMap
La mappa di configurazione del container.
| Nome | Tipo | Descrizione |
|---|---|---|
| keyValuePairs |
object |
Dizionario coppie chiave-valore nella mappa di configurazione. |
Container
Istanza del contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome fornito dall'utente dell'istanza del contenitore. |
| properties.command |
string[] |
Comandi da eseguire all'interno dell'istanza del contenitore nel formato exec. |
| properties.configMap |
Mappa di configurazione. |
|
| properties.environmentVariables |
Variabili di ambiente da impostare nell'istanza del contenitore. |
|
| properties.image |
string |
Nome dell'immagine usata per creare l'istanza del contenitore. |
| properties.instanceView |
Visualizzazione dell'istanza dell'istanza del contenitore. Valido solo in risposta. |
|
| properties.livenessProbe |
Probe di attività. |
|
| properties.ports |
Porte esposte nell'istanza del contenitore. |
|
| properties.readinessProbe |
Probe di idoneità. |
|
| properties.resources |
Requisiti delle risorse dell'istanza del contenitore. |
|
| properties.securityContext |
Proprietà di sicurezza del contenitore. |
|
| properties.volumeMounts |
Il volume viene montato per l'istanza del contenitore. |
ContainerExec
Comando di esecuzione del contenitore, per il probe di attività o idoneità
| Nome | Tipo | Descrizione |
|---|---|---|
| command |
string[] |
Comandi da eseguire all'interno del contenitore. |
ContainerGroup
Gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
| identity |
Identità del gruppo di contenitori, se configurata. |
|
| location |
string |
Percorso della risorsa. |
| name |
string |
Nome della risorsa. |
| properties.confidentialComputeProperties |
Proprietà per il gruppo di contenitori riservati |
|
| properties.containerGroupProfile |
Proprietà del profilo del gruppo di contenitori di riferimento. |
|
| properties.containers |
Contenitori all'interno del gruppo di contenitori. |
|
| properties.diagnostics |
Informazioni di diagnostica per un gruppo di contenitori. |
|
| properties.dnsConfig |
Informazioni di configurazione DNS per un gruppo di contenitori. |
|
| properties.encryptionProperties |
Proprietà di crittografia per un gruppo di contenitori. |
|
| properties.extensions |
estensioni usate da kubelet virtuale |
|
| properties.identityAcls |
Livelli di controllo di accesso delle identità. |
|
| properties.imageRegistryCredentials |
Credenziali del Registro immagini da cui viene creato il gruppo di contenitori. |
|
| properties.initContainers |
Contenitori init per un gruppo di contenitori. |
|
| properties.instanceView |
Visualizzazione dell'istanza del gruppo di contenitori. Valido solo in risposta. |
|
| properties.ipAddress |
Tipo di indirizzo IP del gruppo di contenitori. |
|
| properties.isCreatedFromStandbyPool |
boolean |
Flag per determinare se il gruppo di contenitori viene creato dal pool di standby. |
| properties.osType |
Tipo di sistema operativo richiesto dai contenitori nel gruppo di contenitori. |
|
| properties.priority |
Priorità del gruppo di contenitori. |
|
| properties.provisioningState |
string |
Stato di provisioning del gruppo di contenitori. Questo viene visualizzato solo nella risposta. |
| properties.restartPolicy |
Criteri di riavvio per tutti i contenitori all'interno del gruppo di contenitori.
|
|
| properties.secretReferences |
Riferimenti al segreto a cui verrà fatto riferimento all'interno del gruppo di contenitori. |
|
| properties.sku |
SKU per un gruppo di contenitori. |
|
| properties.standbyPoolProfile |
Proprietà del profilo del pool di standby di riferimento. |
|
| properties.subnetIds |
ID risorsa subnet per un gruppo di contenitori. |
|
| properties.volumes |
Volume[] |
Elenco di volumi che possono essere montati da contenitori in questo gruppo di contenitori. |
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. |
| zones |
string[] |
Zone di disponibilità. |
ContainerGroupDiagnostics
Informazioni di diagnostica del gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| logAnalytics |
Informazioni di Log Analytics del gruppo di contenitori. |
ContainerGroupIdentity
Identità per il gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| principalId |
string |
ID principale dell'identità del gruppo di contenitori. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| tenantId |
string |
ID tenant associato al gruppo di contenitori. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| type |
Tipo di identità usato per il gruppo di contenitori. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal gruppo di contenitori. |
|
| userAssignedIdentities |
<string,
User |
Elenco di identità utente associate al gruppo di contenitori. |
ContainerGroupIpAddressType
Specifica se l'indirizzo IP è esposto alla rete Internet pubblica o alla rete virtuale privata.
| Valore | Descrizione |
|---|---|
| Public |
Public |
| Private |
Privato |
ContainerGroupNetworkProtocol
Protocollo associato alla porta.
| Valore | Descrizione |
|---|---|
| TCP |
TCP |
| UDP |
UDP |
ContainerGroupPriority
Priorità del gruppo di contenitori.
| Valore | Descrizione |
|---|---|
| Regular |
Regolare |
| Spot |
Spot (Contante) |
ContainerGroupProfileReferenceDefinition
Riferimento al profilo del gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID di riferimento del profilo del gruppo di contenitori. Questo sarà un ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName}'. |
| revision |
integer (int32) |
Revisione di riferimento del profilo del gruppo di contenitori. |
ContainerGroupPropertiesPropertiesInstanceView
Visualizzazione dell'istanza del gruppo di contenitori. Valido solo in risposta.
| Nome | Tipo | Descrizione |
|---|---|---|
| events |
Event[] |
Eventi di questo gruppo di contenitori. |
| state |
string |
Stato del gruppo di contenitori. Valido solo in risposta. |
ContainerGroupRestartPolicy
Criteri di riavvio per tutti i contenitori all'interno del gruppo di contenitori.
-
AlwaysRiavviare sempre -
OnFailureRiavvio in caso di errore -
NeverNon riavviare mai
| Valore | Descrizione |
|---|---|
| Always |
Sempre |
| OnFailure |
In caso di esito negativo |
| Never |
Mai |
ContainerGroupSku
SKU del gruppo di contenitori.
| Valore | Descrizione |
|---|---|
| NotSpecified |
Non specificato |
| Standard |
Standard |
| Dedicated |
Dedicato |
| Confidential |
Riservato |
ContainerGroupSubnetId
Informazioni sulla subnet del gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa della rete virtuale e della subnet. |
| name |
string |
Nome descrittivo per la subnet. |
ContainerHttpGet
Impostazioni Http Get del contenitore per il probe di attività o idoneità
| Nome | Tipo | Descrizione |
|---|---|---|
| httpHeaders |
Intestazioni HTTP. |
|
| path |
string |
Percorso del probe. |
| port |
integer (int32) |
Numero di porta da sondare. |
| scheme |
Schema. |
ContainerNetworkProtocol
Protocollo associato alla porta.
| Valore | Descrizione |
|---|---|
| TCP |
TCP |
| UDP |
UDP |
ContainerPort
Porta esposta nell'istanza del contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| port |
integer (int32) |
Numero di porta esposto all'interno del gruppo di contenitori. |
| protocol |
Protocollo associato alla porta. |
ContainerProbe
Probe del contenitore, per attività o idoneità
| Nome | Tipo | Descrizione |
|---|---|---|
| exec |
Comando di esecuzione da probe |
|
| failureThreshold |
integer (int32) |
Soglia di errore. |
| httpGet |
Impostazioni Http Get per il probe |
|
| initialDelaySeconds |
integer (int32) |
Secondi di ritardo iniziali. |
| periodSeconds |
integer (int32) |
Periodo di secondi. |
| successThreshold |
integer (int32) |
Soglia di esito positivo. |
| timeoutSeconds |
integer (int32) |
Secondi di timeout. |
ContainerPropertiesInstanceView
Visualizzazione dell'istanza dell'istanza del contenitore. Valido solo in risposta.
| Nome | Tipo | Descrizione |
|---|---|---|
| currentState |
Stato corrente dell'istanza del contenitore. |
|
| events |
Event[] |
Eventi dell'istanza del contenitore. |
| previousState |
Stato precedente dell'istanza del contenitore. |
|
| restartCount |
integer (int32) |
Numero di volte in cui l'istanza del contenitore è stata riavviata. |
ContainerState
Stato dell'istanza del contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| detailStatus |
string |
Stato leggibile dello stato dell'istanza del contenitore. |
| exitCode |
integer (int32) |
I codici di uscita dell'istanza del contenitore corrispondono a quelli del comando |
| finishTime |
string (date-time) |
Data e ora di fine dello stato dell'istanza del contenitore. |
| startTime |
string (date-time) |
Data/ora di inizio dello stato dell'istanza del contenitore. |
| state |
string |
Stato dell'istanza del contenitore. |
DeploymentExtensionSpec
Sidecar di estensione da aggiungere alla distribuzione.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome dell'estensione. |
| properties.extensionType |
string |
Tipo di estensione da aggiungere. |
| properties.protectedSettings |
Impostazioni protette per l'estensione. |
|
| properties.settings |
Impostazioni per l'estensione. |
|
| properties.version |
string |
Versione dell'estensione in uso. |
DnsConfiguration
Configurazione DNS per il gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| nameServers |
string[] |
Server DNS per il gruppo di contenitori. |
| options |
string |
Opzioni DNS per il gruppo di contenitori. |
| searchDomains |
string |
Domini di ricerca DNS per la ricerca del nome host nel gruppo di contenitori. |
DnsNameLabelReusePolicy
Valore che rappresenta l'enumerazione di sicurezza. Il valore "Non protetto" è il valore predefinito se non è selezionato e indica che l'etichetta del nome di dominio dell'oggetto non è protetta dall'acquisizione del sottodominio. Il valore "TenantReuse" è il valore predefinito se selezionato e indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso tenant. Il valore "SubscriptionReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno della stessa sottoscrizione. Il valore "ResourceGroupReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso gruppo di risorse. Il valore 'NoReuse' indica che l'etichetta del nome di dominio dell'oggetto non può essere riutilizzata all'interno dello stesso gruppo di risorse, sottoscrizione o tenant.
| Valore | Descrizione |
|---|---|
| Unsecure |
Non sicuro |
| TenantReuse |
TenantReuse |
| SubscriptionReuse |
SubscriptionReuse |
| ResourceGroupReuse |
ResourceGroupReuse |
| Noreuse |
Noreuse |
EncryptionProperties
Proprietà di crittografia del gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| identity |
string |
Identità gestita dell'insieme di credenziali delle chiavi. |
| keyName |
string |
Nome della chiave di crittografia. |
| keyVersion |
string |
Versione della chiave di crittografia. |
| vaultBaseUrl |
string |
URL di base dell'insieme di credenziali delle chiavi. |
EnvironmentVariable
Variabile di ambiente da impostare all'interno dell'istanza del contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome della variabile di ambiente. |
| secureValue |
string (password) |
Valore della variabile di ambiente sicura. |
| secureValueReference |
string |
Riferimento della variabile di ambiente sicura. |
| value |
string |
Valore della variabile di ambiente. |
Event
Un gruppo di contenitori o un evento di istanza del contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| count |
integer (int32) |
Conteggio dell'evento. |
| firstTimestamp |
string (date-time) |
Data e ora dell'evento registrato meno recente. |
| lastTimestamp |
string (date-time) |
Data e ora dell'evento registrato più recente. |
| message |
string |
Messaggio dell'evento. |
| name |
string |
Nome dell'evento. |
| type |
string |
Tipo di evento. |
GitRepoVolume
Rappresenta un volume popolato con il contenuto di un repository Git
| Nome | Tipo | Descrizione |
|---|---|---|
| directory |
string |
Nome della directory di destinazione. Non deve contenere o iniziare con '..'. Se viene specificato '.', la directory del volume sarà il repository Git. In caso contrario, se specificato, il volume conterrà il repository Git nella sottodirectory con il nome specificato. |
| repository |
string |
URL del repository |
| revision |
string |
Eseguire il commit dell'hash per la revisione specificata. |
GpuResource
Risorsa GPU.
| Nome | Tipo | Descrizione |
|---|---|---|
| count |
integer (int32) |
Conteggio della risorsa GPU. |
| sku |
SKU della risorsa GPU. |
GpuSku
SKU della risorsa GPU.
| Valore | Descrizione |
|---|---|
| K80 |
K80 |
| P100 |
P100 |
| V100 |
V100 |
HttpHeader
Intestazione HTTP.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome dell'intestazione. |
| value |
string |
Valore dell'intestazione. |
IdentityAccessControl
Controllo di accesso per un'identità
| Nome | Tipo | Descrizione |
|---|---|---|
| access |
Livello di accesso dell'identità. |
|
| identity |
string (arm-id) |
Un'identità. |
IdentityAccessLevel
Livello di accesso di un'identità.
| Valore | Descrizione |
|---|---|
| All |
Tutti |
| System |
System |
| User |
User |
IdentityAcls
Livelli di controllo di accesso delle identità.
| Nome | Tipo | Descrizione |
|---|---|---|
| acls |
Livelli di controllo di accesso per ogni identità. |
|
| defaultAccess |
Livello di accesso predefinito. |
ImageRegistryCredential
Credenziali del Registro di sistema delle immagini.
| Nome | Tipo | Descrizione |
|---|---|---|
| identity |
string |
Identità del Registro di sistema privato. |
| identityUrl |
string |
URL di identità per il Registro di sistema privato. |
| password |
string (password) |
Password per il Registro di sistema privato. |
| passwordReference |
string |
Riferimento per la password del Registro di sistema privato. |
| server |
string |
Il server del Registro di sistema delle immagini Docker senza un protocollo, ad esempio "http" e "https". |
| username |
string |
Nome utente per il Registro di sistema privato. |
InitContainerDefinition
Definizione del contenitore init.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
string |
Nome del contenitore init. |
| properties.command |
string[] |
Comando da eseguire all'interno del contenitore init nel formato exec. |
| properties.environmentVariables |
Variabili di ambiente da impostare nel contenitore init. |
|
| properties.image |
string |
Immagine del contenitore init. |
| properties.instanceView |
Visualizzazione dell'istanza del contenitore init. Valido solo in risposta. |
|
| properties.securityContext |
Proprietà di sicurezza del contenitore. |
|
| properties.volumeMounts |
Il volume monta il contenitore init. |
InitContainerPropertiesDefinitionInstanceView
Visualizzazione dell'istanza del contenitore init. Valido solo in risposta.
| Nome | Tipo | Descrizione |
|---|---|---|
| currentState |
Stato corrente del contenitore init. |
|
| events |
Event[] |
Eventi del contenitore init. |
| previousState |
Stato precedente del contenitore init. |
|
| restartCount |
integer (int32) |
Numero di volte in cui il contenitore init è stato riavviato. |
IpAddress
Indirizzo IP per il gruppo di contenitori.
| Nome | Tipo | Valore predefinito | Descrizione |
|---|---|---|---|
| autoGeneratedDomainNameLabelScope | Unsecure |
Valore che rappresenta l'enumerazione di sicurezza. Il valore "Non protetto" è il valore predefinito se non è selezionato e indica che l'etichetta del nome di dominio dell'oggetto non è protetta dall'acquisizione del sottodominio. Il valore "TenantReuse" è il valore predefinito se selezionato e indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso tenant. Il valore "SubscriptionReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno della stessa sottoscrizione. Il valore "ResourceGroupReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso gruppo di risorse. Il valore 'NoReuse' indica che l'etichetta del nome di dominio dell'oggetto non può essere riutilizzata all'interno dello stesso gruppo di risorse, sottoscrizione o tenant. |
|
| dnsNameLabel |
string |
Etichetta del nome DNS per l'INDIRIZZO IP. |
|
| fqdn |
string |
FQDN per l'INDIRIZZO IP. |
|
| ip |
string |
Ip esposto alla rete Internet pubblica. |
|
| ports |
Port[] |
Elenco di porte esposte nel gruppo di contenitori. |
|
| type |
Specifica se l'indirizzo IP è esposto alla rete Internet pubblica o alla rete virtuale privata. |
LogAnalytics
Informazioni di Log Analytics del gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| logType |
Tipo di log da utilizzare. |
|
| metadata |
object |
Metadati per Log Analytics. |
| workspaceId |
string |
ID dell'area di lavoro per Log Analytics |
| workspaceKey |
string (password) |
Chiave dell'area di lavoro per Log Analytics |
| workspaceResourceId |
string (password) |
ID risorsa dell'area di lavoro per Log Analytics |
LogAnalyticsLogType
Tipo di log da utilizzare.
| Valore | Descrizione |
|---|---|
| ContainerInsights |
ContainerInsights |
| ContainerInstanceLogs |
ContainerInstanceLogs |
OperatingSystemTypes
Tipo di sistema operativo richiesto dai contenitori nel gruppo di contenitori.
| Valore | Descrizione |
|---|---|
| Windows |
Windows |
| Linux |
Linux |
Port
Porta esposta nel gruppo di contenitori.
| Nome | Tipo | Descrizione |
|---|---|---|
| port |
integer (int32) |
Numero di porta. |
| protocol |
Protocollo associato alla porta. |
ResourceIdentityType
Tipo di identità usato per il gruppo di contenitori. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal gruppo di contenitori.
| Valore | Descrizione |
|---|---|
| SystemAssigned |
Assegnato dal sistema |
| UserAssigned |
UserAssigned |
| SystemAssigned, UserAssigned |
SystemAssigned, UserAssigned |
| None |
Nessuno |
ResourceLimits
Limiti delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| cpu |
number (double) |
Limite della CPU di questa istanza del contenitore. |
| gpu |
Limite GPU di questa istanza del contenitore. |
|
| memoryInGB |
number (double) |
Limite di memoria in GB di questa istanza del contenitore. |
ResourceRequests
Richieste di risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| cpu |
number (double) |
Richiesta CPU di questa istanza del contenitore. |
| gpu |
Richiesta GPU di questa istanza del contenitore. |
|
| memoryInGB |
number (double) |
Richiesta di memoria in GB di questa istanza del contenitore. |
ResourceRequirements
Requisiti delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| limits |
Limiti delle risorse di questa istanza del contenitore. |
|
| requests |
Richieste di risorse di questa istanza del contenitore. |
Scheme
Schema.
| Valore | Descrizione |
|---|---|
| http |
http |
| https |
https |
SecretReference
Riferimento a un segreto
| Nome | Tipo | Descrizione |
|---|---|---|
| identity |
string (arm-id) |
ID risorsa ARM dell'identità gestita che ha accesso al segreto nell'insieme di credenziali delle chiavi |
| name |
string |
Identificatore del riferimento al segreto |
| secretReferenceUri |
string (uri) |
URI del segreto nell'insieme di credenziali delle chiavi |
SecurityContextCapabilitiesDefinition
Funzionalità da aggiungere o eliminare da un contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| add |
string[] |
Funzionalità da aggiungere al contenitore. |
| drop |
string[] |
Funzionalità da eliminare dal contenitore. |
SecurityContextDefinition
Contesto di sicurezza per il contenitore.
| Nome | Tipo | Descrizione |
|---|---|---|
| allowPrivilegeEscalation |
boolean |
Valore booleano che indica se il processo init può elevare i privilegi |
| capabilities |
Funzionalità da aggiungere o eliminare da un contenitore. |
|
| privileged |
boolean |
Flag per determinare se le autorizzazioni del contenitore sono elevate in Privileged. |
| runAsGroup |
integer (int32) |
Imposta il GID utente per il contenitore. |
| runAsUser |
integer (int32) |
Imposta l'UID utente per il contenitore. |
| seccompProfile |
string |
stringa con codifica Base64 contenente il contenuto del codice JSON nel profilo seccomp |
StandbyPoolProfileDefinition
Riferimento al profilo del pool di standby.
| Nome | Tipo | Descrizione |
|---|---|---|
| failContainerGroupCreateOnReuseFailure |
boolean |
Flag per determinare se ACI deve non riuscire la richiesta di creazione se il gruppo di contenitori non può essere ottenuto dal pool di standby. |
| id |
string (arm-id) |
ID di riferimento del profilo del pool di standby. Questo sarà un ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName}'. |
UserAssignedIdentities
Elenco di identità utente associate al gruppo di contenitori. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
| Nome | Tipo | Descrizione |
|---|---|---|
| clientId |
string |
ID client dell'identità assegnata dall'utente. |
| principalId |
string |
ID principale dell'identità assegnata dall'utente. |
Volume
Proprietà del volume.
| Nome | Tipo | Descrizione |
|---|---|---|
| azureFile |
Volume file di Azure. |
|
| emptyDir |
Volume di directory vuoto. |
|
| gitRepo |
Volume del repository Git. |
|
| name |
string |
Nome del volume. |
| secret |
object |
Volume segreto. |
| secretReference |
object |
Volume di riferimento segreto. |
VolumeMount
Proprietà del montaggio del volume.
| Nome | Tipo | Descrizione |
|---|---|---|
| mountPath |
string |
Percorso all'interno del contenitore in cui deve essere montato il volume. Non deve contenere due punti (:). |
| name |
string |
Nome del montaggio del volume. |
| readOnly |
boolean |
Flag che indica se il montaggio del volume è di sola lettura. |