Megosztás a következőn keresztül:


Published Artifacts - List

A közzétett tervdefiníciók egy verziójának összetevőinek listázása.

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

URI-paraméterek

Name In Kötelező Típus Description
blueprintName
path True

string

A tervdefiníció neve.

resourceScope
path True

string

Az erőforrás hatóköre. Érvényes hatókörök: felügyeleti csoport (formátum: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), előfizetés (formátum: '/subscriptions/{subscriptionId}').

versionId
path True

string

A közzétett tervdefiníció verziója.

api-version
query True

string

Ügyfél API-verziója.

Válaszok

Name Típus Description
200 OK

ArtifactList

OK – a lekért közzétett tervdefiníció egy verziójának összetevői.

Other Status Codes

CloudError

Tervekkel kapcsolatos hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

MG-ArtifactList
Sub-ArtifactList

MG-ArtifactList

Mintakérelem

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

Mintaválasz

{
  "value": [
    {
      "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/versions/V2/artifacts/ownerAssignment",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "ownerAssignment"
    },
    {
      "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/versions/V2/artifacts/costCenterPolicy",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "costCenterPolicy"
    },
    {
      "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/versions/V2/artifacts/storageTemplate",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "storageTemplate"
    }
  ]
}

Sub-ArtifactList

Mintakérelem

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

Mintaválasz

{
  "value": [
    {
      "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/versions/V2/artifacts/ownerAssignment",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "ownerAssignment"
    },
    {
      "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/versions/V2/artifacts/costCenterPolicy",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "costCenterPolicy"
    },
    {
      "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/versions/V2/artifacts/storageTemplate",
      "type": "Microsoft.Blueprint/blueprints/versions/artifacts",
      "name": "storageTemplate"
    }
  ]
}

Definíciók

Name Description
ArtifactList

Tervösszetevők listája.

CloudError
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorResponse

Hibaválasz

keyVaultReference

Megadja a Key Vault mutató hivatkozást.

ParameterValue

A megadott paraméter értéke. Lehet "érték" vagy "hivatkozás", de nem mindkettő.

PolicyAssignmentArtifact

Tervösszetevő, amely szabályzat-hozzárendelést alkalmaz.

RoleAssignmentArtifact

A szerepkör-hozzárendelést alkalmazó tervösszetevő.

SecretValueReference

Hivatkozás egy Key Vault titkos kódra.

TemplateArtifact

Tervösszetevő, amely Resource Manager sablont helyez üzembe.

ArtifactList

Tervösszetevők listája.

Name Típus Description
nextLink

string

Hivatkozás az eredmények következő oldalára.

value Artifact[]:

Tervösszetevők listája.

CloudError

Name Típus Description
error

ErrorResponse

Hibaválasz
Az összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorResponse

Hibaválasz

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorResponse[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

keyVaultReference

Megadja a Key Vault mutató hivatkozást.

Name Típus Description
id

string

A Key Vault Azure-erőforrás-azonosítója.

ParameterValue

A megadott paraméter értéke. Lehet "érték" vagy "hivatkozás", de nem mindkettő.

Name Típus Description
reference

SecretValueReference

Paraméterérték referenciatípusként.

value

object

Paraméter értéke. Bármely érvényes JSON-érték megengedett, beleértve az objektumokat, tömböket, sztringeket, számokat és logikai értékeket.

PolicyAssignmentArtifact

Tervösszetevő, amely szabályzat-hozzárendelést alkalmaz.

Name Típus Description
id

string

Az Azure-beli erőforrások megkereséséhez használt karakterlánc-azonosító.

kind string:

policyAssignment

Meghatározza a tervösszetevő fajtáját.

name

string

Az erőforrás neve.

properties.dependsOn

string[]

Azokat az összetevőket, amelyeket a megadott összetevő előtt kell üzembe helyezni.

properties.description

string

Ez az erőforrás többsoros magyarázata.

properties.displayName

string

Az egysoros sztring ismerteti ezt az erőforrást.

properties.parameters

<string,  ParameterValue>

A szabályzatdefiníció paraméterértékei.

properties.policyDefinitionId

string

A szabályzatdefiníció Azure-erőforrás-azonosítója.

properties.resourceGroup

string

Annak az erőforráscsoport-helyőrzőnek a neve, amelyhez a szabályzat hozzá lesz rendelve.

type

string

Az erőforrás típusa.

RoleAssignmentArtifact

A szerepkör-hozzárendelést alkalmazó tervösszetevő.

Name Típus Description
id

string

Az Azure-beli erőforrások megkereséséhez használt karakterlánc-azonosító.

kind string:

roleAssignment

Meghatározza a tervösszetevő fajtáját.

name

string

Az erőforrás neve.

properties.dependsOn

string[]

Azokat az összetevőket, amelyeket a megadott összetevő előtt kell üzembe helyezni.

properties.description

string

Ez az erőforrás többsoros magyarázata.

properties.displayName

string

Az egysoros sztring ismerteti ezt az erőforrást.

properties.principalIds

Felhasználói vagy csoportidentitások tömbje az Azure Active Directoryban. A roleDefinition minden identitásra érvényes lesz.

properties.resourceGroup

string

A RoleAssignment az erőforrásCsoport hatóköre lesz. Ha üres, akkor az előfizetésre terjed ki.

properties.roleDefinitionId

string

A RoleDefinition Azure-erőforrás-azonosítója.

type

string

Az erőforrás típusa.

SecretValueReference

Hivatkozás egy Key Vault titkos kódra.

Name Típus Description
keyVault

keyVaultReference

Egy adott Azure-Key Vault való hivatkozás megadása.

secretName

string

A titkos kód neve.

secretVersion

string

A használni kívánt titkos kód verziója. Ha üresen hagyja, a rendszer a titkos kód legújabb verzióját használja.

TemplateArtifact

Tervösszetevő, amely Resource Manager sablont helyez üzembe.

Name Típus Description
id

string

Az Azure-beli erőforrások megkereséséhez használt karakterlánc-azonosító.

kind string:

template

Meghatározza a tervösszetevő fajtáját.

name

string

Az erőforrás neve.

properties.dependsOn

string[]

Azokat az összetevőket, amelyeket a megadott összetevő előtt kell üzembe helyezni.

properties.description

string

Ez az erőforrás többsoros magyarázata.

properties.displayName

string

Az egysoros sztring ismerteti ezt az erőforrást.

properties.parameters

<string,  ParameterValue>

Resource Manager sablonterv-összetevő paraméterértékeket.

properties.resourceGroup

string

Adott esetben annak az erőforráscsoport-helyőrzőnek a neve, amelyre a Resource Manager sablon tervösszetevője üzembe lesz helyezve.

properties.template

object

A Resource Manager sablon tervösszetevőjének törzse.

type

string

Az erőforrás típusa.