Microsoft.Sql managedInstances 2020-02-02-preview

Bicep リソース定義

managedInstances リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.Sql/managedInstances リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Sql/managedInstances@2020-02-02-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    collation: 'string'
    dnsZonePartner: 'string'
    instancePoolId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    restorePointInTime: 'string'
    sourceManagedInstanceId: 'string'
    storageAccountType: 'string'
    storageSizeInGB: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

プロパティ値

managedInstances

名前 説明
name リソース名 string (必須)

文字制限: 1 から 63

有効な文字:
小文字、数字、およびハイフン。

先頭または末尾をハイフンにすることはできません。

リソース名は、Azure 全体で一意である必要があります。
location リソースの場所。 string (必須)
tags リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド インスタンス SKU。 sku.name に使用できる値: GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5 SKU
identity マネージド インスタンスの Azure Active Directory ID。 ResourceIdentity
properties リソースのプロパティ。 ManagedInstanceProperties

ResourceIdentity

名前 説明
type ID の種類。 リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'

ManagedInstanceProperties

名前 説明
administratorLogin マネージド インスタンスの管理者ユーザー名。 マネージド インスタンスが作成されている場合にのみ指定できます (作成に必要です)。 string
administratorLoginPassword 管理者ログイン パスワード (マネージド インスタンスの作成に必要)。 string
照合順序 (collation) マネージド インスタンスの照合順序。 string
dnsZonePartner このマネージド インスタンスが作成後に共有する DNS ゾーンを持つ別のマネージド インスタンスのリソース ID。 string
instancePoolId このマネージド サーバーが属しているインスタンス プールの ID。 string
licenseType ライセンスの種類。 使用できる値は、"LicenseIncluded" (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込むための割引された AHB 価格) です。 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId このマネージド インスタンスに適用するメンテナンス構成 ID を指定します。 string
managedInstanceCreateMode データベースの作成モードを指定します。

既定値: 通常のインスタンスの作成。

復元: 一連のバックアップを特定の時点に復元することによってインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。
'Default'
'PointInTimeRestore'
minimalTlsVersion 最小 TLS バージョン。 使用できる値: 'None'、'1.0'、'1.1'、'1.2' string
proxyOverride インスタンスへの接続に使用される接続の種類。 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled パブリック データ エンドポイントが有効かどうか。 [bool]
restorePointInTime 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 string
sourceManagedInstanceId このインスタンスの作成操作に関連付けられているソース マネージド インスタンスのリソース識別子。 string
storageAccountType このインスタンスのバックアップを格納するために使用されるストレージ アカウントの種類。 オプションは LRS (LocallyRedundantStorage)、ZRS (ZoneRedundantStorage)、GRS (GeoRedundantStorage) です。 'GRS'
'LRS'
'ZRS'
storageSizeInGB ストレージ サイズ (GB 単位)。 最小値: 32。 最大値: 8192。 32 GB の増分のみが許可されます。 INT
subnetId マネージド インスタンスのサブネット リソース ID。 string
Timezoneid タイムゾーンの ID。 使用できる値は、Windows でサポートされているタイムゾーンです。
Windows では、サポートされているタイムゾーン (ID を含む) の詳細がレジストリに保持されます。
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。
これらのレジストリ値は、SELECT name AS timezone_id FROM sys.time_zone_infoに対してクエリを実行することで、SQL Serverを使用して取得できます。
Id の一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行して取得することもできます。
有効なタイムゾーン ID の例として、"太平洋標準時" または "W" があります。 ヨーロッパ標準時"
string
仮想コア 仮想コアの数。 使用できる値: 8、16、24、32、40、64、80。 INT
zoneRedundant multi-az が有効かどうか。 [bool]

Sku

名前 説明
capacity 特定の SKU の容量。 INT
family 同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 string
name SKU の名前 。通常は、文字 + 数値コード (P3 など)。 string (必須)
size 特定の SKU のサイズ string
レベル 特定の SKU のレベルまたはエディション (Basic、Premium など)。 string

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
ネットワークを使用してSQL Managed Instanceをデプロイする

Azure にデプロイする
UDR と NSG をデプロイしてAzure SQL Managed Instanceをサポートし、Managed Instanceをデプロイする
新しい仮想ネットワーク内に SQL MI を作成する

Azure にデプロイする
新しいVirtual Network内に Azure Sql Database Managed Instance (SQL MI) をデプロイします。
ログとメトリックの送信を構成して SQL MI を作成する

Azure にデプロイする
このテンプレートを使用すると、SQL MI と、ログとメトリック (診断ワークスペース、ストレージ アカウント、イベント ハブ) の格納に使用される追加のリソースをデプロイできます。
新しい仮想ネットワーク内にジャンプボックスを使用して SQL MI を作成する

Azure にデプロイする
新しいVirtual Network内に SSMS を使用して Azure Sql Database Managed Instance (SQL MI) と JumpBox をデプロイします。
ポイント対サイト接続が構成された SQL MI を作成する

