Compartir a través de


Cuentas de Microsoft.Maps

Definición de recursos de Bicep

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Maps/accounts, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Maps/accounts@2023-06-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    cors: {
      corsRules: [
        {
          allowedOrigins: [
            'string'
          ]
        }
      ]
    }
    disableLocalAuth: bool
    encryption: {
      customerManagedKeyEncryption: {
        keyEncryptionKeyIdentity: {
          delegatedIdentityClientId: 'string'
          identityType: 'string'
          userAssignedIdentityResourceId: 'string'
        }
        keyEncryptionKeyUrl: 'string'
      }
      infrastructureEncryption: 'string'
    }
    linkedResources: [
      {
        id: 'string'
        uniqueName: 'string'
      }
    ]
  }
}

Valores de propiedad

accounts

Nombre Descripción Value
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-98 (para el nombre del grupo de recursos y el nombre de la cuenta)

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico.
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku SKU de esta cuenta. SKU (obligatorio)
kind Obtiene o establece la propiedad Kind. 'Gen1'
'Gen2'
identidad Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario) ManagedServiceIdentity
properties Propiedades de la cuenta de mapa. MapsAccountProperties

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves del diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. object

MapsAccountProperties

Nombre Descripción Valor
cors Especifica las reglas de CORS para Blob service. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para Blob service. CorsRules
disableLocalAuth Permite alternar la funcionalidad en Azure Policy deshabilitar Azure Maps compatibilidad con la autenticación local. Esto deshabilitará las claves compartidas y la autenticación de token de firma de acceso compartido de cualquier uso. bool
El cifrado (Opcional) No se recomienda incluir en la definición de recursos. Solo es necesario cuando sea posible deshabilitar el cifrado de la plataforma (infraestructura de AKA). Azure SQL TDE es un ejemplo de esto. Los valores están habilitados y deshabilitados. Cifrado
linkedResources Matriz de recursos asociados a la cuenta de asignación. El recurso vinculado de la matriz no se puede actualizar individualmente, debe actualizar todos los recursos vinculados de la matriz juntos. Estos recursos se pueden usar en operaciones en la API rest de Azure Maps. El acceso se controla mediante los permisos de identidades administradas de la cuenta de asignación a esos recursos. LinkedResource[]

Restricciones:
Longitud máxima = 10

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. CorsRule[]

Restricciones:
Longitud máxima = 5

CorsRule

Nombre Descripción Valor
allowedOrigins Obligatorio si el elemento CorsRule está presente. Lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios string[] (obligatorio)

Cifrado

Nombre Descripción Valor
customerManagedKeyEncryption Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. CustomerManagedKeyEncryption
infrastructureEncryption Los valores están habilitados y deshabilitados. 'disabled'
"habilitado"

CustomerManagedKeyEncryption

Nombre Descripción Valor
keyEncryptionKeyIdentity Toda la configuración de identidad de la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticar a Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl key encryption key Url, versioned o non-versioned. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Nombre Descripción Valor
delegatedIdentityClientId identidad delegada que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. string

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType Los valores pueden ser systemAssignedIdentity o userAssignedIdentity. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. string

LinkedResource

Nombre Descripción Value
id Id. de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}'. string (obligatorio)
uniqueName Nombre proporcionado que identifica de forma única el recurso vinculado. string (obligatorio)

SKU

Nombre Descripción Value
name Nombre de la SKU, en formato estándar (por ejemplo, S0). 'G2'
'S0'
'S1' (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
RBAC: creación de acceso de identidad administrada en Azure Maps cuenta

Implementación en Azure
Esta plantilla crea una identidad administrada y la asigna a una cuenta de Azure Maps creada.
Implementación de Azure Maps

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta y enumera la clave principal.
Implementación de Azure Maps con Azure Maps Creator (mapas interiores)

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta con la característica Indoor Maps Creator para permitir la creación de mapas interiores.
Creación de Azure Maps token de SAS almacenado en una instancia de Azure Key Vault

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta y enumera un token de Sas basado en la identidad asignada por el usuario proporcionada que se almacenará en un secreto de Azure Key Vault.

Definición de recursos de plantilla de ARM

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Maps/accounts, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Maps/accounts",
  "apiVersion": "2023-06-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [ "string" ]
        }
      ]
    },
    "disableLocalAuth": "bool",
    "encryption": {
      "customerManagedKeyEncryption": {
        "keyEncryptionKeyIdentity": {
          "delegatedIdentityClientId": "string",
          "identityType": "string",
          "userAssignedIdentityResourceId": "string"
        },
        "keyEncryptionKeyUrl": "string"
      },
      "infrastructureEncryption": "string"
    },
    "linkedResources": [
      {
        "id": "string",
        "uniqueName": "string"
      }
    ]
  }
}

Valores de propiedad

accounts

Nombre Descripción Value
type Tipo de recurso "Microsoft.Maps/accounts"
apiVersion La versión de la API de recursos '2023-06-01'
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-98 (para el nombre del grupo de recursos y el nombre de la cuenta)

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico.
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku SKU de esta cuenta. SKU (obligatorio)
kind Obtiene o establece la propiedad Kind. 'Gen1'
'Gen2'
identidad Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario) ManagedServiceIdentity
properties Propiedades de la cuenta de mapa. MapsAccountProperties

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves del diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. object

MapsAccountProperties

Nombre Descripción Valor
cors Especifica las reglas de CORS para Blob service. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para Blob service. CorsRules
disableLocalAuth Permite alternar la funcionalidad en Azure Policy deshabilitar Azure Maps compatibilidad con la autenticación local. Esto deshabilitará las claves compartidas y la autenticación de token de firma de acceso compartido de cualquier uso. bool
El cifrado (Opcional) No se recomienda incluir en la definición de recursos. Solo es necesario cuando sea posible deshabilitar el cifrado de la plataforma (infraestructura de AKA). Azure SQL TDE es un ejemplo de esto. Los valores están habilitados y deshabilitados. Cifrado
linkedResources Matriz de recursos asociados a la cuenta de asignación. El recurso vinculado de la matriz no se puede actualizar individualmente, debe actualizar todos los recursos vinculados de la matriz juntos. Estos recursos se pueden usar en operaciones en la API rest de Azure Maps. El acceso se controla mediante los permisos de identidades administradas de la cuenta de asignación a esos recursos. LinkedResource[]

Restricciones:
Longitud máxima = 10

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. CorsRule[]

Restricciones:
Longitud máxima = 5

CorsRule

Nombre Descripción Valor
allowedOrigins Obligatorio si el elemento CorsRule está presente. Lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios string[] (obligatorio)

Cifrado

Nombre Descripción Valor
customerManagedKeyEncryption Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. CustomerManagedKeyEncryption
infrastructureEncryption Los valores están habilitados y deshabilitados. 'disabled'
'habilitado'

CustomerManagedKeyEncryption

Nombre Descripción Valor
keyEncryptionKeyIdentity Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticar para Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl key encryption key Url, versioned o non-versioned. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Nombre Descripción Valor
delegatedIdentityClientId identidad delegada que se va a usar para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{grupo de recursos}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. string

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType Los valores pueden ser systemAssignedIdentity o userAssignedIdentity 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{grupo de recursos}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. string

LinkedResource

Nombre Descripción Value
id Identificador de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}'. string (obligatorio)
uniqueName Nombre proporcionado que identifica de forma única el recurso vinculado. string (obligatorio)

SKU

