Registry Endpoint - Create Or Update

Servicio:: IoT Operations

Versión de la API:: 2026-03-01

Creación de un RegistryEndpointResource

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nombre de la instancia.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nombre del recurso RegistryEndpoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	La versión de API que se va a utilizar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación perimetral del recurso.
properties	RegistryEndpointProperties	Propiedades específicas del recurso para este recurso.

Respuestas

Nombre	Tipo	Description
200 OK	RegistryEndpointResource	La operación de actualización del recurso "RegistryEndpointResource" se realizó correctamente
201 Created	RegistryEndpointResource	Operación de creación del recurso "RegistryEndpointResource" realizada correctamente Encabezados Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

RegistryEndpointResource

La operación de actualización del recurso "RegistryEndpointResource" se realizó correctamente

201 Created

RegistryEndpointResource

Operación de creación del recurso "RegistryEndpointResource" realizada correctamente

Encabezados

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 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"
  }
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ExtendedLocation	La ubicación extendida es una extensión de las ubicaciones de Azure. Proporcionan una manera de usar sus clústeres de Kubernetes habilitados para Azure ARC como ubicaciones de destino para implementar instancias de servicios de Azure.
ExtendedLocationType	Se acepta el tipo de definición de enumeración de ExtendedLocation.
ProvisioningState	La enumeración que define el estado del recurso.
RegistryEndpointAnonymousAuthentication	Autenticación anónima
RegistryEndpointArtifactPullSecretAuthentication	Autenticación de secretos de extracción de artefactos
RegistryEndpointArtifactPullSecretSettings	Propiedades de autenticación del secreto de extracción de artefactos de RegistryEndpoint
RegistryEndpointAuthenticationMethod	Método de autenticación.
RegistryEndpointProperties	Propiedades de RegistryEndpoint
RegistryEndpointResource	Recurso RegistryEndpoint
RegistryEndpointSystemAssignedIdentityAuthentication	Autenticación de identidad asignada por el sistema
RegistryEndpointSystemAssignedManagedIdentitySettings	Propiedades de identidad administrada asignadas por el sistema
RegistryEndpointTrustedSigningKeyConfigMap	Configuración de la confianza de RegistryEndpoint proporcionada a través de un configmap.
RegistryEndpointTrustedSigningKeySecret	Configuración de la confianza de RegistryEndpoint proporcionada a través de un secreto.
RegistryEndpointTrustedSigningKeyType	Valores de RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Autenticación de identidad asignada por el usuario
RegistryEndpointUserAssignedManagedIdentitySettings	Propiedades de identidad administrada asignadas por el usuario
ResourceHealthState	El estado de mantenimiento del recurso.
systemData	Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExtendedLocation

Objeto

La ubicación extendida es una extensión de las ubicaciones de Azure. Proporcionan una manera de usar sus clústeres de Kubernetes habilitados para Azure ARC como ubicaciones de destino para implementar instancias de servicios de Azure.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	ExtendedLocationType	Tipo de ExtendedLocation.

ExtendedLocationType

Enumeración

Se acepta el tipo de definición de enumeración de ExtendedLocation.

Valor	Description
CustomLocation	Tipo CustomLocation

ProvisioningState

Enumeración

La enumeración que define el estado del recurso.

Valor	Description
Succeeded	Se ha creado el recurso.
Failed	Error en la creación de recursos.
Canceled	Se canceló la creación de recursos.
Provisioning	El recurso se está aprovisionando.
Updating	El recurso se está actualizando.
Deleting	El recurso es Eliminar.
Accepted	El recurso ha sido aceptado.

RegistryEndpointAnonymousAuthentication

Objeto

Autenticación anónima

Nombre	Tipo	Description
anonymousSettings	RegistryEndpointAnonymousSettings	Propiedades de autenticación anónima
method	string: Anonymous	Método de autenticación.

RegistryEndpointArtifactPullSecretAuthentication

Objeto

Autenticación de secretos de extracción de artefactos

