다음을 통해 공유

Microsoft.Maps 계정

  • 아티클

Bicep 리소스 정의

계정 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Maps/accounts 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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'
      }
    ]
  }
}

속성 값

계정

이름 설명 값
name 리소스 이름 string(필수)

문자 제한: 1-98(리소스 그룹 이름 및 계정 이름)

유효한 문자:
영숫자, 밑줄, 마침표 및 하이픈

영숫자로 시작합니다.
위치 리소스가 있는 지리적 위치 string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 이 계정의 SKU입니다. Sku (필수)
kind Get 또는 Set Kind 속성입니다. 'Gen1'
'Gen2'
identity 관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID) ManagedServiceIdentity
properties 맵 계정 속성입니다. MapsAccountProperties

ManagedServiceIdentity

이름 설명 값
type 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. object

MapsAccountProperties

이름 설명 값
cors Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다. CorsRules
disableLocalAuth Azure Policy 토글 기능을 사용하여 Azure Maps 로컬 인증 지원을 사용하지 않도록 설정할 수 있습니다. 이렇게 하면 모든 사용에서 공유 키 및 공유 액세스 서명 토큰 인증이 비활성화됩니다. bool
암호화 (선택 사항) 리소스 정의에 을 포함하지 않도록 합니다. 플랫폼(AKA 인프라) 암호화를 사용하지 않도록 설정할 수 있는 경우에만 필요합니다. Azure SQL TDE가 그 예입니다. 값을 사용하도록 설정하고 사용하지 않도록 설정합니다. 암호화
linkedResources Map 계정에 연결된 리소스의 배열입니다. 배열의 연결된 리소스는 개별적으로 업데이트할 수 없으며 배열의 연결된 모든 리소스를 함께 업데이트해야 합니다. 이러한 리소스는 Azure Maps REST API의 작업에 사용할 수 있습니다. 액세스는 해당 리소스에 대한 맵 계정 관리 ID 권한에 의해 제어됩니다. LinkedResource[]

제약 조건:
최대 길이 = 10

CorsRules

이름 설명 값
corsRules CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. CorsRule[]

제약 조건:
최대 길이 = 5

CorsRule

이름 설명 값
allowedOrigins CorsRule 요소가 있는 경우 필요합니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*" string[] (필수)

암호화

이름 설명 값
customerManagedKeyEncryption 리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. CustomerManagedKeyEncryption
infrastructureEncryption 값이 활성화되고 사용하지 않도록 설정됩니다. 'disabled'
'enabled'

CustomerManagedKeyEncryption

이름 설명 값
keyEncryptionKeyIdentity Key Vault 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl 키 암호화 키 URL, 버전이 지정되었거나 버전이 지정되지 않았습니다. 예: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 또는 https://contosovault.vault.azure.net/keys/contosokek. 문자열

CustomerManagedKeyEncryptionKeyIdentity

이름 설명 값
delegatedIdentityClientId 키 암호화 키 URL에 액세스하는 데 사용할 위임된 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 userAssignedIdentity와 함께 사용할 수 없습니다. 내부 사용만 가능합니다. 문자열

제약 조건:
최소 길이 = 36
최대 길이 = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType 값은 systemAssignedIdentity 또는 userAssignedIdentity일 수 있습니다. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId 키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 delegatedResourceIdentity와 함께 사용할 수 없습니다. string

LinkedResource

이름 설명 값
id '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}' 형식의 ARM 리소스 ID입니다. string(필수)
uniqueName 연결된 리소스를 고유하게 식별하는 제공된 이름입니다. string(필수)

SKU

이름 설명 값
name 표준 형식(예: S0)으로 된 SKU의 이름입니다. 'G2'
'S0'
'S1'(필수)

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿 설명
RBAC - Azure Maps 계정에서 관리 ID 액세스 만들기

Azure에 배포		 이 템플릿은 관리 ID를 만들고 생성된 Azure Maps 계정에 대한 액세스를 할당합니다.
배포 Azure Maps

Azure에 배포		 이 템플릿은 계정을 배포하고 Azure Maps 기본 키를 나열합니다.
Azure Maps Creator를 사용하여 Azure Maps 배포(실내 지도)

Azure에 배포		 이 템플릿은 실내 지도 작성자 기능을 사용하여 계정을 배포하고 Azure Maps 실내 맵 빌드를 허용합니다.
Azure Key Vault 저장된 Azure Maps SAS 토큰 만들기

Azure에 배포		 이 템플릿은 계정을 배포 및 Azure Maps Azure Key Vault 비밀에 저장할 제공된 사용자 할당 ID를 기반으로 Sas 토큰을 나열합니다.

