Registry Endpoint - Create Or Update

Služba:: IoT Operations

Verze rozhraní API:: 2026-03-01

Vytvoření prostředku RegistryEndpointResource

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Název instance.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Název prostředku RegistryEndpoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
extendedLocation	ExtendedLocation	Hraniční umístění prostředku.
properties	RegistryEndpointProperties	Vlastnosti specifické pro prostředek pro tento prostředek.

Odpovědi

Name	Typ	Description
200 OK	RegistryEndpointResource	Operace aktualizace prostředku RegistryEndpointResource byla úspěšná
201 Created	RegistryEndpointResource	Operace vytvoření prostředku RegistryEndpointResource byla úspěšná Hlavičky Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

RegistryEndpointResource

Operace aktualizace prostředku RegistryEndpointResource byla úspěšná

201 Created

RegistryEndpointResource

Operace vytvoření prostředku RegistryEndpointResource byla úspěšná

Hlavičky

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

RegistryEndpoint_CreateOrUpdate_MaximumSet

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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"
  }
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Rozšířená lokalita je rozšířením lokalit Azure. Poskytují způsob, jak používat clustery Kubernetes s podporou Azure ARC jako cílová umístění pro nasazení instancí služeb Azure.
ExtendedLocationType	Typ definující výčet ExtendedLocation byl přijat.
ProvisioningState	Výčet definující stav zdroje.
RegistryEndpointAnonymousAuthentication	Anonymní ověření
RegistryEndpointArtifactPullSecretAuthentication	Ověřování tajného klíče vyžádaného artefaktu
RegistryEndpointArtifactPullSecretSettings	Vlastnosti ověřování tajného klíče vyžádané replikace artefaktu registruEndpoint
RegistryEndpointAuthenticationMethod	Metoda ověřování.
RegistryEndpointProperties	Vlastnosti RegistryEndpoint
RegistryEndpointResource	Prostředek koncového bodu registru
RegistryEndpointSystemAssignedIdentityAuthentication	Ověření identity přiřazené systémem
RegistryEndpointSystemAssignedManagedIdentitySettings	Vlastnosti spravované identity přiřazené systémem
RegistryEndpointTrustedSigningKeyConfigMap	Nastavení důvěryhodnosti RegistryEndpoint poskytované prostřednictvím mapy konfigurace.
RegistryEndpointTrustedSigningKeySecret	Nastavení důvěryhodnosti RegistryEndpoint poskytované prostřednictvím tajného klíče.
RegistryEndpointTrustedSigningKeyType	Hodnoty RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Ověření identity přiřazené uživatelem
RegistryEndpointUserAssignedManagedIdentitySettings	Vlastnosti spravované identity přiřazené uživatelem
ResourceHealthState	Stav prostředku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Objekt

Rozšířená lokalita je rozšířením lokalit Azure. Poskytují způsob, jak používat clustery Kubernetes s podporou Azure ARC jako cílová umístění pro nasazení instancí služeb Azure.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationType	Typ ExtendedLocation.

ExtendedLocationType

Výčet

Typ definující výčet ExtendedLocation byl přijat.

Hodnota	Description
CustomLocation	Typ CustomLocation

ProvisioningState

Výčet

Výčet definující stav zdroje.

Hodnota	Description
Succeeded	Zdroj byl vytvořen.
Failed	Vytvoření zdroje se nezdařilo.
Canceled	Vytváření zdrojů bylo zrušeno.
Provisioning	Prostředek se zřizuje.
Updating	Zdroj se aktualizuje.
Deleting	Prostředek se odstraňuje.
Accepted	Zdroj byl přijat.

RegistryEndpointAnonymousAuthentication

Objekt

Anonymní ověření

Name	Typ	Description
anonymousSettings	RegistryEndpointAnonymousSettings	Vlastnosti anonymního ověřování
method	string: Anonymous	Metoda ověřování.

RegistryEndpointArtifactPullSecretAuthentication

Objekt

Ověřování tajného klíče vyžádaného artefaktu

Name	Typ	Description
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Vlastnosti ověřování tajného klíče vyžádaného artefaktu
method	string: ArtifactPullSecret	Metoda ověřování.

RegistryEndpointArtifactPullSecretSettings

Objekt

Vlastnosti ověřování tajného klíče vyžádané replikace artefaktu registruEndpoint

Name	Typ	Description
secretRef	string	Název tajného klíče kubernetes, který obsahuje tajný klíč pro vyžádání artefaktů.

RegistryEndpointAuthenticationMethod

Výčet

Metoda ověřování.

Hodnota	Description
SystemAssignedManagedIdentity	Typ SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Typ UserAssignedManagedIdentity
Anonymous	Anonymní možnost
ArtifactPullSecret	Ověřování tajného klíče vyžádaného artefaktu

RegistryEndpointProperties

Objekt

Vlastnosti RegistryEndpoint

Name	Typ	Default value	Description
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		Nastavení ověřování pro Azure Container Registry.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Podpisové certifikační autority používané artefakty v koncovém bodu registru
healthState	ResourceHealthState	Unknown	Stav prostředku.
host	string minLength: 3 maxLength: 63		Název hostitele koncového bodu služby Container Registry.
provisioningState	ProvisioningState		Stav poslední operace.

RegistryEndpointResource

Objekt

Prostředek koncového bodu registru

Name	Typ	Description
extendedLocation	ExtendedLocation	Hraniční umístění prostředku.
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	RegistryEndpointProperties	Vlastnosti specifické pro prostředek pro tento prostředek.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Objekt

Ověření identity přiřazené systémem

Name	Typ	Description
method	string: SystemAssignedManagedIdentity	Metoda ověřování.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Vlastnosti spravované identity přiřazené systémem

RegistryEndpointSystemAssignedManagedIdentitySettings

Objekt

Vlastnosti spravované identity přiřazené systémem

Name	Typ	Description
audience	string	Cílová skupina služby k ověření. Volitelný; výchozí hodnota cílové skupiny pro konfiguraci hostitele služby.

RegistryEndpointTrustedSigningKeyConfigMap

Objekt

Nastavení důvěryhodnosti RegistryEndpoint poskytované prostřednictvím mapy konfigurace.

Name	Typ	Description
configMapRef	string	Název mapy konfigurace.
type	string: ConfigMap	Typ vztahu důvěryhodnosti pro koncový bod registru.

RegistryEndpointTrustedSigningKeySecret

Objekt

Nastavení důvěryhodnosti RegistryEndpoint poskytované prostřednictvím tajného klíče.

Name	Typ	Description
secretRef	string	Název tajného klíče.
type	string: Secret	Typ vztahu důvěryhodnosti pro koncový bod registru.

RegistryEndpointTrustedSigningKeyType

Výčet

Hodnoty RegistryEndpointTrustedSigningKeyType

Hodnota	Description
Secret	Nastavení důvěryhodnosti uložená v tajném klíči Kubernetes.
ConfigMap	Nastavení důvěryhodnosti uložená v Kubernetes ConfigMap.

RegistryEndpointUserAssignedIdentityAuthentication

Objekt

Ověření identity přiřazené uživatelem

Name	Typ	Description
method	string: UserAssignedManagedIdentity	Metoda ověřování.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Vlastnosti spravované identity přiřazené uživatelem

RegistryEndpointUserAssignedManagedIdentitySettings

Objekt

Vlastnosti spravované identity přiřazené uživatelem

Name	Typ	Description
clientId	string	ID klienta pro spravovanou identitu přiřazenou uživatelem
scope	string	Identifikátor prostředku (identifikátor URI ID aplikace) prostředku, připevněný s příponou .default.
tenantId	string	ID klienta.

ResourceHealthState

Výčet

Stav prostředku.

Hodnota	Description
Available	Zdroj je k dispozici a funguje podle očekávání.
Degraded	Stav prostředků je omezený.
Unavailable	Prostředek nefunguje podle očekávání.
Unknown	Stav prostředku není znám.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Registry Endpoint - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

RegistryEndpoint_CreateOrUpdate_MaximumSet

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData