Published Artifacts - List

Listar artefactos para uma versão de uma definição de planta publicada.

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

Parâmetros do URI

Name In Required Type Description
blueprintName
path True
  • string

Nome da definição da planta.

resourceScope
path True
  • string

O âmbito do recurso. Os âmbitos válidos são: grupo de gestão (formato: '/fornecedores/Microsoft.Management/managementGroup/{managementGroup}'), subscrição (formato: '/subscrições/{subscriçãoId}').

versionId
path True
  • string

Versão da definição de planta publicada.

api-version
query True
  • string

Versão API do cliente.

Respostas

Name Type Description
200 OK

Artefactos de uma versão da definição de planta publicada recuperada.

Other Status Codes

Resposta de erro da planta.

Segurança

azure_auth

Flow de Azure Ative Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

MG-ArtifactList
Sub-ArtifactList

MG-ArtifactList

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

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

Definições

ArtifactList

Lista de artefactos de plantas.

CloudError
ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

ErrorResponse

Resposta a Erros

keyVaultReference

Especifica a ligação a um Key Vault.

ParameterValue

Valor para o parâmetro especificado. Pode ser 'valor' ou 'referência', mas não ambos.

PolicyAssignmentArtifact

Artefacto de planta que aplica uma atribuição de política.

RoleAssignmentArtifact

Artefacto de planta que aplica uma atribuição de papel.

SecretValueReference

Referência a um segredo Key Vault.

TemplateArtifact

Artefacto de planta que implementa um modelo de Resource Manager.

ArtifactList

Lista de artefactos de plantas.

Name Type Description
nextLink
  • string

Ligue para a próxima página de resultados.

value Artifact[]:

Lista de artefactos de plantas.

CloudError

Name Type Description
error

Resposta a Erros
Resposta de erro comum para todos os Azure Resource Manager APIs para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

Name Type Description
info
  • object

A informação adicional.

type
  • string

O tipo de informação adicional.

ErrorResponse

Resposta a Erros

Name Type Description
additionalInfo

A informação adicional do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O alvo do erro.

keyVaultReference

Especifica a ligação a um Key Vault.

Name Type Description
id
  • string

Identificação de recursos Azure do Key Vault.

ParameterValue

Valor para o parâmetro especificado. Pode ser 'valor' ou 'referência', mas não ambos.

Name Type Description
reference

Valor do parâmetro como tipo de referência.

value
  • object

Valor do parâmetro. Qualquer valor JSON válido é permitido incluindo objetos, matrizes, cordas, números e booleans.

PolicyAssignmentArtifact

Artefacto de planta que aplica uma atribuição de política.

Name Type Description
id
  • string

O String Id usado para localizar qualquer recurso no Azure.

kind string:
  • policyAssignment

Especifica o tipo de artefacto de planta.

name
  • string

Nome deste recurso.

properties.dependsOn
  • string[]

Artefactos que precisam de ser implantados antes do artefacto especificado.

properties.description
  • string

Multi-line explicar este recurso.

properties.displayName
  • string

Uma corda de um liner explica este recurso.

properties.parameters

Valores de parâmetro para a definição de política.

properties.policyDefinitionId
  • string

Identificação de recurso Azure da definição de política.

properties.resourceGroup
  • string

Nome do espaço reservado do grupo de recursos ao qual a apólice será atribuída.

type
  • string

Tipo deste recurso.

RoleAssignmentArtifact

Artefacto de planta que aplica uma atribuição de papel.

Name Type Description
id
  • string

O String Id usado para localizar qualquer recurso no Azure.

kind string:
  • roleAssignment

Especifica o tipo de artefacto de planta.

name
  • string

Nome deste recurso.

properties.dependsOn
  • string[]

Artefactos que precisam de ser implantados antes do artefacto especificado.

properties.description
  • string

Multi-line explicar este recurso.

properties.displayName
  • string

Uma corda de um liner explica este recurso.

properties.principalIds

Conjunto de identidades de utilizador ou grupo em Azure Ative Directory. O papelDefinition aplicar-se-á a cada identidade.

properties.resourceGroup
  • string

FunAsignment será o âmbito para este grupo de recursos. Se estiver vazio, aplica-se à subscrição.

properties.roleDefinitionId
  • string

ID de recurso Azure da RoleDefinition.

type
  • string

Tipo deste recurso.

SecretValueReference

Referência a um segredo Key Vault.

Name Type Description
keyVault

Especifica a referência a um dado Key Vault Azure.

secretName
  • string

O nome do segredo.

secretVersion
  • string

A versão do segredo para usar. Se deixada em branco, a versão mais recente do segredo é usada.

TemplateArtifact

Artefacto de planta que implementa um modelo de Resource Manager.

Name Type Description
id
  • string

O String Id usado para localizar qualquer recurso no Azure.

kind string:
  • template

Especifica o tipo de artefacto de planta.

name
  • string

Nome deste recurso.

properties.dependsOn
  • string[]

Artefactos que precisam de ser implantados antes do artefacto especificado.

properties.description
  • string

Multi-line explicar este recurso.

properties.displayName
  • string

Uma corda de um liner explica este recurso.

properties.parameters

Resource Manager valores do parâmetro do artefacto da planta do modelo.

properties.resourceGroup
  • string

Se aplicável, o nome do espaço reservado do grupo de recursos para o qual o artefacto de planta do modelo Resource Manager será implantado.

properties.template
  • object

O Resource Manager modelo modelo corpo de artefacto.

type
  • string

Tipo deste recurso.