Deployments - Create Or Update At Management Group Scope
Implementeert resources binnen het bereik van de beheergroep.
U kunt de sjabloon en parameters rechtstreeks in de aanvraag opgeven of een koppeling naar JSON-bestanden maken.
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
De naam van de implementatie. Regex-patroon: |
group
|
path | True |
string |
De beheergroep-id. |
api-version
|
query | True |
string |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
location | True |
string |
De locatie voor het opslaan van de implementatiegegevens. |
properties | True |
De implementatie-eigenschappen. |
|
tags |
object |
Implementatietags |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK: retourneert informatie over de implementatie, waaronder de inrichtingsstatus. |
|
201 Created |
Gemaakt: retourneert informatie over de implementatie, waaronder de inrichtingsstatus. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | uw gebruikersaccount imiteren |
Voorbeelden
Create deployment at management group scope.
Voorbeeldaanvraag
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01
{
"location": "eastus",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Incremental"
}
}
Voorbeeldrespons
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"location": "eastus",
"properties": {
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2019-04-24T22:52:38.7895563Z",
"duration": "PT1.2970875S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Authorization",
"resourceTypes": [
{
"resourceType": "policyDefinitions",
"locations": [
null
]
},
{
"resourceType": "policyAssignments",
"locations": [
null
]
}
]
},
{
"namespace": "Microsoft.Resources",
"resourceTypes": [
{
"resourceType": "deployments",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
}
}
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"location": "eastus",
"properties": {
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2019-04-24T22:52:38.7895563Z",
"duration": "PT1.2970875S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Authorization",
"resourceTypes": [
{
"resourceType": "policyDefinitions",
"locations": [
null
]
},
{
"resourceType": "policyAssignments",
"locations": [
null
]
}
]
},
{
"namespace": "Microsoft.Resources",
"resourceTypes": [
{
"resourceType": "deployments",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
}
}
Definities
Name | Description |
---|---|
Alias |
Het aliastype. |
Alias |
Het type van de paden voor alias. |
Alias |
De kenmerken van het token waarnaar het aliaspad verwijst. |
Alias |
|
Alias |
Het type token waarnaar het aliaspad verwijst. |
Alias |
Het type patroon voor een aliaspad. |
Alias |
Het type aliaspatroon |
Alias |
Het type alias. |
Api |
|
Basic |
Informatie over implementatieafhankelijkheid. |
Cloud |
Een foutreactie voor een resourcebeheeraanvraag. |
Debug |
De instelling voor foutopsporing. |
Dependency |
Informatie over implementatieafhankelijkheid. |
Deployment |
Implementatiegegevens. |
Deployment |
De modus die wordt gebruikt om resources te implementeren. Deze waarde kan incrementeel of Voltooid zijn. In de incrementele modus worden resources geïmplementeerd zonder bestaande resources te verwijderen die niet zijn opgenomen in de sjabloon. In de modus Volledig worden resources geïmplementeerd en worden bestaande resources in de resourcegroep die niet in de sjabloon zijn opgenomen, verwijderd. Wees voorzichtig met het gebruik van de modus Volledig, want u kunt onbedoeld resources verwijderen. |
Deployment |
Implementatie-eigenschappen. |
Deployment |
Implementatie-eigenschappen met aanvullende informatie. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
Foutreactie |
Expression |
Hiermee geeft u op of sjabloonexpressies worden geëvalueerd binnen het bereik van de bovenliggende sjabloon of geneste sjabloon. |
Expression |
Het bereik dat moet worden gebruikt voor de evaluatie van parameters, variabelen en functies in een geneste sjabloon. |
On |
Implementatie bij foutgedrag. |
On |
Implementatie op foutgedrag met aanvullende details. |
On |
De implementatie op foutgedragstype. Mogelijke waarden zijn LastSuccessful en SpecificDeployment. |
Parameters |
Entiteit die de verwijzing naar de implementatieparameters vertegenwoordigt. |
Provider |
Resourceprovidergegevens. |
Provider |
De autorisatietoestemmingsstatus van de provider. |
Provider |
De uitgebreide locatie van de provider. |
Provider |
Resourcetype dat wordt beheerd door de resourceprovider. |
Provisioning |
Geeft de status van de inrichting aan. |
Resource |
Het resource-id-model. |
Scoped |
Parameters voor implementatiebewerking. |
Template |
Entiteit die de verwijzing naar de sjabloon vertegenwoordigt. |
Zone |
Alias
Het aliastype.
Name | Type | Description |
---|---|---|
defaultMetadata |
De metagegevens van het standaardaliaspad. Is van toepassing op het standaardpad en op elk aliaspad dat geen metagegevens bevat |
|
defaultPath |
string |
Het standaardpad voor een alias. |
defaultPattern |
Het standaardpatroon voor een alias. |
|
name |
string |
De aliasnaam. |
paths |
De paden voor een alias. |
|
type |
Het type alias. |
AliasPath
Het type van de paden voor alias.
Name | Type | Description |
---|---|---|
apiVersions |
string[] |
De API-versies. |
metadata |
De metagegevens van het aliaspad. Als dit ontbreekt, moet u terugvallen op de standaardmetagegevens van de alias. |
|
path |
string |
Het pad van een alias. |
pattern |
Het patroon voor een aliaspad. |
AliasPathAttributes
De kenmerken van het token waarnaar het aliaspad verwijst.
Name | Type | Description |
---|---|---|
Modifiable |
string |
Het token waarnaar het aliaspad verwijst, kan worden gewijzigd door beleidsregels met een 'wijzigen'-effect. |
None |
string |
Het token waarnaar het aliaspad verwijst, heeft geen kenmerken. |
AliasPathMetadata
Name | Type | Description |
---|---|---|
attributes |
De kenmerken van het token waarnaar het aliaspad verwijst. |
|
type |
Het type token waarnaar het aliaspad verwijst. |
AliasPathTokenType
Het type token waarnaar het aliaspad verwijst.
Name | Type | Description |
---|---|---|
Any |
string |
Het tokentype kan van alles zijn. |
Array |
string |
Het tokentype is matrix. |
Boolean |
string |
Het tokentype is booleaans. |
Integer |
string |
Het tokentype is geheel getal. |
NotSpecified |
string |
Het tokentype is niet opgegeven. |
Number |
string |
Het tokentype is number. |
Object |
string |
Het tokentype is object. |
String |
string |
Het tokentype is een tekenreeks. |
AliasPattern
Het type patroon voor een aliaspad.
Name | Type | Description |
---|---|---|
phrase |
string |
De aliaspatroonzin. |
type |
Het type aliaspatroon |
|
variable |
string |
De aliaspatroonvariabele. |
AliasPatternType
Het type aliaspatroon
Name | Type | Description |
---|---|---|
Extract |
string |
Uitpakken is de enige toegestane waarde. |
NotSpecified |
string |
NotSpecified is niet toegestaan. |
AliasType
Het type alias.
Name | Type | Description |
---|---|---|
Mask |
string |
Aliaswaarde is geheim. |
NotSpecified |
string |
Aliastype is onbekend (hetzelfde als geen aliastype opgeven). |
PlainText |
string |
Aliaswaarde is niet geheim. |
ApiProfile
Name | Type | Description |
---|---|---|
apiVersion |
string |
De API-versie. |
profileVersion |
string |
De profielversie. |
BasicDependency
Informatie over implementatieafhankelijkheid.
Name | Type | Description |
---|---|---|
id |
string |
De id van de afhankelijkheid. |
resourceName |
string |
De naam van de afhankelijkheidsresource. |
resourceType |
string |
Het resourcetype van de afhankelijkheid. |
CloudError
Een foutreactie voor een resourcebeheeraanvraag.
Name | Type | Description |
---|---|---|
error |
Foutreactie |
DebugSetting
De instelling voor foutopsporing.
Name | Type | Description |
---|---|---|
detailLevel |
string |
Hiermee geeft u het type informatie op dat moet worden vastgelegd voor foutopsporing. De toegestane waarden zijn none, requestContent, responseContent of zowel requestContent als responseContent, gescheiden door een komma. De standaardwaarde is geen. Houd bij het instellen van deze waarde zorgvuldig rekening met het type informatie dat u tijdens de implementatie doorgeeft. Door informatie over de aanvraag of reactie te registreren, kunt u mogelijk gevoelige gegevens beschikbaar maken die worden opgehaald via de implementatiebewerkingen. |
Dependency
Informatie over implementatieafhankelijkheid.
Name | Type | Description |
---|---|---|
dependsOn |
De lijst met afhankelijkheden. |
|
id |
string |
De id van de afhankelijkheid. |
resourceName |
string |
De naam van de afhankelijkheidsresource. |
resourceType |
string |
Het resourcetype van de afhankelijkheid. |
DeploymentExtended
Implementatiegegevens.
Name | Type | Description |
---|---|---|
id |
string |
De id van de implementatie. |
location |
string |
de locatie van de implementatie. |
name |
string |
De naam van de implementatie. |
properties |
Implementatie-eigenschappen. |
|
tags |
object |
Implementatietags |
type |
string |
Het type implementatie. |
DeploymentMode
De modus die wordt gebruikt om resources te implementeren. Deze waarde kan incrementeel of Voltooid zijn. In de incrementele modus worden resources geïmplementeerd zonder bestaande resources te verwijderen die niet zijn opgenomen in de sjabloon. In de modus Volledig worden resources geïmplementeerd en worden bestaande resources in de resourcegroep die niet in de sjabloon zijn opgenomen, verwijderd. Wees voorzichtig met het gebruik van de modus Volledig, want u kunt onbedoeld resources verwijderen.
Name | Type | Description |
---|---|---|
Complete |
string |
|
Incremental |
string |
DeploymentProperties
Implementatie-eigenschappen.
Name | Type | Description |
---|---|---|
debugSetting |
De instelling voor foutopsporing van de implementatie. |
|
expressionEvaluationOptions |
Hiermee geeft u op of sjabloonexpressies worden geëvalueerd binnen het bereik van de bovenliggende sjabloon of geneste sjabloon. Alleen van toepassing op geneste sjablonen. Als dit niet is opgegeven, is de standaardwaarde buitenste waarde. |
|
mode |
De modus die wordt gebruikt om resources te implementeren. Deze waarde kan incrementeel of Voltooid zijn. In de incrementele modus worden resources geïmplementeerd zonder bestaande resources te verwijderen die niet zijn opgenomen in de sjabloon. In de modus Volledig worden resources geïmplementeerd en worden bestaande resources in de resourcegroep die niet in de sjabloon zijn opgenomen, verwijderd. Wees voorzichtig met het gebruik van de modus Volledig, want u kunt onbedoeld resources verwijderen. |
|
onErrorDeployment |
Het foutgedrag van de implementatie. |
|
parameters |
object |
Naam- en waardeparen waarmee de implementatieparameters voor de sjabloon worden gedefinieerd. U gebruikt dit element als u de parameterwaarden rechtstreeks in de aanvraag wilt opgeven in plaats van een koppeling te maken naar een bestaand parameterbestand. Gebruik de eigenschap parametersLink of de eigenschap parameters, maar niet beide. Dit kan een JObject of een goed gevormde JSON-tekenreeks zijn. |
parametersLink |
De URI van het parameterbestand. U gebruikt dit element om een koppeling te maken naar een bestaand parameterbestand. Gebruik de eigenschap parametersLink of de eigenschap parameters, maar niet beide. |
|
template |
object |
De sjablooninhoud. U gebruikt dit element als u de sjabloonsyntaxis rechtstreeks in de aanvraag wilt doorgeven in plaats van een koppeling naar een bestaande sjabloon. Dit kan een JObject of een goed gevormde JSON-tekenreeks zijn. Gebruik de eigenschap templateLink of de sjablooneigenschap, maar niet beide. |
templateLink |
De URI van de sjabloon. Gebruik de eigenschap templateLink of de sjablooneigenschap, maar niet beide. |
DeploymentPropertiesExtended
Implementatie-eigenschappen met aanvullende informatie.
Name | Type | Description |
---|---|---|
correlationId |
string |
De correlatie-id van de implementatie. |
debugSetting |
De instelling voor foutopsporing van de implementatie. |
|
dependencies |
De lijst met implementatieafhankelijkheden. |
|
duration |
string |
De duur van de sjabloonimplementatie. |
error |
Foutreactie |
|
mode |
De implementatiemodus. Mogelijke waarden zijn Incrementeel en Volledig. |
|
onErrorDeployment |
Het foutgedrag van de implementatie. |
|
outputResources |
Matrix van ingerichte resources. |
|
outputs |
object |
Sleutel-waardeparen die de implementatie-uitvoer vertegenwoordigen. |
parameters |
object |
Implementatieparameters. |
parametersLink |
De URI die verwijst naar de parameters. |
|
providers |
Provider[] |
De lijst met resourceproviders die nodig zijn voor de implementatie. |
provisioningState |
Geeft de status van de inrichting aan. |
|
templateHash |
string |
De hash die voor de sjabloon is geproduceerd. |
templateLink |
De URI die verwijst naar de sjabloon. |
|
timestamp |
string |
Het tijdstempel van de sjabloonimplementatie. |
validatedResources |
Matrix van gevalideerde resources. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
additionalInfo |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ExpressionEvaluationOptions
Hiermee geeft u op of sjabloonexpressies worden geëvalueerd binnen het bereik van de bovenliggende sjabloon of geneste sjabloon.
Name | Type | Description |
---|---|---|
scope |
Het bereik dat moet worden gebruikt voor de evaluatie van parameters, variabelen en functies in een geneste sjabloon. |
ExpressionEvaluationOptionsScopeType
Het bereik dat moet worden gebruikt voor de evaluatie van parameters, variabelen en functies in een geneste sjabloon.
Name | Type | Description |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
OnErrorDeployment
Implementatie bij foutgedrag.
Name | Type | Description |
---|---|---|
deploymentName |
string |
De implementatie die moet worden gebruikt voor foutcases. |
type |
De implementatie op foutgedragstype. Mogelijke waarden zijn LastSuccessful en SpecificDeployment. |
OnErrorDeploymentExtended
Implementatie op foutgedrag met aanvullende details.
Name | Type | Description |
---|---|---|
deploymentName |
string |
De implementatie die moet worden gebruikt voor foutcases. |
provisioningState |
string |
De status van de inrichting voor de implementatie bij fout. |
type |
Het type implementatie op foutgedrag. Mogelijke waarden zijn LastSuccessful en SpecificDeployment. |
OnErrorDeploymentType
De implementatie op foutgedragstype. Mogelijke waarden zijn LastSuccessful en SpecificDeployment.
Name | Type | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
ParametersLink
Entiteit die de verwijzing naar de implementatieparameters vertegenwoordigt.
Name | Type | Description |
---|---|---|
contentVersion |
string |
Indien opgenomen, moet overeenkomen met de ContentVersion in de sjabloon. |
uri |
string |
De URI van het parameterbestand. |
Provider
Resourceprovidergegevens.
Name | Type | Description |
---|---|---|
id |
string |
De provider-id. |
namespace |
string |
De naamruimte van de resourceprovider. |
providerAuthorizationConsentState |
De autorisatietoestemmingsstatus van de provider. |
|
registrationPolicy |
string |
Het registratiebeleid van de resourceprovider. |
registrationState |
string |
De registratiestatus van de resourceprovider. |
resourceTypes |
De verzameling providerresourcetypen. |
ProviderAuthorizationConsentState
De autorisatietoestemmingsstatus van de provider.
Name | Type | Description |
---|---|---|
Consented |
string |
|
NotRequired |
string |
|
NotSpecified |
string |
|
Required |
string |
ProviderExtendedLocation
De uitgebreide locatie van de provider.
Name | Type | Description |
---|---|---|
extendedLocations |
string[] |
De uitgebreide locaties voor de Azure-locatie. |
location |
string |
De Azure-locatie. |
type |
string |
Het uitgebreide locatietype. |
ProviderResourceType
Resourcetype dat wordt beheerd door de resourceprovider.
Name | Type | Description |
---|---|---|
aliases |
Alias[] |
De aliassen die worden ondersteund door dit resourcetype. |
apiProfiles |
De API-profielen voor de resourceprovider. |
|
apiVersions |
string[] |
De API-versie. |
capabilities |
string |
De extra mogelijkheden die door dit resourcetype worden geboden. |
defaultApiVersion |
string |
De standaard-API-versie. |
locationMappings |
De locatietoewijzingen die worden ondersteund door dit resourcetype. |
|
locations |
string[] |
De verzameling locaties waar dit resourcetype kan worden gemaakt. |
properties |
object |
De eigenschappen. |
resourceType |
string |
Het resourcetype. |
zoneMappings |
ProvisioningState
Geeft de status van de inrichting aan.
Name | Type | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Created |
string |
|
Creating |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
NotSpecified |
string |
|
Ready |
string |
|
Running |
string |
|
Succeeded |
string |
|
Updating |
string |
ResourceReference
Het resource-id-model.
Name | Type | Description |
---|---|---|
id |
string |
De volledig gekwalificeerde resource-id. |
ScopedDeployment
Parameters voor implementatiebewerking.
Name | Type | Description |
---|---|---|
location |
string |
De locatie voor het opslaan van de implementatiegegevens. |
properties |
De implementatie-eigenschappen. |
|
tags |
object |
Implementatietags |
TemplateLink
Entiteit die de verwijzing naar de sjabloon vertegenwoordigt.
Name | Type | Description |
---|---|---|
contentVersion |
string |
Indien opgenomen, moet overeenkomen met de ContentVersion in de sjabloon. |
id |
string |
De resource-id van een sjabloonspecificatie. Gebruik de eigenschap id of URI, maar niet beide. |
queryString |
string |
De querytekenreeks (bijvoorbeeld een SAS-token) die moet worden gebruikt met de templateLink-URI. |
relativePath |
string |
De eigenschap relativePath kan worden gebruikt om een gekoppelde sjabloon te implementeren op een locatie ten opzichte van het bovenliggende item. Als de bovenliggende sjabloon is gekoppeld aan een TemplateSpec, verwijst dit naar een artefact in de TemplateSpec. Als het bovenliggende item is gekoppeld aan een URI, is de onderliggende implementatie een combinatie van de bovenliggende en relatievePath-URI's |
uri |
string |
De URI van de sjabloon die moet worden geïmplementeerd. Gebruik de eigenschap URI of id, maar niet beide. |
ZoneMapping
Name | Type | Description |
---|---|---|
location |
string |
De locatie van de zonetoewijzing. |
zones |
string[] |