Microsoft.ContainerInstance containerGroups 2017-08-01-preview
Artikel 05/11/2023
1 Mitwirkender
Feedback
In diesem Artikel
Bicep-Ressourcendefinition
Der Ressourcentyp containerGroups kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll .
Um eine Microsoft.ContainerInstance/containerGroups-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-08-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
containers: [
{
name: 'string'
properties: {
command: [
'string'
]
environmentVariables: [
{
name: 'string'
value: 'string'
}
]
image: 'string'
ports: [
{
port: int
}
]
resources: {
limits: {
cpu: int
memoryInGB: json('decimal-as-string')
}
requests: {
cpu: int
memoryInGB: json('decimal-as-string')
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
imageRegistryCredentials: [
{
password: 'string'
server: 'string'
username: 'string'
}
]
ipAddress: {
ip: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
type: 'Public'
}
osType: 'string'
restartPolicy: 'always'
volumes: [
{
azureFile: {
readOnly: bool
shareName: 'string'
storageAccountKey: 'string'
storageAccountName: 'string'
}
name: 'string'
}
]
}
}
Eigenschaftswerte
containerGroups
Name
BESCHREIBUNG
Wert
name
Der Ressourcenname
Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Aufeinanderfolgende Bindestriche sind nicht zulässig.
location
Der Ressourcenspeicherort.
Zeichenfolge (erforderlich)
tags
Die Ressourcentags.
Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties
ContainerGroupProperties (erforderlich)
ContainerGroupProperties
Name
BESCHREIBUNG
Wert
containers
Die Container innerhalb der Containergruppe.
Container [] (erforderlich)
imageRegistryCredentials
Die Anmeldeinformationen für die Imageregistrierung, mit denen die Containergruppe erstellt wird.
ImageRegistryCredential []
ipAddress
Der IP-Adressentyp der Containergruppe.
IpAddress
osType
Der für die Container in der Containergruppe erforderliche Betriebssystemtyp.
"Linux" "Windows" (erforderlich)
restartPolicy
Neustartrichtlinie für alle Container innerhalb der Containergruppe. Derzeit ist always
die einzige verfügbare Option .
"immer"
volumes
Die Liste der Volumes, die von Containern in dieser Containergruppe eingebunden werden können.
Volume []
Container
Name
BESCHREIBUNG
Wert
name
Der vom Benutzer bereitgestellte Name der Containerinstanz.
Zeichenfolge (erforderlich)
properties
Der Eigenschaften der Containerinstanz.
ContainerProperties (erforderlich)
ContainerProperties
Name
BESCHREIBUNG
Wert
command
Die innerhalb der Containerinstanz auszuführenden Befehle im EXEC-Format.
string[]
environmentVariables
Die in der Containerinstanz festzulegenden Umgebungsvariablen.
EnvironmentVariable []
image
Der Name des zum Erstellen der Containerinstanz verwendeten Images.
Zeichenfolge (erforderlich)
ports
Die in der Containerinstanz verfügbar gemachten Ports.
ContainerPort []
ressourcen
Die Ressourcenanforderungen der Containerinstanz.
ResourceRequirements (erforderlich)
volumeMounts
Die für die Containerinstanz verfügbaren Volumebereitstellungen.
VolumeMount []
EnvironmentVariable
Name
BESCHREIBUNG
Wert
name
Der Name der Umgebungsvariablen.
Zeichenfolge (erforderlich)
value
Der Wert der Umgebungsvariablen.
Zeichenfolge (erforderlich)
ContainerPort
Name
BESCHREIBUNG
Wert
port
Die innerhalb der Containergruppe verfügbar gemachte Portnummer.
int (erforderlich)
ResourceRerements
Name
BESCHREIBUNG
Wert
Grenzwerte
Die Ressourcenlimits dieser Containerinstanz.
ResourceLimits
requests
Die Ressourcenanforderungen dieser Containerinstanz.
ResourceRequests (erforderlich)
ResourceLimits
Name
BESCHREIBUNG
Wert
cpu
Das CPU-Limit dieser Containerinstanz.
INT
memoryInGB
Das Arbeitsspeicherlimit dieser Containerinstanz in GB. Verwenden Sie die json() -Funktion, um einen Dezimalwert anzugeben.
int oder json dezimal
ResourceRequests
Name
BESCHREIBUNG
Wert
cpu
Die CPU-Anforderungen dieser Containerinstanz.
int (erforderlich)
memoryInGB
Die Arbeitsspeicheranforderung dieser Containerinstanz in GB. Verwenden Sie die json() -Funktion, um einen Dezimalwert anzugeben.
int oder json decimal (erforderlich)
VolumeMount
Name
BESCHREIBUNG
Wert
mountPath
Der Pfad innerhalb des Containers, in dem das Volume bereitgestellt werden soll. Darf keinen Doppelpunkt (:) enthalten.
Zeichenfolge (erforderlich)
name
Der Name der Volumebereitstellung.
Zeichenfolge (erforderlich)
readOnly
Das Flag, das anzeigt, ob die Volumebereitstellung schreibgeschützt ist.
bool
ImageRegistryCredential
Name
BESCHREIBUNG
Wert
password
Das Kennwort für die private Registrierung.
Zeichenfolge
server
Der Docker-Imageregistrierungsserver ohne ein Protokoll wie „HTTP“ oder „HTTPS“.
Zeichenfolge (erforderlich)
username
Der Benutzername für die private Registrierung.
Zeichenfolge (erforderlich)
IpAddress
Name
BESCHREIBUNG
Wert
ip
Die dem öffentlichen Internet verfügbar gemachte IP-Adresse.
Zeichenfolge
ports
Die Liste der in der Containergruppe verfügbar gemachten Ports.
Port [] (erforderlich)
Typ
Gibt an, ob die IP-Adresse für das öffentliche Internet verfügbar gemacht wird.
"Öffentlich" (erforderlich)
Port
Name
BESCHREIBUNG
Wert
port
Die Portnummer.
int (erforderlich)
Protokoll
Das dem Port zugeordnete Protokoll.
"TCP" "UDP"
Volume
Name
BESCHREIBUNG
Wert
azureFile
Der Name des Azure-Dateivolumes.
AzureFileVolume (erforderlich)
name
Der Name des Volumes.
Zeichenfolge (erforderlich)
AzureFileVolume
Name
BESCHREIBUNG
Wert
readOnly
Das Flag, das anzeigt, ob die als Volume bereitgestellte Azure File-Freigabe schreibgeschützt ist.
bool
shareName
Der Name der als Volume bereitzustellenden Azure File-Freigabe.
Zeichenfolge (erforderlich)
storageAccountKey
Der Zugriffsschlüssel des Speicherkontos, der für den Zugriff auf die Azure File-Freigabe verwendet wird.
Zeichenfolge
storageAccountName
Der Name des Speicherkontos, das die Azure File-Freigabe enthält.
Zeichenfolge (erforderlich)
Schnellstartvorlagen
In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp containerGroups kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll .
Um eine Microsoft.ContainerInstance/containerGroups-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2017-08-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"containers": [
{
"name": "string",
"properties": {
"command": [ "string" ],
"environmentVariables": [
{
"name": "string",
"value": "string"
}
],
"image": "string",
"ports": [
{
"port": "int"
}
],
"resources": {
"limits": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
},
"requests": {
"cpu": "int",
"memoryInGB": "[json('decimal-as-string')]"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"imageRegistryCredentials": [
{
"password": "string",
"server": "string",
"username": "string"
}
],
"ipAddress": {
"ip": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"type": "Public"
},
"osType": "string",
"restartPolicy": "always",
"volumes": [
{
"azureFile": {
"readOnly": "bool",
"shareName": "string",
"storageAccountKey": "string",
"storageAccountName": "string"
},
"name": "string"
}
]
}
}
Eigenschaftswerte
containerGroups
Name
BESCHREIBUNG
Wert
type
Der Ressourcentyp
"Microsoft.ContainerInstance/containerGroups"
apiVersion
Die Version der Ressourcen-API
"2017-08-01-preview"
name
Der Ressourcenname
Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Aufeinanderfolgende Bindestriche sind nicht zulässig.
location
Der Ressourcenspeicherort.
Zeichenfolge (erforderlich)
tags
Die Ressourcentags.
Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties
ContainerGroupProperties (erforderlich)
ContainerGroupProperties
Name
BESCHREIBUNG
Wert
containers
Die Container innerhalb der Containergruppe.
Container [] (erforderlich)
imageRegistryCredentials
Die Anmeldeinformationen für die Imageregistrierung, mit denen die Containergruppe erstellt wird.
ImageRegistryCredential []
ipAddress
Der IP-Adressentyp der Containergruppe.
IpAddress
osType
Der für die Container in der Containergruppe erforderliche Betriebssystemtyp.
"Linux" "Windows" (erforderlich)
restartPolicy
Neustartrichtlinie für alle Container innerhalb der Containergruppe. Derzeit ist always
die einzige verfügbare Option .
"immer"
volumes
Die Liste der Volumes, die von Containern in dieser Containergruppe eingebunden werden können.
Volume []
Container
Name
BESCHREIBUNG
Wert
name
Der vom Benutzer bereitgestellte Name der Containerinstanz.
Zeichenfolge (erforderlich)
properties
Der Eigenschaften der Containerinstanz.
ContainerProperties (erforderlich)
ContainerProperties
Name
BESCHREIBUNG
Wert
command
Die innerhalb der Containerinstanz auszuführenden Befehle im EXEC-Format.
string[]
environmentVariables
Die in der Containerinstanz festzulegenden Umgebungsvariablen.
EnvironmentVariable []
image
Der Name des zum Erstellen der Containerinstanz verwendeten Images.
Zeichenfolge (erforderlich)
ports
Die in der Containerinstanz verfügbar gemachten Ports.
ContainerPort []
ressourcen
Die Ressourcenanforderungen der Containerinstanz.
ResourceRequirements (erforderlich)
volumeMounts
Die für die Containerinstanz verfügbaren Volumebereitstellungen.
VolumeMount []
EnvironmentVariable
Name
BESCHREIBUNG
Wert
name
Der Name der Umgebungsvariablen.
Zeichenfolge (erforderlich)
value
Der Wert der Umgebungsvariablen.
Zeichenfolge (erforderlich)
ContainerPort
Name
BESCHREIBUNG
Wert
port
Die innerhalb der Containergruppe verfügbar gemachte Portnummer.
int (erforderlich)
ResourceRerements
Name
BESCHREIBUNG
Wert
Grenzwerte
Die Ressourcenlimits dieser Containerinstanz.
ResourceLimits
requests
Die Ressourcenanforderungen dieser Containerinstanz.
ResourceRequests (erforderlich)
ResourceLimits
Name
BESCHREIBUNG
Wert
cpu
Das CPU-Limit dieser Containerinstanz.
INT
memoryInGB
Das Arbeitsspeicherlimit dieser Containerinstanz in GB. Verwenden Sie die json() -Funktion, um einen Dezimalwert anzugeben.
int oder json dezimal
ResourceRequests
Name
BESCHREIBUNG
Wert
cpu
Die CPU-Anforderungen dieser Containerinstanz.
int (erforderlich)
memoryInGB
Die Arbeitsspeicheranforderung dieser Containerinstanz in GB. Verwenden Sie die json() -Funktion, um einen Dezimalwert anzugeben.
int oder json decimal (erforderlich)
VolumeMount
Name
BESCHREIBUNG
Wert
mountPath
Der Pfad innerhalb des Containers, in dem das Volume bereitgestellt werden soll. Darf keinen Doppelpunkt (:) enthalten.
Zeichenfolge (erforderlich)
name
Der Name der Volumebereitstellung.
Zeichenfolge (erforderlich)
readOnly
Das Flag, das anzeigt, ob die Volumebereitstellung schreibgeschützt ist.
bool
ImageRegistryCredential
Name
BESCHREIBUNG
Wert
password
Das Kennwort für die private Registrierung.
Zeichenfolge
server
Der Docker-Imageregistrierungsserver ohne ein Protokoll wie „HTTP“ oder „HTTPS“.
Zeichenfolge (erforderlich)
username
Der Benutzername für die private Registrierung.
Zeichenfolge (erforderlich)
IpAddress
Name
BESCHREIBUNG
Wert
ip
Die dem öffentlichen Internet verfügbar gemachte IP-Adresse.
Zeichenfolge
ports
Die Liste der in der Containergruppe verfügbar gemachten Ports.
Port [] (erforderlich)
Typ
Gibt an, ob die IP-Adresse für das öffentliche Internet verfügbar gemacht wird.
"Öffentlich" (erforderlich)
Port
Name
BESCHREIBUNG
Wert
port
Die Portnummer.
int (erforderlich)
Protokoll
Das dem Port zugeordnete Protokoll.
"TCP" "UDP"
Lautstärke
Name
BESCHREIBUNG
Wert
azureFile
Der Name des Azure-Dateivolumes.
AzureFileVolume (erforderlich)
name
Der Name des Volumes.
Zeichenfolge (erforderlich)
AzureFileVolume
Name
BESCHREIBUNG
Wert
readOnly
Das Flag, das anzeigt, ob die als Volume bereitgestellte Azure File-Freigabe schreibgeschützt ist.
bool
shareName
Der Name der als Volume bereitzustellenden Azure File-Freigabe.
Zeichenfolge (erforderlich)
storageAccountKey
Der Zugriffsschlüssel des Speicherkontos, der für den Zugriff auf die Azure File-Freigabe verwendet wird.
Zeichenfolge
storageAccountName
Der Name des Speicherkontos, das die Azure File-Freigabe enthält.
Zeichenfolge (erforderlich)
Schnellstartvorlagen
In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.
Der Ressourcentyp containerGroups kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll .
Um eine Microsoft.ContainerInstance/containerGroups-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2017-08-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
containers = [
{
name = "string"
properties = {
command = [
"string"
]
environmentVariables = [
{
name = "string"
value = "string"
}
]
image = "string"
ports = [
{
port = int
}
]
resources = {
limits = {
cpu = int
memoryInGB = "decimal-as-string"
}
requests = {
cpu = int
memoryInGB = "decimal-as-string"
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
imageRegistryCredentials = [
{
password = "string"
server = "string"
username = "string"
}
]
ipAddress = {
ip = "string"
ports = [
{
port = int
protocol = "string"
}
]
type = "Public"
}
osType = "string"
restartPolicy = "always"
volumes = [
{
azureFile = {
readOnly = bool
shareName = "string"
storageAccountKey = "string"
storageAccountName = "string"
}
name = "string"
}
]
}
})
}
Eigenschaftswerte
containerGroups
Name
BESCHREIBUNG
Wert
type
Der Ressourcentyp
"Microsoft.ContainerInstance/containerGroups@2017-08-01-preview"
name
Der Ressourcenname
Zeichenfolge (erforderlich) Zeichenlimit: 1-63 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Darf nicht mit einem Bindestrich beginnen oder enden. Aufeinanderfolgende Bindestriche sind nicht zulässig.
location
Der Ressourcenspeicherort.
Zeichenfolge (erforderlich)
parent_id
Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe.
Zeichenfolge (erforderlich)
tags
Die Ressourcentags.
Wörterbuch der Tagnamen und -werte.
properties
ContainerGroupProperties (erforderlich)
ContainerGroupProperties
Name
BESCHREIBUNG
Wert
containers
Die Container innerhalb der Containergruppe.
Container [] (erforderlich)
imageRegistryCredentials
Die Anmeldeinformationen für die Imageregistrierung, mit denen die Containergruppe erstellt wird.
ImageRegistryCredential []
ipAddress
Der IP-Adressentyp der Containergruppe.
IpAddress
osType
Der für die Container in der Containergruppe erforderliche Betriebssystemtyp.
"Linux" "Windows" (erforderlich)
restartPolicy
Neustartrichtlinie für alle Container innerhalb der Containergruppe. Derzeit ist always
die einzige verfügbare Option .
„always“
volumes
Die Liste der Volumes, die von Containern in dieser Containergruppe eingebunden werden können.
Volume []
Container
Name
BESCHREIBUNG
Wert
name
Der vom Benutzer bereitgestellte Name der Containerinstanz.
Zeichenfolge (erforderlich)
properties
Der Eigenschaften der Containerinstanz.
ContainerProperties (erforderlich)
ContainerProperties
Name
BESCHREIBUNG
Wert
command
Die innerhalb der Containerinstanz auszuführenden Befehle im EXEC-Format.
string[]
environmentVariables
Die in der Containerinstanz festzulegenden Umgebungsvariablen.
EnvironmentVariable []
image
Der Name des zum Erstellen der Containerinstanz verwendeten Images.
Zeichenfolge (erforderlich)
ports
Die in der Containerinstanz verfügbar gemachten Ports.
ContainerPort []
ressourcen
Die Ressourcenanforderungen der Containerinstanz.
ResourceRequirements (erforderlich)
volumeMounts
Die für die Containerinstanz verfügbaren Volumebereitstellungen.
VolumeMount []
EnvironmentVariable
Name
BESCHREIBUNG
Wert
name
Der Name der Umgebungsvariablen.
Zeichenfolge (erforderlich)
value
Der Wert der Umgebungsvariablen.
Zeichenfolge (erforderlich)
ContainerPort
Name
BESCHREIBUNG
Wert
port
Die innerhalb der Containergruppe verfügbar gemachte Portnummer.
int (erforderlich)
ResourceRerements
Name
BESCHREIBUNG
Wert
Grenzwerte
Die Ressourcenlimits dieser Containerinstanz.
ResourceLimits
requests
Die Ressourcenanforderungen dieser Containerinstanz.
ResourceRequests (erforderlich)
ResourceLimits
Name
BESCHREIBUNG
Wert
cpu
Das CPU-Limit dieser Containerinstanz.
INT
memoryInGB
Das Arbeitsspeicherlimit dieser Containerinstanz in GB. Geben Sie einen Dezimalwert als Zeichenfolge an.
int oder json dezimal
ResourceRequests
Name
BESCHREIBUNG
Wert
cpu
Die CPU-Anforderungen dieser Containerinstanz.
int (erforderlich)
memoryInGB
Die Arbeitsspeicheranforderung dieser Containerinstanz in GB. Geben Sie einen Dezimalwert als Zeichenfolge an.
int oder json dezimal (erforderlich)
VolumeMount
Name
BESCHREIBUNG
Wert
mountPath
Der Pfad innerhalb des Containers, in dem das Volume bereitgestellt werden soll. Darf keinen Doppelpunkt (:) enthalten.
Zeichenfolge (erforderlich)
name
Der Name der Volumebereitstellung.
Zeichenfolge (erforderlich)
readOnly
Das Flag, das anzeigt, ob die Volumebereitstellung schreibgeschützt ist.
bool
ImageRegistryCredential
Name
BESCHREIBUNG
Wert
password
Das Kennwort für die private Registrierung.
Zeichenfolge
server
Der Docker-Imageregistrierungsserver ohne ein Protokoll wie „HTTP“ oder „HTTPS“.
Zeichenfolge (erforderlich)
username
Der Benutzername für die private Registrierung.
Zeichenfolge (erforderlich)
IpAddress
Name
BESCHREIBUNG
Wert
ip
Die dem öffentlichen Internet verfügbar gemachte IP-Adresse.
Zeichenfolge
ports
Die Liste der in der Containergruppe verfügbar gemachten Ports.
Port [] (erforderlich)
Typ
Gibt an, ob die IP-Adresse für das öffentliche Internet verfügbar gemacht wird.
"Öffentlich" (erforderlich)
Port
Name
BESCHREIBUNG
Wert
port
Die Portnummer.
int (erforderlich)
Protokoll
Das dem Port zugeordnete Protokoll.
"TCP" "UDP"
Volume
Name
BESCHREIBUNG
Wert
azureFile
Der Name des Azure-Dateivolumes.
AzureFileVolume (erforderlich)
name
Der Name des Volumes.
Zeichenfolge (erforderlich)
AzureFileVolume
Name
BESCHREIBUNG
Wert
readOnly
Das Flag, das anzeigt, ob die als Volume bereitgestellte Azure File-Freigabe schreibgeschützt ist.
bool
shareName
Der Name der als Volume bereitzustellenden Azure File-Freigabe.
Zeichenfolge (erforderlich)
storageAccountKey
Der Zugriffsschlüssel des Speicherkontos, der für den Zugriff auf die Azure File-Freigabe verwendet wird.
Zeichenfolge
storageAccountName
Der Name des Speicherkontos, das die Azure File-Freigabe enthält.
Zeichenfolge (erforderlich)