Akri Connector Template - Create Or Update

Servizio:: IoT Operations

Versione API:: 2026-03-01

Creare un AkriConnectorTemplateResource

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
akriConnectorTemplateName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome della risorsa AkriConnectorTemplate.
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome dell'istanza.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	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	Tipo	Descrizione
extendedLocation	ExtendedLocation	Posizione perimetrale della risorsa.
properties	AkriConnectorTemplateProperties	Proprietà specifiche della risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	AkriConnectorTemplateResource	Operazione di aggiornamento della risorsa 'AkriConnectorTemplateResource' riuscita
201 Created	AkriConnectorTemplateResource	Operazione di creazione della risorsa 'AkriConnectorTemplateResource' riuscita Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

AkriConnectorTemplateResource

Operazione di aggiornamento della risorsa 'AkriConnectorTemplateResource' riuscita

201 Created

AkriConnectorTemplateResource

Operazione di creazione della risorsa 'AkriConnectorTemplateResource' riuscita

Intestazioni

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Esempio di richiesta

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"
  }
}

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
AkriConnectorsContainerRegistry	Proprietà AkriConnectorsContainerRegistry.
AkriConnectorsContainerRegistrySettings	Proprietà AkriConnectorsContainerRegistry.
AkriConnectorsDiagnosticsLogs	Proprietà del registro AkriConnectorsDiagnostic.
AkriConnectorsDigest	Proprietà AkriConnectorsDigest.
AkriConnectorsImagePullPolicy	Criteri pull delle immagini.
AkriConnectorsImagePullSecret	Proprietà AkriConnectorsImagePullSecret.
AkriConnectorsMqttAuthenticationMethod	Proprietà AkriConnectorsMqttAuthenticationMethod.
AkriConnectorsMqttConnectionConfiguration	Proprietà AkriConnectorsMqttConnectionConfiguration.
AkriConnectorsMqttProtocolType	Tipi di protocollo Mqtt.
AkriConnectorsRegistryEndpointRef	Proprietà AkriConnectorsRegistryEndpointRef.
AkriConnectorsRegistrySettingsType	Proprietà AkriConnectorsRegistrySettings.
AkriConnectorsSecret	Proprietà AkriConnectorsSecret.
AkriConnectorsServiceAccountAuthentication	Proprietà AkriConnectorsServiceAccountAuthentication.
AkriConnectorsServiceAccountTokenSettings	Proprietà AkriConnectorsServiceAccountTokenSettings.
AkriConnectorsTag	Proprietà AkriConnectorsTag.
AkriConnectorsTagDigestType	Valori AkriConnectorsTagDigestType.
AkriConnectorTemplateAioMetadata	Proprietà AkriConnectorTemplateAioMetadata.
AkriConnectorTemplateAllocationPolicy	Proprietà AkriConnectorTemplateAllocationPolicy.
AkriConnectorTemplateBucketizedAllocation	Proprietà AkriConnectorTemplateBucketizedAlbication.
AkriConnectorTemplateDeviceInboundEndpointType	Proprietà AkriConnectorTemplateDeviceInboundEndpointType.
AkriConnectorTemplateDiagnostics	Proprietà AkriConnectorTemplateDiagnostics.
AkriConnectorTemplateManagedConfiguration	Proprietà AkriConnectorTemplateManagedConfiguration.
AkriConnectorTemplateManagedConfigurationType	Tipi di configurazione gestiti.
AkriConnectorTemplatePersistentVolumeClaim	Proprietà AkriConnectorTemplatePersistentVolumeClaim.
AkriConnectorTemplateProperties	Proprietà AkriConnectorTemplate.
AkriConnectorTemplateResource	AkriConnectorTemplate.
AkriConnectorTemplateRuntimeConfigurationType	Tipi di configurazione di runtime.
AkriConnectorTemplateRuntimeImageConfiguration	Proprietà AkriConnectorTemplateRuntimeImageConfiguration.
AkriConnectorTemplateRuntimeImageConfigurationSettings	Proprietà AkriConnectorTemplateRuntimeImageConfiguration.
AkriConnectorTemplateRuntimeStatefulSetConfiguration	Proprietà AkriConnectorTemplateRuntimeStatefulSetConfiguration.
AkriConnectorTemplateTrustList	Proprietà AkriConnectorTemplateTrustList.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	La posizione estesa è un'estensione delle posizioni di Azure. Forniscono un modo per usare i cluster Kubernetes abilitati per Azure ARC come posizioni di destinazione per la distribuzione delle istanze dei servizi di Azure.
ExtendedLocationType	Tipo di enumerazione che definisce ExtendedLocation accettato.
OperationalMode	Proprietà della modalità
ProvisioningState	L'enumerazione che definisce lo stato della risorsa.
ResourceHealthState	Stato di integrità della risorsa.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TlsProperties	Proprietà Tls

AkriConnectorsContainerRegistry

Oggetto

Proprietà AkriConnectorsContainerRegistry.

Nome	Tipo	Descrizione
containerRegistrySettings	AkriConnectorsContainerRegistrySettings	Impostazioni del Registro di sistema per il Registro contenitori.
registrySettingsType	string: ContainerRegistry	Proprietà AkriConnectorsRegistrySettings.

AkriConnectorsContainerRegistrySettings

Oggetto

Proprietà AkriConnectorsContainerRegistry.

Nome	Tipo	Descrizione
imagePullSecrets	AkriConnectorsImagePullSecret[]	Elenco facoltativo di riferimenti ai segreti nello stesso spazio dei nomi da usare per il pull dell'immagine del connettore.
registry	string	Registro contenitori da utilizzare per l'artefatto.

AkriConnectorsDiagnosticsLogs

Oggetto

Proprietà del registro AkriConnectorsDiagnostic.

Nome	Tipo	Valore predefinito	Descrizione
level	string	info	Livello di registrazione. Esempi: 'debug', 'info', 'warn', 'error', 'trace'.

AkriConnectorsDigest

Oggetto

Proprietà AkriConnectorsDigest.

Nome	Tipo	Descrizione
digest	string	Il riassunto dell'immagine.
tagDigestType	string: Digest	Il tipo di tag o digest.

AkriConnectorsImagePullPolicy

Enumerazione

Criteri pull delle immagini.

Valore	Descrizione
Always	Estrai sempre l'immagine.
IfNotPresent	IfNotPresent estrae l'immagine.
Never	Non tirare mai l'immagine.

AkriConnectorsImagePullSecret

Oggetto

Proprietà AkriConnectorsImagePullSecret.

Nome	Tipo	Descrizione
secretRef	string	Nome del segreto pull dell'immagine.

AkriConnectorsMqttAuthenticationMethod

Enumerazione

Proprietà AkriConnectorsMqttAuthenticationMethod.

Valore	Descrizione
ServiceAccountToken	Autenticazione del token dell'account del servizio.

AkriConnectorsMqttConnectionConfiguration

Oggetto

Proprietà AkriConnectorsMqttConnectionConfiguration.

Nome	Tipo	Descrizione
authentication	AkriConnectorsMqttAuthentication: AkriConnectorsServiceAccountAuthentication	Proprietà di autenticazione.
host	string	Host del broker sotto forma di <nome host>: porta<>.
keepAliveSeconds	integer (int32) minimum: 0	KeepAlive per la connessione in pochi secondi.
maxInflightMessages	integer (int32) minimum: 0	Numero massimo di messaggi da mantenere in anteprima. Per la sottoscrizione, si tratta del valore massimo di ricezione. Per la pubblicazione, si tratta del numero massimo di messaggi da inviare prima di attendere un ack.
protocol	AkriConnectorsMqttProtocolType	Protocollo da utilizzare per la connessione. Attualmente è supportato solo `mqtt` .
sessionExpirySeconds	integer (int32) minimum: 0	La scadenza della sessione è in secondi.
tls	TlsProperties	Configurazione tls.

AkriConnectorsMqttProtocolType

Enumerazione

Tipi di protocollo Mqtt.

Valore	Descrizione
Mqtt	Protocollo Mqtt.

AkriConnectorsRegistryEndpointRef

Oggetto

Proprietà AkriConnectorsRegistryEndpointRef.

Nome	Tipo	Descrizione
registryEndpointRef	string	Nome dell'endpoint del Registro di sistema.
registrySettingsType	string: RegistryEndpointRef	Proprietà AkriConnectorsRegistrySettings.

AkriConnectorsRegistrySettingsType

Enumerazione

Proprietà AkriConnectorsRegistrySettings.

Valore	Descrizione
RegistryEndpointRef	Riferimento all'endpoint del Registro di sistema.
ContainerRegistry	Informazioni di riferimento su Registro contenitori.

AkriConnectorsSecret

Oggetto

Proprietà AkriConnectorsSecret.

Nome	Tipo	Descrizione
secretAlias	string	Alias definito dall'applicazione per il segreto.
secretKey	string	La chiave nel segreto da montare.
secretRef	string	Il nome del segreto da montare.

AkriConnectorsServiceAccountAuthentication

Oggetto

Proprietà AkriConnectorsServiceAccountAuthentication.

Nome	Tipo	Descrizione
method	string: ServiceAccountToken	Il metodo di autenticazione per la connessione MQTT.
serviceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings	Il token dell'account di servizio per la connessione MQTT.

AkriConnectorsServiceAccountTokenSettings

Oggetto

Proprietà AkriConnectorsServiceAccountTokenSettings.

Nome	Tipo	Descrizione
audience	string	Destinatari per il token dell'account del servizio.

