Akri Connector Template - Create Or Update

Dienst:: IoT Operations

API-Version:: 2026-03-01

Erstellen einer AkriConnectorTemplateResource

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTOperations/instances/{instanceName}/akriConnectorTemplates/{akriConnectorTemplateName}?api-version=2026-03-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
akriConnectorTemplateName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Name der AkriConnectorTemplate-Ressource.
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Name der Instanz.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Edgespeicherort der Ressource.
properties	AkriConnectorTemplateProperties	Die ressourcenspezifischen Eigenschaften für diese Ressource.

Antworten

Name	Typ	Beschreibung
200 OK	AkriConnectorTemplateResource	Der Aktualisierungsvorgang für die Ressource "AkriConnectorTemplateResource" war erfolgreich
201 Created	AkriConnectorTemplateResource	Der Erstellungsvorgang der Ressource 'AkriConnectorTemplateResource' war erfolgreich Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

AkriConnectorTemplateResource

Der Aktualisierungsvorgang für die Ressource "AkriConnectorTemplateResource" war erfolgreich

201 Created

AkriConnectorTemplateResource

Der Erstellungsvorgang der Ressource 'AkriConnectorTemplateResource' war erfolgreich

Header

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.IoTOperations/instances/resource-name123/akriConnectorTemplates/resource-name123?api-version=2026-03-01

