Delen via


Artifacts - Create Or Update

Blauwdrukartefact maken of bijwerken.

PUT https://management.azure.com/{resourceScope}/providers/Microsoft.Blueprint/blueprints/{blueprintName}/artifacts/{artifactName}?api-version=2018-11-01-preview

URI-parameters

Name In Vereist Type Description
artifactName
path True

string

Naam van het blauwdrukartefact.

blueprintName
path True

string

Naam van de blauwdrukdefinitie.

resourceScope
path True

string

Het bereik van de resource. Geldige bereiken zijn: beheergroep (indeling: /providers/Microsoft.Management/managementGroups/{managementGroup}), abonnement (indeling: '/subscriptions/{subscriptionId}').

api-version
query True

string

Client-API-versie.

Aanvraagbody

De aanvraagtekst kan een van de volgende zijn:

Name Description
PolicyAssignmentArtifact

Blauwdrukartefact dat een beleidstoewijzing toepast.

RoleAssignmentArtifact

Blauwdrukartefact dat een roltoewijzing toepast.

TemplateArtifact

Blauwdrukartefact waarmee een Resource Manager-sjabloon wordt geïmplementeerd.

PolicyAssignmentArtifact

Blauwdrukartefact dat een beleidstoewijzing toepast.

Name Vereist Type Description
kind True string:

policyAssignment

Hiermee geeft u het soort blauwdrukartefact op.

properties.parameters True

<string,  ParameterValue>

Parameterwaarden voor de beleidsdefinitie.

properties.policyDefinitionId True

string

Azure-resource-id van de beleidsdefinitie.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.resourceGroup

string

Naam van de tijdelijke aanduiding voor de resourcegroep waaraan het beleid wordt toegewezen.

RoleAssignmentArtifact

Blauwdrukartefact dat een roltoewijzing toepast.

Name Vereist Type Description
kind True string:

roleAssignment

Hiermee geeft u het soort blauwdrukartefact op.

properties.principalIds True

Matrix van gebruikers- of groepsidentiteiten in Azure Active Directory. De roleDefinition is van toepassing op elke identiteit.

properties.roleDefinitionId True

string

Azure-resource-id van de RoleDefinition.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.resourceGroup

string

RoleAssignment is het bereik van deze resourceGroup. Als deze leeg is, wordt het bereik van het abonnement bereikt.

TemplateArtifact

Blauwdrukartefact waarmee een Resource Manager-sjabloon wordt geïmplementeerd.

Name Vereist Type Description
kind True string:

template

Hiermee geeft u het soort blauwdrukartefact op.

properties.parameters True

<string,  ParameterValue>

Parameterwaarden voor blauwdrukartefacten in Resource Manager-sjabloon.

properties.template True

object

De hoofdtekst van het blauwdrukartefact van de Resource Manager-sjabloon.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.resourceGroup

string

Indien van toepassing, wordt de naam van de tijdelijke aanduiding voor de resourcegroep waarnaar het blauwdrukartefact van de Resource Manager-sjabloon wordt geïmplementeerd.

Antwoorden

Name Type Description
201 Created Artifact:

Gemaakt: blauwdrukartefact gemaakt/bijgewerkt.

Other Status Codes

CloudError

Antwoord op blauwdrukkenfout.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

MG-ARMTemplateArtifact
MG-PolicyAssignmentArtifact
MG-RoleAssignmentArtifact
Sub-ARMTemplateArtifact
Sub-PolicyAssignmentArtifact
Sub-RoleAssignmentArtifact

MG-ARMTemplateArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/storageTemplate?api-version=2018-11-01-preview

