Registries - Update

Referenz

Service:: Machine Learning

API Version:: 2023-06-01-preview

Aktualisieren von Tags

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}?api-version=2023-06-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
registryName	path	True	string	Name der Azure Machine Learning-Registrierung. Hierbei wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
identity	RegistryPartialManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
sku	PartialSku	SKU-Details, die für den ARM-Vertrag für die automatische Skalierung erforderlich sind.
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	RegistryTrackedResource	Erfolg
Other Status Codes	ErrorResponse	Fehler

Beispiele

Update Registry with system created accounts.

Update Registry with user created accounts.

Update Registry with system created accounts.

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/string?api-version=2023-06-01-preview

{
  "tags": {},
  "identity": {
    "type": "SystemAssigned",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "sku": {
    "name": "string",
    "tier": "Basic",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

Sample Response

Status code:: 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",
    "privateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:02",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:02",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Update Registry with user created accounts.

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/string?api-version=2023-06-01-preview

{
  "tags": {},
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "sku": {
    "name": "string",
    "tier": "Basic",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

Sample Response

Status code:: 200

{
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "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": [
          {
            "userCreatedStorageAccount": {
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ],
        "acrDetails": [
          {
            "userCreatedAcrAccount": {
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "privateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:58",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:58",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Definitionen

Name	Beschreibung
AcrDetails	Details zum ACR-Konto, das für die Registrierung verwendet werden soll
ArmResourceId	ARM ResourceId einer Ressource
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
EndpointServiceConnectionStatus	Verbindung status des Dienstverbrauchers mit dem Dienstanbieter
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Fehlerdetails.
ErrorResponse	Fehlerantwort
ManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl systemAssigned- als auch UserAssigned-Typen zulässig sind).
PartialRegistryPartialTrackedResource	Wird streng in Updateanforderungen verwendet.
PartialSku	Allgemeine SKU-Definition.
PrivateEndpointResource	Die PE-Netzwerkressource, die mit dieser PE-Verbindung verknüpft ist.
RegistryPartialManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
RegistryPrivateEndpointConnection	Definition der Verbindung mit privatem Endpunkt.
RegistryPrivateLinkServiceConnectionState	Der Verbindungsstatus.
RegistryRegionArmDetails	Details für jede Region, in der sich die Registrierung befindet
RegistryTrackedResource
Sku	Die Ressourcenmodelldefinition, die die SKU darstellt
SkuTier	Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.
StorageAccountDetails	Details des Speicherkontos, das für die Registrierung verwendet werden soll
SystemCreatedAcrAccount
SystemCreatedStorageAccount
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
UserAssignedIdentity	Benutzerseitig zugewiesene Identitätseigenschaften
UserCreatedAcrAccount
UserCreatedStorageAccount

AcrDetails

Details zum ACR-Konto, das für die Registrierung verwendet werden soll

Name	Typ	Beschreibung
systemCreatedAcrAccount	SystemCreatedAcrAccount	Details zum vom System erstellten ACR-Konto, das für die Registrierung verwendet werden soll
userCreatedAcrAccount	UserCreatedAcrAccount	Details des vom Benutzer erstellten ACR-Kontos, das für die Registrierung verwendet werden soll

ArmResourceId

ARM ResourceId einer Ressource

Name	Typ	Beschreibung
resourceId	string	Arm ResourceId hat das Format "/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Storage/storageAccounts/{StorageAccountName}" oder "/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{AcrName}"

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

EndpointServiceConnectionStatus

Verbindung status des Dienstverbrauchers mit dem Dienstanbieter

Name	Typ	Beschreibung
Approved	string
Disconnected	string
Pending	string
Rejected	string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Infotyp.

ErrorDetail

Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ManagedServiceIdentity

Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)

Name	Typ	Beschreibung
principalId	string	Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
type	ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl systemAssigned- als auch UserAssigned-Typen zulässig sind).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identitäten Die Gruppe der benutzerseitig zugewiesenen Identitäten, die der Ressource zugeordnet sind. Bei den UserAssignedIdentities-Wörterbuchschlüsseln handelt es sich um ARM-Ressourcen-IDs in der Form : '/subscriptions/{subscriptionId}/resourceGroupGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei sowohl systemAssigned- als auch UserAssigned-Typen zulässig sind).

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PartialRegistryPartialTrackedResource

Wird streng in Updateanforderungen verwendet.

Name	Typ	Beschreibung
identity	RegistryPartialManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
sku	PartialSku	SKU-Details, die für den ARM-Vertrag für die automatische Skalierung erforderlich sind.
tags	object	Ressourcentags.

PartialSku

Allgemeine SKU-Definition.

Name	Typ	Beschreibung
capacity	integer	Wenn die SKU das Horizontal-/Einskalieren unterstützt, sollte die ganze Kapazität enthalten sein. Wenn das Horizontal-/Einskalieren für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen.
family	string	Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden.
name	string	Der Name der SKU. Beispiel: P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode.
size	string	Die SKU-Größe. Wenn das Feld name die Kombination aus Ebene und einem anderen Wert ist, ist dies der eigenständige Code.
tier	SkuTier	Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.

PrivateEndpointResource

Die PE-Netzwerkressource, die mit dieser PE-Verbindung verknüpft ist.

Name	Typ	Beschreibung
id	string	Der ARM-Bezeichner für private Endpunkte
subnetArmId	string	Die subnetId, mit der der private Endpunkt verbunden ist.

RegistryPartialManagedServiceIdentity

Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)

Name	Typ	Beschreibung
principalId	string	Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt.
type	ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl systemAssigned- als auch UserAssigned-Typen zulässig sind).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identitäten Die Gruppe der benutzerseitig zugewiesenen Identitäten, die der Ressource zugeordnet sind. Bei den UserAssignedIdentities-Wörterbuchschlüsseln handelt es sich um ARM-Ressourcen-IDs in der Form : '/subscriptions/{subscriptionId}/resourceGroupGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

RegistryPrivateEndpointConnection

Definition der Verbindung mit privatem Endpunkt.

Name	Typ	Beschreibung
id	string	Dies ist der Name der verbindung des privaten Endpunkts, der auf der SRP Full-Ressourcen-ID erstellt wurde: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.MachineLearningServices/{resourceType}/{resourceName}/privateEndpointConnections/{peConnectionName}
location	string	Identisch mit dem Arbeitsbereichsspeicherort.
properties.groupIds	string[]	Die Gruppen-IDs
properties.privateEndpoint	PrivateEndpointResource	Die PE-Netzwerkressource, die mit dieser PE-Verbindung verknüpft ist.
properties.privateLinkServiceConnectionState	RegistryPrivateLinkServiceConnectionState	Der Verbindungsstatus.
properties.provisioningState	string	Einer von NULL, "Erfolgreich", "Bereitstellung", "Fehler". Es ist zwar nicht genehmigt, aber null.

RegistryPrivateLinkServiceConnectionState

Der Verbindungsstatus.

Name	Typ	Beschreibung
actionsRequired	string	Einige RP haben "Keine" ausgewählt. Andere RPs verwenden dies für die Regionserweiterung.
description	string	Benutzerdefinierte Nachricht, die pro NRP-Dokumentation für genehmigungsbezogene Nachrichten verwendet werden kann.
status	EndpointServiceConnectionStatus	Verbindung status des Dienstverbrauchers mit dem Dienstanbieter

RegistryRegionArmDetails

Details für jede Region, in der sich die Registrierung befindet

Name	Typ	Beschreibung
acrDetails	AcrDetails[]	Liste der ACR-Konten
location	string	Der Speicherort, an dem die Registrierung vorhanden ist
storageAccountDetails	StorageAccountDetails[]	Liste der Speicherkonten

RegistryTrackedResource

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
kind	string	Metadaten, die vom Portal/Tooling/etc verwendet werden, um unterschiedliche UX-Erfahrungen für Ressourcen desselben Typs zu rendern.
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.discoveryUrl	string	Ermittlungs-URL für die Registrierung
properties.intellectualPropertyPublisher	string	IntellectualPropertyPublisher für die Registrierung
properties.managedResourceGroup	ArmResourceId	ResourceId der verwalteten RG, wenn die Registrierung über vom System erstellte Ressourcen verfügt
properties.mlFlowRegistryUri	string	MLFlow-Registrierungs-URI für die Registrierung
properties.privateEndpointConnections	RegistryPrivateEndpointConnection[]	Informationen zu Verbindungen mit privaten Endpunkten, die für ausstehende Verbindungen im Private Link-Portal verwendet werden
properties.publicNetworkAccess	string	Kann über das Internet auf die Registrierung zugegriffen werden? Mögliche Werte: "Aktiviert" oder "Deaktiviert"
properties.regionDetails	RegistryRegionArmDetails[]	Details zu jeder Region, in der sich die Registrierung befindet
sku	Sku	SKU-Details, die für den ARM-Vertrag für die automatische Skalierung erforderlich sind.
systemData	systemData	Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

Sku

Die Ressourcenmodelldefinition, die die SKU darstellt

Name	Typ	Beschreibung
capacity	integer	Wenn die SKU das Horizontal-/Einskalieren unterstützt, sollte die ganze Kapazität enthalten sein. Wenn das Horizontal-/Einskalieren für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen.
family	string	Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden.
name	string	Der Name der SKU. Beispiel: P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode.
size	string	Die SKU-Größe. Wenn das Feld name die Kombination aus Ebene und einem anderen Wert ist, ist dies der eigenständige Code.
tier	SkuTier	Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.

SkuTier

Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst über mehrere Ebenen verfügt, aber für einen PUT nicht erforderlich ist.

Name	Typ	Beschreibung
Basic	string
Free	string
Premium	string
Standard	string

StorageAccountDetails

Details des Speicherkontos, das für die Registrierung verwendet werden soll

Name	Typ	Beschreibung
systemCreatedStorageAccount	SystemCreatedStorageAccount	Details zum vom System erstellten Speicherkonto, das für die Registrierung verwendet werden soll
userCreatedStorageAccount	UserCreatedStorageAccount	Details des vom Benutzer erstellten Speicherkontos, das für die Registrierung verwendet werden soll

SystemCreatedAcrAccount

Name	Typ	Beschreibung
acrAccountName	string	Name des ACR-Kontos
acrAccountSku	string	SKU des ACR-Kontos
armResourceId	ArmResourceId	Diese wird aufgefüllt, sobald das ACR-Konto erstellt wurde.

SystemCreatedStorageAccount

Name	Typ	Beschreibung
allowBlobPublicAccess	boolean	Zugriff auf öffentliche Blobs zulässig
armResourceId	ArmResourceId	Diese wird aufgefüllt, sobald das Speicherkonto erstellt wurde.
storageAccountHnsEnabled	boolean	HNS für Speicherkonto aktiviert
storageAccountName	string	Name des Speicherkontos
storageAccountType	string	Zulässige Werte: "Standard_LRS", "Standard_GRS", "Standard_RAGRS", "Standard_ZRS", "Standard_GZRS", "Standard_RAGZRS", "Premium_LRS", "Premium_ZRS"

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserAssignedIdentity

Benutzerseitig zugewiesene Identitätseigenschaften

Name	Typ	Beschreibung
clientId	string	Die Client-ID der zugewiesenen Identität.
principalId	string	Die Prinzipal-ID der zugewiesenen Identität.

UserCreatedAcrAccount

Name	Typ	Beschreibung
armResourceId	ArmResourceId	ARM ResourceId einer Ressource

UserCreatedStorageAccount

Name	Typ	Beschreibung
armResourceId	ArmResourceId	ARM ResourceId einer Ressource

Registries - Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

Update Registry with system created accounts.

Sample Request

Sample Response

Update Registry with user created accounts.

Sample Request

Sample Response

Definitionen

AcrDetails

ArmResourceId

createdByType

EndpointServiceConnectionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

PartialRegistryPartialTrackedResource

PartialSku

PrivateEndpointResource

RegistryPartialManagedServiceIdentity

RegistryPrivateEndpointConnection

RegistryPrivateLinkServiceConnectionState

RegistryRegionArmDetails

RegistryTrackedResource

Sku

SkuTier

StorageAccountDetails

SystemCreatedAcrAccount

SystemCreatedStorageAccount

systemData

UserAssignedIdentity

UserCreatedAcrAccount

UserCreatedStorageAccount

Zusätzliche Ressourcen