Published Artifacts - List

Servizio:: Blueprints

Versione API:: 2018-11-01-preview

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 di progetto pubblicata recuperata.
Other Status Codes	CloudError	Risposta di errore di Blueprints.

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

HTTP

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

Codice di stato:: 200

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

HTTP

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

Codice di stato:: 200

{
  "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 sull'errore di gestione delle risorse.
ErrorResponse	Risposta errore
keyVaultReference	Specifica il collegamento a un insieme di credenziali delle chiavi.
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 di Key Vault.
TemplateArtifact	Artefatto del progetto che distribuisce un modello di Resource Manager.

ArtifactList

Object

Elenco degli artefatti del progetto.

Nome	Tipo	Descrizione
nextLink	string	Collegarsi alla pagina successiva dei risultati.
value	Artifact[]: PolicyAssignmentArtifact[] RoleAssignmentArtifact[] TemplateArtifact[]	Elenco degli artefatti del progetto.

CloudError

Object

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta errore Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Object

Risposta 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

Object

Specifica il collegamento a un insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
id	string	ID risorsa di Azure dell'insieme di credenziali delle chiavi.

ParameterValue

Object

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

Nome	Tipo	Descrizione
reference	SecretValueReference	Valore del parametro come tipo riferimento.
value	object	Valore del parametro. Qualsiasi valore JSON valido è consentito, inclusi oggetti, matrici, stringhe, numeri e valori booleani.

PolicyAssignmentArtifact

Object

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 della risorsa.
properties.dependsOn	string[]	Artefatti che devono essere distribuiti prima dell'artefatto specificato.
properties.description	string maxLength: 500	Spiegare in più righe questa risorsa.
properties.displayName	string maxLength: 256	La stringa di una riga 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 verranno assegnati i criteri.
type	string	Tipo di questa risorsa.

RoleAssignmentArtifact

Object

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 della risorsa.
properties.dependsOn	string[]	Artefatti che devono essere distribuiti prima dell'artefatto specificato.
properties.description	string maxLength: 500	Spiegare in più righe questa risorsa.
properties.displayName	string maxLength: 256	La stringa di una riga spiega questa risorsa.
properties.principalIds		Matrice di identità di utenti o gruppi in Azure Active Directory. RoleDefinition si applicherà a ogni identità.
properties.resourceGroup	string	RoleAssignment sarà l'ambito di questo resourceGroup. Se vuoto, l'ambito è la sottoscrizione.
properties.roleDefinitionId	string	ID risorsa di Azure di RoleDefinition.
type	string	Tipo di questa risorsa.

SecretValueReference

Object

Riferimento a un segreto di Key Vault.

Nome	Tipo	Descrizione
keyVault	keyVaultReference	Specifica il riferimento a un determinato insieme di credenziali delle chiavi 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

Object

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 della risorsa.
properties.dependsOn	string[]	Artefatti che devono essere distribuiti prima dell'artefatto specificato.
properties.description	string maxLength: 500	Spiegare in più righe questa risorsa.
properties.displayName	string maxLength: 256	La stringa di una riga spiega questa risorsa.
properties.parameters	<string, ParameterValue>	Valori dei parametri dell'artefatto del progetto modello di Resource Manager.
properties.resourceGroup	string	Se applicabile, il nome del segnaposto del gruppo di risorse in cui verrà distribuito l'artefatto del progetto modello di Resource Manager.
properties.template	object	Corpo dell'artefatto del progetto modello di Resource Manager.
type	string	Tipo di questa risorsa.

Condividi tramite

Published Artifacts - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

MG-ArtifactList

Esempio di richiesta

Risposta di esempio

Sub-ArtifactList

Esempio di richiesta

Risposta di esempio

Definizioni

ArtifactList

CloudError

ErrorAdditionalInfo

ErrorResponse

keyVaultReference

ParameterValue

PolicyAssignmentArtifact

RoleAssignmentArtifact

SecretValueReference

TemplateArtifact