Azure にデプロイする
新しい仮想ネットワーク内でポイント対サイト接続用に構成された Azure Sql Database Managed Instance (SQL MI) と仮想ネットワーク ゲートウェイをデプロイします。

ARM テンプレート リソース定義

managedInstances リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.Sql/managedInstances リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2020-02-02-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "collation": "string",
    "dnsZonePartner": "string",
    "instancePoolId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "restorePointInTime": "string",
    "sourceManagedInstanceId": "string",
    "storageAccountType": "string",
    "storageSizeInGB": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

プロパティ値

managedInstances

名前 説明
type リソースの種類 'Microsoft.Sql/managedInstances'
apiVersion リソース API のバージョン '2020-02-02-preview'
name リソース名 string (必須)

文字制限: 1 から 63

有効な文字:
小文字、数字、およびハイフン。

先頭または末尾をハイフンにすることはできません。

リソース名は、Azure 全体で一意である必要があります。
location リソースの場所。 string (必須)
tags リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド インスタンス SKU。 sku.name に使用できる値: GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5 SKU
identity マネージド インスタンスの Azure Active Directory ID。 ResourceIdentity
properties リソースのプロパティ。 ManagedInstanceProperties

ResourceIdentity

名前 説明
type ID の種類。 リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'

ManagedInstanceProperties

名前 説明
administratorLogin マネージド インスタンスの管理者ユーザー名。 マネージド インスタンスが作成されている場合にのみ指定できます (作成に必要です)。 string
administratorLoginPassword 管理者ログイン パスワード (マネージド インスタンスの作成に必要)。 string
照合順序 (collation) マネージド インスタンスの照合順序。 string
dnsZonePartner このマネージド インスタンスが作成後に共有する DNS ゾーンを持つ別のマネージド インスタンスのリソース ID。 string
instancePoolId このマネージド サーバーが属しているインスタンス プールの ID。 string
licenseType ライセンスの種類。 使用できる値は、"LicenseIncluded" (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込むための割引された AHB 価格) です。 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId このマネージド インスタンスに適用するメンテナンス構成 ID を指定します。 string
managedInstanceCreateMode データベースの作成モードを指定します。

既定値: 通常のインスタンスの作成。

復元: 一連のバックアップを特定の時点に復元することによってインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。
'Default'
'PointInTimeRestore'
minimalTlsVersion 最小 TLS バージョン。 使用できる値: 'None'、'1.0'、'1.1'、'1.2' string
proxyOverride インスタンスへの接続に使用される接続の種類。 'Default'
'Proxy'
'Redirect'
publicDataEndpointEnabled パブリック データ エンドポイントが有効になっているかどうか。 [bool]
restorePointInTime 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 string
sourceManagedInstanceId このインスタンスの作成操作に関連付けられているソース マネージド インスタンスのリソース識別子。 string
storageAccountType このインスタンスのバックアップを格納するために使用されるストレージ アカウントの種類。 オプションは、LRS (LocallyRedundantStorage)、ZRS (ZoneRedundantStorage) および GRS (GeoRedundantStorage) です。 'GRS'
'LRS'
'ZRS'
storageSizeInGB ストレージ サイズ (GB 単位)。 最小値: 32。 最大値: 8192。 32 GB の増分のみが許可されます。 INT
subnetId マネージド インスタンスのサブネット リソース ID。 string
Timezoneid タイムゾーンの ID。 使用できる値は、Windows でサポートされているタイムゾーンです。
Windows では、サポートされているタイムゾーン (ID を含む) の詳細がレジストリに保持されます。
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。
これらのレジストリ値は、SELECT name AS timezone_id FROM sys.time_zone_infoに対してクエリを実行することで、SQL Serverを使用して取得できます。
Id の一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行して取得することもできます。
有効なタイムゾーン ID の例として、"太平洋標準時" または "W" があります。 ヨーロッパ標準時"
string
仮想コア 仮想コアの数。 使用できる値: 8、16、24、32、40、64、80。 INT
zoneRedundant multi-az が有効かどうか。 [bool]

Sku

名前 説明
capacity 特定の SKU の容量。 INT
family 同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 string
name SKU の名前 。通常は、文字 + 数値コード (P3 など)。 string (必須)
size 特定の SKU のサイズ string
レベル 特定の SKU のレベルまたはエディション (Basic、Premium など)。 string

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
ネットワークを使用してSQL Managed Instanceをデプロイする

Azure にデプロイする
UDR と NSG をデプロイしてAzure SQL Managed Instanceをサポートし、Managed Instanceをデプロイする
新しい仮想ネットワーク内に SQL MI を作成する

Azure にデプロイする
新しいVirtual Network内に Azure Sql Database Managed Instance (SQL MI) をデプロイします。
ログとメトリックの送信を構成して SQL MI を作成する

Azure にデプロイする
このテンプレートを使用すると、SQL MI と、ログとメトリック (診断ワークスペース、ストレージ アカウント、イベント ハブ) の格納に使用される追加のリソースをデプロイできます。
新しい仮想ネットワーク内にジャンプボックスを使用して SQL MI を作成する

Azure にデプロイする
新しいVirtual Network内に SSMS を使用して Azure Sql Database Managed Instance (SQL MI) と JumpBox をデプロイします。
ポイント対サイト接続が構成された SQL MI を作成する

Azure にデプロイする
新しい仮想ネットワーク内でポイント対サイト接続用に構成された Azure Sql Database Managed Instance (SQL MI) と仮想ネットワーク ゲートウェイをデプロイします。

Terraform (AzAPI プロバイダー) リソース定義

managedInstances リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.Sql/managedInstances リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2020-02-02-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      collation = "string"
      dnsZonePartner = "string"
      instancePoolId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      restorePointInTime = "string"
      sourceManagedInstanceId = "string"
      storageAccountType = "string"
      storageSizeInGB = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

プロパティ値

managedInstances

名前 説明
type リソースの種類 "Microsoft.Sql/managedInstances@2020-02-02-preview"
name リソース名 string (必須)

文字数制限: 1 から 63

有効な文字:
小文字、数字、およびハイフン。

先頭または末尾をハイフンにすることはできません。

リソース名は、Azure 全体で一意である必要があります。
location リソースの場所。 string (必須)
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags リソース タグ。 タグ名と値のディクショナリ。
sku マネージド インスタンス SKU。 sku.name に使用できる値: GP_Gen4、GP_Gen5、BC_Gen4、BC_Gen5 SKU
identity マネージド インスタンスの Azure Active Directory ID。 ResourceIdentity
properties リソースのプロパティ。 ManagedInstanceProperties

ResourceIdentity

名前 説明
type ID の種類。 リソースの Azure Active Directory プリンシパルを自動的に作成して割り当てるには、これを "SystemAssigned" に設定します。 "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"

ManagedInstanceProperties

名前 説明
administratorLogin マネージド インスタンスの管理者ユーザー名。 マネージド インスタンスが作成されている場合にのみ指定できます (作成に必要です)。 string
administratorLoginPassword 管理者ログイン パスワード (マネージド インスタンスの作成に必要)。 string
照合順序 (collation) マネージド インスタンスの照合順序。 string
dnsZonePartner このマネージド インスタンスが作成後に共有する DNS ゾーンを持つ別のマネージド インスタンスのリソース ID。 string
instancePoolId このマネージド サーバーが属しているインスタンス プールの ID。 string
licenseType ライセンスの種類。 使用できる値は、"LicenseIncluded" (新しい SQL ライセンスを含む通常価格) と 'BasePrice' (独自の SQL ライセンスを持ち込むための割引された AHB 価格) です。 "BasePrice"
"LicenseIncluded"
maintenanceConfigurationId このマネージド インスタンスに適用するメンテナンス構成 ID を指定します。 string
managedInstanceCreateMode データベースの作成モードを指定します。

既定値: 通常のインスタンスの作成。

復元: 一連のバックアップを特定の時点に復元することによってインスタンスを作成します。 RestorePointInTime と SourceManagedInstanceId を指定する必要があります。
"Default"
"PointInTimeRestore"
minimalTlsVersion 最小 TLS バージョン。 使用できる値: 'None'、'1.0'、'1.1'、'1.2' string
proxyOverride インスタンスへの接続に使用される接続の種類。 "Default"
"Proxy"
"Redirect"
publicDataEndpointEnabled パブリック データ エンドポイントが有効になっているかどうか。 [bool]
restorePointInTime 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 string
sourceManagedInstanceId このインスタンスの作成操作に関連付けられているソース マネージド インスタンスのリソース識別子。 string
storageAccountType このインスタンスのバックアップを格納するために使用されるストレージ アカウントの種類。 オプションは、LRS (LocallyRedundantStorage)、ZRS (ZoneRedundantStorage) および GRS (GeoRedundantStorage) です。 "GRS"
"LRS"
"ZRS"
storageSizeInGB ストレージ サイズ (GB 単位)。 最小値: 32。 最大値: 8192。 32 GB の増分のみが許可されます。 INT
subnetId マネージド インスタンスのサブネット リソース ID。 string
Timezoneid タイムゾーンの ID。 使用できる値は、Windows でサポートされているタイムゾーンです。
Windows では、サポートされているタイムゾーン (ID を含む) の詳細がレジストリに保持されます。
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。
SQL SERVERを使用してこれらのレジストリ値を取得するには、SELECT name AS timezone_id FROM sys.time_zone_infoに対してクエリを実行します。
Id の一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行して取得することもできます。
有効なタイムゾーン ID の例として、"太平洋標準時" または "W" があります。 ヨーロッパ標準時"
string
仮想コア 仮想コアの数。 使用できる値: 8、16、24、32、40、64、80。 INT
zoneRedundant multi-az が有効になっているかどうか。 [bool]

Sku

名前 説明
capacity 特定の SKU の容量。 INT
family サービスのハードウェアの世代が異なる場合は、同じ SKU に対して、ここでキャプチャできます。 string
name SKU の名前 (通常は文字 + 番号コード、例: P3)。 string (必須)
size 特定の SKU のサイズ string
レベル 特定の SKU のレベルまたはエディション (Basic、Premium など)。 string