Deployments - What If At Management Group Scope
Vrátí změny, které provede nasazení v rozsahu skupiny pro správu.
POST https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
Název nasazení. Vzor regulárního výrazu: |
group
|
path | True |
string |
ID skupiny pro správu. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
location | True |
string |
Umístění pro uložení dat nasazení. |
properties | True |
Vlastnosti nasazení. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK – vrátí stav operace What-If. |
|
202 Accepted |
Přijato – vrátí adresu URL v hlavičce umístění pro dotaz na stav dlouhotrvající operace. Hlavičky
|
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Predict template changes at management group scope
Ukázkový požadavek
POST https://management.azure.com/providers/Microsoft.Management/managementGroups/myManagementGruop/providers/Microsoft.Resources/deployments/exampleDeploymentName/whatIf?api-version=2021-04-01
{
"location": "eastus",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Incremental"
}
}
Ukázková odpověď
{
"status": "Succeeded",
"properties": {
"changes": [
{
"resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
"changeType": "Modify",
"before": {
"apiVersion": "2019-06-01",
"id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
"type": "Microsoft.Authorization/policyAssignments",
"name": "myPolicyAssignment",
"location": "westus2",
"properties": {
"policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
"scope": "/subscriptions/00000000-0000-0000-0000-000000000001",
"enforcementMode": "Default"
}
},
"after": {
"resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
"changeType": "Modify",
"before": {
"apiVersion": "2019-06-01",
"id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
"type": "Microsoft.Authorization/policyAssignments",
"name": "myPolicyAssignment",
"location": "westus2",
"properties": {
"policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
"scope": "/subscriptions/00000000-0000-0000-0000-000000000001",
"enforcementMode": "DoNotEnforce"
}
},
"delta": [
{
"path": "properties.enforcementMode",
"propertyChangeType": "Modify",
"before": "Default",
"after": "DoNotEnforce"
}
]
}
},
{
"resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment2",
"changeType": "Create",
"after": {
"apiVersion": "2019-06-01",
"id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment2",
"type": "Microsoft.Authorization/policyAssignments",
"name": "myPolicyAssignment2",
"location": "westus2",
"properties": {
"policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
"scope": "/subscriptions/00000000-0000-0000-0000-000000000002",
"enforcementMode": "Default"
}
}
}
]
}
}
Location: /subscriptions/4d0ca63b-7939-4c9c-afbe-5fafae501724/operationresults/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
Definice
Name | Description |
---|---|
Change |
Typ změny, která se provede u prostředku při spuštění nasazení. |
Cloud |
Chybová odpověď pro žádost o správu prostředků. |
Debug |
Nastavení ladění |
Deployment |
Režim, který se používá k nasazení prostředků. Tato hodnota může být přírůstková nebo dokončená. V přírůstkovém režimu se prostředky nasadí bez odstranění existujících prostředků, které nejsou součástí šablony. V úplném režimu se prostředky nasadí a stávající prostředky ve skupině prostředků, které nejsou zahrnuté v šabloně, se odstraní. Při používání úplného režimu buďte opatrní, protože můžete neúmyslně odstranit prostředky. |
Deployment |
Vlastnosti citlivostní analýzy nasazení |
Deployment |
Nastavení operace nasazení What-If. |
Error |
Další informace o chybě správy prostředků |
Error |
Odpověď na chybu |
Expression |
Určuje, jestli se výrazy šablony vyhodnocují v rámci oboru nadřazené šablony nebo vnořené šablony. |
Expression |
Obor, který se má použít pro vyhodnocení parametrů, proměnných a funkcí ve vnořené šabloně. |
On |
Nasazení při chybovém chování. |
On |
Typ chování nasazení při chybě. Možné hodnoty jsou LastSuccessful a SpecificDeployment. |
Parameters |
Entita představující odkaz na parametry nasazení. |
Property |
Typ vlastnosti se změní. |
Scoped |
Parametry operace Citlivostní analýza nasazení |
Template |
Entita představující odkaz na šablonu |
What |
Informace o jedné změně prostředku predikované operací What-If. |
What |
Výsledek operace What-If. Obsahuje seznam predikovaných změn a odkaz URL pro získání další sady výsledků. |
What |
Predikovaná změna vlastnosti prostředku |
What |
Formát What-If výsledků |
ChangeType
Typ změny, která se provede u prostředku při spuštění nasazení.
Name | Typ | Description |
---|---|---|
Create |
string |
Prostředek neexistuje v aktuálním stavu, ale je v požadovaném stavu. Prostředek se vytvoří při spuštění nasazení. |
Delete |
string |
Prostředek existuje v aktuálním stavu a v požadovaném stavu chybí. Prostředek se odstraní při spuštění nasazení. |
Deploy |
string |
Prostředek existuje v aktuálním a požadovaném stavu a po spuštění nasazení se znovu nasadí. Vlastnosti prostředku se mohou nebo nemusí změnit. |
Ignore |
string |
Prostředek existuje v aktuálním stavu a v požadovaném stavu chybí. Při spuštění nasazení se prostředek nenasadí ani neupraví. |
Modify |
string |
Prostředek existuje v aktuálním a požadovaném stavu a po spuštění nasazení se znovu nasadí. Vlastnosti prostředku se změní. |
NoChange |
string |
Prostředek existuje v aktuálním a požadovaném stavu a po spuštění nasazení se znovu nasadí. Vlastnosti prostředku se nezmění. |
Unsupported |
string |
What-If prostředek nepodporuje. |
CloudError
Chybová odpověď pro žádost o správu prostředků.
Name | Typ | Description |
---|---|---|
error |
Odpověď na chybu |
DebugSetting
Nastavení ladění
Name | Typ | Description |
---|---|---|
detailLevel |
string |
Určuje typ informací, které se mají protokolovat pro ladění. Povolené hodnoty jsou none, requestContent, responseContent nebo obě hodnoty requestContent a responseContent oddělené čárkami. Výchozí hodnota je none. Při nastavování této hodnoty pečlivě zvažte typ informací, které předáváte během nasazení. Protokolováním informací o požadavku nebo odpovědi můžete potenciálně zpřístupnit citlivá data, která se načítají prostřednictvím operací nasazení. |
DeploymentMode
Režim, který se používá k nasazení prostředků. Tato hodnota může být přírůstková nebo dokončená. V přírůstkovém režimu se prostředky nasadí bez odstranění existujících prostředků, které nejsou součástí šablony. V úplném režimu se prostředky nasadí a stávající prostředky ve skupině prostředků, které nejsou zahrnuté v šabloně, se odstraní. Při používání úplného režimu buďte opatrní, protože můžete neúmyslně odstranit prostředky.
Name | Typ | Description |
---|---|---|
Complete |
string |
|
Incremental |
string |
DeploymentWhatIfProperties
Vlastnosti citlivostní analýzy nasazení
Name | Typ | Description |
---|---|---|
debugSetting |
Nastavení ladění nasazení. |
|
expressionEvaluationOptions |
Určuje, jestli se výrazy šablony vyhodnocují v rámci oboru nadřazené šablony nebo vnořené šablony. Platí jenom pro vnořené šablony. Pokud není zadán, je výchozí hodnota vnější. |
|
mode |
Režim, který se používá k nasazení prostředků. Tato hodnota může být přírůstková nebo dokončená. V přírůstkovém režimu se prostředky nasadí bez odstranění existujících prostředků, které nejsou součástí šablony. V úplném režimu se prostředky nasadí a stávající prostředky ve skupině prostředků, které nejsou zahrnuté v šabloně, se odstraní. Při používání úplného režimu buďte opatrní, protože můžete neúmyslně odstranit prostředky. |
|
onErrorDeployment |
Chování nasazení při chybě. |
|
parameters |
object |
Páry název a hodnota, které definují parametry nasazení šablony. Tento prvek použijete, když chcete zadat hodnoty parametrů přímo v požadavku místo propojení s existujícím souborem parametrů. Použijte buď vlastnost parametersLink, nebo vlastnost parameters, ale ne obojí. Může to být JObject nebo řetězec JSON ve správném formátu. |
parametersLink |
Identifikátor URI souboru parametrů. Tento element použijete k propojení s existujícím souborem parametrů. Použijte buď vlastnost parametersLink, nebo vlastnost parameters, ale ne obojí. |
|
template |
object |
Obsah šablony. Tento prvek použijete, když chcete předat syntaxi šablony přímo v požadavku místo odkazu na existující šablonu. Může to být JObject nebo řetězec JSON ve správném formátu. Použijte buď vlastnost templateLink, nebo vlastnost šablony, ale ne obě. |
templateLink |
Identifikátor URI šablony Použijte buď vlastnost templateLink, nebo vlastnost šablony, ale ne obě. |
|
whatIfSettings |
Volitelné nastavení operace What-If. |
DeploymentWhatIfSettings
Nastavení operace nasazení What-If.
Name | Typ | Description |
---|---|---|
resultFormat |
Formát What-If výsledků |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorResponse
Odpověď na chybu
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ExpressionEvaluationOptions
Určuje, jestli se výrazy šablony vyhodnocují v rámci oboru nadřazené šablony nebo vnořené šablony.
Name | Typ | Description |
---|---|---|
scope |
Obor, který se má použít pro vyhodnocení parametrů, proměnných a funkcí ve vnořené šabloně. |
ExpressionEvaluationOptionsScopeType
Obor, který se má použít pro vyhodnocení parametrů, proměnných a funkcí ve vnořené šabloně.
Name | Typ | Description |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
OnErrorDeployment
Nasazení při chybovém chování.
Name | Typ | Description |
---|---|---|
deploymentName |
string |
Nasazení, které se má použít v případě chyby. |
type |
Typ chování nasazení při chybě. Možné hodnoty jsou LastSuccessful a SpecificDeployment. |
OnErrorDeploymentType
Typ chování nasazení při chybě. Možné hodnoty jsou LastSuccessful a SpecificDeployment.
Name | Typ | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
ParametersLink
Entita představující odkaz na parametry nasazení.
Name | Typ | Description |
---|---|---|
contentVersion |
string |
Pokud je součástí, musí odpovídat hodnotě ContentVersion v šabloně. |
uri |
string |
Identifikátor URI souboru parametrů. |
PropertyChangeType
Typ vlastnosti se změní.
Name | Typ | Description |
---|---|---|
Array |
string |
Vlastnost je pole a obsahuje vnořené změny. |
Create |
string |
Vlastnost neexistuje v aktuálním stavu, ale je v požadovaném stavu. Vlastnost se vytvoří při spuštění nasazení. |
Delete |
string |
Vlastnost existuje v aktuálním stavu a v požadovaném stavu chybí. Při spuštění nasazení se odstraní. |
Modify |
string |
Vlastnost existuje v aktuálním i požadovaném stavu a liší se. Hodnota vlastnosti se změní při spuštění nasazení. |
NoEffect |
string |
Vlastnost nebude nastavena ani aktualizována. |
ScopedDeploymentWhatIf
Parametry operace Citlivostní analýza nasazení
Name | Typ | Description |
---|---|---|
location |
string |
Umístění pro uložení dat nasazení. |
properties |
Vlastnosti nasazení. |
TemplateLink
Entita představující odkaz na šablonu
Name | Typ | Description |
---|---|---|
contentVersion |
string |
Pokud je součástí, musí odpovídat hodnotě ContentVersion v šabloně. |
id |
string |
ID prostředku specifikace šablony. Použijte buď vlastnost id, nebo URI, ale ne obě. |
queryString |
string |
Řetězec dotazu (například token SAS), který se má použít s identifikátorem URI templateLink. |
relativePath |
string |
Vlastnost relativePath lze použít k nasazení propojené šablony v umístění vzhledem k nadřazené. Pokud byla nadřazená šablona propojena šablonou TemplateSpec, bude odkazovat na artefakt v TemplateSpec. Pokud byl nadřazený objekt propojený pomocí identifikátoru URI, podřízené nasazení bude kombinací nadřazeného a relativního identifikátoru URI. |
uri |
string |
Identifikátor URI šablony, kterou chcete nasadit. Použijte buď vlastnost URI, nebo id, ale ne obojí. |
WhatIfChange
Informace o jedné změně prostředku predikované operací What-If.
Name | Typ | Description |
---|---|---|
after |
object |
Predikovaný snímek prostředku po spuštění nasazení. |
before |
object |
Snímek prostředku před spuštěním nasazení. |
changeType |
Typ změny, která se provede u prostředku při spuštění nasazení. |
|
delta |
Predikované změny ve vlastnostech prostředku. |
|
resourceId |
string |
ID prostředku |
unsupportedReason |
string |
Vysvětlení, proč prostředek není podporován citlivostní analýzy. |
WhatIfOperationResult
Výsledek operace What-If. Obsahuje seznam predikovaných změn a odkaz URL pro získání další sady výsledků.
Name | Typ | Description |
---|---|---|
error |
Odpověď na chybu |
|
properties.changes |
Seznam změn prostředků predikovaných operací What-If |
|
status |
string |
Stav operace What-If. |
WhatIfPropertyChange
Predikovaná změna vlastnosti prostředku
Name | Typ | Description |
---|---|---|
after |
object |
Hodnota vlastnosti po spuštění nasazení. |
before |
object |
Hodnota vlastnosti před spuštěním nasazení. |
children |
Změny vnořených vlastností |
|
path |
string |
Cesta vlastnosti. |
propertyChangeType |
Typ vlastnosti se změní. |
WhatIfResultFormat
Formát What-If výsledků
Name | Typ | Description |
---|---|---|
FullResourcePayloads |
string |
|
ResourceIdOnly |
string |