Akri Connector Template - Create Or Update

Serviço:: IoT Operations

Versão da API:: 2026-03-01

Criar um AkriConnectorTemplateResource

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
akriConnectorTemplateName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome do recurso AkriConnectorTemplate.
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome da instância.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
extendedLocation	ExtendedLocation	Local de borda do recurso.
properties	AkriConnectorTemplateProperties	As propriedades específicas do recurso para esse recurso.

Respostas

Nome	Tipo	Description
200 OK	AkriConnectorTemplateResource	Operação de atualização do recurso 'AkriConnectorTemplateResource' bem-sucedida
201 Created	AkriConnectorTemplateResource	Recurso 'AkriConnectorTemplateResource' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

AkriConnectorTemplateResource

Operação de atualização do recurso 'AkriConnectorTemplateResource' bem-sucedida

201 Created

AkriConnectorTemplateResource

Recurso 'AkriConnectorTemplateResource' criar operação bem-sucedida

Cabeçalhos

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
  }
}

Código de status:: 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"
  }
}

Definições

Nome	Description
AkriConnectorsContainerRegistry	Propriedades AkriConnectorsContainerRegistry.
AkriConnectorsContainerRegistrySettings	Propriedades AkriConnectorsContainerRegistry.
AkriConnectorsDiagnosticsLogs	Propriedades do Log de Diagnóstico AkriConnectors.
AkriConnectorsDigest	Propriedades AkriConnectorsDigest.
AkriConnectorsImagePullPolicy	Política de pull de imagem.
AkriConnectorsImagePullSecret	Propriedades AkriConnectorsImagePullSecret.
AkriConnectorsMqttAuthenticationMethod	Propriedades AkriConnectorsMqttAuthenticationMethod.
AkriConnectorsMqttConnectionConfiguration	Propriedades AkriConnectorsMqttConnectionConfiguration.
AkriConnectorsMqttProtocolType	Tipos de protocolo Mqtt.
AkriConnectorsRegistryEndpointRef	Propriedades AkriConnectorsRegistryEndpointRef.
AkriConnectorsRegistrySettingsType	Propriedades AkriConnectorsRegistrySettings.
AkriConnectorsSecret	Propriedades AkriConnectorsSecret.
AkriConnectorsServiceAccountAuthentication	Propriedades AkriConnectorsServiceAccountAuthentication.
AkriConnectorsServiceAccountTokenSettings	Propriedades AkriConnectorsServiceAccountTokenSettings.
AkriConnectorsTag	Propriedades AkriConnectorsTag.
AkriConnectorsTagDigestType	Valores AkriConnectorsTagDigestType.
AkriConnectorTemplateAioMetadata	Propriedades AkriConnectorTemplateAioMetadata.
AkriConnectorTemplateAllocationPolicy	Propriedades AkriConnectorTemplateAllocationPolicy.
AkriConnectorTemplateBucketizedAllocation	Propriedades AkriConnectorTemplateBucketizedAallocation .
AkriConnectorTemplateDeviceInboundEndpointType	Propriedades AkriConnectorTemplateDeviceInboundEndpointType.
AkriConnectorTemplateDiagnostics	Propriedades AkriConnectorTemplateDiagnostics.
AkriConnectorTemplateManagedConfiguration	Propriedades AkriConnectorTemplateManagedConfiguration.
AkriConnectorTemplateManagedConfigurationType	Tipos de configuração gerenciados.
AkriConnectorTemplatePersistentVolumeClaim	Propriedades AkriConnectorTemplatePersistentVolumeClaim.
AkriConnectorTemplateProperties	Propriedades AkriConnectorTemplate.
AkriConnectorTemplateResource	AkriConnectorTemplate.
AkriConnectorTemplateRuntimeConfigurationType	Tipos de configuração de tempo de execução.
AkriConnectorTemplateRuntimeImageConfiguration	Propriedades AkriConnectorTemplateRuntimeImageConfiguration.
AkriConnectorTemplateRuntimeImageConfigurationSettings	Propriedades AkriConnectorTemplateRuntimeImageConfiguration.
AkriConnectorTemplateRuntimeStatefulSetConfiguration	Propriedades AkriConnectorTemplateRuntimeStatefulSetConfiguration.
AkriConnectorTemplateTrustList	Propriedades AkriConnectorTemplateTrustList.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	A localização estendida é uma extensão das localizações do Azure. Eles fornecem uma maneira de usar seus clusters do Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.
ExtendedLocationType	A enumeração que define o tipo de ExtendedLocation aceito.
OperationalMode	Propriedades do modo
ProvisioningState	A enumeração que define o status do recurso.
ResourceHealthState	O estado de integridade do recurso.
systemData	Metadados relativos à criação e última modificação do recurso.
TlsProperties	Propriedades Tls

AkriConnectorsContainerRegistry

Objeto

Propriedades AkriConnectorsContainerRegistry.

Nome	Tipo	Description
containerRegistrySettings	AkriConnectorsContainerRegistrySettings	As configurações do Registro para o registro de contêiner.
registrySettingsType	string: ContainerRegistry	Propriedades AkriConnectorsRegistrySettings.

AkriConnectorsContainerRegistrySettings

Objeto

Propriedades AkriConnectorsContainerRegistry.

Nome	Tipo	Description
imagePullSecrets	AkriConnectorsImagePullSecret[]	Lista opcional de referências a segredos no mesmo namespace a ser usado para extrair a imagem do conector.
registry	string	O registro de contêiner a ser usado para o artefato.

AkriConnectorsDiagnosticsLogs

Objeto

Propriedades do Log de Diagnóstico AkriConnectors.

Nome	Tipo	Valor padrão	Description
level	string	info	O nível de log. Exemplos - 'depuração', 'info', 'warn', 'error', 'trace'.

AkriConnectorsDigest

Objeto

Propriedades AkriConnectorsDigest.

Nome	Tipo	Description
digest	string	O resumo da imagem.
tagDigestType	string: Digest	O tipo de marca ou resumo.

AkriConnectorsImagePullPolicy

Enumeração

Política de pull de imagem.

Valor	Description
Always	Sempre puxe a imagem.
IfNotPresent	IfNotPresent puxe a imagem.
Never	Nunca puxe a imagem.

AkriConnectorsImagePullSecret

Objeto

Propriedades AkriConnectorsImagePullSecret.

Nome	Tipo	Description
secretRef	string	O nome do segredo de extração da imagem.

AkriConnectorsMqttAuthenticationMethod

Enumeração

Propriedades AkriConnectorsMqttAuthenticationMethod.

Valor	Description
ServiceAccountToken	Autenticação de Token de Conta de Serviço.

AkriConnectorsMqttConnectionConfiguration

Objeto

Propriedades AkriConnectorsMqttConnectionConfiguration.

Nome	Tipo	Description
authentication	AkriConnectorsMqttAuthentication: AkriConnectorsServiceAccountAuthentication	Propriedades de autenticação.
host	string	Host do Agente na forma de <nome do host>:<porta>.
keepAliveSeconds	integer (int32) minimum: 0	KeepAlive para conexão em segundos.
maxInflightMessages	integer (int32) minimum: 0	O número máximo de mensagens a serem mantidas em voo. Para assinar, esse é o máximo de recebimento. Para publicação, esse é o número máximo de mensagens a serem enviadas antes de aguardar uma ack.
protocol	AkriConnectorsMqttProtocolType	O protocolo a ser usado para a conexão. Atualmente, há suporte apenas para `mqtt` .
sessionExpirySeconds	integer (int32) minimum: 0	Expiração da sessão em segundos.
tls	TlsProperties	Configuração do TLS.

AkriConnectorsMqttProtocolType

Enumeração

Tipos de protocolo Mqtt.

Valor	Description
Mqtt	Protocolo Mqtt.

AkriConnectorsRegistryEndpointRef

Objeto

Propriedades AkriConnectorsRegistryEndpointRef.

Nome	Tipo	Description
registryEndpointRef	string	O nome do ponto de extremidade do Registro.
registrySettingsType	string: RegistryEndpointRef	Propriedades AkriConnectorsRegistrySettings.

AkriConnectorsRegistrySettingsType

Enumeração

Propriedades AkriConnectorsRegistrySettings.

Valor	Description
RegistryEndpointRef	Uma referência de Ponto de Extremidade do Registro.
ContainerRegistry	Uma referência do Container Registry.

AkriConnectorsSecret

Objeto

Propriedades AkriConnectorsSecret.

Nome	Tipo	Description
secretAlias	string	O alias definido pelo aplicativo para o segredo.
secretKey	string	A chave do segredo a ser montada.
secretRef	string	O nome do segredo a ser montado.

AkriConnectorsServiceAccountAuthentication

Objeto

Propriedades AkriConnectorsServiceAccountAuthentication.

Nome	Tipo	Description
method	string: ServiceAccountToken	O método de autenticação para a conexão MQTT.
serviceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings	O token da conta de serviço para a conexão MQTT.

AkriConnectorsServiceAccountTokenSettings

Objeto