AkriConnectorsTag

Oggetto

Proprietà AkriConnectorsTag.

Nome	Tipo	Descrizione
tag	string	Il tag dell'immagine.
tagDigestType	string: Tag	Il tipo di tag o digest.

AkriConnectorsTagDigestType

Enumerazione

Valori AkriConnectorsTagDigestType.

Valore	Descrizione
Tag	Indica che deve essere specificato un tag.
Digest	Indica che è necessario specificare un digest.

AkriConnectorTemplateAioMetadata

Oggetto

Proprietà AkriConnectorTemplateAioMetadata.

Nome	Tipo	Descrizione
aioMaxVersion	string	La versione massima di AIO richiesta per il connettore.
aioMinVersion	string	La versione minima di AIO richiesta per il connettore.

AkriConnectorTemplateAllocationPolicy

Enumerazione

Proprietà AkriConnectorTemplateAllocationPolicy.

Valore	Descrizione
Bucketized	Criteri di allocazione raggruppati.

AkriConnectorTemplateBucketizedAllocation

Oggetto

Proprietà AkriConnectorTemplateBucketizedAlbication.

Nome	Tipo	Descrizione
bucketSize	integer (int32) minimum: 1 maximum: 100	L'allocazione a bucket di AEP per i connettori.
policy	string: Bucketized	Tipo di criterio di allocazione.

AkriConnectorTemplateDeviceInboundEndpointType

Oggetto

Proprietà AkriConnectorTemplateDeviceInboundEndpointType.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'endpoint in ingresso del dispositivo.
endpointType	string minLength: 1	Tipo di endpoint in ingresso del dispositivo.
version	string minLength: 1	Versione dell'endpoint in ingresso del dispositivo.

AkriConnectorTemplateDiagnostics

Oggetto

Proprietà AkriConnectorTemplateDiagnostics.

Nome	Tipo	Descrizione
logs	AkriConnectorsDiagnosticsLogs	Impostazioni del registro per il modello di connettore.

AkriConnectorTemplateManagedConfiguration

Oggetto

Proprietà AkriConnectorTemplateManagedConfiguration.

Nome	Tipo	Descrizione
managedConfigurationSettings	AkriConnectorTemplateManagedConfigurationSettings: AkriConnectorTemplateRuntimeImageConfiguration AkriConnectorTemplateRuntimeStatefulSetConfiguration	Le impostazioni di configurazione gestite.
runtimeConfigurationType	string: ManagedConfiguration	Tipo di configurazione di runtime per il modello di connettore.

AkriConnectorTemplateManagedConfigurationType

Enumerazione

Tipi di configurazione gestiti.

Valore	Descrizione
ImageConfiguration	Tipo di configurazione dell'immagine.
StatefulSetConfiguration	Tipo di configurazione StatefulSet.

AkriConnectorTemplatePersistentVolumeClaim

Oggetto

Proprietà AkriConnectorTemplatePersistentVolumeClaim.

Nome	Tipo	Descrizione
claimName	string	Nome dell'attestazione di volume persistente.
mountPath	string	Percorso di montaggio per l'attestazione di volume persistente.

AkriConnectorTemplateProperties

Oggetto

Proprietà AkriConnectorTemplate.

Nome	Tipo	Valore predefinito	Descrizione
aioMetadata	AkriConnectorTemplateAioMetadata		Metadati su AIO.
connectorMetadataRef	string		Riferimento a un riferimento a un documento di metadati del connettore in un registro contenitori.
deviceInboundEndpointTypes	AkriConnectorTemplateDeviceInboundEndpointType[]		Tipi di endpoint in ingresso del dispositivo.
diagnostics	AkriConnectorTemplateDiagnostics		Impostazioni di diagnostica per il modello di connettore.
healthState	ResourceHealthState	Unknown	Stato di integrità della risorsa.
mqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration		Impostazioni di configurazione della connessione Mqtt.
provisioningState	ProvisioningState		Stato dell'ultima operazione.
runtimeConfiguration	AkriConnectorTemplateRuntimeConfiguration: AkriConnectorTemplateManagedConfiguration		Configurazione di runtime per il modello di connettore.

AkriConnectorTemplateResource

Oggetto

AkriConnectorTemplate.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	Posizione perimetrale della risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	AkriConnectorTemplateProperties	Proprietà specifiche della risorsa.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AkriConnectorTemplateRuntimeConfigurationType

Enumerazione

Tipi di configurazione di runtime.

Valore	Descrizione
ManagedConfiguration	Tipo di configurazione gestita.

AkriConnectorTemplateRuntimeImageConfiguration

Oggetto

Proprietà AkriConnectorTemplateRuntimeImageConfiguration.

