Registry Endpoint - Create Or Update

Usługa:: IoT Operations

Wersja API:: 2026-03-01

Tworzenie zasobu RegistryEndpointResource

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

Parametry URI

Nazwa	W	Wymagane	Typ	Opis
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nazwa wystąpienia.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nazwa zasobu RegistryEndpoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Ciało żądania

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	Lokalizacja krawędzi zasobu.
properties	RegistryEndpointProperties	Właściwości specyficzne dla zasobu dla tego zasobu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RegistryEndpointResource	Operacja aktualizacji zasobu "RegistryEndpointResource" powiodła się
201 Created	RegistryEndpointResource	Operacja tworzenia zasobu "RegistryEndpointResource" powiodła się Nagłówki Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

200 OK

RegistryEndpointResource

Operacja aktualizacji zasobu "RegistryEndpointResource" powiodła się

201 Created

RegistryEndpointResource

Operacja tworzenia zasobu "RegistryEndpointResource" powiodła się

Nagłówki

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

RegistryEndpoint_CreateOrUpdate_MaximumSet

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:: 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"
  }
}

Kod statusu:: 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"
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocation	Lokalizacja rozszerzona jest rozszerzeniem lokalizacji platformy Azure. Umożliwiają one korzystanie z klastrów Kubernetes z obsługą usługi Azure ARC jako lokalizacji docelowych do wdrażania wystąpień usług platformy Azure.
ExtendedLocationType	Akceptowano typ wyliczenia definiujący ExtendedLocation.
ProvisioningState	Wyliczenie definiujące stan zasobu.
RegistryEndpointAnonymousAuthentication	Uwierzytelnianie anonimowe
RegistryEndpointArtifactPullSecretAuthentication	Uwierzytelnianie wpisu tajnego ściągania artefaktów
RegistryEndpointArtifactPullSecretSettings	Właściwości uwierzytelniania wpisu tajnego ściągania artefaktu rejestru RegistryEndpoint Artifact Pull Secret authentication properties
RegistryEndpointAuthenticationMethod	Metoda uwierzytelniania.
RegistryEndpointProperties	Właściwości RegistryEndpoint
RegistryEndpointResource	Zasób RegistryEndpoint
RegistryEndpointSystemAssignedIdentityAuthentication	Uwierzytelnianie tożsamości przypisanej przez system
RegistryEndpointSystemAssignedManagedIdentitySettings	Właściwości tożsamości zarządzanej przypisane przez system
RegistryEndpointTrustedSigningKeyConfigMap	Ustawienia zaufania punktu końcowego rejestru udostępniane za pośrednictwem mapy konfiguracji.
RegistryEndpointTrustedSigningKeySecret	Ustawienia zaufania punktu końcowego rejestru udostępniane za pośrednictwem wpisu tajnego.
RegistryEndpointTrustedSigningKeyType	Wartości RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Uwierzytelnianie tożsamości przypisanej przez użytkownika
RegistryEndpointUserAssignedManagedIdentitySettings	Właściwości tożsamości zarządzanej przypisanej przez użytkownika
ResourceHealthState	Stan kondycji zasobu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Sprzeciwiać się

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Sprzeciwiać się

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Sprzeciwiać się

Lokalizacja rozszerzona jest rozszerzeniem lokalizacji platformy Azure. Umożliwiają one korzystanie z klastrów Kubernetes z obsługą usługi Azure ARC jako lokalizacji docelowych do wdrażania wystąpień usług platformy Azure.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	ExtendedLocationType	Typ extendedLocation.

ExtendedLocationType

Wyliczenie

Akceptowano typ wyliczenia definiujący ExtendedLocation.

Wartość	Opis
CustomLocation	Typ CustomLocation

ProvisioningState

Wyliczenie

Wyliczenie definiujące stan zasobu.

Wartość	Opis
Succeeded	Zasób został utworzony.
Failed	Tworzenie zasobu nie powiodło się.
Canceled	Tworzenie zasobu zostało anulowane.
Provisioning	Zasób jest aprowizowany.
Updating	Zasób jest aktualizowany.
Deleting	Zasób jest usuwany.
Accepted	Zasób został zaakceptowany.

RegistryEndpointAnonymousAuthentication

Sprzeciwiać się

Uwierzytelnianie anonimowe

Nazwa	Typ	Opis
anonymousSettings	RegistryEndpointAnonymousSettings	Właściwości uwierzytelniania anonimowego
method	string: Anonymous	Metoda uwierzytelniania.

RegistryEndpointArtifactPullSecretAuthentication

Sprzeciwiać się

Uwierzytelnianie wpisu tajnego ściągania artefaktów

Nazwa	Typ	Opis
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Właściwości uwierzytelniania wpisu tajnego ściągania artefaktu
method	string: ArtifactPullSecret	Metoda uwierzytelniania.

RegistryEndpointArtifactPullSecretSettings

Sprzeciwiać się

Właściwości uwierzytelniania wpisu tajnego ściągania artefaktu rejestru RegistryEndpoint Artifact Pull Secret authentication properties

Nazwa	Typ	Opis
secretRef	string	Nazwa wpisu tajnego kubernetes, który zawiera wpis tajny ściągania artefaktu.

RegistryEndpointAuthenticationMethod

Wyliczenie

Metoda uwierzytelniania.

Wartość	Opis
SystemAssignedManagedIdentity	Typ tożsamości SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Typ UserAssignedManagedIdentity
Anonymous	Opcja anonimowa
ArtifactPullSecret	Uwierzytelnianie wpisu tajnego ściągania artefaktów

RegistryEndpointProperties

Sprzeciwiać się

Właściwości RegistryEndpoint

Nazwa	Typ	Wartość domyślna	Opis
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		Ustawienia uwierzytelniania dla Azure Container Registry.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		Urzędy certyfikacji podpisywania używane przez artefakty w punkcie końcowym rejestru
healthState	ResourceHealthState	Unknown	Stan kondycji zasobu.
host	string minLength: 3 maxLength: 63		Nazwa hosta punktu końcowego usługi Container Registry.
provisioningState	ProvisioningState		Stan ostatniej operacji.

RegistryEndpointResource

Sprzeciwiać się

Zasób RegistryEndpoint

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	Lokalizacja krawędzi zasobu.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties	RegistryEndpointProperties	Właściwości specyficzne dla zasobu dla tego zasobu.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Sprzeciwiać się

Uwierzytelnianie tożsamości przypisanej przez system

Nazwa	Typ	Opis
method	string: SystemAssignedManagedIdentity	Metoda uwierzytelniania.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Właściwości tożsamości zarządzanej przypisane przez system

RegistryEndpointSystemAssignedManagedIdentitySettings

Sprzeciwiać się

Właściwości tożsamości zarządzanej przypisane przez system

Nazwa	Typ	Opis
audience	string	Odbiorcy usługi do uwierzytelniania. Fakultatywny; wartość domyślna dla odbiorców konfiguracji hosta usługi.

RegistryEndpointTrustedSigningKeyConfigMap

Sprzeciwiać się

Ustawienia zaufania punktu końcowego rejestru udostępniane za pośrednictwem mapy konfiguracji.

Nazwa	Typ	Opis
configMapRef	string	Nazwa mapy konfiguracyjnej.
type	string: ConfigMap	Typ zaufania dla punktu końcowego rejestru.

RegistryEndpointTrustedSigningKeySecret

Sprzeciwiać się

Ustawienia zaufania punktu końcowego rejestru udostępniane za pośrednictwem wpisu tajnego.

Nazwa	Typ	Opis
secretRef	string	Nazwa wpisu tajnego.
type	string: Secret	Typ zaufania dla punktu końcowego rejestru.

RegistryEndpointTrustedSigningKeyType

Wyliczenie

Wartości RegistryEndpointTrustedSigningKeyType

Wartość	Opis
Secret	Ufaj ustawieniom przechowywanym w wpisie tajnym kubernetes.
ConfigMap	Ufaj ustawieniom przechowywanym w Kubernetes ConfigMap.

RegistryEndpointUserAssignedIdentityAuthentication

Sprzeciwiać się

Uwierzytelnianie tożsamości przypisanej przez użytkownika

Nazwa	Typ	Opis
method	string: UserAssignedManagedIdentity	Metoda uwierzytelniania.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Właściwości tożsamości zarządzanej przypisanej przez użytkownika

RegistryEndpointUserAssignedManagedIdentitySettings

Sprzeciwiać się

Właściwości tożsamości zarządzanej przypisanej przez użytkownika

Nazwa	Typ	Opis
clientId	string	Identyfikator klienta tożsamości zarządzanej przypisanej przez użytkownika.
scope	string	Identyfikator zasobu (identyfikator URI identyfikatora aplikacji) zasobu umieszczony z sufiksem domyślnym.
tenantId	string	Identyfikator dzierżawy.

ResourceHealthState

Wyliczenie

Stan kondycji zasobu.

Wartość	Opis
Available	Zasób jest dostępny i działa zgodnie z oczekiwaniami.
Degraded	Kondycja zasobów jest obniżona.
Unavailable	Zasób nie działa zgodnie z oczekiwaniami.
Unknown	Stan zasobu jest nieznany.

systemData

Sprzeciwiać się

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

Registry Endpoint - Create Or Update

Parametry URI

Ciało żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresów

Przykłady

RegistryEndpoint_CreateOrUpdate_MaximumSet

Przykładowa prośba

Przykładowa odpowiedź

Definicje

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData