Registries - Create Or Update

Service:: Machine Learning

Version d'API:: 2025-04-01

Créer ou mettre à jour le Registre

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}?api-version=2025-04-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Nom du registre Azure Machine Learning. Ceci ne respecte pas la casse
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
identity		ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
kind		string	Métadonnées utilisées par le portail/l’outil/etc pour afficher différentes expériences d’expérience utilisateur pour les ressources du même type.
properties.discoveryUrl		string	URL de découverte pour le Registre
properties.intellectualPropertyPublisher		string	IntellectualPropertyPublisher pour le registre
properties.managedResourceGroup		ArmResourceId	ResourceId du groupe de ressources managé si le registre a créé des ressources
properties.managedResourceGroupSettings		ManagedResourceGroupSettings	Paramètres spécifiques au groupe de ressources managés
properties.mlFlowRegistryUri		string	URI du Registre MLFlow pour le Registre
properties.publicNetworkAccess		string	Le Registre est-il accessible à partir d’Internet ? Valeurs possibles : « Activé » ou « Désactivé »
properties.regionDetails		RegistryRegionArmDetails[]	Détails de chaque région dans laquelle se trouve le Registre
properties.registryPrivateEndpointConnections		RegistryPrivateEndpointConnection[]	Informations sur les connexions de point de terminaison privé utilisées pour les connexions en attente dans le portail de liaison privée
sku		Sku	Détails de la référence SKU requis pour le contrat ARM pour la mise à l’échelle automatique.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	RegistryTrackedResource	Succès
201 Created	RegistryTrackedResource	Date de création
Other Status Codes	ErrorResponse	Erreur

Exemples

CreateOrUpdate Registry with system created accounts.

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/string?api-version=2025-04-01

