Published Artifacts - List

Wyświetlanie listy artefaktów dla wersji opublikowanej definicji strategii.

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

Parametry identyfikatora URI

Name In Required Type Description
blueprintName
path True
  • string

Nazwa definicji strategii.

resourceScope
path True
  • string

Zakres zasobu. Prawidłowe zakresy to: grupa zarządzania (format: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), subskrypcja (format: "/subscriptions/{subscriptionId}").

versionId
path True
  • string

Wersja opublikowanej definicji strategii.

api-version
query True
  • string

Wersja interfejsu API klienta.

Odpowiedzi

Name Type Description
200 OK

OK — pobrane artefakty wersji opublikowanej definicji strategii.

Other Status Codes

Odpowiedź na błąd strategii.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

ArtifactList

Lista artefaktów strategii.

CloudError
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorResponse

Odpowiedź na błąd

keyVaultReference

Określa link do Key Vault.

ParameterValue

Wartość określonego parametru. Może to być wartość lub odwołanie, ale nie oba.

PolicyAssignmentArtifact

Artefakt strategii, który stosuje przypisanie zasad.

RoleAssignmentArtifact

Artefakt strategii, który stosuje przypisanie roli.

SecretValueReference

Odwołanie do wpisu tajnego Key Vault.

TemplateArtifact

Artefakt strategii, który wdraża szablon Resource Manager.

ArtifactList

Lista artefaktów strategii.

Name Type Description
nextLink
  • string

Łącze do następnej strony wyników.

value Artifact[]:

Lista artefaktów strategii.

CloudError

Name Type Description
error

Odpowiedź na błąd
Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Name Type Description
info
  • object

Dodatkowe informacje.

type
  • string

Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Name Type Description
additionalInfo

Dodatkowe informacje o błędzie.

code
  • string

Kod błędu.

details

Szczegóły błędu.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy błędu.

keyVaultReference

Określa link do Key Vault.

Name Type Description
id
  • string

Identyfikator zasobu platformy Azure Key Vault.

ParameterValue

Wartość określonego parametru. Może to być wartość lub odwołanie, ale nie oba.

Name Type Description
reference

Wartość parametru jako typ odwołania.

value
  • object

Wartość parametru. Dozwolona jest dowolna prawidłowa wartość JSON, w tym obiekty, tablice, ciągi, liczby i wartości logiczne.

PolicyAssignmentArtifact

Artefakt strategii, który stosuje przypisanie zasad.

Name Type Description
id
  • string

Identyfikator ciągu używany do lokalizowania dowolnego zasobu na platformie Azure.

kind string:
  • policyAssignment

Określa rodzaj artefaktu strategii.

name
  • string

Nazwa tego zasobu.

properties.dependsOn
  • string[]

Artifacts, które należy wdrożyć przed określonym artefaktem.

properties.description
  • string

Wiele wierszy wyjaśnia ten zasób.

properties.displayName
  • string

Jeden ciąg liniowy wyjaśnia ten zasób.

properties.parameters

Wartości parametrów definicji zasad.

properties.policyDefinitionId
  • string

Identyfikator zasobu platformy Azure definicji zasad.

properties.resourceGroup
  • string

Nazwa symbolu zastępczego grupy zasobów, do którego zostaną przypisane zasady.

type
  • string

Typ tego zasobu.

RoleAssignmentArtifact

Artefakt strategii, który stosuje przypisanie roli.

Name Type Description
id
  • string

Identyfikator ciągu używany do lokalizowania dowolnego zasobu na platformie Azure.

kind string:
  • roleAssignment

Określa rodzaj artefaktu strategii.

name
  • string

Nazwa tego zasobu.

properties.dependsOn
  • string[]

Artifacts, które należy wdrożyć przed określonym artefaktem.

properties.description
  • string

Wiele wierszy wyjaśnia ten zasób.

properties.displayName
  • string

Jeden ciąg liniowy wyjaśnia ten zasób.

properties.principalIds

Tablica tożsamości użytkowników lub grup w Azure Active Directory. Definicja roli będzie stosowana do każdej tożsamości.

properties.resourceGroup
  • string

RoleAssignment będzie zakresem dla tej grupy zasobów. Jeśli jest ona pusta, zakresy są ograniczone do subskrypcji.

properties.roleDefinitionId
  • string

Identyfikator zasobu platformy Azure elementu RoleDefinition.

type
  • string

Typ tego zasobu.

SecretValueReference

Odwołanie do wpisu tajnego Key Vault.

Name Type Description
keyVault

Określa odwołanie do danej usługi Azure Key Vault.

secretName
  • string

Nazwa wpisu tajnego.

secretVersion
  • string

Wersja wpisu tajnego do użycia. Jeśli pole pozostanie puste, zostanie użyta najnowsza wersja wpisu tajnego.

TemplateArtifact

Artefakt strategii, który wdraża szablon Resource Manager.

Name Type Description
id
  • string

Identyfikator ciągu używany do lokalizowania dowolnego zasobu na platformie Azure.

kind string:
  • template

Określa rodzaj artefaktu strategii.

name
  • string

Nazwa tego zasobu.

properties.dependsOn
  • string[]

Artifacts, które należy wdrożyć przed określonym artefaktem.

properties.description
  • string

Wiele wierszy wyjaśnia ten zasób.

properties.displayName
  • string

Jeden ciąg liniowy wyjaśnia ten zasób.

properties.parameters

Resource Manager wartości parametrów artefaktu strategii szablonu.

properties.resourceGroup
  • string

Jeśli ma to zastosowanie, symbol zastępczy grupy zasobów, do którego zostanie wdrożony artefakt strategii szablonu Resource Manager.

properties.template
  • object

Treść artefaktu strategii szablonu Resource Manager.

type
  • string

Typ tego zasobu.