Nombre Descripción Value
name Nombre de la SKU, en formato estándar (por ejemplo, S0). 'G2'
'S0'
'S1' (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
RBAC: creación de acceso de identidad administrada en Azure Maps cuenta

Implementación en Azure
Esta plantilla crea una identidad administrada y la asigna a una cuenta de Azure Maps creada.
Implementación de Azure Maps

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta y enumera la clave principal.
Implementación de Azure Maps con Azure Maps Creator (mapas interiores)

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta con la característica Indoor Maps Creator para permitir la creación de mapas interiores.
Creación de un token de SAS de Azure Maps almacenado en una instancia de Azure Key Vault

Implementación en Azure
Esta plantilla implementa y Azure Maps cuenta y enumera un token de Sas basado en la identidad asignada por el usuario proporcionada que se almacenará en un secreto de Azure Key Vault.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Maps/accounts, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maps/accounts@2023-06-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      cors = {
        corsRules = [
          {
            allowedOrigins = [
              "string"
            ]
          }
        ]
      }
      disableLocalAuth = bool
      encryption = {
        customerManagedKeyEncryption = {
          keyEncryptionKeyIdentity = {
            delegatedIdentityClientId = "string"
            identityType = "string"
            userAssignedIdentityResourceId = "string"
          }
          keyEncryptionKeyUrl = "string"
        }
        infrastructureEncryption = "string"
      }
      linkedResources = [
        {
          id = "string"
          uniqueName = "string"
        }
      ]
    }
    sku = {
      name = "string"
    }
    kind = "string"
  })
}

Valores de propiedad

accounts

Nombre Descripción Value
type Tipo de recurso "Microsoft.Maps/accounts@2023-06-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-98 (para el nombre del grupo de recursos y el nombre de la cuenta)

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos y guiones.

Comience con un carácter alfanumérico.
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta.
sku SKU de esta cuenta. SKU (obligatorio)
kind Obtiene o establece la propiedad Kind. "Gen1"
"Gen2"
identidad Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario) ManagedServiceIdentity
properties Propiedades de la cuenta de asignación. MapsAccountProperties

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (obligatorio)
identity_ids Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves del diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. Matriz de identificadores de identidad de usuario.

MapsAccountProperties

Nombre Descripción Valor
cors Especifica las reglas de CORS para Blob service. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para Blob Service. CorsRules
disableLocalAuth Permite alternar la funcionalidad en Azure Policy deshabilitar Azure Maps compatibilidad con la autenticación local. Esto deshabilitará las claves compartidas y la autenticación de token de firma de acceso compartido desde cualquier uso. bool
El cifrado (Opcional) No se recomienda incluir en la definición de recursos. Solo es necesario cuando sea posible deshabilitar el cifrado de la plataforma (infraestructura de AKA). Azure SQL TDE es un ejemplo de esto. Los valores están habilitados y deshabilitados. Cifrado
linkedResources Matriz de recursos asociados a la cuenta de asignación. El recurso vinculado de la matriz no se puede actualizar individualmente; debe actualizar todos los recursos vinculados de la matriz juntos. Estos recursos se pueden usar en operaciones en la API rest de Azure Maps. El acceso se controla mediante los permisos de identidades administradas de la cuenta de asignación a esos recursos. LinkedResource[]

Restricciones:
Longitud máxima = 10

CorsRules

Nombre Descripción Valor
corsRules Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. CorsRule[]

Restricciones:
Longitud máxima = 5

CorsRule

Nombre Descripción Valor
allowedOrigins Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios string[] (obligatorio)

Cifrado

Nombre Descripción Valor
customerManagedKeyEncryption Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. CustomerManagedKeyEncryption
infrastructureEncryption Los valores están habilitados y deshabilitados. "disabled"
"enabled"

CustomerManagedKeyEncryption

Nombre Descripción Valor
keyEncryptionKeyIdentity Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticar para Key Vault. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl key encryption key Url, versioned o non-versioned. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 or https://contosovault.vault.azure.net/keys/contosokek. string

CustomerManagedKeyEncryptionKeyIdentity

Nombre Descripción Valor
delegatedIdentityClientId identidad delegada que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y userAssignedIdentity: solo uso interno. string

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType Los valores pueden ser systemAssignedIdentity o userAssignedIdentity. "delegatedResourceIdentity"
"systemAssignedIdentity"
"userAssignedIdentity"
userAssignedIdentityResourceId identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity y delegatedResourceIdentity. string

LinkedResource

Nombre Descripción Value
id Id. de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}'. string (obligatorio)
uniqueName Nombre proporcionado que identifica de forma única el recurso vinculado. string (obligatorio)

SKU

Nombre Descripción Value
name Nombre de la SKU, en formato estándar (por ejemplo, S0). "G2"
"S0"
"S1" (obligatorio)