Registry Endpoint - Create Or Update

Serviço:: IoT Operations

Versão API:: 2026-03-01

Criar um RegistryEndpointResource

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

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
instanceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome da instância.
registryEndpointName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nome do recurso RegistryEndpoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Órgão do Pedido

Nome	Tipo	Descrição
extendedLocation	ExtendedLocation	Localização de borda do recurso.
properties	RegistryEndpointProperties	As propriedades específicas do recurso para este recurso.

Respostas

Nome	Tipo	Descrição
200 OK	RegistryEndpointResource	Operação de atualização do recurso 'RegistryEndpointResource' bem-sucedida
201 Created	RegistryEndpointResource	Recurso 'RegistryEndpointResource' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Descrição

200 OK

RegistryEndpointResource

Operação de atualização do recurso 'RegistryEndpointResource' bem-sucedida

201 Created

RegistryEndpointResource

Recurso 'RegistryEndpointResource' criar operação bem-sucedida

Cabeçalhos

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Pedido de exemplo

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

Resposta de exemplo

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Nome	Descrição
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	O local estendido é uma extensão dos locais do Azure. Eles fornecem uma maneira de usar seus clusters Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.
ExtendedLocationType	O enum que define o tipo de ExtendedLocation aceito.
ProvisioningState	O enum que define o status do recurso.
RegistryEndpointAnonymousAuthentication	Autenticação anónima
RegistryEndpointArtifactPullSecretAuthentication	Autenticação Artifact Pull Secret
RegistryEndpointArtifactPullSecretSettings	Propriedades de autenticação RegistryEndpoint Artifact Pull Secret
RegistryEndpointAuthenticationMethod	O método de autenticação.
RegistryEndpointProperties	Propriedades RegistryEndpoint
RegistryEndpointResource	Recurso RegistryEndpoint
RegistryEndpointSystemAssignedIdentityAuthentication	Autenticação de identidade atribuída pelo sistema
RegistryEndpointSystemAssignedManagedIdentitySettings	Propriedades de identidade gerenciada atribuídas pelo sistema
RegistryEndpointTrustedSigningKeyConfigMap	Configurações para a confiança do RegistryEndpoint fornecidas por meio de um configmap.
RegistryEndpointTrustedSigningKeySecret	Configurações para confiança RegistryEndpoint fornecidas por meio de um segredo.
RegistryEndpointTrustedSigningKeyType	Valores RegistryEndpointTrustedSigningKeyType
RegistryEndpointUserAssignedIdentityAuthentication	Autenticação de identidade atribuída pelo usuário
RegistryEndpointUserAssignedManagedIdentitySettings	Propriedades de identidade gerenciada atribuídas pelo usuário
ResourceHealthState	O estado de saúde do recurso.
systemData	Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

Nome	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objetivo

Resposta de erro

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Objetivo

O local estendido é uma extensão dos locais do Azure. Eles fornecem uma maneira de usar seus clusters Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.

Nome	Tipo	Descrição
name	string	O nome do local estendido.
type	ExtendedLocationType	Tipo de ExtendedLocation.

ExtendedLocationType

Enumeração

O enum que define o tipo de ExtendedLocation aceito.

Valor	Descrição
CustomLocation	Tipo CustomLocation

ProvisioningState

Enumeração

O enum que define o status do recurso.

Valor	Descrição
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Provisioning	O recurso está sendo provisionado.
Updating	O recurso está se atualizando.
Deleting	O recurso está sendo excluído.
Accepted	O recurso foi aceito.

RegistryEndpointAnonymousAuthentication

Objetivo

Autenticação anónima

Nome	Tipo	Descrição
anonymousSettings	RegistryEndpointAnonymousSettings	Propriedades de autenticação anônima
method	string: Anonymous	O método de autenticação.

RegistryEndpointArtifactPullSecretAuthentication

Objetivo

Autenticação Artifact Pull Secret

Nome	Tipo	Descrição
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Propriedades de autenticação Artifact Pull Secret
method	string: ArtifactPullSecret	O método de autenticação.

RegistryEndpointArtifactPullSecretSettings

Objetivo

Propriedades de autenticação RegistryEndpoint Artifact Pull Secret

Nome	Tipo	Descrição
secretRef	string	O nome do segredo do kubernetes que contém o segredo de extração de artefato.

RegistryEndpointAuthenticationMethod

Enumeração

O método de autenticação.

Valor	Descrição
SystemAssignedManagedIdentity	Tipo SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Tipo UserAssignedManagedIdentity
Anonymous	Opção anónima
ArtifactPullSecret	Autenticação Artifact Pull Secret

RegistryEndpointProperties

Objetivo

Propriedades RegistryEndpoint

