Microsoft.Blueprint blueprints/artifacts 2017-11-11-preview

• Latest
• 2018-11-01-preview
• 2017-11-11-preview

Bicep resource definition

The blueprints/artifacts resource type can be deployed with operations that target:

• Management groups - See management group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Blueprint/blueprints/artifacts resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Blueprint/blueprints/artifacts@2017-11-11-preview' = {
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.Blueprint/blueprints/artifacts objects
}

Microsoft.Blueprint/blueprints/artifacts objects

Set the kind property to specify the type of object.

For policyAssignment, use:

{
  kind: 'policyAssignment'
  properties: {
    dependsOn: [
      'string'
    ]
    description: 'string'
    displayName: 'string'
    parameters: {
      {customized property}: {
        description: 'string'
      }
    }
    policyDefinitionId: 'string'
    resourceGroup: 'string'
  }
}

For roleAssignment, use:

{
  kind: 'roleAssignment'
  properties: {
    dependsOn: [
      'string'
    ]
    description: 'string'
    displayName: 'string'
    principalIds: any(Azure.Bicep.Types.Concrete.AnyType)
    resourceGroup: 'string'
    roleDefinitionId: 'string'
  }
}

For template, use:

{
  kind: 'template'
  properties: {
    dependsOn: [
      'string'
    ]
    description: 'string'
    displayName: 'string'
    parameters: {
      {customized property}: {
        description: 'string'
      }
    }
    resourceGroup: 'string'
    template: any(Azure.Bicep.Types.Concrete.AnyType)
  }
}

Property values

Microsoft.Blueprint/blueprints/artifacts

Name	Description	Value
kind	Set to 'policyAssignment' for type PolicyAssignmentArtifact. Set to 'roleAssignment' for type RoleAssignmentArtifact. Set to 'template' for type TemplateArtifact.	'policyAssignment' 'roleAssignment' 'template' (required)
name	The resource name	string (required)
parent	In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource.	Symbolic name for resource of type: blueprints

ParameterValueBase

Name	Description	Value
description	Optional property, just to establish ParameterValueBase as a BaseClass.	string

ParameterValueCollection

Name	Description	Value

ParameterValueCollection

Name	Description	Value

PolicyAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'policyAssignment' (required)
properties	properties for policyAssignment Artifact	PolicyAssignmentArtifactProperties (required)

PolicyAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Parameter values for the policy definition.	ParameterValueCollection (required)
policyDefinitionId	Azure resource ID of the policy definition.	string (required)
resourceGroup	Name of the resource group placeholder to which the policy will be assigned.	string

RoleAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'roleAssignment' (required)
properties	Properties for roleAssignment artifact.	RoleAssignmentArtifactProperties (required)

RoleAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
principalIds	Array of user or group identities in Azure Active Directory. The roleDefinition will apply to these identity.	any (required)
resourceGroup	RoleAssignment will be scope to this resourceGroup, if left empty, it would scope to the subscription.	string
roleDefinitionId	Azure resource ID of the RoleDefinition.	string (required)

TemplateArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'template' (required)
properties	Properties for template artifact	TemplateArtifactProperties (required)

TemplateArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Template parameter values.	ParameterValueCollection (required)
resourceGroup	If applicable, the name of the resource group placeholder to which the template will be deployed.	string
template	The Azure Resource Manager template body.	any (required)

ARM template resource definition

The blueprints/artifacts resource type can be deployed with operations that target:

• Management groups - See management group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Blueprint/blueprints/artifacts resource, add the following JSON to your template.

{
  "name": "string",
  "kind": "string"
  // For remaining properties, see Microsoft.Blueprint/blueprints/artifacts objects
}

Microsoft.Blueprint/blueprints/artifacts objects

Set the kind property to specify the type of object.

For policyAssignment, use:

{
  "kind": "policyAssignment",
  "properties": {
    "dependsOn": [ "string" ],
    "description": "string",
    "displayName": "string",
    "parameters": {
      "{customized property}": {
        "description": "string"
      }
    },
    "policyDefinitionId": "string",
    "resourceGroup": "string"
  }
}

For roleAssignment, use:

{
  "kind": "roleAssignment",
  "properties": {
    "dependsOn": [ "string" ],
    "description": "string",
    "displayName": "string",
    "principalIds": {},
    "resourceGroup": "string",
    "roleDefinitionId": "string"
  }
}

For template, use:

{
  "kind": "template",
  "properties": {
    "dependsOn": [ "string" ],
    "description": "string",
    "displayName": "string",
    "parameters": {
      "{customized property}": {
        "description": "string"
      }
    },
    "resourceGroup": "string",
    "template": {}
  }
}

Property values

Microsoft.Blueprint/blueprints/artifacts

Name	Description	Value
apiVersion	The api version	'2017-11-11-preview'
kind	Set to 'policyAssignment' for type PolicyAssignmentArtifact. Set to 'roleAssignment' for type RoleAssignmentArtifact. Set to 'template' for type TemplateArtifact.	'policyAssignment' 'roleAssignment' 'template' (required)
name	The resource name	string (required)
type	The resource type	'Microsoft.Blueprint/blueprints/artifacts'

ParameterValueBase

Name	Description	Value
description	Optional property, just to establish ParameterValueBase as a BaseClass.	string

ParameterValueCollection

Name	Description	Value

ParameterValueCollection

Name	Description	Value

PolicyAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'policyAssignment' (required)
properties	properties for policyAssignment Artifact	PolicyAssignmentArtifactProperties (required)

PolicyAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Parameter values for the policy definition.	ParameterValueCollection (required)
policyDefinitionId	Azure resource ID of the policy definition.	string (required)
resourceGroup	Name of the resource group placeholder to which the policy will be assigned.	string

RoleAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'roleAssignment' (required)
properties	Properties for roleAssignment artifact.	RoleAssignmentArtifactProperties (required)

RoleAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
principalIds	Array of user or group identities in Azure Active Directory. The roleDefinition will apply to these identity.	any (required)
resourceGroup	RoleAssignment will be scope to this resourceGroup, if left empty, it would scope to the subscription.	string
roleDefinitionId	Azure resource ID of the RoleDefinition.	string (required)

TemplateArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'template' (required)
properties	Properties for template artifact	TemplateArtifactProperties (required)

TemplateArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Template parameter values.	ParameterValueCollection (required)
resourceGroup	If applicable, the name of the resource group placeholder to which the template will be deployed.	string
template	The Azure Resource Manager template body.	any (required)

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Blueprints - Create a new blueprint definition	This template creates an Azure Blueprint blueprint definition. The blueprint definition includes a policy assignment artifact and can be modified and then deployed to management groups or subscriptions for consistent environments.

Terraform (AzAPI provider) resource definition

The blueprints/artifacts resource type can be deployed with operations that target:

• Management groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Blueprint/blueprints/artifacts resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  name = "string"
  kind = "string"
  // For remaining properties, see Microsoft.Blueprint/blueprints/artifacts objects
}

Microsoft.Blueprint/blueprints/artifacts objects

Set the kind property to specify the type of object.

For policyAssignment, use:

{
  kind = "policyAssignment"
  properties = {
    dependsOn = [
      "string"
    ]
    description = "string"
    displayName = "string"
    parameters = {
      {customized property} = {
        description = "string"
      }
    }
    policyDefinitionId = "string"
    resourceGroup = "string"
  }
}

For roleAssignment, use:

{
  kind = "roleAssignment"
  properties = {
    dependsOn = [
      "string"
    ]
    description = "string"
    displayName = "string"
    principalIds = ?
    resourceGroup = "string"
    roleDefinitionId = "string"
  }
}

For template, use:

{
  kind = "template"
  properties = {
    dependsOn = [
      "string"
    ]
    description = "string"
    displayName = "string"
    parameters = {
      {customized property} = {
        description = "string"
      }
    }
    resourceGroup = "string"
    template = ?
  }
}

Property values

Microsoft.Blueprint/blueprints/artifacts

Name	Description	Value
kind	Set to 'policyAssignment' for type PolicyAssignmentArtifact. Set to 'roleAssignment' for type RoleAssignmentArtifact. Set to 'template' for type TemplateArtifact.	'policyAssignment' 'roleAssignment' 'template' (required)
name	The resource name	string (required)
parent_id	The ID of the resource that is the parent for this resource.	ID for resource of type: blueprints
type	The resource type	"Microsoft.Blueprint/blueprints/artifacts@2017-11-11-preview"

ParameterValueBase

Name	Description	Value
description	Optional property, just to establish ParameterValueBase as a BaseClass.	string

ParameterValueCollection

Name	Description	Value

ParameterValueCollection

Name	Description	Value

PolicyAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'policyAssignment' (required)
properties	properties for policyAssignment Artifact	PolicyAssignmentArtifactProperties (required)

PolicyAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Parameter values for the policy definition.	ParameterValueCollection (required)
policyDefinitionId	Azure resource ID of the policy definition.	string (required)
resourceGroup	Name of the resource group placeholder to which the policy will be assigned.	string

RoleAssignmentArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'roleAssignment' (required)
properties	Properties for roleAssignment artifact.	RoleAssignmentArtifactProperties (required)

RoleAssignmentArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
principalIds	Array of user or group identities in Azure Active Directory. The roleDefinition will apply to these identity.	any (required)
resourceGroup	RoleAssignment will be scope to this resourceGroup, if left empty, it would scope to the subscription.	string
roleDefinitionId	Azure resource ID of the RoleDefinition.	string (required)

TemplateArtifact

Name	Description	Value
kind	Specifies the kind of Blueprint artifact.	'template' (required)
properties	Properties for template artifact	TemplateArtifactProperties (required)

TemplateArtifactProperties

Name	Description	Value
dependsOn	Artifacts which need to be deployed before the specified artifact.	string[]
description	Multi-line explain this resource.	string Constraints: Max length =
displayName	One-liner string explain this resource.	string Constraints: Max length =
parameters	Template parameter values.	ParameterValueCollection (required)
resourceGroup	If applicable, the name of the resource group placeholder to which the template will be deployed.	string
template	The Azure Resource Manager template body.	any (required)