Registry Endpoint - Create Or Update

Serviço:: IoT Operations

Versão da 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 de URI

Nome	Em	Obrigatório	Tipo	Description
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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
extendedLocation	ExtendedLocation	Local de borda do recurso.
properties	RegistryEndpointProperties	As propriedades específicas do recurso para esse recurso.

Respostas

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

Nome

Tipo

Description

200 OK

RegistryEndpointResource

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

201 Created

RegistryEndpointResource

Operação de criação do recurso 'RegistryEndpointResource' 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 Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Solicitação 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 status:: 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 status:: 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	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocation	A localização estendida é uma extensão das localizações do Azure. Eles fornecem uma maneira de usar seus clusters do Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.
ExtendedLocationType	A enumeração que define o tipo de ExtendedLocation aceito.
ProvisioningState	A enumeração que define o status do recurso.
RegistryEndpointAnonymousAuthentication	Autenticação anônima
RegistryEndpointArtifactPullSecretAuthentication	Autenticação do Segredo de Pull do Artefato
RegistryEndpointArtifactPullSecretSettings	Propriedades de autenticação do RegistryEndpoint Artifact Pull Secret
RegistryEndpointAuthenticationMethod	O método de autenticação.
RegistryEndpointProperties	Propriedades do 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 confiança RegistryEndpoint fornecidas por meio de um configmap.
RegistryEndpointTrustedSigningKeySecret	Configurações para confiança RegistryEndpoint fornecidas por meio de um segredo.
RegistryEndpointTrustedSigningKeyType	Valores de 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 integridade do recurso.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

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

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
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

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExtendedLocation

Objeto

A localização estendida é uma extensão das localizações do Azure. Eles fornecem uma maneira de usar seus clusters do Kubernetes habilitados para Azure ARC como locais de destino para implantar instâncias de serviços do Azure.

Nome	Tipo	Description
name	string	O nome do local estendido.
type	ExtendedLocationType	Tipo de ExtendedLocation.

ExtendedLocationType

Enumeração

A enumeração que define o tipo de ExtendedLocation aceito.

Valor	Description
CustomLocation	Tipo CustomLocation

ProvisioningState

Enumeração

A enumeração que define o status do recurso.

Valor	Description
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á atualizando.
Deleting	O recurso está sendo excluído.
Accepted	O recurso foi aceito.

RegistryEndpointAnonymousAuthentication

Objeto

Autenticação anônima

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

RegistryEndpointArtifactPullSecretAuthentication

Objeto

Autenticação do Segredo de Pull do Artefato

Nome	Tipo	Description
artifactPullSecretSettings	RegistryEndpointArtifactPullSecretSettings	Propriedades de autenticação do Segredo de Pull do Artefato
method	string: ArtifactPullSecret	O método de autenticação.

RegistryEndpointArtifactPullSecretSettings

Objeto

Propriedades de autenticação do RegistryEndpoint Artifact Pull Secret

Nome	Tipo	Description
secretRef	string	O nome do segredo do kubernetes que contém o segredo de pull do artefato.

RegistryEndpointAuthenticationMethod

Enumeração

O método de autenticação.

Valor	Description
SystemAssignedManagedIdentity	Tipo SystemAssignedManagedIdentity
UserAssignedManagedIdentity	Tipo UserAssignedManagedIdentity
Anonymous	Opção anônima
ArtifactPullSecret	Autenticação do Segredo de Pull do Artefato

RegistryEndpointProperties

Objeto

Propriedades do RegistryEndpoint

Nome	Tipo	Valor padrão	Description
authentication	RegistryEndpointAuthentication: RegistryEndpointAnonymousAuthentication RegistryEndpointArtifactPullSecretAuthentication RegistryEndpointSystemAssignedIdentityAuthentication RegistryEndpointUserAssignedIdentityAuthentication		As configurações de autenticação do 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 integridade 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

Objeto

Recurso RegistryEndpoint

Nome	Tipo	Description
extendedLocation	ExtendedLocation	Local de borda do recurso.
id	string (arm-id)	ID de recurso totalmente qualificada 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 esse recurso.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

RegistryEndpointSystemAssignedIdentityAuthentication

Objeto

Autenticação de identidade atribuída pelo sistema

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

RegistryEndpointSystemAssignedManagedIdentitySettings

Objeto

Propriedades de identidade gerenciada atribuídas pelo sistema

Nome	Tipo	Description
audience	string	Público-alvo do serviço para autenticação. Opcional; o padrão é o público-alvo da configuração do host do serviço.

RegistryEndpointTrustedSigningKeyConfigMap

Objeto

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

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

RegistryEndpointTrustedSigningKeySecret

Objeto

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

Nome	Tipo	Description
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 de RegistryEndpointTrustedSigningKeyType

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

RegistryEndpointUserAssignedIdentityAuthentication

Objeto

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

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

RegistryEndpointUserAssignedManagedIdentitySettings

Objeto

Propriedades de identidade gerenciada atribuídas pelo usuário

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

ResourceHealthState

Enumeração

O estado de integridade do recurso.

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

systemData

Objeto

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

Nome	Tipo	Description
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.

Compartilhar via

Registry Endpoint - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

RegistryEndpoint_CreateOrUpdate_MaximumSet

Solicitação 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