Nome	Tipo	Valor padrão	Descrição
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		As configurações de autenticação para o Registro de Contêiner do Azure.
codeSigningCas	RegistryEndpointTrustedSigningKey[]: RegistryEndpointTrustedSigningKeyConfigMap[] RegistryEndpointTrustedSigningKeySecret[]		As autoridades de certificação de assinatura usadas por artefatos no ponto de extremidade do Registro
healthState	ResourceHealthState	Unknown	O estado de saúde do recurso.
host	string minLength: 3 maxLength: 63		O nome do host do ponto de extremidade do Registro de Contêiner.
provisioningState	ProvisioningState		O status da última operação.

RegistryEndpointResource

Objetivo

Recurso RegistryEndpoint

Nome	Tipo	Descrição
extendedLocation	ExtendedLocation	Localização de borda do recurso.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties	RegistryEndpointProperties	As propriedades específicas do recurso para este recurso.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Objetivo

Autenticação de identidade atribuída pelo sistema

Nome	Tipo	Descrição
method	string: SystemAssignedManagedIdentity	O método de autenticação.
systemAssignedManagedIdentitySettings	RegistryEndpointSystemAssignedManagedIdentitySettings	Propriedades de identidade gerenciada atribuídas pelo sistema

RegistryEndpointSystemAssignedManagedIdentitySettings

Objetivo

Propriedades de identidade gerenciada atribuídas pelo sistema

Nome	Tipo	Descrição
audience	string	Audiência do serviço para autenticar contra. Opcional; padrão para a audiência para a configuração do host de serviço.

RegistryEndpointTrustedSigningKeyConfigMap

Objetivo

Configurações para a confiança do RegistryEndpoint fornecidas por meio de um configmap.

Nome	Tipo	Descrição
configMapRef	string	O nome do configmap.
type	string: ConfigMap	O tipo de confiança para o ponto de extremidade do Registro.

RegistryEndpointTrustedSigningKeySecret

Objetivo

Configurações para confiança RegistryEndpoint fornecidas por meio de um segredo.

Nome	Tipo	Descrição
secretRef	string	O nome do segredo.
type	string: Secret	O tipo de confiança para o ponto de extremidade do Registro.

RegistryEndpointTrustedSigningKeyType

Enumeração

Valores RegistryEndpointTrustedSigningKeyType

Valor	Descrição
Secret	Configurações de confiança armazenadas em um segredo do Kubernetes.
ConfigMap	Configurações de confiança armazenadas em um Kubernetes ConfigMap.

RegistryEndpointUserAssignedIdentityAuthentication

Objetivo

Autenticação de identidade atribuída pelo usuário

Nome	Tipo	Descrição
method	string: UserAssignedManagedIdentity	O método de autenticação.
userAssignedManagedIdentitySettings	RegistryEndpointUserAssignedManagedIdentitySettings	Propriedades de identidade gerenciada atribuídas pelo usuário

RegistryEndpointUserAssignedManagedIdentitySettings

Objetivo

Propriedades de identidade gerenciada atribuídas pelo usuário

Nome	Tipo	Descrição
clientId	string	ID do cliente para a identidade gerenciada atribuída pelo usuário.
scope	string	Identificador de recurso (URI de ID do aplicativo) do recurso, afixado com o sufixo .default.
tenantId	string	ID do inquilino.

ResourceHealthState

Enumeração

O estado de saúde do recurso.

Valor	Descrição
Available	O recurso está disponível e funcionando conforme o esperado.
Degraded	A integridade dos recursos está degradada.
Unavailable	O recurso não está funcionando como esperado.
Unknown	O estado do recurso é desconhecido.

systemData

Objetivo

Metadados referentes à criação e última modificação do recurso.

Nome	Tipo	Descrição
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Registry Endpoint - Create Or Update

Parâmetros URI

Órgão do Pedido

Respostas

Segurança

azure_auth

Alcances

Exemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Pedido de exemplo

Resposta de exemplo

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationType

ProvisioningState

RegistryEndpointAnonymousAuthentication

RegistryEndpointArtifactPullSecretAuthentication

RegistryEndpointArtifactPullSecretSettings

RegistryEndpointAuthenticationMethod

RegistryEndpointProperties

RegistryEndpointResource

RegistryEndpointSystemAssignedIdentityAuthentication

RegistryEndpointSystemAssignedManagedIdentitySettings

RegistryEndpointTrustedSigningKeyConfigMap

RegistryEndpointTrustedSigningKeySecret

RegistryEndpointTrustedSigningKeyType

RegistryEndpointUserAssignedIdentityAuthentication

RegistryEndpointUserAssignedManagedIdentitySettings

ResourceHealthState

systemData