{
  "properties": {
    "aioMetadata": {
      "aioMinVersion": "1.2.0",
      "aioMaxVersion": "1.4.0"
    },
    "runtimeConfiguration": {
      "runtimeConfigurationType": "ManagedConfiguration",
      "managedConfigurationSettings": {
        "managedConfigurationType": "ImageConfiguration",
        "imageConfigurationSettings": {
          "registrySettings": {
            "registrySettingsType": "ContainerRegistry",
            "containerRegistrySettings": {
              "registry": "akribuilds.azurecr.io"
            }
          },
          "imageName": "akri-connectors/rest",
          "tagDigestSettings": {
            "tagDigestType": "Tag",
            "tag": "0.5.0-20250825.4"
          }
        }
      }
    },
    "diagnostics": {
      "logs": {
        "level": "info"
      }
    },
    "deviceInboundEndpointTypes": [
      {
        "endpointType": "Microsoft.Rest",
        "version": "0.0.1"
      }
    ],
    "mqttConnectionConfiguration": {
      "authentication": {
        "method": "ServiceAccountToken",
        "serviceAccountTokenSettings": {
          "audience": "MQ-SAT"
        }
      },
      "host": "aio-broker:18883",
      "protocol": "Mqtt",
      "keepAliveSeconds": 10,
      "maxInflightMessages": 10,
      "sessionExpirySeconds": 60,
      "tls": {
        "mode": "Enabled",
        "trustedCaCertificateConfigMapRef": "azure-iot-operations-aio-ca-trust-bundle"
      }
    }
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "properties": {
    "provisioningState": "Succeeded",
    "aioMetadata": {
      "aioMinVersion": "1.2.0",
      "aioMaxVersion": "1.4.0"
    },
    "runtimeConfiguration": {
      "runtimeConfigurationType": "ManagedConfiguration",
      "managedConfigurationSettings": {
        "managedConfigurationType": "ImageConfiguration",
        "imageConfigurationSettings": {
          "registrySettings": {
            "registrySettingsType": "ContainerRegistry",
            "containerRegistrySettings": {
              "registry": "akribuilds.azurecr.io"
            }
          },
          "imageName": "akri-connectors/rest",
          "tagDigestSettings": {
            "tagDigestType": "Tag",
            "tag": "0.5.0-20250825.4"
          }
        }
      }
    },
    "diagnostics": {
      "logs": {
        "level": "info"
      }
    },
    "deviceInboundEndpointTypes": [
      {
        "endpointType": "Microsoft.Rest",
        "version": "0.0.1"
      }
    ],
    "mqttConnectionConfiguration": {
      "authentication": {
        "method": "ServiceAccountToken",
        "serviceAccountTokenSettings": {
          "audience": "MQ-SAT"
        }
      },
      "host": "aio-broker:18883",
      "protocol": "Mqtt",
      "keepAliveSeconds": 10,
      "maxInflightMessages": 10,
      "sessionExpirySeconds": 60,
      "tls": {
        "mode": "Enabled",
        "trustedCaCertificateConfigMapRef": "azure-iot-operations-aio-ca-trust-bundle"
      }
    }
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/akriConnectorTemplates/resource-name123",
  "name": "bfimycofjtzxduufwanuxwoudsh",
  "type": "wnabnudmydrgpccqusxkmsmgcwzwh",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Statuscode:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "provisioningState": "Accepted",
    "aioMetadata": {
      "aioMinVersion": "1.2.0",
      "aioMaxVersion": "1.4.0"
    },
    "runtimeConfiguration": {
      "runtimeConfigurationType": "ManagedConfiguration",
      "managedConfigurationSettings": {
        "managedConfigurationType": "ImageConfiguration",
        "imageConfigurationSettings": {
          "registrySettings": {
            "registrySettingsType": "ContainerRegistry",
            "containerRegistrySettings": {
              "registry": "akribuilds.azurecr.io"
            }
          },
          "imageName": "akri-connectors/rest",
          "tagDigestSettings": {
            "tagDigestType": "Tag",
            "tag": "0.5.0-20250825.4"
          }
        }
      }
    },
    "diagnostics": {
      "logs": {
        "level": "info"
      }
    },
    "deviceInboundEndpointTypes": [
      {
        "endpointType": "Microsoft.Rest",
        "version": "0.0.1"
      }
    ],
    "mqttConnectionConfiguration": {
      "authentication": {
        "method": "ServiceAccountToken",
        "serviceAccountTokenSettings": {
          "audience": "MQ-SAT"
        }
      },
      "host": "aio-broker:18883",
      "protocol": "Mqtt",
      "keepAliveSeconds": 10,
      "maxInflightMessages": 10,
      "sessionExpirySeconds": 60,
      "tls": {
        "mode": "Enabled",
        "trustedCaCertificateConfigMapRef": "azure-iot-operations-aio-ca-trust-bundle"
      }
    }
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup123/providers/Microsoft.IoTOperations/instances/resource-name123/akriConnectorTemplates/resource-name123",
  "name": "bfimycofjtzxduufwanuxwoudsh",
  "type": "wnabnudmydrgpccqusxkmsmgcwzwh",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Definitionen

Name	Beschreibung
AkriConnectorsContainerRegistry	AkriConnectorsContainerRegistry-Eigenschaften.
AkriConnectorsContainerRegistrySettings	AkriConnectorsContainerRegistry-Eigenschaften.
AkriConnectorsDiagnosticsLogs	Eigenschaften des AkriConnectorsDiagnoseprotokolls.
AkriConnectorsDigest	AkriConnectorsDigest-Eigenschaften.
AkriConnectorsImagePullPolicy	Bild-Pull-Richtlinie.
AkriConnectorsImagePullSecret	AkriConnectorsImagePullSecret-Eigenschaften.
AkriConnectorsMqttAuthenticationMethod	AkriConnectorsMqttAuthenticationMethod-Eigenschaften.
AkriConnectorsMqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration-Eigenschaften.
AkriConnectorsMqttProtocolType	Mqtt-Protokolltypen.
AkriConnectorsRegistryEndpointRef	AkriConnectorsRegistryEndpointRef-Eigenschaften.
AkriConnectorsRegistrySettingsType	AkriConnectorsRegistrySettings-Eigenschaften.
AkriConnectorsSecret	AkriConnectorsSecret-Eigenschaften.
AkriConnectorsServiceAccountAuthentication	AkriConnectorsServiceAccountAuthentication-Eigenschaften.
AkriConnectorsServiceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings-Eigenschaften.
AkriConnectorsTag	AkriConnectorsTag-Eigenschaften.
AkriConnectorsTagDigestType	AkriConnectorsTagDigestType-Werte.
AkriConnectorTemplateAioMetadata	AkriConnectorTemplateAioMetadata-Eigenschaften.
AkriConnectorTemplateAllocationPolicy	AkriConnectorTemplateAllocationPolicy-Eigenschaften.
AkriConnectorTemplateBucketizedAllocation	AkriConnectorTemplateBucketizedAllocation-Eigenschaften.
AkriConnectorTemplateDeviceInboundEndpointType	AkriConnectorTemplateDeviceInboundEndpointType-Eigenschaften.
AkriConnectorTemplateDiagnostics	AkriConnectorTemplateDiagnostics-Eigenschaften.
AkriConnectorTemplateManagedConfiguration	AkriConnectorTemplateManagedConfiguration-Eigenschaften.
AkriConnectorTemplateManagedConfigurationType	Verwaltete Konfigurationstypen.
AkriConnectorTemplatePersistentVolumeClaim	AkriConnectorTemplatePersistentVolumeClaim-Eigenschaften.
AkriConnectorTemplateProperties	AkriConnectorTemplate-Eigenschaften.
AkriConnectorTemplateResource	AkriConnectorTemplate-Ressource.
AkriConnectorTemplateRuntimeConfigurationType	Laufzeitkonfigurationstypen.
AkriConnectorTemplateRuntimeImageConfiguration	AkriConnectorTemplateRuntimeImageConfiguration-Eigenschaften.
AkriConnectorTemplateRuntimeImageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfiguration-Eigenschaften.
AkriConnectorTemplateRuntimeStatefulSetConfiguration	AkriConnectorTemplateRuntimeStatefulSetConfiguration-Eigenschaften.
AkriConnectorTemplateTrustList	AkriConnectorTemplateTrustList-Eigenschaften.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ExtendedLocation	Der erweiterte Standort ist eine Erweiterung von Azure-Standorten. Sie bieten eine Möglichkeit, ihre Azure ARC-fähigen Kubernetes-Cluster als Zielspeicherorte für die Bereitstellung von Azure-Dienstinstanzen zu verwenden.
ExtendedLocationType	Der Enumerationsdefinitionstyp von ExtendedLocation wird akzeptiert.
OperationalMode	Eigenschaften des Modus
ProvisioningState	Die Enumeration, die den Status der Ressource definiert.
ResourceHealthState	Der Integritätsstatus der Ressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TlsProperties	Tls-Eigenschaften

AkriConnectorsContainerRegistry

Objekt

AkriConnectorsContainerRegistry-Eigenschaften.

Name	Typ	Beschreibung
containerRegistrySettings	AkriConnectorsContainerRegistrySettings	Die Registrierungseinstellungen für die Containerregistrierung.
registrySettingsType	string: ContainerRegistry	AkriConnectorsRegistrySettings-Eigenschaften.

AkriConnectorsContainerRegistrySettings

Objekt

AkriConnectorsContainerRegistry-Eigenschaften.

Name	Typ	Beschreibung
imagePullSecrets	AkriConnectorsImagePullSecret[]	Optionale Liste von Verweisen auf Geheimnisse im selben Namespace, die zum Abrufen des Connectorimages verwendet werden sollen.
registry	string	Die Containerregistrierung, die für das Artefakt verwendet werden soll.

AkriConnectorsDiagnosticsLogs

Objekt

Eigenschaften des AkriConnectorsDiagnoseprotokolls.

Name	Typ	Standardwert	Beschreibung
level	string	info	Die Protokollebene. Beispiele : "debug", "info", "warn", "error", "trace".

AkriConnectorsDigest

Objekt

AkriConnectorsDigest-Eigenschaften.

Name	Typ	Beschreibung
digest	string	Die Zusammenfassung des Bildes.
tagDigestType	string: Digest	Der Tag- oder Digest-Typ.

AkriConnectorsImagePullPolicy

Enumeration

Bild-Pull-Richtlinie.

Wert	Beschreibung
Always	Ziehen Sie immer das Bild.
IfNotPresent	IfNotPresent rufen Sie das Bild ab.
Never	Ziehen Sie niemals das Bild.

AkriConnectorsImagePullSecret

Objekt

AkriConnectorsImagePullSecret-Eigenschaften.

Name	Typ	Beschreibung
secretRef	string	Der Name des geheimen Bildpulls.

AkriConnectorsMqttAuthenticationMethod

Enumeration

AkriConnectorsMqttAuthenticationMethod-Eigenschaften.

Wert	Beschreibung
ServiceAccountToken	Dienstkontotokenauthentifizierung.

AkriConnectorsMqttConnectionConfiguration

Objekt

AkriConnectorsMqttConnectionConfiguration-Eigenschaften.

Name	Typ	Beschreibung
authentication	AkriConnectorsMqttAuthentication: AkriConnectorsServiceAccountAuthentication	Authentifizierungseigenschaften.
host	string	Host des Brokers in Form von <hostname>:<port>.
keepAliveSeconds	integer (int32) minimum: 0	KeepAlive für eine Verbindung in Sekundenschnelle.
maxInflightMessages	integer (int32) minimum: 0	Die maximale Anzahl von Nachrichten, die im Test-Flight beibehalten werden sollen. Für abonniert ist dies der empfangshöchste Wert. Für die Veröffentlichung ist dies die maximale Anzahl von Nachrichten, die gesendet werden sollen, bevor sie auf einen Ck warten.
protocol	AkriConnectorsMqttProtocolType	Das Protokoll, das für die Verbindung verwendet werden soll. Derzeit wird nur `mqtt` unterstützt.
sessionExpirySeconds	integer (int32) minimum: 0	Sitzung läuft in Sekunden ab.
tls	TlsProperties	TLS-Konfiguration.

AkriConnectorsMqttProtocolType

Enumeration

Mqtt-Protokolltypen.

Wert	Beschreibung
Mqtt	Mqtt-Protokoll.

AkriConnectorsRegistryEndpointRef

Objekt

AkriConnectorsRegistryEndpointRef-Eigenschaften.

Name	Typ	Beschreibung
registryEndpointRef	string	Der Name des Registrierungsendpunkts.
registrySettingsType	string: RegistryEndpointRef	AkriConnectorsRegistrySettings-Eigenschaften.

AkriConnectorsRegistrySettingsType

Enumeration

AkriConnectorsRegistrySettings-Eigenschaften.

Wert	Beschreibung
RegistryEndpointRef	Eine Referenz zum Registrierungsendpunkt.
ContainerRegistry	Eine Container Registry-Referenz.

AkriConnectorsSecret

Objekt

AkriConnectorsSecret-Eigenschaften.

Name	Typ	Beschreibung
secretAlias	string	Der anwendungsdefinierte Alias für den geheimen Schlüssel.
secretKey	string	Der Schlüssel in dem Geheimnis, das gemountet werden soll.
secretRef	string	Der Name des Geheimnisses, das bereitgestellt werden soll.

AkriConnectorsServiceAccountAuthentication

Objekt

AkriConnectorsServiceAccountAuthentication-Eigenschaften.

Name	Typ	Beschreibung
method	string: ServiceAccountToken	Die Authentifizierungsmethode für die MQTT-Verbindung.
serviceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings	Das Dienstkonto-Token für die MQTT-Verbindung.

AkriConnectorsServiceAccountTokenSettings

Objekt

AkriConnectorsServiceAccountTokenSettings-Eigenschaften.

Name	Typ	Beschreibung
audience	string	Die Zielgruppe für das Dienstkontotoken.

AkriConnectorsTag

Objekt

AkriConnectorsTag-Eigenschaften.

Name	Typ	Beschreibung
tag	string	Das Tag des Bildes.
tagDigestType	string: Tag	Der Tag- oder Digest-Typ.

AkriConnectorsTagDigestType

Enumeration

AkriConnectorsTagDigestType-Werte.

Wert	Beschreibung
Tag	Gibt an, dass ein Tag angegeben werden soll.
Digest	Gibt an, dass ein Digest angegeben werden soll.

AkriConnectorTemplateAioMetadata

Objekt

AkriConnectorTemplateAioMetadata-Eigenschaften.

Name	Typ	Beschreibung
aioMaxVersion	string	Die maximale Version von AIO, die für den Connector erforderlich ist.
aioMinVersion	string	Die Mindestversion von AIO, die für den Connector erforderlich ist.

AkriConnectorTemplateAllocationPolicy

Enumeration

AkriConnectorTemplateAllocationPolicy-Eigenschaften.

Wert	Beschreibung
Bucketized	Bucket-Zuordnungsrichtlinie.

AkriConnectorTemplateBucketizedAllocation

Objekt

AkriConnectorTemplateBucketizedAllocation-Eigenschaften.

Name	Typ	Beschreibung
bucketSize	integer (int32) minimum: 1 maximum: 100	Die Bucket-Zuweisung von AEPs für Konnektoren.
policy	string: Bucketized	Der Typ der Zuordnungsrichtlinie.

AkriConnectorTemplateDeviceInboundEndpointType

Objekt

AkriConnectorTemplateDeviceInboundEndpointType-Eigenschaften.

Name	Typ	Beschreibung
displayName	string	Der Anzeigename des eingehenden Endpunkts des Geräts.
endpointType	string minLength: 1	Der Typ des eingehenden Endpunkts des Geräts.
version	string minLength: 1	Die Version des eingehenden Endpunkts des Geräts.

AkriConnectorTemplateDiagnostics

Objekt

AkriConnectorTemplateDiagnostics-Eigenschaften.

Name	Typ	Beschreibung
logs	AkriConnectorsDiagnosticsLogs	Die Protokolleinstellungen für die Connectorvorlage.

AkriConnectorTemplateManagedConfiguration

Objekt

AkriConnectorTemplateManagedConfiguration-Eigenschaften.

Name	Typ	Beschreibung
managedConfigurationSettings	AkriConnectorTemplateManagedConfigurationSettings: AkriConnectorTemplateRuntimeImageConfiguration AkriConnectorTemplateRuntimeStatefulSetConfiguration	Die verwalteten Konfigurationseinstellungen.
runtimeConfigurationType	string: ManagedConfiguration	Laufzeitkonfigurationstyp für die Connectorvorlage.

AkriConnectorTemplateManagedConfigurationType

Enumeration

Verwaltete Konfigurationstypen.

Wert	Beschreibung
ImageConfiguration	Art der Image-Konfiguration.
StatefulSetConfiguration	StatefulSet-Konfigurationstyp.

AkriConnectorTemplatePersistentVolumeClaim

Objekt

AkriConnectorTemplatePersistentVolumeClaim-Eigenschaften.

Name	Typ	Beschreibung
claimName	string	Der Name des Anspruchs auf ein persistentes Volume.
mountPath	string	Der Bereitstellungspfad für den Anspruch auf ein persistentes Volume.

AkriConnectorTemplateProperties

Objekt

AkriConnectorTemplate-Eigenschaften.

Name	Typ	Standardwert	Beschreibung
aioMetadata	AkriConnectorTemplateAioMetadata		Metadaten über AIO.
connectorMetadataRef	string		Ein Verweis auf einen Verweis auf ein Connectormetadatendokument in einer Containerregistrierung.
deviceInboundEndpointTypes	AkriConnectorTemplateDeviceInboundEndpointType[]		Typen von eingehenden Endpunkten für Geräte.
diagnostics	AkriConnectorTemplateDiagnostics		Diagnoseeinstellungen für die Connectorvorlage.
healthState	ResourceHealthState	Unknown	Der Integritätsstatus der Ressource.
mqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration		Konfigurationseinstellungen für Mqtt-Verbindungen.
provisioningState	ProvisioningState		Der Status des letzten Vorgangs.
runtimeConfiguration	AkriConnectorTemplateRuntimeConfiguration: AkriConnectorTemplateManagedConfiguration		Die Laufzeitkonfiguration für die Connectorvorlage.

AkriConnectorTemplateResource

Objekt

AkriConnectorTemplate-Ressource.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Edgespeicherort der Ressource.
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	AkriConnectorTemplateProperties	Die ressourcenspezifischen Eigenschaften für diese Ressource.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

AkriConnectorTemplateRuntimeConfigurationType

Enumeration

Laufzeitkonfigurationstypen.

Wert	Beschreibung
ManagedConfiguration	Verwalteter Konfigurationstyp.

AkriConnectorTemplateRuntimeImageConfiguration

Objekt

AkriConnectorTemplateRuntimeImageConfiguration-Eigenschaften.

Name	Typ	Beschreibung
additionalConfiguration	object	Zusätzliche Konfiguration für das Image der verwalteten Konfiguration.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Zuordnungseinstellungen für die verwaltete Konfiguration.
imageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfigurationSettings	Die Einstellungen für die Bildkonfiguration.
managedConfigurationType	string: ImageConfiguration	Der Typ der verwalteten Konfiguration.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Die Anspruchsvorlagen für persistente Datenträger für die verwaltete Konfiguration. Siehe https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	Der persistente Datenträgeranspruch für die verwaltete Konfiguration.
secrets	AkriConnectorsSecret[]	Connectorgeheimnisse, die für alle Connectorinstanzen bereitgestellt werden.
trustSettings	AkriConnectorTemplateTrustList	Vertrauensliste für den Connector. Dies wird verwendet, um die Zertifikate anzugeben, denen alle Connectorinstanzen vertrauen sollen.

AkriConnectorTemplateRuntimeImageConfigurationSettings

Objekt

AkriConnectorTemplateRuntimeImageConfiguration-Eigenschaften.

Name	Typ	Beschreibung
imageName	string	Der Imagename ohne Registrierungsverweis, Tag oder Digest.
imagePullPolicy	AkriConnectorsImagePullPolicy	Die Pull-Richtlinie des Bildes.
registrySettings	AkriConnectorsRegistrySettings: AkriConnectorsContainerRegistry AkriConnectorsRegistryEndpointRef	Die Registrierungseinstellungen für das Image. Sie können dieses Feld weglassen, wenn Sie das standardmäßige Docker Hub-Repository oder ein lokales Image verwenden.
replicas	integer (int32)	Die Anzahl der Replikate, die eingerichtet werden sollen.
tagDigestSettings	AkriConnectorsTagDigestSettings: AkriConnectorsDigest AkriConnectorsTag	Optionales Image-Tag oder Digest. Wenn nicht angegeben, ist `latest`das Standard-Tag .

AkriConnectorTemplateRuntimeStatefulSetConfiguration

Objekt

AkriConnectorTemplateRuntimeStatefulSetConfiguration-Eigenschaften.

Name	Typ	Beschreibung
additionalConfiguration	object	Zusätzliche Konfiguration für das Image der verwalteten Konfiguration.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Zuordnungseinstellungen für die verwaltete Konfiguration.
managedConfigurationType	string: StatefulSetConfiguration	Der Typ der verwalteten Konfiguration.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Die Anspruchsvorlagen für persistente Datenträger für die verwaltete Konfiguration. Siehe https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	Der persistente Datenträgeranspruch für die verwaltete Konfiguration.
secrets	AkriConnectorsSecret[]	Connectorgeheimnisse, die für alle Connectorinstanzen bereitgestellt werden.
statefulSetConfigurationSettings		Der zustandsbehaftete Satz der Konfigurationseinstellungen. Dies entspricht der Kubernetes StatefulSet-Ressource. Siehe https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json#/components/schemas/io.k8s.api.apps.v1.StatefulSetSpec.
trustSettings	AkriConnectorTemplateTrustList	Vertrauensliste für den Connector. Dies wird verwendet, um die Zertifikate anzugeben, denen alle Connectorinstanzen vertrauen sollen.

AkriConnectorTemplateTrustList

Objekt

AkriConnectorTemplateTrustList-Eigenschaften.

Name	Typ	Beschreibung
trustListSecretRef	string	Die geheime Referenz für Zertifikate, denen vertraut werden soll.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ExtendedLocation

Objekt

Der erweiterte Standort ist eine Erweiterung von Azure-Standorten. Sie bieten eine Möglichkeit, ihre Azure ARC-fähigen Kubernetes-Cluster als Zielspeicherorte für die Bereitstellung von Azure-Dienstinstanzen zu verwenden.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationType	Typ von ExtendedLocation.

ExtendedLocationType

Enumeration

Der Enumerationsdefinitionstyp von ExtendedLocation wird akzeptiert.

Wert	Beschreibung
CustomLocation	CustomLocation-Typ

OperationalMode

Enumeration

Eigenschaften des Modus

Wert	Beschreibung
Enabled	Aktiviert entspricht True
Disabled	Deaktiviert entspricht False.

ProvisioningState

Enumeration

Die Enumeration, die den Status der Ressource definiert.

Wert	Beschreibung
Succeeded	Ressource wurde erstellt.
Failed	Fehler bei der Ressourcenerstellung.
Canceled	Die Ressourcenerstellung wurde abgebrochen.
Provisioning	Die Ressource wird bereitgestellt.
Updating	Ressource wird aktualisiert.
Deleting	Ressource wird gelöscht.
Accepted	Die Ressource wurde akzeptiert.

ResourceHealthState

Enumeration

Der Integritätsstatus der Ressource.

Wert	Beschreibung
Available	Die Ressource ist verfügbar und funktioniert wie erwartet.
Degraded	Die Ressourcenintegrität wird herabgestuft.
Unavailable	Die Ressource funktioniert nicht wie erwartet.
Unknown	Der Ressourcenstatus ist unbekannt.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TlsProperties

Objekt

Tls-Eigenschaften

Name	Typ	Standardwert	Beschreibung
mode	OperationalMode	Enabled	Modus für TLS.
trustedCaCertificateConfigMapRef	string		Konfigurationszuordnung für vertrauenswürdige Zertifizierungsstellen.

Freigeben über

Akri Connector Template - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AkriConnectorsContainerRegistry

AkriConnectorsContainerRegistrySettings

AkriConnectorsDiagnosticsLogs

AkriConnectorsDigest

AkriConnectorsImagePullPolicy

AkriConnectorsImagePullSecret

AkriConnectorsMqttAuthenticationMethod

AkriConnectorsMqttConnectionConfiguration

AkriConnectorsMqttProtocolType

AkriConnectorsRegistryEndpointRef

AkriConnectorsRegistrySettingsType

AkriConnectorsSecret

AkriConnectorsServiceAccountAuthentication

AkriConnectorsServiceAccountTokenSettings

AkriConnectorsTag

AkriConnectorsTagDigestType

AkriConnectorTemplateAioMetadata

AkriConnectorTemplateAllocationPolicy

AkriConnectorTemplateBucketizedAllocation

AkriConnectorTemplateDeviceInboundEndpointType

AkriConnectorTemplateDiagnostics

AkriConnectorTemplateManagedConfiguration

AkriConnectorTemplateManagedConfigurationType

AkriConnectorTemplatePersistentVolumeClaim

AkriConnectorTemplateProperties

AkriConnectorTemplateResource

AkriConnectorTemplateRuntimeConfigurationType

AkriConnectorTemplateRuntimeImageConfiguration

AkriConnectorTemplateRuntimeImageConfigurationSettings

AkriConnectorTemplateRuntimeStatefulSetConfiguration

AkriConnectorTemplateTrustList

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

OperationalMode

ProvisioningState

ResourceHealthState

systemData

TlsProperties