Nome	Tipo	Descrizione
additionalConfiguration	object	Configurazione aggiuntiva per l'immagine della configurazione gestita.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Impostazioni di allocazione per la configurazione gestita.
imageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfigurationSettings	Le impostazioni di configurazione dell'immagine.
managedConfigurationType	string: ImageConfiguration	Tipo di configurazione gestita.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Modelli di attestazione del volume persistenti per la configurazione gestita. Vedi https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	Le attestazioni del volume persistente per la configurazione gestita.
secrets	AkriConnectorsSecret[]	Segreti del connettore che verranno montati in tutte le istanze del connettore.
trustSettings	AkriConnectorTemplateTrustList	Elenco di attendibilità per il connettore. Viene utilizzato per specificare i certificati che tutte le istanze del connettore devono considerare attendibili.

AkriConnectorTemplateRuntimeImageConfigurationSettings

Oggetto

Proprietà AkriConnectorTemplateRuntimeImageConfiguration.

Nome	Tipo	Descrizione
imageName	string	Il nome dell'immagine senza alcun riferimento al Registro di sistema, tag o digest.
imagePullPolicy	AkriConnectorsImagePullPolicy	Criteri pull dell'immagine.
registrySettings	AkriConnectorsRegistrySettings: AkriConnectorsContainerRegistry AkriConnectorsRegistryEndpointRef	Impostazioni del Registro di sistema per l'immagine. È possibile omettere questo campo se si utilizza il repository docker hub predefinito o se si utilizza un'immagine locale.
replicas	integer (int32)	Numero di repliche da configurare.
tagDigestSettings	AkriConnectorsTagDigestSettings: AkriConnectorsDigest AkriConnectorsTag	Tag immagine o digest opzionale. Se non specificato, il tag predefinito è `latest`.

AkriConnectorTemplateRuntimeStatefulSetConfiguration

Oggetto

Proprietà AkriConnectorTemplateRuntimeStatefulSetConfiguration.

Nome	Tipo	Descrizione
additionalConfiguration	object	Configurazione aggiuntiva per l'immagine della configurazione gestita.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Impostazioni di allocazione per la configurazione gestita.
managedConfigurationType	string: StatefulSetConfiguration	Tipo di configurazione gestita.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Modelli di attestazione del volume persistenti per la configurazione gestita. Vedi https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	Le attestazioni del volume persistente per la configurazione gestita.
secrets	AkriConnectorsSecret[]	Segreti del connettore che verranno montati in tutte le istanze del connettore.
statefulSetConfigurationSettings		Le impostazioni di configurazione impostate con stato. Corrisponde alla risorsa Kubernetes StatefulSet. Fare riferimento a 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	Elenco di attendibilità per il connettore. Viene utilizzato per specificare i certificati che tutte le istanze del connettore devono considerare attendibili.

AkriConnectorTemplateTrustList

Oggetto

Proprietà AkriConnectorTemplateTrustList.

Nome	Tipo	Descrizione
trustListSecretRef	string	Riferimento segreto per i certificati da considerare attendibili.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Oggetto

La posizione estesa è un'estensione delle posizioni di Azure. Forniscono un modo per usare i cluster Kubernetes abilitati per Azure ARC come posizioni di destinazione per la distribuzione delle istanze dei servizi di Azure.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationType	Tipo di ExtendedLocation.

ExtendedLocationType

Enumerazione

Tipo di enumerazione che definisce ExtendedLocation accettato.

Valore	Descrizione
CustomLocation	Tipo di posizione personalizzata

OperationalMode

Enumerazione

Proprietà della modalità

Valore	Descrizione
Enabled	Enabled equivale a True
Disabled	Disabilitato equivale a Falso.

ProvisioningState

Enumerazione

L'enumerazione che definisce lo stato della risorsa.

Valore	Descrizione
Succeeded	La risorsa è stata creata.
Failed	Creazione della risorsa non riuscita.
Canceled	La creazione delle risorse è stata annullata.
Provisioning	È in corso il provisioning della risorsa.
Updating	La risorsa è in fase di aggiornamento.
Deleting	La risorsa è in fase di eliminazione.
Accepted	La risorsa è stata accettata.

ResourceHealthState

Enumerazione

Stato di integrità della risorsa.

Valore	Descrizione
Available	La risorsa è disponibile e funziona come previsto.
Degraded	L'integrità delle risorse è ridotta.
Unavailable	La risorsa non funziona come previsto.
Unknown	Lo stato della risorsa è sconosciuto.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TlsProperties

Oggetto

Proprietà Tls

Nome	Tipo	Valore predefinito	Descrizione
mode	OperationalMode	Enabled	Modalità per TLS.
trustedCaCertificateConfigMapRef	string		Mappa di configurazione del certificato CA attendibile.

Condividi tramite

Akri Connector Template - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Esempio di richiesta

Risposta di esempio

Definizioni

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