Registry Endpoint - Create Or Update

Servizio:: IoT Operations

Versione API:: 2026-03-01

Creare un oggetto RegistryEndpointResource

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome dell'istanza.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome della risorsa RegistryEndpoint
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	RegistryEndpointProperties	Proprietà specifiche della risorsa.

Risposte

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

Nome

Tipo

Descrizione

200 OK

RegistryEndpointResource

L'operazione di aggiornamento della risorsa 'RegistryEndpointResource' è riuscita

201 Created

RegistryEndpointResource

Operazione di creazione della risorsa 'RegistryEndpointResource' 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

RegistryEndpoint_CreateOrUpdate_MaximumSet

Esempio di richiesta

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

Risposta di esempio

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

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

Definizioni

Nome	Descrizione
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.
ProvisioningState	L'enumerazione che definisce lo stato della risorsa.
RegistryEndpointAnonymousAuthentication	Autenticazione anonima
RegistryEndpointArtifactPullSecretAuthentication	Autenticazione del segreto pull degli artefatti
RegistryEndpointArtifactPullSecretSettings	Proprietà di autenticazione del segreto pull dell'artefatto RegistryEndpoint
RegistryEndpointAuthenticationMethod	Metodo di autenticazione.
RegistryEndpointProperties	Proprietà di RegistryEndpoint
RegistryEndpointResource	Risorsa RegistryEndpoint
RegistryEndpointSystemAssignedIdentityAuthentication	Autenticazione dell'identità assegnata dal sistema
RegistryEndpointSystemAssignedManagedIdentitySettings	Proprietà dell'identità gestita assegnata dal sistema
RegistryEndpointTrustedSigningKeyConfigMap	Impostazioni per l'attendibilità RegistryEndpoint fornite tramite una configmap.
RegistryEndpointTrustedSigningKeySecret	Impostazioni per l'attendibilità RegistryEndpoint fornite tramite un segreto.
RegistryEndpointTrustedSigningKeyType	Valori di RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Autenticazione dell'identità assegnata dall'utente
RegistryEndpointUserAssignedManagedIdentitySettings	Proprietà dell'identità gestita assegnata dall'utente
ResourceHealthState	Stato di integrità della risorsa.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

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

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.

RegistryEndpointAnonymousAuthentication

Oggetto

Autenticazione anonima

Nome	Tipo	Descrizione
anonymousSettings	RegistryEndpointAnonymousSettings	Proprietà di autenticazione anonime
method	string: Anonymous	Metodo di autenticazione.

RegistryEndpointArtifactPullSecretAuthentication

Oggetto

Autenticazione del segreto pull degli artefatti

Nome	Tipo	Descrizione
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Proprietà di autenticazione del segreto pull artefatto
method	string: ArtifactPullSecret	Metodo di autenticazione.

RegistryEndpointArtifactPullSecretSettings

Oggetto

Proprietà di autenticazione del segreto pull dell'artefatto RegistryEndpoint

Nome	Tipo	Descrizione
secretRef	string	Nome del segreto kubernetes che contiene il segreto di estrazione dell'artefatto.

RegistryEndpointAuthenticationMethod

Enumerazione

Metodo di autenticazione.

Valore	Descrizione
SystemAssignedManagedIdentity	Tipo SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Tipo UserAssignedManagedIdentity
Anonymous	Opzione anonima
ArtifactPullSecret	Autenticazione del segreto pull degli artefatti

RegistryEndpointProperties

Oggetto

Proprietà di RegistryEndpoint

Nome	Tipo	Valore predefinito	Descrizione
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		Impostazioni di autenticazione per il Registro Azure Container.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Autorità di certificazione di firma utilizzate dagli elementi nell'endpoint del Registro di sistema
healthState	ResourceHealthState	Unknown	Stato di integrità della risorsa.
host	string minLength: 3 maxLength: 63		Nome host dell'endpoint del Registro Container.
provisioningState	ProvisioningState		Stato dell'ultima operazione.

RegistryEndpointResource

Oggetto

Risorsa RegistryEndpoint

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

RegistryEndpointSystemAssignedIdentityAuthentication

Oggetto

Autenticazione dell'identità assegnata dal sistema

Nome	Tipo	Descrizione
method	string: SystemAssignedManagedIdentity	Metodo di autenticazione.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Proprietà dell'identità gestita assegnata dal sistema

RegistryEndpointSystemAssignedManagedIdentitySettings

Oggetto

Proprietà dell'identità gestita assegnata dal sistema

Nome	Tipo	Descrizione
audience	string	Destinatari del servizio per l'autenticazione. Opzionale; il valore predefinito è il gruppo di destinatari per la configurazione host del servizio.

RegistryEndpointTrustedSigningKeyConfigMap

Oggetto

Impostazioni per l'attendibilità RegistryEndpoint fornite tramite una configmap.

Nome	Tipo	Descrizione
configMapRef	string	Il nome della configmap.
type	string: ConfigMap	Tipo di attendibilità per l'endpoint del Registro di sistema.

RegistryEndpointTrustedSigningKeySecret

Oggetto

Impostazioni per l'attendibilità RegistryEndpoint fornite tramite un segreto.

Nome	Tipo	Descrizione
secretRef	string	Nome del segreto.
type	string: Secret	Tipo di attendibilità per l'endpoint del Registro di sistema.

RegistryEndpointTrustedSigningKeyType

Enumerazione

Valori di RegistryEndpointTrustedSigningKeyType

Valore	Descrizione
Secret	Considera attendibili le impostazioni archiviate in un segreto Kubernetes.
ConfigMap	Considera attendibili le impostazioni archiviate in una ConfigMap Kubernetes.

RegistryEndpointUserAssignedIdentityAuthentication

Oggetto

Autenticazione dell'identità assegnata dall'utente

Nome	Tipo	Descrizione
method	string: UserAssignedManagedIdentity	Metodo di autenticazione.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Proprietà dell'identità gestita assegnata dall'utente

RegistryEndpointUserAssignedManagedIdentitySettings

Oggetto

Proprietà dell'identità gestita assegnata dall'utente

Nome	Tipo	Descrizione
clientId	string	ID client per l'identità gestita assegnata dall'utente.
scope	string	Identificatore di risorsa (URI ID applicazione) della risorsa, affissa con il suffisso predefinito.
tenantId	string	ID inquilino.

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.

Condividi tramite

Registry Endpoint - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

RegistryEndpoint_CreateOrUpdate_MaximumSet

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData