Akri Connector Template - Create Or Update

서비스:: IoT Operations

API 버전:: 2026-03-01

AkriConnectorTemplateResource 만들기

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
akriConnectorTemplateName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	AkriConnectorTemplate 리소스의 이름입니다.
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	인스턴스의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
extendedLocation	ExtendedLocation	리소스의 에지 위치입니다.
properties	AkriConnectorTemplateProperties	이 리소스에 대한 리소스별 속성입니다.

응답

Name	형식	Description
200 OK	AkriConnectorTemplateResource	리소스 'AkriConnectorTemplateResource' 업데이트 작업에 성공했습니다.
201 Created	AkriConnectorTemplateResource	리소스 'AkriConnectorTemplateResource' 만들기 작업에 성공했습니다. 헤더 Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

AkriConnectorTemplateResource

리소스 'AkriConnectorTemplateResource' 업데이트 작업에 성공했습니다.

201 Created

AkriConnectorTemplateResource

리소스 'AkriConnectorTemplateResource' 만들기 작업에 성공했습니다.

헤더

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

샘플 요청

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

샘플 응답

상태 코드:: 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"
  }
}

상태 코드:: 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"
  }
}

정의

Name	Description
AkriConnectorsContainerRegistry	AkriConnectorsContainerRegistry 속성을 사용합니다.
AkriConnectorsContainerRegistrySettings	AkriConnectorsContainerRegistry 속성을 사용합니다.
AkriConnectorsDiagnosticsLogs	AkriConnectorsDiagnostic 로그 속성.
AkriConnectorsDigest	AkriConnectorsDigest 속성을 사용합니다.
AkriConnectorsImagePullPolicy	이미지 끌어오기 정책입니다.
AkriConnectorsImagePullSecret	AkriConnectorsImagePullSecret 속성을 사용합니다.
AkriConnectorsMqttAuthenticationMethod	AkriConnectorsMqttAuthenticationMethod 속성을 사용합니다.
AkriConnectorsMqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration 속성을 사용합니다.
AkriConnectorsMqttProtocolType	Mqtt 프로토콜 유형.
AkriConnectorsRegistryEndpointRef	AkriConnectorsRegistryEndpointRef 속성을 사용합니다.
AkriConnectorsRegistrySettingsType	AkriConnectorsRegistrySettings 속성을 사용합니다.
AkriConnectorsSecret	AkriConnectorsSecret 속성.
AkriConnectorsServiceAccountAuthentication	AkriConnectorsServiceAccountAuthentication 속성입니다.
AkriConnectorsServiceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings 속성을 사용합니다.
AkriConnectorsTag	AkriConnectorsTag 속성을 사용합니다.
AkriConnectorsTagDigestType	AkriConnectorsTagDigestType 값을 사용합니다.
AkriConnectorTemplateAioMetadata	AkriConnectorTemplateAioMetadata 속성을 사용합니다.
AkriConnectorTemplateAllocationPolicy	AkriConnectorTemplateAllocationPolicy 속성을 사용합니다.
AkriConnectorTemplateBucketizedAllocation	AkriConnectorTemplateBucketizedAllocation 속성을 사용합니다.
AkriConnectorTemplateDeviceInboundEndpointType	AkriConnectorTemplateDeviceInboundEndpointType 속성을 사용합니다.
AkriConnectorTemplateDiagnostics	AkriConnectorTemplateDiagnostics 속성을 사용합니다.
AkriConnectorTemplateManagedConfiguration	AkriConnectorTemplateManagedConfiguration 속성을 사용합니다.
AkriConnectorTemplateManagedConfigurationType	관리되는 구성 유형.
AkriConnectorTemplatePersistentVolumeClaim	AkriConnectorTemplatePersistentVolumeClaim 속성을 사용합니다.
AkriConnectorTemplateProperties	AkriConnectorTemplate 속성을 사용합니다.
AkriConnectorTemplateResource	AkriConnectorTemplate 리소스.
AkriConnectorTemplateRuntimeConfigurationType	런타임 구성 유형.
AkriConnectorTemplateRuntimeImageConfiguration	AkriConnectorTemplateRuntimeImageConfiguration 속성을 사용합니다.
AkriConnectorTemplateRuntimeImageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfiguration 속성을 사용합니다.
AkriConnectorTemplateRuntimeStatefulSetConfiguration	AkriConnectorTemplateRuntimeStatefulSetConfiguration 속성을 사용합니다.
AkriConnectorTemplateTrustList	AkriConnectorTemplateTrustList 속성.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ExtendedLocation	확장된 위치는 Azure 위치의 확장입니다. Azure ARC 지원 Kubernetes 클러스터를 Azure 서비스 인스턴스를 배포하기 위한 대상 위치로 사용하는 방법을 제공합니다.
ExtendedLocationType	ExtendedLocation의 열거형 정의 형식이 허용됩니다.
OperationalMode	모드 속성
ProvisioningState	자원의 상태를 정의하는 열거형입니다.
ResourceHealthState	리소스의 상태입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TlsProperties	Tls 속성

AkriConnectorsContainerRegistry

Object

AkriConnectorsContainerRegistry 속성을 사용합니다.

Name	형식	Description
containerRegistrySettings	AkriConnectorsContainerRegistrySettings	컨테이너 레지스트리에 대한 레지스트리 설정입니다.
registrySettingsType	string: ContainerRegistry	AkriConnectorsRegistrySettings 속성을 사용합니다.

AkriConnectorsContainerRegistrySettings

Object

AkriConnectorsContainerRegistry 속성을 사용합니다.

Name	형식	Description
imagePullSecrets	AkriConnectorsImagePullSecret[]	커넥터 이미지를 가져오는 데 사용할 동일한 네임스페이스의 비밀에 대한 참조 목록(선택사항)입니다.
registry	string	아티팩트에 사용할 컨테이너 레지스트리입니다.

AkriConnectorsDiagnosticsLogs

Object

AkriConnectorsDiagnostic 로그 속성.

Name	형식	Default value	Description
level	string	info	로그 수준입니다. 예 - 'debug', 'info', 'warn', 'error', 'trace'.

AkriConnectorsDigest

Object

AkriConnectorsDigest 속성을 사용합니다.

Name	형식	Description
digest	string	이미지의 다이제스트입니다.
tagDigestType	string: Digest	태그 또는 다이제스트 유형입니다.

AkriConnectorsImagePullPolicy

열거형

이미지 끌어오기 정책입니다.

값	Description
Always	항상 이미지를 당깁니다.
IfNotPresent	IfNotPresent는 이미지를 가져옵니다.
Never	이미지를 당기지 마십시오.

AkriConnectorsImagePullSecret

Object

AkriConnectorsImagePullSecret 속성을 사용합니다.

Name	형식	Description
secretRef	string	이미지 끌어오기 시크릿의 이름입니다.

AkriConnectorsMqttAuthenticationMethod

열거형

AkriConnectorsMqttAuthenticationMethod 속성을 사용합니다.

값	Description
ServiceAccountToken	서비스 계정 토큰 인증.

AkriConnectorsMqttConnectionConfiguration

Object

AkriConnectorsMqttConnectionConfiguration 속성을 사용합니다.

Name	형식	Description
authentication	AkriConnectorsMqttAuthentication: AkriConnectorsServiceAccountAuthentication	인증 속성입니다.
host	string	hostname<:>port< 형식의 >Broker 호스트입니다.
keepAliveSeconds	integer (int32) minimum: 0	몇 초 만에 연결할 수 있는 KeepAlive.
maxInflightMessages	integer (int32) minimum: 0	계속 진행 중인 메시지의 최대 수입니다. 구독의 경우 수신 최대값입니다. 게시의 경우 ack를 기다리기 전에 보낼 최대 메시지 수입니다.
protocol	AkriConnectorsMqttProtocolType	연결에 사용할 프로토콜입니다. 현재 `mqtt` 만 유일하게 지원됩니다.
sessionExpirySeconds	integer (int32) minimum: 0	세션 만료 시간(초)입니다.
tls	TlsProperties	TLS 구성.

AkriConnectorsMqttProtocolType

열거형

Mqtt 프로토콜 유형.

값	Description
Mqtt	Mqtt 프로토콜.

AkriConnectorsRegistryEndpointRef

Object

AkriConnectorsRegistryEndpointRef 속성을 사용합니다.

Name	형식	Description
registryEndpointRef	string	레지스트리 엔드포인트의 이름입니다.
registrySettingsType	string: RegistryEndpointRef	AkriConnectorsRegistrySettings 속성을 사용합니다.

AkriConnectorsRegistrySettingsType

열거형

AkriConnectorsRegistrySettings 속성을 사용합니다.

값	Description
RegistryEndpointRef	레지스트리 엔드포인트 참조입니다.
ContainerRegistry	Container Registry 참조입니다.

AkriConnectorsSecret

Object

AkriConnectorsSecret 속성.

Name	형식	Description
secretAlias	string	시크릿에 대한 애플리케이션 정의 별칭입니다.
secretKey	string	마운트할 시크릿의 키입니다.
secretRef	string	마운트할 시크릿의 이름입니다.

AkriConnectorsServiceAccountAuthentication

Object

AkriConnectorsServiceAccountAuthentication 속성입니다.

Name	형식	Description
method	string: ServiceAccountToken	MQTT 연결에 대한 인증 방법입니다.
serviceAccountTokenSettings	AkriConnectorsServiceAccountTokenSettings	MQTT 연결에 대한 서비스 계정 토큰입니다.

AkriConnectorsServiceAccountTokenSettings

Object

AkriConnectorsServiceAccountTokenSettings 속성을 사용합니다.

Name	형식	Description
audience	string	서비스 계정 토큰의 대상 그룹입니다.

AkriConnectorsTag

Object

AkriConnectorsTag 속성을 사용합니다.

Name	형식	Description
tag	string	이미지의 태그입니다.
tagDigestType	string: Tag	태그 또는 다이제스트 유형입니다.

AkriConnectorsTagDigestType

열거형

AkriConnectorsTagDigestType 값을 사용합니다.

값	Description
Tag	태그를 지정해야 함을 나타냅니다.
Digest	다이제스트를 지정해야 함을 나타냅니다.

AkriConnectorTemplateAioMetadata

Object

AkriConnectorTemplateAioMetadata 속성을 사용합니다.

Name	형식	Description
aioMaxVersion	string	커넥터에 필요한 AIO의 최대 버전입니다.
aioMinVersion	string	커넥터에 필요한 AIO의 최소 버전입니다.

AkriConnectorTemplateAllocationPolicy

열거형

AkriConnectorTemplateAllocationPolicy 속성을 사용합니다.

값	Description
Bucketized	버킷화된 할당 정책.

AkriConnectorTemplateBucketizedAllocation

Object

AkriConnectorTemplateBucketizedAllocation 속성을 사용합니다.

Name	형식	Description
bucketSize	integer (int32) minimum: 1 maximum: 100	커넥터에 대한 AEP의 버킷화된 할당입니다.
policy	string: Bucketized	할당 정책 유형입니다.

AkriConnectorTemplateDeviceInboundEndpointType

Object

AkriConnectorTemplateDeviceInboundEndpointType 속성을 사용합니다.

Name	형식	Description
displayName	string	디바이스 인바운드 엔드포인트의 표시 이름입니다.
endpointType	string minLength: 1	디바이스 인바운드 엔드포인트의 유형입니다.
version	string minLength: 1	디바이스 인바운드 엔드포인트의 버전입니다.

AkriConnectorTemplateDiagnostics

Object

AkriConnectorTemplateDiagnostics 속성을 사용합니다.

Name	형식	Description
logs	AkriConnectorsDiagnosticsLogs	커넥터 템플릿에 대한 로그 설정입니다.

AkriConnectorTemplateManagedConfiguration

Object

AkriConnectorTemplateManagedConfiguration 속성을 사용합니다.