Nombre	Tipo	Description
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Propiedades de autenticación del secreto de extracción de artefactos
method	string: ArtifactPullSecret	Método de autenticación.

RegistryEndpointArtifactPullSecretSettings

Objeto

Propiedades de autenticación del secreto de extracción de artefactos de RegistryEndpoint

Nombre	Tipo	Description
secretRef	string	El nombre del secreto de kubernetes que contiene el secreto de extracción del artefacto.

RegistryEndpointAuthenticationMethod

Enumeración

Método de autenticación.

Valor	Description
SystemAssignedManagedIdentity	Tipo SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Tipo UserAssignedManagedIdentity
Anonymous	Opción anónima
ArtifactPullSecret	Autenticación de secretos de extracción de artefactos

RegistryEndpointProperties

Objeto

Propiedades de RegistryEndpoint

Nombre	Tipo	Valor predeterminado	Description
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		La configuración de autenticación de Azure Container Registry.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Las entidades de certificación de firma usadas por los artefactos en el punto de conexión del Registro
healthState	ResourceHealthState	Unknown	El estado de mantenimiento del recurso.
host	string minLength: 3 maxLength: 63		El nombre de host del punto de conexión de Container Registry.
provisioningState	ProvisioningState		Estado de la última operación.

RegistryEndpointResource

Objeto

Recurso RegistryEndpoint

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación perimetral del recurso.
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties	RegistryEndpointProperties	Propiedades específicas del recurso para este recurso.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Objeto

Autenticación de identidad asignada por el sistema

Nombre	Tipo	Description
method	string: SystemAssignedManagedIdentity	Método de autenticación.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Propiedades de identidad administrada asignadas por el sistema

RegistryEndpointSystemAssignedManagedIdentitySettings

Objeto

Propiedades de identidad administrada asignadas por el sistema

Nombre	Tipo	Description
audience	string	Audiencia del servicio en la que se va a autenticar. Opcional; el valor predeterminado es la audiencia para la configuración del host del servicio.

RegistryEndpointTrustedSigningKeyConfigMap

Objeto

Configuración de la confianza de RegistryEndpoint proporcionada a través de un configmap.

Nombre	Tipo	Description
configMapRef	string	El nombre del mapa de configuración.
type	string: ConfigMap	El tipo de confianza para el punto de conexión del registro.

RegistryEndpointTrustedSigningKeySecret

Objeto

Configuración de la confianza de RegistryEndpoint proporcionada a través de un secreto.

Nombre	Tipo	Description
secretRef	string	Nombre del secreto.
type	string: Secret	El tipo de confianza para el punto de conexión del registro.

RegistryEndpointTrustedSigningKeyType

Enumeración

Valores de RegistryEndpointTrustedSigningKeyType

Valor	Description
Secret	Configuración de confianza almacenada en un secreto de Kubernetes.
ConfigMap	Configuración de confianza almacenada en un ConfigMap de Kubernetes.

RegistryEndpointUserAssignedIdentityAuthentication

Objeto

Autenticación de identidad asignada por el usuario

Nombre	Tipo	Description
method	string: UserAssignedManagedIdentity	Método de autenticación.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Propiedades de identidad administrada asignadas por el usuario

RegistryEndpointUserAssignedManagedIdentitySettings

Objeto

Propiedades de identidad administrada asignadas por el usuario

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad administrada asignada por el usuario.
scope	string	Identificador de recurso (URI de identificador de aplicación) del recurso, con el sufijo .default.
tenantId	string	Id. de inquilino.

ResourceHealthState

Enumeración

El estado de mantenimiento del recurso.

Valor	Description
Available	El recurso está disponible y funciona según lo esperado.
Degraded	El estado de los recursos se degrada.
Unavailable	El recurso no funciona como se esperaba.
Unknown	Se desconoce el estado del recurso.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Registry Endpoint - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Solicitud de ejemplo

Respuesta de muestra

Definiciones

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData