Registry Endpoint - Create Or Update

Служба:: IoT Operations

Версия API:: 2026-03-01

Создание ресурса RegistryEndpointResource

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Имя экземпляра.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Имя ресурса RegistryEndpoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
extendedLocation	ExtendedLocation	Пограничное расположение ресурса.
properties	RegistryEndpointProperties	Свойства, относящиеся к ресурсу, для этого ресурса.

Ответы

Имя	Тип	Описание
200 OK	RegistryEndpointResource	Операция обновления ресурса 'RegistryEndpointResource' выполнена успешно
201 Created	RegistryEndpointResource	Операция по созданию ресурса 'RegistryEndpointResource' выполнена успешно Заголовки Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

RegistryEndpointResource

Операция обновления ресурса 'RegistryEndpointResource' выполнена успешно

201 Created

RegistryEndpointResource

Операция по созданию ресурса 'RegistryEndpointResource' выполнена успешно

Заголовки

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

RegistryEndpoint_CreateOrUpdate_MaximumSet

Образец запроса

HTTP

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

{
  "properties": {
    "host": "contoso.azurecr.io",
    "authentication": {
      "method": "Anonymous",
      "anonymousSettings": {}
    },
    "codeSigningCas": [
      {
        "type": "Secret",
        "secretRef": "my-secret"
      },
      {
        "type": "ConfigMap",
        "configMapRef": "my-configmap"
      }
    ]
  },
  "extendedLocation": {
    "name": "/subscriptions/F8C729F9-DF9C-4743-848F-96EE433D8E53/resourceGroups/rgiotoperations/providers/Microsoft.ExtendedLocation/customLocations/resource-123",
    "type": "CustomLocation"
  }
}

Пример ответа

Код состояния:: 200

{
  "properties": {
    "host": "contoso.azurecr.io",
    "authentication": {
      "method": "Anonymous",
      "anonymousSettings": {}
    },
    "codeSigningCas": [
      {
        "type": "Secret",
        "secretRef": "my-secret"
      },
      {
        "type": "ConfigMap",
        "configMapRef": "my-configmap"
      }
    ],
    "provisioningState": "Succeeded"
  },
  "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/registryEndpoints/resource-name123",
  "name": "resource-name123",
  "type": "Microsoft.IoTOperations/registryEndpoints",
  "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": {
    "host": "contoso.azurecr.io",
    "authentication": {
      "method": "Anonymous",
      "anonymousSettings": {}
    },
    "provisioningState": "Accepted"
  },
  "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/registryEndpoints/resource-name123",
  "name": "resource-name123",
  "type": "Microsoft.IoTOperations/registryEndpoints",
  "systemData": {
    "createdBy": "contosouser",
    "createdByType": "User",
    "createdAt": "2024-08-09T18:13:29.389Z",
    "lastModifiedBy": "contosouser",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-08-09T18:13:29.389Z"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
ExtendedLocation	Расширенное расположение — это расширение расположений Azure. Они позволяют использовать кластеры Kubernetes с поддержкой Azure ARC в качестве целевых расположений для развертывания экземпляров служб Azure.
ExtendedLocationType	Тип перечисления, определяющий ExtendedLocation, принимается.
ProvisioningState	Перечисление, определяющее состояние ресурса.
RegistryEndpointAnonymousAuthentication	анонимная аутентификация;
RegistryEndpointArtifactPullSecretAuthentication	Аутентификация Artifact Pull Secret
RegistryEndpointArtifactPullSecretSettings	Свойства аутентификации RegistryEndpoint Artifact Pull Secret
RegistryEndpointAuthenticationMethod	Метод проверки подлинности.
RegistryEndpointProperties	Свойства RegistryEndpoint
RegistryEndpointResource	Ресурс RegistryEndpoint
RegistryEndpointSystemAssignedIdentityAuthentication	Аутентификация с помощью системной идентификации
RegistryEndpointSystemAssignedManagedIdentitySettings	Свойства управляемого удостоверения, назначаемые системой
RegistryEndpointTrustedSigningKeyConfigMap	Параметры доверия RegistryEndpoint предоставляются с помощью configmap.
RegistryEndpointTrustedSigningKeySecret	Параметры доверия RegistryEndpoint, предоставляемые через секрет.
RegistryEndpointTrustedSigningKeyType	Значения RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Аутентификация по удостоверению личности пользователя
RegistryEndpointUserAssignedManagedIdentitySettings	Свойства управляемого удостоверения, назначенные пользователем
ResourceHealthState	Состояние работоспособности ресурса.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительная информация.
type	string	Тип дополнительной информации.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Ошибка дополнительная информация.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Цель ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ExtendedLocation

Объект

Расширенное расположение — это расширение расположений Azure. Они позволяют использовать кластеры Kubernetes с поддержкой Azure ARC в качестве целевых расположений для развертывания экземпляров служб Azure.

Имя	Тип	Описание
name	string	Имя расширенного расположения.
type	ExtendedLocationType	Тип ExtendedLocation.

ExtendedLocationType

Перечисление

Тип перечисления, определяющий ExtendedLocation, принимается.

Значение	Описание
CustomLocation	Тип CustomLocation

ProvisioningState

Перечисление

Перечисление, определяющее состояние ресурса.

Значение	Описание
Succeeded	Ресурс создан.
Failed	Не удалось создать ресурс.
Canceled	Создание ресурсов было отменено.
Provisioning	Ресурс инициализируется.
Updating	Ресурс обновляется.
Deleting	Ресурс удаляется.
Accepted	Ресурс принят.

RegistryEndpointAnonymousAuthentication

Объект

анонимная аутентификация;

Имя	Тип	Описание
anonymousSettings	RegistryEndpointAnonymousSettings	Свойства анонимной аутентификации
method	string: Anonymous	Метод проверки подлинности.

RegistryEndpointArtifactPullSecretAuthentication

Объект

Аутентификация Artifact Pull Secret

Имя	Тип	Описание
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Свойства аутентификации Artifact Pull Secret
method	string: ArtifactPullSecret	Метод проверки подлинности.

RegistryEndpointArtifactPullSecretSettings

Объект

Свойства аутентификации RegistryEndpoint Artifact Pull Secret

Имя	Тип	Описание
secretRef	string	Имя секрета kubernetes, содержащего секрет извлечения артефакта.

RegistryEndpointAuthenticationMethod

Перечисление

Метод проверки подлинности.

Значение	Описание
SystemAssignedManagedIdentity	Тип SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Тип UserAssignedManagedIdentity
Anonymous	Анонимный вариант
ArtifactPullSecret	Аутентификация Artifact Pull Secret

RegistryEndpointProperties

Объект

Свойства RegistryEndpoint

Имя	Тип	Default value	Описание
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		Параметры проверки подлинности для Реестра контейнеров Azure.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Центры сертификации подписи, используемые артефактами в конечной точке реестра
healthState	ResourceHealthState	Unknown	Состояние работоспособности ресурса.
host	string minLength: 3 maxLength: 63		Имя узла конечной точки Реестра контейнеров.
provisioningState	ProvisioningState		Состояние последней операции.

RegistryEndpointResource

Объект

Ресурс RegistryEndpoint

Имя	Тип	Описание
extendedLocation	ExtendedLocation	Пограничное расположение ресурса.
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties	RegistryEndpointProperties	Свойства, относящиеся к ресурсу, для этого ресурса.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Объект

Аутентификация с помощью системной идентификации

Имя	Тип	Описание
method	string: SystemAssignedManagedIdentity	Метод проверки подлинности.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Свойства управляемого удостоверения, назначаемые системой

RegistryEndpointSystemAssignedManagedIdentitySettings

Объект

Свойства управляемого удостоверения, назначаемые системой

Имя	Тип	Описание
audience	string	Аудитория службы для проверки подлинности. Необязательный; по умолчанию для аудитории для конфигурации узла службы.

RegistryEndpointTrustedSigningKeyConfigMap

Объект

Параметры доверия RegistryEndpoint предоставляются с помощью configmap.

Имя	Тип	Описание
configMapRef	string	Имя карты конфигурации.
type	string: ConfigMap	Тип доверия для конечной точки реестра.

RegistryEndpointTrustedSigningKeySecret

Объект

Параметры доверия RegistryEndpoint, предоставляемые через секрет.

Имя	Тип	Описание
secretRef	string	Название секрета.
type	string: Secret	Тип доверия для конечной точки реестра.

RegistryEndpointTrustedSigningKeyType

Перечисление

Значения RegistryEndpointTrustedSigningKeyType

Значение	Описание
Secret	Доверяйте настройкам, хранящимся в секрете Kubernetes.
ConfigMap	Доверяйте настройкам, хранящимся в Kubernetes ConfigMap.

RegistryEndpointUserAssignedIdentityAuthentication

Объект

Аутентификация по удостоверению личности пользователя

Имя	Тип	Описание
method	string: UserAssignedManagedIdentity	Метод проверки подлинности.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Свойства управляемого удостоверения, назначенные пользователем

RegistryEndpointUserAssignedManagedIdentitySettings

Объект

Свойства управляемого удостоверения, назначенные пользователем

Имя	Тип	Описание
clientId	string	Идентификатор клиента для управляемого удостоверения, назначаемого пользователем.
scope	string	Идентификатор ресурса (URI идентификатора приложения) ресурса, прикрепленный с суффиксом по умолчанию.
tenantId	string	Идентификатор клиента.

ResourceHealthState

Перечисление

Состояние работоспособности ресурса.

Значение	Описание
Available	Ресурс доступен и функционирует как ожидается.
Degraded	Работоспособность ресурсов ухудшается.
Unavailable	Ресурс не функционирует должным образом.
Unknown	Состояние ресурса неизвестно.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Registry Endpoint - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

RegistryEndpoint_CreateOrUpdate_MaximumSet

Образец запроса

Пример ответа

Определения

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData