Bicep の Scope 関数

[アーティクル]
07/11/2024

この記事では、スコープの値を取得するための Bicep 関数について説明します。

managementGroup

managementGroup()

現在のデプロイの管理グループからプロパティを持つオブジェクトを返します。

managementGroup(identifier)

スコープを管理グループに設定するために使用されるオブジェクトを返します。

名前空間: az。

解説

managementGroup() は、管理グループのデプロイ上でのみ使用できます。これは、デプロイ操作の現在の管理グループを返します。スコープオブジェクトを取得するとき、または現在の管理グループのプロパティを取得するときに使用します。

managementGroup(identifier) は、任意のデプロイスコープに使用できますが、スコープオブジェクトを取得する場合のみになります。管理グループのプロパティを取得するために、管理グループの識別子を渡すことはできません。

パラメーター

パラメーター	必須	タイプ	説明
identifier	いいえ	string	デプロイ先の管理グループの一意識別子。管理グループの表示名は使用しないでください。値を指定しない場合は、現在の管理グループが返されます。

戻り値

モジュールまたは拡張リソースの種類上で scope プロパティを設定するために使用されるオブジェクト。または、現在の管理グループのプロパティを持つオブジェクト。

管理グループの例

次の例では、モジュールのスコープを管理グループに設定します。

param managementGroupIdentifier string

module  'mgModule.bicep' = {
  name: 'deployToMG'
  scope: managementGroup(managementGroupIdentifier)
}

次の例では、現在の管理グループのプロパティが返されます。

targetScope = 'managementGroup'

var mgInfo = managementGroup()

output mgResult object = mgInfo

戻り値は次のとおりです。

"mgResult": {
  "type": "Object",
  "value": {
    "id": "/providers/Microsoft.Management/managementGroups/examplemg1",
    "name": "examplemg1",
    "properties": {
      "details": {
        "parent": {
          "displayName": "Tenant Root Group",
          "id": "/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000",
          "name": "00000000-0000-0000-0000-000000000000"
        },
        "updatedBy": "00000000-0000-0000-0000-000000000000",
        "updatedTime": "2020-07-23T21:05:52.661306Z",
        "version": "1"
      },
      "displayName": "Example MG 1",
      "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
    },
    "type": "/providers/Microsoft.Management/managementGroups"
  }
}

次の例では、新しい管理グループを作成し、この関数を使用して親管理グループを設定します。

targetScope = 'managementGroup'

param mgName string = 'mg-${uniqueString(newGuid())}'

resource newMG 'Microsoft.Management/managementGroups@2023-04-01' = {
  scope: tenant()
  name: mgName
  properties: {
    details: {
      parent: {
        id: managementGroup().id
      }
    }
  }
}

output newManagementGroup string = mgName

resourceGroup

resourceGroup()

現在のリソースグループを表すオブジェクトを返します。

resourceGroup(resourceGroupName)

および

resourceGroup(subscriptionId, resourceGroupName)

スコープをリソースグループに設定するために使われるオブジェクトを返します。

名前空間: az。

解説

resourceGroup 関数には、2 つの異なる用途があります。 1 つは、モジュールまたは拡張リソースの種類上でスコープを設定すること、もう 1 つは、現在のリソースグループに関する詳細を取得することです。その用途は、関数の配置によって決まります。 scope プロパティの設定に使用すると、スコープオブジェクトが返されます。

resourceGroup() は、スコープの設定またはリソースグループに関する詳細の取得に使用できます。

resourceGroup(resourceGroupName) と resourceGroup(subscriptionId, resourceGroupName) は、スコープの設定にのみ使用できます。

パラメーター

パラメーター	必須	タイプ	説明
resourceGroupName	いいえ	string	デプロイ先のリソースグループの名前。値を指定しない場合は、現在のリソースグループが返されます。
subscriptionId	いいえ	string	デプロイ先のサブスクリプションの一意識別子。値を指定しない場合は、現在のサブスクリプションが返されます。

戻り値

スコープの設定に使用すると、関数によって、モジュールまたは拡張リソースの種類上の scope プロパティに対して有効なオブジェクトが返されます。

リソースグループの詳細の取得に使用すると、関数によって次の形式が返されます。

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}",
  "name": "{resourceGroupName}",
  "type":"Microsoft.Resources/resourceGroups",
  "location": "{resourceGroupLocation}",
  "managedBy": "{identifier-of-managing-resource}",
  "tags": {
  },
  "properties": {
    "provisioningState": "{status}"
  }
}

managedBy プロパティは、別のサービスによって管理されているリソースを含むリソースグループに対してのみ返されます。 Managed Applications、Databricks、および AKS の場合、プロパティの値は管理しているリソースのリソース ID になります。

リソースグループの例

次の例は、モジュールのスコープをリソースグループに設定します。

param resourceGroupName string

module exampleModule 'rgModule.bicep' = {
  name: 'exampleModule'
  scope: resourceGroup(resourceGroupName)
}

次の例は、リソースグループのプロパティを返します。

output resourceGroupOutput object = resourceGroup()

次の形式のオブジェクトが返されます。

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/examplegroup",
  "name": "examplegroup",
  "type":"Microsoft.Resources/resourceGroups",
  "location": "southcentralus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

resourceGroup 関数の一般的な用途では、リソースグループと同じ場所にリソースを作成します。次の例では、既定のパラメーター値にリソースグループの場所を使用します。

param location string = resourceGroup().location

resourceGroup 関数を使用して、リソースグループからリソースにタグを適用することもできます。詳細については、「リソースグループからタグを適用する」を参照してください。

subscription

subscription()

現在のデプロイのサブスクリプションの詳細を返します。

subscription(subscriptionId)

スコープをサブスクリプションに設定するために使用されるオブジェクトを返します。

名前空間: az。

解説

subscription 関数には、2 つの異なる用途があります。 1 つは、モジュールまたは拡張リソースの種類上でスコープを設定すること、もう 1 つは、現在のサブスクリプションに関する詳細を取得することです。その用途は、関数の配置によって決まります。 scope プロパティの設定に使用すると、スコープオブジェクトが返されます。

subscription(subscriptionId) は、スコープの設定にのみ使用できます。

subscription() は、スコープの設定またはサブスクリプションに関する詳細の取得に使用できます。

パラメーター

パラメーター	必須	タイプ	説明
subscriptionId	いいえ	string	デプロイ先のサブスクリプションの一意識別子。値を指定しない場合は、現在のサブスクリプションが返されます。

戻り値

サブスクリプションの詳細の取得に使用すると、関数によって次の形式が返されます。

{
  "id": "/subscriptions/{subscription-id}",
  "subscriptionId": "{subscription-id}",
  "tenantId": "{tenant-id}",
  "displayName": "{name-of-subscription}"
}

サブスクリプションの例

次の例は、モジュールのスコープをサブスクリプションに設定します。

module exampleModule 'subModule.bicep' = {
  name: 'deployToSub'
  scope: subscription()
}

次の例は、サブスクリプションの詳細を返します。

output subscriptionOutput object = subscription()

tenant

tenant()

スコープをテナントに設定するために使用されるオブジェクトを返します。

または

ユーザーのテナントを返します。

名前空間: az。

解説

tenant() は、任意のデプロイスコープに使用できます。常に、現在のテナントが返されます。この関数を使用して、リソースのスコープを設定したり、現在のテナントのプロパティを取得したりできます。

戻り値

モジュールまたは拡張リソースの種類上で scope プロパティを設定するために使用されるオブジェクト。または、現在のテナントに関するプロパティを持つオブジェクト。

テナントの例

次の例は、テナントにデプロイするモジュールを表示します。

module exampleModule 'tenantModule.bicep' = {
  name: 'deployToTenant'
  scope: tenant()
}

次の例では、テナントのプロパティが返されます。

var tenantInfo = tenant()

output tenantResult object = tenantInfo

戻り値は次のとおりです。

"tenantResult": {
  "type": "Object",
  "value": {
    "countryCode": "US",
    "displayName": "Contoso",
    "id": "/tenants/00000000-0000-0000-0000-000000000000",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
  }
}

一部のリソースでは、プロパティのテナント ID を設定する必要があります。テナント ID をパラメーターとして渡すのではなく、テナント関数を使用して取得できます。

resource kv 'Microsoft.KeyVault/vaults@2023-07-01' = {
  name: 'examplekeyvault'
  location: 'westus'
  properties: {
    tenantId: tenant().tenantId
    ...
  }
}

次のステップ

デプロイのスコープの詳細については、以下を参照してください。

次の方法で共有

Bicep の Scope 関数

managementGroup

解説

パラメーター

戻り値

管理グループの例

resourceGroup

解説

パラメーター

戻り値

リソースグループの例

subscription

解説

パラメーター

戻り値

サブスクリプションの例

tenant

解説

戻り値

テナントの例

次のステップ

フィードバック

その他のリソース

次の方法で共有

Bicep の Scope 関数

managementGroup

解説

パラメーター

戻り値

管理グループの例

resourceGroup

解説

パラメーター

戻り値

リソース グループの例

subscription

解説

パラメーター

戻り値

サブスクリプションの例

tenant

解説

戻り値

テナントの例

次のステップ

フィードバック

その他のリソース

リソースグループの例