Accounts - Create Or Update

Referenz

Service:: Azure Video Indexer

API Version:: 2024-01-01

Erstellt oder aktualisiert ein Azure Video Indexer-Konto.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VideoIndexer/accounts/{accountName}?api-version=2024-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Azure Video Indexer-Kontos. Regex pattern: `^[A-Za-z0-9-]+$`
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	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
identity		ManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
properties.accountId		string	Die Datenebenen-ID des Kontos. Dies kann nur beim Herstellen einer Verbindung mit einem vorhandenen klassischen Konto festgelegt werden.
properties.storageServices		StorageServicesForPutRequest	Details zu Den Speicherdiensten
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	Account	Die Ressource wurde erfolgreich aktualisiert.
201 Created	Account	Die Ressource wurde erfolgreich erstellt.
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Connect classic account to arm account using system assigned Mi

Connect classic account to arm account using user assigned Mi

Create or update account with system assigned Mi

Create or update account with user assigned Mi

Connect classic account to arm account using system assigned Mi

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/b04775c3-63fa-40f3-9430-139d2e5522d3/resourceGroups/contosto-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer?api-version=2024-01-01

{
  "location": "NorthEurope",
  "properties": {
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    }
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "principalId": "43a83441-c17f-4e06-84a3-2eaf86668da7",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Status code:: 201

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "principalId": "43a83441-c17f-4e06-84a3-2eaf86668da7",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Connect classic account to arm account using user assigned Mi

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/b04775c3-63fa-40f3-9430-139d2e5522d3/resourceGroups/contosto-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer?api-version=2024-01-01

{
  "location": "NorthEurope",
  "properties": {
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {}
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {
        "principalId": "a661c16c-ee39-46e7-93f6-7fb80d17ef13",
        "clientId": "92e65ecf-0fae-432e-8272-fedb6edb96c7"
      }
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {
        "principalId": "a661c16c-ee39-46e7-93f6-7fb80d17ef13",
        "clientId": "92e65ecf-0fae-432e-8272-fedb6edb96c7"
      }
    }
  }
}

Create or update account with system assigned Mi

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/b04775c3-63fa-40f3-9430-139d2e5522d3/resourceGroups/contosto-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer?api-version=2024-01-01

{
  "location": "NorthEurope",
  "properties": {
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    }
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "principalId": "43a83441-c17f-4e06-84a3-2eaf86668da7",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Status code:: 201

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "principalId": "43a83441-c17f-4e06-84a3-2eaf86668da7",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  }
}

Create or update account with user assigned Mi

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/b04775c3-63fa-40f3-9430-139d2e5522d3/resourceGroups/contosto-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer?api-version=2024-01-01

{
  "location": "NorthEurope",
  "properties": {
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {}
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {
        "principalId": "a661c16c-ee39-46e7-93f6-7fb80d17ef13",
        "clientId": "92e65ecf-0fae-432e-8272-fedb6edb96c7"
      }
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.VideoIndexer/accounts/contosto-videoanalyzer",
  "name": "contosto-videoanalyzer",
  "location": "NorthEurope",
  "type": "Microsoft.VideoIndexer/accounts",
  "tags": {},
  "properties": {
    "tenantId": "8c406f87-77ac-4ebb-a401-e8562450630e",
    "accountId": "462af7c5-d1f6-4b91-86e3-8bc5e8a61574",
    "accountName": "contosto-videoanalyzer",
    "storageServices": {
      "resourceId": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.Storage/storageAccounts/contoso-videoanalyzer-ms",
      "userAssignedIdentity": "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi"
    },
    "totalSecondsIndexed": 0,
    "provisioningState": "Succeeded"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/xxx/resourceGroups/contoso-videoanalyzer-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/contoso-videoanalyzer-mi": {
        "principalId": "a661c16c-ee39-46e7-93f6-7fb80d17ef13",
        "clientId": "92e65ecf-0fae-432e-8272-fedb6edb96c7"
      }
    }
  }
}

Definitionen

Name	Beschreibung
Account	Ein Azure Video Indexer-Konto.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorDefinition	Fehlerdefinition.
ErrorResponse	Fehlerantwort.
ManagedServiceIdentity	Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).
provisioningState	Ruft die status des Kontos zum Zeitpunkt des Aufrufs des Vorgangs ab.
StorageServicesForPutRequest	Details zu Den Speicherdiensten
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
UserAssignedIdentity	Benutzerseitig zugewiesene Identitätseigenschaften

Account

Ein Azure Video Indexer-Konto.

Name	Typ	Standardwert	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)
location	string		Der geografische Standort, an dem sich die Ressource befindet
name	string		Der Name der Ressource
properties.accountId	string	00000000-0000-0000-0000-000000000000	Die Datenebenen-ID des Kontos. Dies kann nur beim Herstellen einer Verbindung mit einem vorhandenen klassischen Konto festgelegt werden.
properties.accountName	string		Der Name des Kontos
properties.provisioningState	provisioningState		Ruft die status des Kontos zum Zeitpunkt des Aufrufs des Vorgangs ab.
properties.storageServices	StorageServicesForPutRequest		Details zu Den Speicherdiensten
properties.tenantId	string		Die Mandanten-ID des Kontos
properties.totalSecondsIndexed	integer		Eine ganze Zahl, die die Gesamtzahl der Sekunden darstellt, die für das Konto indiziert wurden
systemData	systemData		Die Systemmetadaten zu dieser Ressource.
tags	object		Ressourcentags.
type	string		Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDefinition

Fehlerdefinition.

Name	Typ	Beschreibung
code	string	Dienstspezifischer Fehlercode, der als Unterstatus für den HTTP-Fehlercode dient.
details	ErrorDefinition[]	Interne Fehlerdetails.
message	string	Beschreibung des Fehlers

ErrorResponse

Fehlerantwort.

Name	Typ	Beschreibung
error	ErrorDefinition	Die Fehlerdetails.

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 der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identitäten Der Satz von benutzerseitig zugewiesenen Identitäten, die der Ressource zugeordnet sind. Bei den userAssignedIdentities-Wörterbuchschlüsseln handelt es sich um ARM-Ressourcen-IDs im Format :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

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

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

provisioningState

Ruft die status des Kontos zum Zeitpunkt des Aufrufs des Vorgangs ab.

Name	Typ	Beschreibung
Accepted	string
Canceled	string
Deleting	string
Failed	string
Provisioning	string
Succeeded	string

StorageServicesForPutRequest

Details zu Den Speicherdiensten

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID des Speicherdiensts
userAssignedIdentity	string	Die vom Benutzer zugewiesene Identität, die zum Erteilen von Berechtigungen verwendet werden soll

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.

Accounts - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

Connect classic account to arm account using system assigned Mi

Sample Request

Sample Response

Connect classic account to arm account using user assigned Mi

Sample Request

Sample Response

Create or update account with system assigned Mi

Sample Request

Sample Response

Create or update account with user assigned Mi

Sample Request

Sample Response

Definitionen

Account

createdByType

ErrorDefinition

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

provisioningState

StorageServicesForPutRequest

systemData

UserAssignedIdentity

Zusätzliche Ressourcen