Udostępnij za pośrednictwem


Published Artifacts - List

Wyświetl listę 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

Nazwa W Wymagane Typ Opis
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

Nazwa Typ Opis
200 OK

ArtifactList

OK — pobrane artefakty wersji opublikowanej definicji strategii.

Other Status Codes

CloudError

Odpowiedź na błędy strategii.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

MG-ArtifactList
Sub-ArtifactList

MG-ArtifactList

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Nazwa Opis
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ść dla określonego parametru. Może to być wartość "value" lub "reference", ale nie oba te elementy.

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.

Nazwa Typ Opis
nextLink

string

Link do następnej strony wyników.

value Artifact[]:

Lista artefaktów strategii.

CloudError

Nazwa Typ Opis
error

ErrorResponse

Odpowiedź na błąd
Typowa odpowiedź na błąd 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 oData).

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorResponse[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

keyVaultReference

Określa link do Key Vault.

Nazwa Typ Opis
id

string

Identyfikator zasobu platformy Azure Key Vault.

ParameterValue

Wartość dla określonego parametru. Może to być wartość "value" lub "reference", ale nie oba te elementy.

Nazwa Typ Opis
reference

SecretValueReference

Wartość parametru jako typ odwołania.

value

object

Wartość parametru. Każda prawidłowa wartość JSON jest dozwolona, w tym obiekty, tablice, ciągi, liczby i wartości logiczne.

PolicyAssignmentArtifact

Artefakt strategii, który stosuje przypisanie zasad.

Nazwa Typ Opis
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[]

Artefakty, 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

<string,  ParameterValue>

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.

Nazwa Typ Opis
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[]

Artefakty, 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 usłudze Azure Active Directory. Funkcja roleDefinition 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 roliDefinition.

type

string

Typ tego zasobu.

SecretValueReference

Odwołanie do wpisu tajnego Key Vault.

Nazwa Typ Opis
keyVault

keyVaultReference

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

secretName

string

Nazwa wpisu tajnego.

secretVersion

string

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

TemplateArtifact

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

Nazwa Typ Opis
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[]

Artefakty, 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

<string,  ParameterValue>

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

properties.resourceGroup

string

Jeśli ma to zastosowanie, nazwa symbolu zastępczego 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.