Name	형식	Description
managedConfigurationSettings	AkriConnectorTemplateManagedConfigurationSettings: AkriConnectorTemplateRuntimeImageConfiguration AkriConnectorTemplateRuntimeStatefulSetConfiguration	관리되는 구성 설정입니다.
runtimeConfigurationType	string: ManagedConfiguration	커넥터 템플릿의 런타임 구성 유형입니다.

AkriConnectorTemplateManagedConfigurationType

열거형

관리되는 구성 유형.

값	Description
ImageConfiguration	이미지 구성 유형.
StatefulSetConfiguration	StatefulSet 구성 유형입니다.

AkriConnectorTemplatePersistentVolumeClaim

Object

AkriConnectorTemplatePersistentVolumeClaim 속성을 사용합니다.

Name	형식	Description
claimName	string	영구 볼륨 클레임의 이름입니다.
mountPath	string	영구 볼륨 클레임의 탑재 경로입니다.

AkriConnectorTemplateProperties

Object

AkriConnectorTemplate 속성을 사용합니다.

Name	형식	Default value	Description
aioMetadata	AkriConnectorTemplateAioMetadata		AIO에 대한 메타데이터입니다.
connectorMetadataRef	string		컨테이너 레지스트리의 커넥터 메타데이터 문서 참조에 대한 참조입니다.
deviceInboundEndpointTypes	AkriConnectorTemplateDeviceInboundEndpointType[]		디바이스 인바운드 엔드포인트 유형입니다.
diagnostics	AkriConnectorTemplateDiagnostics		커넥터 템플릿에 대한 진단 설정입니다.
healthState	ResourceHealthState	Unknown	리소스의 상태입니다.
mqttConnectionConfiguration	AkriConnectorsMqttConnectionConfiguration		Mqtt 연결 구성 설정.
provisioningState	ProvisioningState		마지막 작업의 상태입니다.
runtimeConfiguration	AkriConnectorTemplateRuntimeConfiguration: AkriConnectorTemplateManagedConfiguration		커넥터 템플릿의 런타임 구성입니다.

AkriConnectorTemplateResource

Object

AkriConnectorTemplate 리소스.

Name	형식	Description
extendedLocation	ExtendedLocation	리소스의 에지 위치입니다.
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties	AkriConnectorTemplateProperties	이 리소스에 대한 리소스별 속성입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

AkriConnectorTemplateRuntimeConfigurationType

열거형

런타임 구성 유형.

값	Description
ManagedConfiguration	관리되는 구성 유형.

AkriConnectorTemplateRuntimeImageConfiguration

Object

AkriConnectorTemplateRuntimeImageConfiguration 속성을 사용합니다.

Name	형식	Description
additionalConfiguration	object	관리되는 구성의 이미지에 대한 추가 구성입니다.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	관리되는 구성에 대한 할당 설정입니다.
imageConfigurationSettings	AkriConnectorTemplateRuntimeImageConfigurationSettings	이미지 구성 설정입니다.
managedConfigurationType	string: ImageConfiguration	관리되는 구성의 유형입니다.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	관리되는 구성에 대한 영구 볼륨 클레임 템플릿입니다. https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json을(를) 참조하세요.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	관리 구성에 대한 영구 볼륨 클레임입니다.
secrets	AkriConnectorsSecret[]	모든 커넥터 인스턴스에 탑재될 커넥터 비밀입니다.
trustSettings	AkriConnectorTemplateTrustList	커넥터에 대한 신뢰 목록입니다. 이는 모든 커넥터 인스턴스가 신뢰해야 하는 인증서를 지정하는 데 사용됩니다.

AkriConnectorTemplateRuntimeImageConfigurationSettings

Object

AkriConnectorTemplateRuntimeImageConfiguration 속성을 사용합니다.

Name	형식	Description
imageName	string	레지스트리 참조, 태그 또는 다이제스트가 없는 이미지 이름입니다.
imagePullPolicy	AkriConnectorsImagePullPolicy	이미지의 끌어오기 정책입니다.
registrySettings	AkriConnectorsRegistrySettings: AkriConnectorsContainerRegistry AkriConnectorsRegistryEndpointRef	이미지에 대한 레지스트리 설정입니다. 기본 docker hub 리포지토리를 사용하거나 로컬 이미지를 사용하는 경우 이 필드를 생략할 수 있습니다.
replicas	integer (int32)	설정할 복제본 수입니다.
tagDigestSettings	AkriConnectorsTagDigestSettings: AkriConnectorsDigest AkriConnectorsTag	선택적 이미지 태그 또는 다이제스트. 지정하지 않으면 기본 태그는 `latest`.

AkriConnectorTemplateRuntimeStatefulSetConfiguration

Object

AkriConnectorTemplateRuntimeStatefulSetConfiguration 속성을 사용합니다.

Name	형식	Description
additionalConfiguration	object	관리되는 구성의 이미지에 대한 추가 구성입니다.
allocation	AkriConnectorTemplateAllocation: AkriConnectorTemplateBucketizedAllocation	관리되는 구성에 대한 할당 설정입니다.
managedConfigurationType	string: StatefulSetConfiguration	관리되는 구성의 유형입니다.
persistentVolumeClaimTemplates	AkriConnectorTemplateManagedConfigurationSettings.PersistentVolumeClaimTemplates[]	관리되는 구성에 대한 영구 볼륨 클레임 템플릿입니다. https://raw.githubusercontent.com/kubernetes/kubernetes/refs/heads/master/api/openapi-spec/v3/apis__apps__v1_openapi.json을(를) 참조하세요.
persistentVolumeClaims	AkriConnectorTemplatePersistentVolumeClaim[]	관리 구성에 대한 영구 볼륨 클레임입니다.
secrets	AkriConnectorsSecret[]	모든 커넥터 인스턴스에 탑재될 커넥터 비밀입니다.
statefulSetConfigurationSettings		상태 저장 세트 구성 설정입니다. 이는 Kubernetes StatefulSet 리소스에 해당합니다. 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	커넥터에 대한 신뢰 목록입니다. 이는 모든 커넥터 인스턴스가 신뢰해야 하는 인증서를 지정하는 데 사용됩니다.

AkriConnectorTemplateTrustList

Object

AkriConnectorTemplateTrustList 속성.

Name	형식	Description
trustListSecretRef	string	신뢰할 인증서에 대한 비밀 참조입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ExtendedLocation

Object

확장된 위치는 Azure 위치의 확장입니다. Azure ARC 지원 Kubernetes 클러스터를 Azure 서비스 인스턴스를 배포하기 위한 대상 위치로 사용하는 방법을 제공합니다.

Name	형식	Description
name	string	확장된 위치의 이름입니다.
type	ExtendedLocationType	ExtendedLocation의 형식입니다.

ExtendedLocationType

열거형

ExtendedLocation의 열거형 정의 형식이 허용됩니다.

값	Description
CustomLocation	CustomLocation 유형

OperationalMode

열거형

모드 속성

값	Description
Enabled	Enabled는 True와 동일합니다.
Disabled	Disabled는 False와 동일합니다.

ProvisioningState

열거형

자원의 상태를 정의하는 열거형입니다.

값	Description
Succeeded	리소스가 만들어졌습니다.
Failed	리소스를 만들지 못했습니다.
Canceled	리소스 만들기가 취소되었습니다.
Provisioning	리소스가 프로비전되고 있습니다.
Updating	리소스가 업데이트 중입니다.
Deleting	리소스가 삭제 중입니다.
Accepted	리소스가 수락되었습니다.

ResourceHealthState

열거형

리소스의 상태입니다.

값	Description
Available	리소스가 사용 가능하고 예상대로 작동합니다.
Degraded	리소스 상태가 저하됩니다.
Unavailable	리소스가 예상대로 작동하지 않습니다.
Unknown	리소스 상태를 알 수 없습니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

TlsProperties

Object

Tls 속성

Name	형식	Default value	Description
mode	OperationalMode	Enabled	TLS 모드입니다.
trustedCaCertificateConfigMapRef	string		신뢰할 수 있는 CA 인증서 구성 맵입니다.

다음을 통해 공유

Akri Connector Template - Create Or Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

AkriConnectorTemplate_CreateOrUpdate_MaximumSet

샘플 요청

샘플 응답

정의

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