Propriedades AkriConnectorsServiceAccountTokenSettings.

Nome	Tipo	Description
audience	string	O público-alvo do token da conta de serviço.

AkriConnectorsTag

Objeto

Propriedades AkriConnectorsTag.

Nome	Tipo	Description
tag	string	A tag da imagem.
tagDigestType	string: Tag	O tipo de marca ou resumo.

AkriConnectorsTagDigestType

Enumeração

Valores AkriConnectorsTagDigestType.

Valor	Description
Tag	Indica que uma marca deve ser especificada.
Digest	Indica que um resumo deve ser especificado.

AkriConnectorTemplateAioMetadata

Objeto

Propriedades AkriConnectorTemplateAioMetadata.

Nome	Tipo	Description
aioMaxVersion	string	A versão máxima do AIO necessária para o conector.
aioMinVersion	string	A versão mínima do AIO necessária para o conector.

AkriConnectorTemplateAllocationPolicy

Enumeração

Propriedades AkriConnectorTemplateAllocationPolicy.

Valor	Description
Bucketized	Política de alocação em bucket.

AkriConnectorTemplateBucketizedAllocation

Objeto

Propriedades AkriConnectorTemplateBucketizedAallocation .

Nome	Tipo	Description
bucketSize	integer (int32) minimum: 1 maximum: 100	A alocação agrupada de AEPs para conectores.
policy	string: Bucketized	O tipo de política de alocação.

AkriConnectorTemplateDeviceInboundEndpointType

Objeto

Propriedades AkriConnectorTemplateDeviceInboundEndpointType.

Nome	Tipo	Description
displayName	string	O nome de exibição do ponto de extremidade de entrada do dispositivo.
endpointType	string minLength: 1	O tipo do ponto de extremidade de entrada do dispositivo.
version	string minLength: 1	A versão do ponto de extremidade de entrada do dispositivo.

AkriConnectorTemplateDiagnostics

Objeto

Propriedades AkriConnectorTemplateDiagnostics.

Nome	Tipo	Description
logs	AkriConnectorsDiagnosticsLogs	As configurações de log para o modelo do Conector.

AkriConnectorTemplateManagedConfiguration

Objeto

Propriedades AkriConnectorTemplateManagedConfiguration.

Nome	Tipo	Description
managedConfigurationSettings	AkriConnectorTemplateManagedConfigurationSettings: AkriConnectorTemplateRuntimeImageConfiguration AkriConnectorTemplateRuntimeStatefulSetConfiguration	As definições de configuração gerenciadas.
runtimeConfigurationType	string: ManagedConfiguration	Tipo de configuração de tempo de execução para o modelo do Conector.

AkriConnectorTemplateManagedConfigurationType

Enumeração

Tipos de configuração gerenciados.

Valor	Description
ImageConfiguration	Tipo de configuração de imagem.
StatefulSetConfiguration	Tipo de configuração StatefulSet.

AkriConnectorTemplatePersistentVolumeClaim

Objeto

Propriedades AkriConnectorTemplatePersistentVolumeClaim.

Nome	Tipo	Description
claimName	string	O nome da declaração de volume persistente.
mountPath	string	O caminho de montagem para a declaração de volume persistente.

AkriConnectorTemplateProperties

Objeto

Propriedades AkriConnectorTemplate.

Nome	Tipo	Valor padrão	Description
aioMetadata	AkriConnectorTemplateAioMetadata		Metadados sobre AIO.
connectorMetadataRef	string		Uma referência a uma referência de documento de metadados do conector em um registro de contêiner.
deviceInboundEndpointTypes	AkriConnectorTemplateDeviceInboundEndpointType[]		Tipos de endpoint de entrada do dispositivo.
diagnostics	AkriConnectorTemplateDiagnostics		Configurações de diagnóstico para o modelo de conector.
healthState	ResourceHealthState	Unknown	O estado de integridade do recurso.
mqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration		Definições de configuração de conexão Mqtt.
provisioningState	ProvisioningState		O status da última operação.
runtimeConfiguration	AkriConnectorTemplateRuntimeConfiguration: AkriConnectorTemplateManagedConfiguration		A configuração de runtime para o modelo do Conector.

AkriConnectorTemplateResource

Objeto

AkriConnectorTemplate.

Nome	Tipo	Description
extendedLocation	ExtendedLocation	Local de borda do recurso.
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties	AkriConnectorTemplateProperties	As propriedades específicas do recurso para esse recurso.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AkriConnectorTemplateRuntimeConfigurationType

Enumeração

Tipos de configuração de tempo de execução.

Valor	Description
ManagedConfiguration	Tipo de configuração gerenciada.

AkriConnectorTemplateRuntimeImageConfiguration

Objeto

Propriedades AkriConnectorTemplateRuntimeImageConfiguration.

Nome	Tipo	Description
additionalConfiguration	object	Configuração adicional para a imagem da configuração gerenciada.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Definições de alocação para a configuração gerenciada.
imageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfigurationSettings	As definições de configuração da imagem.
managedConfigurationType	string: ImageConfiguration	O tipo de configuração gerenciada.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Os modelos de declaração de volume persistente para a configuração gerenciada. Consulte https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	As declarações de volume persistente para a configuração gerenciada.
secrets	AkriConnectorsSecret[]	Segredos do conector que serão montados em todas as instâncias do conector.
trustSettings	AkriConnectorTemplateTrustList	Lista de confiança para o conector. Isso é usado para especificar os certificados nos quais todas as instâncias do conector devem confiar.

AkriConnectorTemplateRuntimeImageConfigurationSettings

Objeto

Propriedades AkriConnectorTemplateRuntimeImageConfiguration.

Nome	Tipo	Description
imageName	string	O nome da imagem sem qualquer referência de registro, marca ou resumo.
imagePullPolicy	AkriConnectorsImagePullPolicy	A política de pull da imagem.
registrySettings	AkriConnectorsRegistrySettings: AkriConnectorsContainerRegistry AkriConnectorsRegistryEndpointRef	As configurações do Registro para a imagem. Você pode omitir esse campo se estiver usando o repositório padrão do docker hub ou usando uma imagem local.
replicas	integer (int32)	O número de réplicas a serem configuradas.
tagDigestSettings	AkriConnectorsTagDigestSettings: AkriConnectorsDigest AkriConnectorsTag	Tag ou resumo de imagem opcional. Se não for especificado, a tag padrão será `latest`.

AkriConnectorTemplateRuntimeStatefulSetConfiguration

Objeto

Propriedades AkriConnectorTemplateRuntimeStatefulSetConfiguration.

Nome	Tipo	Description
additionalConfiguration	object	Configuração adicional para a imagem da configuração gerenciada.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	Definições de alocação para a configuração gerenciada.
managedConfigurationType	string: StatefulSetConfiguration	O tipo de configuração gerenciada.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	Os modelos de declaração de volume persistente para a configuração gerenciada. Consulte https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	As declarações de volume persistente para a configuração gerenciada.
secrets	AkriConnectorsSecret[]	Segredos do conector que serão montados em todas as instâncias do conector.
statefulSetConfigurationSettings		As definições de configuração de conjunto com monitoração de estado. Isso corresponde ao recurso StatefulSet do Kubernetes. Consulte 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	Lista de confiança para o conector. Isso é usado para especificar os certificados nos quais todas as instâncias do conector devem confiar.

AkriConnectorTemplateTrustList

Objeto

Propriedades AkriConnectorTemplateTrustList.

Nome	Tipo	Description
trustListSecretRef	string	A referência secreta para certificados confiáveis.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Objeto

A localização estendida é uma extensão das localizações do Azure. Eles fornecem uma maneira de usar seus clusters do Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.

Nome	Tipo	Description
name	string	O nome do local estendido.
type	ExtendedLocationType	Tipo de ExtendedLocation.

ExtendedLocationType

Enumeração

A enumeração que define o tipo de ExtendedLocation aceito.

Valor	Description
CustomLocation	Tipo CustomLocation

OperationalMode

Enumeração

Propriedades do modo

Valor	Description
Enabled	Habilitado é equivalente a Verdadeiro
Disabled	Disabled é equivalente a False.

ProvisioningState

Enumeração

A enumeração que define o status do recurso.

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Provisioning	O recurso está sendo provisionado.
Updating	O recurso está atualizando.
Deleting	O recurso está sendo excluído.
Accepted	O recurso foi aceito.

ResourceHealthState

Enumeração

O estado de integridade do recurso.

Valor	Description
Available	O recurso está disponível e funcionando conforme o esperado.
Degraded	A integridade do recurso é degradada.
Unavailable	O recurso não está funcionando conforme o esperado.
Unknown	O estado do recurso é desconhecido.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TlsProperties

Objeto

Propriedades Tls

Nome	Tipo	Valor padrão	Description
mode	OperationalMode	Enabled	Modo para TLS.
trustedCaCertificateConfigMapRef	string		Mapa de configuração de certificado de autoridade de certificação confiável.

Compartilhar via

Akri Connector Template - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

Solicitação de exemplo

Resposta de exemplo

Definições

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