{
  "kind": "template",
  "properties": {
    "template": {
      "contentVersion": "1.0.0.0",
      "parameters": {
        "storageAccountType": {
          "type": "string",
          "defaultValue": "Standard_LRS",
          "allowedValues": [
            "Standard_LRS",
            "Standard_GRS",
            "Standard_ZRS",
            "Premium_LRS"
          ],
          "metadata": {
            "description": "Storage Account type"
          }
        }
      },
      "variables": {
        "storageAccountName": "[concat(uniquestring(resourceGroup().id), 'standardsa')]"
      },
      "resources": [
        {
          "type": "Microsoft.Storage/storageAccounts",
          "name": "[variables('storageAccountName')]",
          "apiVersion": "2016-01-01",
          "location": "[resourceGroup().location]",
          "sku": {
            "name": "[parameters('storageAccountType')]"
          },
          "kind": "Storage",
          "properties": {}
        }
      ],
      "outputs": {
        "storageAccountName": {
          "type": "string",
          "value": "[variables('storageAccountName')]"
        }
      }
    },
    "resourceGroup": "storageRG",
    "parameters": {
      "storageAccountType": {
        "value": "[parameters('storageAccountType')]"
      }
    }
  }
}

Voorbeeldrespons

{
  "properties": {
    "template": {
      "contentVersion": "1.0.0.0",
      "parameters": {
        "storageAccountType": {
          "type": "string",
          "defaultValue": "Standard_LRS",
          "allowedValues": [
            "Standard_LRS",
            "Standard_GRS",
            "Standard_ZRS",
            "Premium_LRS"
          ],
          "metadata": {
            "description": "Storage Account type"
          }
        }
      },
      "variables": {
        "storageAccountName": "[concat(uniquestring(resourceGroup().id), 'standardsa')]"
      },
      "resources": [
        {
          "type": "Microsoft.Storage/storageAccounts",
          "name": "[variables('storageAccountName')]",
          "apiVersion": "2016-01-01",
          "location": "[resourceGroup().location]",
          "sku": {
            "name": "[parameters('storageAccountType')]"
          },
          "kind": "Storage",
          "properties": {}
        }
      ],
      "outputs": {
        "storageAccountName": {
          "type": "string",
          "value": "[variables('storageAccountName')]"
        }
      }
    },
    "resourceGroup": "storageRG",
    "parameters": {
      "storageAccountType": {
        "value": "[parameters('storageAccountType')]"
      }
    }
  },
  "kind": "template",
  "id": "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/storageTemplate",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "storageTemplate"
}

MG-PolicyAssignmentArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/costCenterPolicy?api-version=2018-11-01-preview

{
  "properties": {
    "displayName": "force costCenter tag on all resources",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/1e30110a-5ceb-460c-a204-c1c3969c6d62",
    "parameters": {
      "tagName": {
        "value": "costCenter"
      },
      "tagValue": {
        "value": "[parameter('costCenter')]"
      }
    }
  },
  "kind": "policyAssignment"
}

Voorbeeldrespons

{
  "properties": {
    "displayName": "force costCenter tag on all resources",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/1e30110a-5ceb-460c-a204-c1c3969c6d62",
    "parameters": {
      "tagName": {
        "value": "costCenter"
      },
      "tagValue": {
        "value": "[parameter('costCenter')]"
      }
    }
  },
  "kind": "policyAssignment",
  "id": "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/costCenterPolicy",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "costCenterPolicy"
}

MG-RoleAssignmentArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/ownerAssignment?api-version=2018-11-01-preview

{
  "properties": {
    "displayName": "enforce owners of given subscription",
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7",
    "principalIds": "[parameters('owners')]"
  },
  "kind": "roleAssignment"
}

Voorbeeldrespons

{
  "properties": {
    "displayName": "enforce owners of given subscription",
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7",
    "principalIds": "[parameters('owners')]"
  },
  "kind": "roleAssignment",
  "id": "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/ownerAssignment",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "ownerAssignment"
}

Sub-ARMTemplateArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/storageTemplate?api-version=2018-11-01-preview

{
  "kind": "template",
  "properties": {
    "template": {
      "contentVersion": "1.0.0.0",
      "parameters": {
        "storageAccountType": {
          "type": "string",
          "defaultValue": "Standard_LRS",
          "allowedValues": [
            "Standard_LRS",
            "Standard_GRS",
            "Standard_ZRS",
            "Premium_LRS"
          ],
          "metadata": {
            "description": "Storage Account type"
          }
        }
      },
      "variables": {
        "storageAccountName": "[concat(uniquestring(resourceGroup().id), 'standardsa')]"
      },
      "resources": [
        {
          "type": "Microsoft.Storage/storageAccounts",
          "name": "[variables('storageAccountName')]",
          "apiVersion": "2016-01-01",
          "location": "[resourceGroup().location]",
          "sku": {
            "name": "[parameters('storageAccountType')]"
          },
          "kind": "Storage",
          "properties": {}
        }
      ],
      "outputs": {
        "storageAccountName": {
          "type": "string",
          "value": "[variables('storageAccountName')]"
        }
      }
    },
    "resourceGroup": "storageRG",
    "parameters": {
      "storageAccountType": {
        "value": "[parameters('storageAccountType')]"
      }
    }
  }
}

Voorbeeldrespons

{
  "properties": {
    "template": {
      "contentVersion": "1.0.0.0",
      "parameters": {
        "storageAccountType": {
          "type": "string",
          "defaultValue": "Standard_LRS",
          "allowedValues": [
            "Standard_LRS",
            "Standard_GRS",
            "Standard_ZRS",
            "Premium_LRS"
          ],
          "metadata": {
            "description": "Storage Account type"
          }
        }
      },
      "variables": {
        "storageAccountName": "[concat(uniquestring(resourceGroup().id), 'standardsa')]"
      },
      "resources": [
        {
          "type": "Microsoft.Storage/storageAccounts",
          "name": "[variables('storageAccountName')]",
          "apiVersion": "2016-01-01",
          "location": "[resourceGroup().location]",
          "sku": {
            "name": "[parameters('storageAccountType')]"
          },
          "kind": "Storage",
          "properties": {}
        }
      ],
      "outputs": {
        "storageAccountName": {
          "type": "string",
          "value": "[variables('storageAccountName')]"
        }
      }
    },
    "resourceGroup": "storageRG",
    "parameters": {
      "storageAccountType": {
        "value": "[parameters('storageAccountType')]"
      }
    }
  },
  "kind": "template",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/storageTemplate",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "storageTemplate"
}

Sub-PolicyAssignmentArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/costCenterPolicy?api-version=2018-11-01-preview

{
  "properties": {
    "displayName": "force costCenter tag on all resources",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/1e30110a-5ceb-460c-a204-c1c3969c6d62",
    "parameters": {
      "tagName": {
        "value": "costCenter"
      },
      "tagValue": {
        "value": "[parameter('costCenter')]"
      }
    }
  },
  "kind": "policyAssignment"
}

Voorbeeldrespons

{
  "properties": {
    "displayName": "force costCenter tag on all resources",
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/1e30110a-5ceb-460c-a204-c1c3969c6d62",
    "parameters": {
      "tagName": {
        "value": "costCenter"
      },
      "tagValue": {
        "value": "[parameter('costCenter')]"
      }
    }
  },
  "kind": "policyAssignment",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/costCenterPolicy",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "costCenterPolicy"
}

Sub-RoleAssignmentArtifact

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/ownerAssignment?api-version=2018-11-01-preview

{
  "properties": {
    "displayName": "enforce owners of given subscription",
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7",
    "principalIds": "[parameters('owners')]"
  },
  "kind": "roleAssignment"
}

Voorbeeldrespons

{
  "properties": {
    "displayName": "enforce owners of given subscription",
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7",
    "principalIds": "[parameters('owners')]"
  },
  "kind": "roleAssignment",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Blueprint/blueprints/simpleBlueprint/artifacts/ownerAssignment",
  "type": "Microsoft.Blueprint/blueprints/artifacts",
  "name": "ownerAssignment"
}

Definities

Name Description
CloudError
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorResponse

Foutreactie

keyVaultReference

Hiermee geeft u de koppeling naar een Sleutelkluis.

ParameterValue

Waarde voor de opgegeven parameter. Kan 'value' of 'reference' zijn, maar niet beide.

PolicyAssignmentArtifact

Blauwdrukartefact dat een beleidstoewijzing toepast.

RoleAssignmentArtifact

Blauwdrukartefact dat een roltoewijzing toepast.

SecretValueReference

Verwijzing naar een Key Vault-geheim.

TemplateArtifact

Blauwdrukartefact waarmee een Resource Manager-sjabloon wordt geïmplementeerd.

CloudError

Name Type Description
error

ErrorResponse

Foutreactie
Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactie-indeling.)

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorResponse

Foutreactie

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorResponse[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

keyVaultReference

Hiermee geeft u de koppeling naar een Sleutelkluis.

Name Type Description
id

string

Azure-resource-id van de Key Vault.

ParameterValue

Waarde voor de opgegeven parameter. Kan 'value' of 'reference' zijn, maar niet beide.

Name Type Description
reference

SecretValueReference

Parameterwaarde als referentietype.

value

object

Parameterwaarde. Elke geldige JSON-waarde is toegestaan, waaronder objecten, matrices, tekenreeksen, getallen en booleaanse waarden.

PolicyAssignmentArtifact

Blauwdrukartefact dat een beleidstoewijzing toepast.

Name Type Description
id

string

Tekenreeks-id die wordt gebruikt om een resource in Azure te vinden.

kind string:

policyAssignment

Hiermee geeft u het soort blauwdrukartefact op.

name

string

Naam van deze resource.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.parameters

<string,  ParameterValue>

Parameterwaarden voor de beleidsdefinitie.

properties.policyDefinitionId

string

Azure-resource-id van de beleidsdefinitie.

properties.resourceGroup

string

Naam van de tijdelijke aanduiding voor de resourcegroep waaraan het beleid wordt toegewezen.

type

string

Type van deze resource.

RoleAssignmentArtifact

Blauwdrukartefact dat een roltoewijzing toepast.

Name Type Description
id

string

Tekenreeks-id die wordt gebruikt om een resource in Azure te vinden.

kind string:

roleAssignment

Hiermee geeft u het soort blauwdrukartefact op.

name

string

Naam van deze resource.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.principalIds

Matrix van gebruikers- of groepsidentiteiten in Azure Active Directory. De roleDefinition is van toepassing op elke identiteit.

properties.resourceGroup

string

RoleAssignment is het bereik van deze resourceGroup. Als deze leeg is, wordt het bereik van het abonnement bereikt.

properties.roleDefinitionId

string

Azure-resource-id van de RoleDefinition.

type

string

Type van deze resource.

SecretValueReference

Verwijzing naar een Key Vault-geheim.

Name Type Description
keyVault

keyVaultReference

Hiermee geeft u de verwijzing naar een bepaalde Azure Key Vault.

secretName

string

Naam van het geheim.

secretVersion

string

De versie van het geheim die moet worden gebruikt. Als u niets opgeeft, wordt de meest recente versie van het geheim gebruikt.

TemplateArtifact

Blauwdrukartefact waarmee een Resource Manager-sjabloon wordt geïmplementeerd.

Name Type Description
id

string

Tekenreeks-id die wordt gebruikt om een resource in Azure te vinden.

kind string:

template

Hiermee geeft u het soort blauwdrukartefact op.

name

string

Naam van deze resource.

properties.dependsOn

string[]

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

properties.description

string

maxLength: 500

In meerdere regels wordt deze resource uitgelegd.

properties.displayName

string

maxLength: 256

In een-linertekenreeks wordt deze resource uitgelegd.

properties.parameters

<string,  ParameterValue>

Parameterwaarden voor blauwdrukartefacten in Resource Manager-sjabloon.

properties.resourceGroup

string

Indien van toepassing, wordt de naam van de tijdelijke aanduiding voor de resourcegroep waarnaar het blauwdrukartefact van de Resource Manager-sjabloon wordt geïmplementeerd.

properties.template

object

De hoofdtekst van het blauwdrukartefact van de Resource Manager-sjabloon.

type

string

Type van deze resource.