ARM 템플릿 리소스 정의

다음을 대상으로 하는 작업으로 계정 리소스 유형을 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Maps/accounts 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

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

속성 값

계정

이름 설명 값
type 리소스 종류 'Microsoft.Maps/accounts'
apiVersion 리소스 api 버전 '2023-06-01'
name 리소스 이름 string(필수)

문자 제한: 1-98(리소스 그룹 이름 및 계정 이름)

유효한 문자:
영숫자, 밑줄, 마침표 및 하이픈

영숫자로 시작합니다.
위치 리소스가 있는 지리적 위치 string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 이 계정의 SKU입니다. Sku (필수)
kind Get 또는 Set Kind 속성입니다. 'Gen1'
'Gen2'
identity 관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID) ManagedServiceIdentity
properties 맵 계정 속성입니다. MapsAccountProperties

ManagedServiceIdentity

이름 설명 값
type 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. object

MapsAccountProperties

이름 설명 값
cors Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다. CorsRules
disableLocalAuth Azure Policy 토글 기능을 사용하여 Azure Maps 로컬 인증 지원을 사용하지 않도록 설정할 수 있습니다. 이렇게 하면 모든 사용에서 공유 키 및 공유 액세스 서명 토큰 인증이 비활성화됩니다. bool
암호화 (선택 사항) 리소스 정의에 을 포함하지 않도록 합니다. 플랫폼(AKA 인프라) 암호화를 사용하지 않도록 설정할 수 있는 경우에만 필요합니다. Azure SQL TDE가 그 예입니다. 값을 사용하도록 설정하고 사용하지 않도록 설정합니다. 암호화
linkedResources Map 계정에 연결된 리소스의 배열입니다. 배열의 연결된 리소스는 개별적으로 업데이트할 수 없으며 배열의 연결된 모든 리소스를 함께 업데이트해야 합니다. 이러한 리소스는 Azure Maps REST API의 작업에 사용할 수 있습니다. 액세스는 해당 리소스에 대한 맵 계정 관리 ID 권한에 의해 제어됩니다. LinkedResource[]

제약 조건:
최대 길이 = 10

CorsRules

이름 설명 값
corsRules CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. CorsRule[]

제약 조건:
최대 길이 = 5

CorsRule

이름 설명 값
allowedOrigins CorsRule 요소가 있는 경우 필요합니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*" string[] (필수)

암호화

이름 설명 값
customerManagedKeyEncryption 리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. CustomerManagedKeyEncryption
infrastructureEncryption 값을 사용하도록 설정하고 사용하지 않도록 설정합니다. 'disabled'
'enabled'

CustomerManagedKeyEncryption

이름 설명 값
keyEncryptionKeyIdentity Key Vault 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl 키 암호화 키 URL, 버전이 지정되었거나 버전이 지정되지 않았습니다. 예: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 또는 https://contosovault.vault.azure.net/keys/contosokek. 문자열

CustomerManagedKeyEncryptionKeyIdentity

이름 설명 값
delegatedIdentityClientId 키 암호화 키 URL에 액세스하는 데 사용할 위임된 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 userAssignedIdentity와 함께 사용할 수 없습니다. 내부 전용입니다. 문자열

제약 조건:
최소 길이 = 36
최대 길이 = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType 값은 systemAssignedIdentity 또는 userAssignedIdentity일 수 있습니다. 'delegatedResourceIdentity'
'systemAssignedIdentity'
'userAssignedIdentity'
userAssignedIdentityResourceId 키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 delegatedResourceIdentity와 함께 사용할 수 없습니다. 문자열

LinkedResource

이름 설명 값
id '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}' 형식의 ARM 리소스 ID입니다. string(필수)
uniqueName 연결된 리소스를 고유하게 식별하는 제공된 이름입니다. string(필수)

SKU

이름 설명 값
name 표준 형식(예: S0)의 SKU 이름입니다. 'G2'
'S0'
'S1'(필수)

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿 설명
RBAC - Azure Maps 계정에서 관리 ID 액세스 만들기

Azure에 배포		 이 템플릿은 관리 ID를 만들고 생성된 Azure Maps 계정에 대한 액세스를 할당합니다.
배포 Azure Maps

Azure에 배포		 이 템플릿은 계정을 배포하고 Azure Maps 기본 키를 나열합니다.
Azure Maps Creator를 사용하여 Azure Maps 배포(실내 지도)

Azure에 배포		 이 템플릿은 실내 지도 작성자 기능을 사용하여 계정을 배포하고 Azure Maps 실내 지도 빌드를 허용합니다.
Azure Key Vault 저장된 Azure Maps SAS 토큰 만들기

Azure에 배포		 이 템플릿은 계정을 배포하고 Azure Maps Azure Key Vault 비밀에 저장할 제공된 사용자 할당 ID를 기반으로 Sas 토큰을 나열합니다.

Terraform(AzAPI 공급자) 리소스 정의

계정 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Maps/accounts 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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

속성 값

계정

이름 설명 값
type 리소스 종류 "Microsoft.Maps/accounts@2023-06-01"
name 리소스 이름 string(필수)

문자 제한: 1-98(리소스 그룹 이름 및 계정 이름)

유효한 문자:
영숫자, 밑줄, 마침표 및 하이픈

영숫자로 시작합니다.
위치 리소스가 있는 지리적 위치 string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다.
sku 이 계정의 SKU입니다. Sku (필수)
kind Get 또는 Set Kind 속성입니다. "Gen1"
"Gen2"
identity 관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID) ManagedServiceIdentity
properties 맵 계정 속성입니다. MapsAccountProperties

ManagedServiceIdentity

이름 설명 값
type 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"(필수)
identity_ids 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. 사용자 ID ID의 배열입니다.

MapsAccountProperties

이름 설명 값
cors Blob 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 Blob 서비스에 대해 CORS가 비활성화됩니다. CorsRules
disableLocalAuth Azure Policy 토글 기능을 사용하여 Azure Maps 로컬 인증 지원을 사용하지 않도록 설정할 수 있습니다. 이렇게 하면 모든 사용에서 공유 키 및 공유 액세스 서명 토큰 인증이 비활성화됩니다. bool
암호화 (선택 사항) 리소스 정의에 을 포함하지 않도록 합니다. 플랫폼(AKA 인프라) 암호화를 사용하지 않도록 설정할 수 있는 경우에만 필요합니다. Azure SQL TDE가 그 예입니다. 값을 사용하도록 설정하고 사용하지 않도록 설정합니다. 암호화
linkedResources Map 계정에 연결된 리소스의 배열입니다. 배열의 연결된 리소스는 개별적으로 업데이트할 수 없으며 배열의 연결된 모든 리소스를 함께 업데이트해야 합니다. 이러한 리소스는 Azure Maps REST API의 작업에 사용할 수 있습니다. 액세스는 해당 리소스에 대한 맵 계정 관리 ID 권한에 의해 제어됩니다. LinkedResource[]

제약 조건:
최대 길이 = 10

CorsRules

이름 설명 값
corsRules CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. CorsRule[]

제약 조건:
최대 길이 = 5

CorsRule

이름 설명 값
allowedOrigins CorsRule 요소가 있는 경우 필요합니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*" string[] (필수)

암호화

이름 설명 값
customerManagedKeyEncryption 리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. CustomerManagedKeyEncryption
infrastructureEncryption 값을 사용하도록 설정하고 사용하지 않도록 설정합니다. "disabled"
"enabled"

CustomerManagedKeyEncryption

이름 설명 값
keyEncryptionKeyIdentity Key Vault 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다. CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl 키 암호화 키 URL, 버전이 지정되었거나 버전이 지정되지 않았습니다. 예: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 또는 https://contosovault.vault.azure.net/keys/contosokek. 문자열

CustomerManagedKeyEncryptionKeyIdentity

이름 설명 값
delegatedIdentityClientId 키 암호화 키 URL에 액세스하는 데 사용할 위임된 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 userAssignedIdentity와 함께 사용할 수 없습니다. 내부 사용만 가능합니다. string

제약 조건:
최소 길이 = 36
최대 길이 = 36
Pattern = "^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$"
identityType 값은 systemAssignedIdentity 또는 userAssignedIdentity일 수 있습니다. "delegatedResourceIdentity"
"systemAssignedIdentity"
"userAssignedIdentity"
userAssignedIdentityResourceId 키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다. 예: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/{resource group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. identityType systemAssignedIdentity 및 delegatedResourceIdentity와 함께 사용할 수 없습니다. 문자열

LinkedResource

이름 설명 값
id '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}' 형식의 ARM 리소스 ID입니다. string(필수)
uniqueName 연결된 리소스를 고유하게 식별하는 제공된 이름입니다. string(필수)

SKU

이름 설명 값
name 표준 형식(예: S0)으로 된 SKU의 이름입니다. "G2"
"S0"
"S1"(필수)