Registry Endpoint - Create Or Update

Tjänst:: IoT Operations

API-versionen:: 2026-03-01

Skapa en RegistryEndpointResource

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Namnet på instansen.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Namnet på RegistryEndpoint-resursen
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begäranarorgan

Namn	Typ	Beskrivning
extendedLocation	ExtendedLocation	Resursens gränsplats.
properties	RegistryEndpointProperties	Resursspecifika egenskaper för den här resursen.

Svaren

Namn	Typ	Beskrivning
200 OK	RegistryEndpointResource	Uppdateringsåtgärden för resursen "RegistryEndpointResource" lyckades
201 Created	RegistryEndpointResource	Resursen "RegistryEndpointResource" för att skapa åtgärden lyckades Headers Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Namn

Typ

Beskrivning

200 OK

RegistryEndpointResource

Uppdateringsåtgärden för resursen "RegistryEndpointResource" lyckades

201 Created

RegistryEndpointResource

Resursen "RegistryEndpointResource" för att skapa åtgärden lyckades

Headers

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

RegistryEndpoint_CreateOrUpdate_MaximumSet

Exempelförfrågan

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

Exempelsvar

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

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

Definitioner

Namn	Beskrivning
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ExtendedLocation	Utökad plats är en utökning av Azure-platser. De är ett sätt att använda sina Azure ARC-aktiverade Kubernetes-kluster som målplatser för att distribuera instanser av Azure-tjänster.
ExtendedLocationType	Uppräkningen som definierar typen av ExtendedLocation accepterad.
ProvisioningState	Uppräkningen som definierar status för resursen.
RegistryEndpointAnonymousAuthentication	Anonym autentisering
RegistryEndpointArtifactPullSecretAuthentication	Autentisering med artefakthämtningshemlighet
RegistryEndpointArtifactPullSecretSettings	Egenskaper för autentisering med RegistryEndpoint-artefakt för att hämta hemlighet
RegistryEndpointAuthenticationMethod	Autentiseringsmetoden.
RegistryEndpointProperties	Egenskaper för RegistryEndpoint
RegistryEndpointResource	RegistryEndpoint-resurs
RegistryEndpointSystemAssignedIdentityAuthentication	Systemtilldelad identitetsautentisering
RegistryEndpointSystemAssignedManagedIdentitySettings	Egenskaper för systemtilldelad hanterad identitet
RegistryEndpointTrustedSigningKeyConfigMap	Inställningar för RegistryEndpoint förtroende som tillhandahålls via en configmap.
RegistryEndpointTrustedSigningKeySecret	Inställningar för RegistryEndpoint förtroende som tillhandahålls via en hemlighet.
RegistryEndpointTrustedSigningKeyType	RegistryEndpointTrustedSigningKeyType-värden
RegistryEndpointUserAssignedIdentityAuthentication	Användartilldelad identitetsautentisering
RegistryEndpointUserAssignedManagedIdentitySettings	Användartilldelade egenskaper för hanterad identitet
ResourceHealthState	Resursens hälsotillstånd.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Beskrivning
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felet riktas.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felet objektet.

ExtendedLocation

Objekt

Utökad plats är en utökning av Azure-platser. De är ett sätt att använda sina Azure ARC-aktiverade Kubernetes-kluster som målplatser för att distribuera instanser av Azure-tjänster.

Namn	Typ	Beskrivning
name	string	Namnet på den utökade platsen.
type	ExtendedLocationType	Typ av ExtendedLocation.

ExtendedLocationType

Uppräkning

Uppräkningen som definierar typen av ExtendedLocation accepterad.

Värde	Beskrivning
CustomLocation	CustomLocation-typ

ProvisioningState

Uppräkning

Uppräkningen som definierar status för resursen.

Värde	Beskrivning
Succeeded	Resursen har skapats.
Failed	Det gick inte att skapa resurser.
Canceled	Resursskapandet avbröts.
Provisioning	Resursen etableras.
Updating	Resursen uppdateras.
Deleting	Resursen tas bort.
Accepted	Resursen har godkänts.

RegistryEndpointAnonymousAuthentication

Objekt

Anonym autentisering

Namn	Typ	Beskrivning
anonymousSettings	RegistryEndpointAnonymousSettings	Egenskaper för anonym autentisering
method	string: Anonymous	Autentiseringsmetoden.

RegistryEndpointArtifactPullSecretAuthentication

Objekt

Autentisering med artefakthämtningshemlighet

Namn	Typ	Beskrivning
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Autentiseringsegenskaper för artefakthämtningshemlighet
method	string: ArtifactPullSecret	Autentiseringsmetoden.

RegistryEndpointArtifactPullSecretSettings

Objekt

Egenskaper för autentisering med RegistryEndpoint-artefakt för att hämta hemlighet

Namn	Typ	Beskrivning
secretRef	string	Namnet på kubernetes-hemligheten som innehåller artefaktens pull-hemlighet.

RegistryEndpointAuthenticationMethod

Uppräkning

Autentiseringsmetoden.

Värde	Beskrivning
SystemAssignedManagedIdentity	Typ av SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Typ av UserAssignedManagedIdentity
Anonymous	Anonymt alternativ
ArtifactPullSecret	Autentisering med artefakthämtningshemlighet

RegistryEndpointProperties

Objekt

Egenskaper för RegistryEndpoint

Namn	Typ	Standardvärde	Beskrivning
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		Autentiseringsinställningarna för Azure Container Registry.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Utfärdare av signeringscertifikat som används av artefakter i registerslutpunkten
healthState	ResourceHealthState	Unknown	Resursens hälsotillstånd.
host	string minLength: 3 maxLength: 63		Värdnamnet för Container Registry-slutpunkten.
provisioningState	ProvisioningState		Status för den senaste åtgärden.

RegistryEndpointResource

Objekt

RegistryEndpoint-resurs

Namn	Typ	Beskrivning
extendedLocation	ExtendedLocation	Resursens gränsplats.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties	RegistryEndpointProperties	Resursspecifika egenskaper för den här resursen.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Objekt

Systemtilldelad identitetsautentisering

Namn	Typ	Beskrivning
method	string: SystemAssignedManagedIdentity	Autentiseringsmetoden.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Egenskaper för systemtilldelad hanterad identitet

RegistryEndpointSystemAssignedManagedIdentitySettings

Objekt

Egenskaper för systemtilldelad hanterad identitet

Namn	Typ	Beskrivning
audience	string	Målgrupp för tjänsten att autentisera mot. Valfri; standardvärdet för målgruppen för konfiguration av tjänstvärdar.

RegistryEndpointTrustedSigningKeyConfigMap

Objekt

Inställningar för RegistryEndpoint förtroende som tillhandahålls via en configmap.

Namn	Typ	Beskrivning
configMapRef	string	Namnet på konfigurationskartan.
type	string: ConfigMap	Förtroendetypen för registerslutpunkten.

RegistryEndpointTrustedSigningKeySecret

Objekt

Inställningar för RegistryEndpoint förtroende som tillhandahålls via en hemlighet.

Namn	Typ	Beskrivning
secretRef	string	Namnet på hemligheten.
type	string: Secret	Förtroendetypen för registerslutpunkten.

RegistryEndpointTrustedSigningKeyType

Uppräkning

RegistryEndpointTrustedSigningKeyType-värden

Värde	Beskrivning
Secret	Förtroendeinställningar som lagras i en Kubernetes-hemlighet.
ConfigMap	Förtroendeinställningar som lagras i en Kubernetes ConfigMap.

RegistryEndpointUserAssignedIdentityAuthentication

Objekt

Användartilldelad identitetsautentisering

Namn	Typ	Beskrivning
method	string: UserAssignedManagedIdentity	Autentiseringsmetoden.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Användartilldelade egenskaper för hanterad identitet

RegistryEndpointUserAssignedManagedIdentitySettings

Objekt

Användartilldelade egenskaper för hanterad identitet

Namn	Typ	Beskrivning
clientId	string	Klient-ID för den användartilldelade hanterade identiteten.
scope	string	Resursidentifierare (program-ID URI) för resursen, fäst med .default-suffixet.
tenantId	string	Klientorganisations-ID.

ResourceHealthState

Uppräkning

Resursens hälsotillstånd.

Värde	Beskrivning
Available	Resursen är tillgänglig och fungerar som förväntat.
Degraded	Resurshälsan försämras.
Unavailable	Resursen fungerar inte som förväntat.
Unknown	Resurstillståndet är okänt.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Namn	Typ	Beskrivning
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Registry Endpoint - Create Or Update

URI-parametrar

Begäranarorgan

Svaren

Säkerhet

azure_auth

Scope

Exempel

RegistryEndpoint_CreateOrUpdate_MaximumSet

Exempelförfrågan

Exempelsvar

Definitioner

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData