Condividi tramite


Published Artifacts - List

Elencare gli artefatti per una versione di una definizione di progetto pubblicata.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
blueprintName
path True

string

Nome della definizione del progetto.

resourceScope
path True

string

Ambito della risorsa. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}').

versionId
path True

string

Versione della definizione del progetto pubblicata.

api-version
query True

string

Versione dell'API client.

Risposte

Nome Tipo Descrizione
200 OK

ArtifactList

OK : artefatti di una versione della definizione del progetto pubblicata recuperata.

Other Status Codes

CloudError

Risposta all'errore dei progetti.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

MG-ArtifactList
Sub-ArtifactList

MG-ArtifactList

Esempio di richiesta

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

Risposta di esempio

{
  "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

Esempio di richiesta

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

Risposta di esempio

{
  "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"
    }
  ]
}

Definizioni

Nome Descrizione
ArtifactList

Elenco degli artefatti del progetto.

CloudError
ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorResponse

Risposta di errore

keyVaultReference

Specifica il collegamento a un Key Vault.

ParameterValue

Valore per il parametro specificato. Può essere "value" o "reference", ma non entrambi.

PolicyAssignmentArtifact

Artefatto del progetto che applica un'assegnazione di criteri.

RoleAssignmentArtifact

Artefatto del progetto che applica un'assegnazione di ruolo.

SecretValueReference

Riferimento a un segreto Key Vault.

TemplateArtifact

Artefatto del progetto che distribuisce un modello di Resource Manager.

ArtifactList

Elenco degli artefatti del progetto.

Nome Tipo Descrizione
nextLink

string

Collegamento alla pagina successiva dei risultati.

value Artifact[]:

Elenco degli artefatti del progetto.

CloudError

Nome Tipo Descrizione
error

ErrorResponse

Risposta di errore
Risposta di errore comune per tutte le API di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorResponse[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

keyVaultReference

Specifica il collegamento a un Key Vault.

Nome Tipo Descrizione
id

string

ID risorsa di Azure del Key Vault.

ParameterValue

Valore per il parametro specificato. Può essere "value" o "reference", ma non entrambi.

Nome Tipo Descrizione
reference

SecretValueReference

Valore del parametro come tipo di riferimento.

value

object

Valore del parametro. Qualsiasi valore JSON valido è consentito, inclusi oggetti, matrici, stringhe, numeri e booleani.

PolicyAssignmentArtifact

Artefatto del progetto che applica un'assegnazione di criteri.

Nome Tipo Descrizione
id

string

ID stringa usato per individuare qualsiasi risorsa in Azure.

kind string:

policyAssignment

Specifica il tipo di artefatto del progetto.

name

string

Nome di questa risorsa.

properties.dependsOn

string[]

Elementi che devono essere distribuiti prima dell'artefatto specificato.

properties.description

string

Questa risorsa viene illustrata in più righe.

properties.displayName

string

Una stringa di linea spiega questa risorsa.

properties.parameters

<string,  ParameterValue>

Valori dei parametri per la definizione dei criteri.

properties.policyDefinitionId

string

ID risorsa di Azure della definizione dei criteri.

properties.resourceGroup

string

Nome del segnaposto del gruppo di risorse a cui verrà assegnato il criterio.

type

string

Tipo di questa risorsa.

RoleAssignmentArtifact

Artefatto del progetto che applica un'assegnazione di ruolo.

Nome Tipo Descrizione
id

string

ID stringa usato per individuare qualsiasi risorsa in Azure.

kind string:

roleAssignment

Specifica il tipo di artefatto del progetto.

name

string

Nome di questa risorsa.

properties.dependsOn

string[]

Elementi che devono essere distribuiti prima dell'artefatto specificato.

properties.description

string

Questa risorsa viene illustrata in più righe.

properties.displayName

string

Una stringa di linea spiega questa risorsa.

properties.principalIds

Matrice di identità utente o gruppo in Azure Active Directory. Il ruoloDefinition verrà applicato a ogni identità.

properties.resourceGroup

string

RoleAssignment sarà l'ambito di questo resourceGroup. Se vuoto, viene ambito della sottoscrizione.

properties.roleDefinitionId

string

ID risorsa di Azure del ruoloDefinition.

type

string

Tipo di questa risorsa.

SecretValueReference

Riferimento a un segreto Key Vault.

Nome Tipo Descrizione
keyVault

keyVaultReference

Specifica il riferimento a un determinato Key Vault di Azure.

secretName

string

Nome del segreto.

secretVersion

string

Versione del segreto da usare. Se lasciato vuoto, viene usata la versione più recente del segreto.

TemplateArtifact

Artefatto del progetto che distribuisce un modello di Resource Manager.

Nome Tipo Descrizione
id

string

ID stringa usato per individuare qualsiasi risorsa in Azure.

kind string:

template

Specifica il tipo di artefatto del progetto.

name

string

Nome di questa risorsa.

properties.dependsOn

string[]

Elementi che devono essere distribuiti prima dell'artefatto specificato.

properties.description

string

Questa risorsa viene illustrata in più righe.

properties.displayName

string

Una stringa di linea spiega questa risorsa.

properties.parameters

<string,  ParameterValue>

Resource Manager valori dei parametri del progetto modello.

properties.resourceGroup

string

Se applicabile, il nome del segnaposto del gruppo di risorse a cui verrà distribuito l'artefatto del progetto modello di Resource Manager.

properties.template

object

Corpo dell'artefatto modello Resource Manager.

type

string

Tipo di questa risorsa.