{
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "None",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

Exemple de réponse

Code d’état:: 200

{
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444",
    "userAssignedIdentities": {
      "string": {
        "principalId": "00000000-1111-2222-3333-444444444444",
        "clientId": "00000000-1111-2222-3333-444444444444"
      }
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  },
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:38",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:38",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Code d’état:: 201

{
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444",
    "userAssignedIdentities": {
      "string": {
        "principalId": "00000000-1111-2222-3333-444444444444",
        "clientId": "00000000-1111-2222-3333-444444444444"
      }
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  },
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:38",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:38",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Définitions

Nom	Description
AcrDetails	Détails du compte ACR à utiliser pour le Registre
ArmResourceId	ARM ResourceId d’une ressource
createdByType	Type d’identité qui a créé la ressource.
EndpointServiceConnectionStatus	État de connexion du consommateur de services avec le fournisseur de services
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ManagedResourceGroupAssignedIdentities	Détails des identités affectées par le groupe de ressources managés.
ManagedResourceGroupSettings	Paramètres du groupe de ressources managés
ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
PrivateEndpointResource	Ressource réseau PE liée à cette connexion PE.
RegistryPrivateEndpointConnection	Définition de connexion de point de terminaison privé.
RegistryPrivateLinkServiceConnectionState	État de connexion.
RegistryRegionArmDetails	Détails de chaque région dans laquelle se trouve le Registre
RegistryTrackedResource
Sku	Définition du modèle de ressource représentant la référence SKU
SkuTier	Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT.
StorageAccountDetails	Détails du compte de stockage à utiliser pour le Registre
SystemCreatedAcrAccount
SystemCreatedStorageAccount
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserAssignedIdentity	Propriétés d’identité attribuées par l’utilisateur

AcrDetails

Object

Détails du compte ACR à utiliser pour le Registre

Nom	Type	Description
systemCreatedAcrAccount	SystemCreatedAcrAccount	Détails du compte ACR créé par le système à utiliser pour le Registre

ArmResourceId

Object

ARM ResourceId d’une ressource

Nom	Type	Description
resourceId	string	Arm ResourceId est au format « /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Storage/storageAccounts/{StorageAccountName} » ou « /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.ContainerRegistry/registrys/{AcrName} »

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
Application
Key
ManagedIdentity
User

EndpointServiceConnectionStatus

Énumération

État de connexion du consommateur de services avec le fournisseur de services

Valeur	Description
Approved
Disconnected
Pending
Rejected

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ManagedResourceGroupAssignedIdentities

Object

Détails des identités affectées par le groupe de ressources managés.

Nom	Type	Description
principalId	string	ID du principal d’identité

ManagedResourceGroupSettings

Object

Paramètres du groupe de ressources managés

Nom	Type	Description
assignedIdentities	ManagedResourceGroupAssignedIdentities[]	Liste des identités affectées pour le groupe de ressources managé

ManagedServiceIdentity

Object

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom	Type	Description
principalId	string (uuid)	ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string (uuid)	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	identités User-Assigned Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Énumération

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrivateEndpointResource

Object

Ressource réseau PE liée à cette connexion PE.

Nom	Type	Description
id	string	Identificateur ARM pour le point de terminaison privé
subnetArmId	string	Sous-réseauId auquel le point de terminaison privé est connecté.

RegistryPrivateEndpointConnection

Object

Définition de connexion de point de terminaison privé.

Nom	Type	Description
id	string	Il s’agit du nom de connexion de point de terminaison privé créé sur l’ID de ressource complet SRP : /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.MachineLearningServices/{resourceType}/{resourceName}/registryPrivateEndpointConnections/{peConnectionName}
location	string	Identique à l’emplacement de l’espace de travail.
properties.groupIds	string[]	ID de groupe
properties.privateEndpoint	PrivateEndpointResource	Ressource réseau PE liée à cette connexion PE.
properties.provisioningState	string	L’une des valeurs Null, « Succeeded », « Provisioning », « Failed ». Bien qu’il ne soit pas approuvé, il s’agit de la valeur Null.
properties.registryPrivateLinkServiceConnectionState	RegistryPrivateLinkServiceConnectionState	État de connexion.

RegistryPrivateLinkServiceConnectionState

Object

État de connexion.

Nom	Type	Description
actionsRequired	string	Certains rp ont choisi « Aucun ». D’autres demandes de requête utilisent cette option pour l’expansion de la région.
description	string	Message défini par l’utilisateur qui, par document NRP, peut être utilisé pour le message lié à l’approbation.
status	EndpointServiceConnectionStatus	État de connexion du consommateur de services avec le fournisseur de services

RegistryRegionArmDetails

Object

Détails de chaque région dans laquelle se trouve le Registre

Nom	Type	Description
acrDetails	AcrDetails[]	Liste des comptes ACR
location	string	Emplacement où se trouve le Registre
storageAccountDetails	StorageAccountDetails[]	Liste des comptes de stockage

RegistryTrackedResource

Object

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
kind	string	Métadonnées utilisées par le portail/l’outil/etc pour afficher différentes expériences d’expérience utilisateur pour les ressources du même type.
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.discoveryUrl	string	URL de découverte pour le Registre
properties.intellectualPropertyPublisher	string	IntellectualPropertyPublisher pour le registre
properties.managedResourceGroup	ArmResourceId	ResourceId du groupe de ressources managé si le registre a créé des ressources
properties.managedResourceGroupSettings	ManagedResourceGroupSettings	Paramètres spécifiques au groupe de ressources managés
properties.mlFlowRegistryUri	string	URI du Registre MLFlow pour le Registre
properties.publicNetworkAccess	string	Le Registre est-il accessible à partir d’Internet ? Valeurs possibles : « Activé » ou « Désactivé »
properties.regionDetails	RegistryRegionArmDetails[]	Détails de chaque région dans laquelle se trouve le Registre
properties.registryPrivateEndpointConnections	RegistryPrivateEndpointConnection[]	Informations sur les connexions de point de terminaison privé utilisées pour les connexions en attente dans le portail de liaison privée
sku	Sku	Détails de la référence SKU requis pour le contrat ARM pour la mise à l’échelle automatique.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

Sku

Object

Définition du modèle de ressource représentant la référence SKU

Nom	Type	Description
capacity	integer (int32)	Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis.
family	string	Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici.
name	string	Nom de la référence SKU. Pièce P3. Il s’agit généralement d’une lettre+code numérique
size	string	Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome.
tier	SkuTier	Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT.

SkuTier

Énumération

Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT.

Valeur	Description
Basic
Free
Premium
Standard

StorageAccountDetails

Object

Détails du compte de stockage à utiliser pour le Registre

Nom	Type	Description
systemCreatedStorageAccount	SystemCreatedStorageAccount	Détails du compte de stockage créé par le système à utiliser pour le Registre

SystemCreatedAcrAccount

Object

Nom	Type	Description
acrAccountName	string	Nom du compte ACR
acrAccountSku	string	Référence SKU du compte ACR
armResourceId	ArmResourceId	Cette opération est remplie une fois le compte ACR créé.

SystemCreatedStorageAccount

Object

Nom	Type	Description
allowBlobPublicAccess	boolean	Accès aux objets blob publics autorisés
armResourceId	ArmResourceId	Cette opération est remplie une fois le compte de stockage créé.
storageAccountHnsEnabled	boolean	HNS activé pour le compte de stockage
storageAccountName	string	Nom du compte de stockage
storageAccountType	string	Valeurs autorisées : « Standard_LRS », « Standard_GRS », « Standard_RAGRS », « Standard_ZRS », « Standard_GZRS », « Standard_RAGZRS », « Premium_LRS », « Premium_ZRS »

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UserAssignedIdentity

Object

Propriétés d’identité attribuées par l’utilisateur

Nom	Type	Description
clientId	string (uuid)	ID client de l’identité affectée.
principalId	string (uuid)	ID principal de l’identité affectée.

Partager via

Registries - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

CreateOrUpdate Registry with system created accounts.

Exemple de requête

Exemple de réponse

Définitions

AcrDetails

ArmResourceId

createdByType

EndpointServiceConnectionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedResourceGroupAssignedIdentities

ManagedResourceGroupSettings

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpointResource

RegistryPrivateEndpointConnection

RegistryPrivateLinkServiceConnectionState

RegistryRegionArmDetails

RegistryTrackedResource

Sku

SkuTier

StorageAccountDetails

SystemCreatedAcrAccount

SystemCreatedStorageAccount

systemData

UserAssignedIdentity