Microsoft. Contas DeviceUpdate
Definição de recurso do Bicep
O tipo de recurso de contas pode ser implementado em:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar uma Microsoft. DeviceUpdate/recurso de contas, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.DeviceUpdate/accounts@2022-12-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
encryption: {
keyVaultKeyUri: 'string'
userAssignedIdentity: 'string'
}
privateEndpointConnections: [
{
properties: {
groupIds: [
'string'
]
privateEndpoint: {}
privateLinkServiceConnectionState: {
actionsRequired: 'string'
description: 'string'
status: 'string'
}
}
}
]
publicNetworkAccess: 'string'
sku: 'string'
}
}
Valores de propriedade
accounts
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| identidade | O tipo de identidade utilizado para o recurso. | ManagedServiceIdentity |
| propriedades | Propriedades da conta de Atualização de Dispositivos. | Propriedades da Conta |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). | "Nenhum" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (obrigatório) |
| userAssignedIdentities | 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. | objeto |
Propriedades da Conta
| Nome | Descrição | Valor |
|---|---|---|
| Encriptação | Propriedades de encriptação CMK inativa | Encriptação |
| privateEndpointConnections | Lista de ligações de ponto final privado associadas à conta. | PrivateEndpointConnection[] |
| publicNetworkAccess | Se o acesso à rede pública é ou não permitido para a conta. | "Desativado" "Ativado" |
| sku | SKU de Atualização de Dispositivos | 'Gratuito' 'Standard' |
Encriptação
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultKeyUri | O URI do cofre de chaves | string |
| userAssignedIdentity | O resourceId completo da identidade atribuída pelo utilizador a utilizar para o acesso ao cofre de chaves. A identidade também tem de ser atribuída à Conta | string |
PrivateEndpointConnection
| Nome | Descrição | Valor |
|---|---|---|
| propriedades | Propriedades do recurso. | PrivateEndpointConnectionProperties (obrigatório) |
PrivateEndpointConnectionProperties
| Nome | Descrição | Valor |
|---|---|---|
| groupIds | Matriz de IDs de grupo. | string[] |
| privateEndpoint | O recurso do ponto final privado. | PrivateEndpoint |
| privateLinkServiceConnectionState | Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor do serviço. | PrivateLinkServiceConnectionState (obrigatório) |
PrivateEndpoint
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
PrivateLinkServiceConnectionState
| Nome | Descrição | Valor |
|---|---|---|
| actionsRequired | Uma mensagem a indicar se as alterações no fornecedor de serviços requerem atualizações no consumidor. | string |
| descrição | O motivo da aprovação/rejeição da ligação. | string |
| status | Indica se a ligação foi Aprovada/Rejeitada/Removida pelo proprietário do serviço. | "Aprovado" "Pendente" "Rejeitado" |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Criar a Atualização de Dispositivos para Hub IoT conta |
Este modelo cria uma conta que fornece um registo DNS público e permite efetuar chamadas à API REST para o Plano de Dados. Em seguida, o utilizador tem de criar uma instância na conta e ligá-la a uma Hub IoT para começar a utilizar o serviço. |
| Criar a Atualização de Dispositivos para Hub IoT conta, instância Hub IoT |
Este modelo cria uma conta e uma instância e um hub com o qual ligar a instância. Configura o hub com as políticas de acesso, rotas e grupo de consumidores necessários. |
Definição de recurso do modelo arm
O tipo de recurso de contas pode ser implementado em:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar uma Microsoft. DeviceUpdate/recurso de contas, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.DeviceUpdate/accounts",
"apiVersion": "2022-12-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"encryption": {
"keyVaultKeyUri": "string",
"userAssignedIdentity": "string"
},
"privateEndpointConnections": [
{
"properties": {
"groupIds": [ "string" ],
"privateEndpoint": {},
"privateLinkServiceConnectionState": {
"actionsRequired": "string",
"description": "string",
"status": "string"
}
}
}
],
"publicNetworkAccess": "string",
"sku": "string"
}
}
Valores de propriedade
accounts
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | Microsoft. DeviceUpdate/accounts' |
| apiVersion | A versão da API de recursos | '2022-12-01-preview' |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| identidade | O tipo de identidade utilizado para o recurso. | ManagedServiceIdentity |
| propriedades | Propriedades da conta de Atualização de Dispositivos. | Propriedades da Conta |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). | "Nenhum" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (obrigatório) |
| userAssignedIdentities | 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. | objeto |
Propriedades da Conta
| Nome | Descrição | Valor |
|---|---|---|
| Encriptação | Propriedades de encriptação CMK inativa | Encriptação |
| privateEndpointConnections | Lista de ligações de ponto final privado associadas à conta. | PrivateEndpointConnection[] |
| publicNetworkAccess | Se o acesso à rede pública é ou não permitido para a conta. | "Desativado" "Ativado" |
| sku | SKU de Atualização de Dispositivos | 'Gratuito' 'Standard' |
Encriptação
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultKeyUri | O URI do cofre de chaves | string |
| userAssignedIdentity | O resourceId completo da identidade atribuída pelo utilizador a utilizar para o acesso ao cofre de chaves. A identidade também tem de ser atribuída à Conta | string |
PrivateEndpointConnection
| Nome | Descrição | Valor |
|---|---|---|
| propriedades | Propriedades do recurso. | PrivateEndpointConnectionProperties (obrigatório) |
PrivateEndpointConnectionProperties
| Nome | Descrição | Valor |
|---|---|---|
| groupIds | Matriz de IDs de grupo. | cadeia[] |
| privateEndpoint | O recurso do ponto final privado. | PrivateEndpoint |
| privateLinkServiceConnectionState | Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor de serviços. | PrivateLinkServiceConnectionState (obrigatório) |
PrivateEndpoint
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
PrivateLinkServiceConnectionState
| Nome | Descrição | Valor |
|---|---|---|
| actionsRequired | Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor. | string |
| descrição | O motivo da aprovação/rejeição da ligação. | string |
| status | Indica se a ligação foi Aprovada/Rejeitada/Removida pelo proprietário do serviço. | "Aprovado" "Pendente" "Rejeitado" |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Criar a Atualização de Dispositivos para Hub IoT conta |
Este modelo cria uma conta que fornece um registo DNS público e permite efetuar chamadas à API REST para o Plano de Dados. Em seguida, o utilizador tem de criar uma instância na conta e ligá-la a uma Hub IoT para começar a utilizar o serviço. |
| Criar a Atualização de Dispositivos para Hub IoT conta, instância Hub IoT |
Este modelo cria uma conta e uma instância e um hub para ligar a instância. Configura o hub com as políticas, rotas e grupos de consumidores de acesso necessários. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso de contas pode ser implementado em:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um Microsoft. DeviceUpdate/recurso de contas, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DeviceUpdate/accounts@2022-12-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
encryption = {
keyVaultKeyUri = "string"
userAssignedIdentity = "string"
}
privateEndpointConnections = [
{
properties = {
groupIds = [
"string"
]
privateEndpoint = {}
privateLinkServiceConnectionState = {
actionsRequired = "string"
description = "string"
status = "string"
}
}
}
]
publicNetworkAccess = "string"
sku = "string"
}
})
}
Valores de propriedade
accounts
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft. DeviceUpdate/accounts@2022-12-01-preview" |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde o recurso se encontra | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| identidade | O tipo de identidade utilizado para o recurso. | ManagedServiceIdentity |
| propriedades | Propriedades da conta de Atualização de Dispositivos. | AccountProperties |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerida (onde os tipos SystemAssigned e UserAssigned são permitidos). | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (obrigatório) |
| identity_ids | 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. | Matriz de IDs de identidade de utilizador. |
AccountProperties
| Nome | Descrição | Valor |
|---|---|---|
| Encriptação | Encriptação de CMK em propriedades inativas | Encriptação |
| privateEndpointConnections | Lista de ligações de ponto final privado associadas à conta. | PrivateEndpointConnection[] |
| publicNetworkAccess | Se o acesso à rede pública é ou não permitido para a conta. | "Desativado" "Ativado" |
| sku | SKU de Atualização de Dispositivos | "Gratuito" "Standard" |
Encriptação
| Nome | Descrição | Valor |
|---|---|---|
| keyVaultKeyUri | O URI do cofre de chaves | string |
| userAssignedIdentity | O resourceId completo da identidade atribuída pelo utilizador a utilizar para o acesso ao cofre de chaves. A identidade também tem de ser atribuída à Conta | string |
PrivateEndpointConnection
| Nome | Descrição | Valor |
|---|---|---|
| propriedades | Propriedades do recurso. | PrivateEndpointConnectionProperties (obrigatório) |
PrivateEndpointConnectionProperties
| Nome | Descrição | Valor |
|---|---|---|
| groupIds | Matriz de IDs de grupo. | cadeia[] |
| privateEndpoint | O recurso do ponto final privado. | PrivateEndpoint |
| privateLinkServiceConnectionState | Uma coleção de informações sobre o estado da ligação entre o consumidor e o fornecedor de serviços. | PrivateLinkServiceConnectionState (obrigatório) |
PrivateEndpoint
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
PrivateLinkServiceConnectionState
| Nome | Descrição | Valor |
|---|---|---|
| actionsRequired | Uma mensagem a indicar se as alterações no fornecedor de serviços necessitam de atualizações no consumidor. | string |
| descrição | O motivo da aprovação/rejeição da ligação. | string |
| status | Indica se a ligação foi Aprovada/Rejeitada/Removida pelo proprietário do serviço. | "Aprovado" "Pendente" "Rejeitado" |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários