Accounts - Create Or Update

Referência

Service:: Azure Video Indexer

API Version:: 2024-01-01

Cria ou atualiza uma conta do Video Indexer do Azure.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta do Video Indexer do Azure. Regex pattern: `^[A-Za-z0-9-]+$`
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
subscriptionId	path	True	string	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A localização geográfica onde o recurso se encontra
identity		ManagedServiceIdentity	Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador)
properties.accountId		string	O ID do plano de dados da conta. Isto só pode ser definido ao ligar uma conta clássica existente
properties.storageServices		StorageServicesForPutRequest	Os detalhes dos serviços de armazenamento
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	Account	O recurso foi atualizado com êxito.
201 Created	Account	O recurso foi criado com êxito.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

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

Definições

Name	Description
Account	Uma conta do Azure Video Indexer.
createdByType	O tipo de identidade que criou o recurso.
ErrorDefinition	Definição de erro.
ErrorResponse	Resposta de erro.
ManagedServiceIdentity	Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador)
ManagedServiceIdentityType	Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos).
provisioningState	Obtém o estado da conta no momento em que a operação foi chamada.
StorageServicesForPutRequest	Os detalhes dos serviços de armazenamento
systemData	Metadados relativos à criação e última modificação do recurso.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo utilizador

Account

Uma conta do Azure Video Indexer.

Name	Tipo	Valor Predefinido	Description
id	string		ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity		Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador)
location	string		A localização geográfica onde o recurso se encontra
name	string		O nome do recurso
properties.accountId	string	00000000-0000-0000-0000-000000000000	O ID do plano de dados da conta. Isto só pode ser definido ao ligar uma conta clássica existente
properties.accountName	string		O nome da conta
properties.provisioningState	provisioningState		Obtém o estado da conta no momento em que a operação foi chamada.
properties.storageServices	StorageServicesForPutRequest		Os detalhes dos serviços de armazenamento
properties.tenantId	string		O ID de inquilino da conta
properties.totalSecondsIndexed	integer		Um número inteiro que representa o total de segundos que foram indexados na conta
systemData	systemData		Os metadados do sistema relacionados com este recurso.
tags	object		Etiquetas de recursos.
type	string		O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDefinition

Definição de erro.

Name	Tipo	Description
code	string	Código de erro específico do serviço que serve como o subtatus para o código de erro HTTP.
details	ErrorDefinition[]	Detalhes de erro internos.
message	string	Descrição do erro.

ErrorResponse

Resposta de erro.

Name	Tipo	Description
error	ErrorDefinition	Os detalhes do erro.

ManagedServiceIdentity

Identidade de serviço gerida (identidades atribuídas pelo sistema e/ou pelo utilizador)

Name	Tipo	Description
principalId	string	O ID do principal de serviço da identidade atribuída pelo sistema. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema.
tenantId	string	O ID de inquilino da identidade atribuída pelo sistema. Esta propriedade só será fornecida para uma identidade atribuída pelo sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	Identidades de User-Assigned O conjunto de identidades atribuídas pelo utilizador associadas ao recurso. As chaves de dicionário userAssignedIdentities serão IDs de recursos do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) nos pedidos.

ManagedServiceIdentityType

Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos).

Name	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

provisioningState

Obtém o estado da conta no momento em que a operação foi chamada.

Name	Tipo	Description
Accepted	string
Canceled	string
Deleting	string
Failed	string
Provisioning	string
Succeeded	string

StorageServicesForPutRequest

Os detalhes dos serviços de armazenamento

Name	Tipo	Description
resourceId	string	O ID de recurso dos serviços de armazenamento
userAssignedIdentity	string	A identidade atribuída pelo utilizador a ser utilizada para conceder permissões

systemData

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

Name	Tipo	Description
createdAt	string	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	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.

UserAssignedIdentity

Propriedades de identidade atribuídas pelo utilizador

Name	Tipo	Description
clientId	string	O ID de cliente da identidade atribuída.
principalId	string	O ID principal da identidade atribuída.

Accounts - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Scopes

Exemplos

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

Definições

Account

createdByType

ErrorDefinition

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

provisioningState

StorageServicesForPutRequest

systemData

UserAssignedIdentity

Recursos adicionais