Deployments - Create Or Update At Management Group Scope

Déploie des ressources à l’étendue du groupe d’administration.
Vous pouvez fournir le modèle et les paramètres directement dans la requête ou le lien vers des fichiers JSON.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01

Paramètres URI

Nom Dans Obligatoire Type Description
deploymentName
path True

string

Le nom du déploiement.

Regex pattern: ^[-\w\._\(\)]+$

groupId
path True

string

ID du groupe d’administration.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement où stocker les données de déploiement.

properties True

DeploymentProperties

Propriétés de déploiement.

tags

object

Balises de déploiement

Réponses

Nom Type Description
200 OK

DeploymentExtended

OK : retourne des informations sur le déploiement, y compris l’approvisionnement status.

201 Created

DeploymentExtended

Créé : retourne des informations sur le déploiement, y compris l’approvisionnement des status.

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create deployment at management group scope.

Sample Request

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

Sample Response

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

Définitions

Nom Description
Alias

Type d’alias.

AliasPath

Type des chemins d’accès pour alias.

AliasPathAttributes

Attributs du jeton auquel le chemin d’alias fait référence.

AliasPathMetadata
AliasPathTokenType

Type du jeton auquel le chemin d’alias fait référence.

AliasPattern

Type du modèle d’un chemin d’alias.

AliasPatternType

Type de modèle d’alias

AliasType

Type de l'alias.

ApiProfile
BasicDependency

Informations sur les dépendances de déploiement.

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

DebugSetting

Paramètre de débogage.

Dependency

Informations sur les dépendances de déploiement.

DeploymentExtended

Informations relatives au déploiement.

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Complète. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

DeploymentProperties

Propriétés de déploiement.

DeploymentPropertiesExtended

Propriétés de déploiement avec des détails supplémentaires.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorResponse

Réponse d’erreur

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué.

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

OnErrorDeployment

Déploiement sur le comportement d’erreur.

OnErrorDeploymentExtended

Déploiement sur le comportement d’erreur avec des détails supplémentaires.

OnErrorDeploymentType

Type de comportement de déploiement sur erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

ParametersLink

Entité représentant la référence aux paramètres de déploiement.

Provider

Informations sur le fournisseur de ressources.

ProviderAuthorizationConsentState

État du consentement d’autorisation du fournisseur.

ProviderExtendedLocation

Emplacement étendu du fournisseur.

ProviderResourceType

Type de ressource géré par le fournisseur de ressources.

ProvisioningState

Indique l’état de l’approvisionnement.

ResourceReference

Modèle d’ID de ressource.

ScopedDeployment

Paramètres de l’opération de déploiement.

TemplateLink

Entité représentant la référence au modèle.

ZoneMapping

Alias

Type d’alias.

Nom Type Description
defaultMetadata

AliasPathMetadata

Métadonnées de chemin d’alias par défaut. S’applique au chemin par défaut et à n’importe quel chemin d’alias qui n’a pas de métadonnées

defaultPath

string

Chemin par défaut d’un alias.

defaultPattern

AliasPattern

Modèle par défaut pour un alias.

name

string

Nom de l’alias.

paths

AliasPath[]

Chemins d’accès d’un alias.

type

AliasType

Type de l'alias.

AliasPath

Type des chemins d’accès pour alias.

Nom Type Description
apiVersions

string[]

Versions de l’API.

metadata

AliasPathMetadata

Métadonnées du chemin d’alias. En cas d’absence, revenez aux métadonnées par défaut de l’alias.

path

string

Chemin d’accès d’un alias.

pattern

AliasPattern

Modèle d’un chemin d’alias.

AliasPathAttributes

Attributs du jeton auquel le chemin d’alias fait référence.

Nom Type Description
Modifiable

string

Le jeton auquel le chemin d’alias fait référence est modifiable par les stratégies avec effet « modifier ».

None

string

Le jeton auquel le chemin d’alias fait référence n’a aucun attribut.

AliasPathMetadata

Nom Type Description
attributes

AliasPathAttributes

Attributs du jeton auquel le chemin d’alias fait référence.

type

AliasPathTokenType

Type du jeton auquel le chemin d’alias fait référence.

AliasPathTokenType

Type du jeton auquel le chemin d’alias fait référence.

Nom Type Description
Any

string

Le type de jeton peut être n’importe quoi.

Array

string

Le type de jeton est tableau.

Boolean

string

Le type de jeton est booléen.

Integer

string

Le type de jeton est entier.

NotSpecified

string

Le type de jeton n’est pas spécifié.

Number

string

Le type de jeton est number.

Object

string

Le type de jeton est objet.

String

string

Le type de jeton est string.

AliasPattern

Type du modèle d’un chemin d’alias.

Nom Type Description
phrase

string

Expression de modèle d’alias.

type

AliasPatternType

Type de modèle d’alias

variable

string

Variable de modèle d’alias.

AliasPatternType

Type de modèle d’alias

Nom Type Description
Extract

string

Extraire est la seule valeur autorisée.

NotSpecified

string

NotSpecified n’est pas autorisé.

AliasType

Type de l'alias.

Nom Type Description
Mask

string

La valeur de l’alias est secret.

NotSpecified

string

Le type d’alias est inconnu (identique à ne pas fournir de type d’alias).

PlainText

string

La valeur de l’alias n’est pas secrète.

ApiProfile

Nom Type Description
apiVersion

string

Version de l'API.

profileVersion

string

Version du profil.

BasicDependency

Informations sur les dépendances de déploiement.

Nom Type Description
id

string

ID de la dépendance.

resourceName

string

Nom de la ressource de dépendance.

resourceType

string

Type de ressource de dépendance.

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

DebugSetting

Paramètre de débogage.

Nom Type Description
detailLevel

string

Spécifie le type d’informations à consigner pour le débogage. Les valeurs autorisées sont none, requestContent, responseContent ou requestContent et responseContent séparées par une virgule. La valeur par défaut est aucune gestion. Lorsque vous définissez cette valeur, examinez soigneusement le type d’informations que vous transmettez pendant le déploiement. En enregistrant des informations sur la requête ou la réponse, vous risquez d’exposer des données sensibles récupérées au cours des opérations de déploiement.

Dependency

Informations sur les dépendances de déploiement.

Nom Type Description
dependsOn

BasicDependency[]

Liste de dépendances.

id

string

ID de la dépendance.

resourceName

string

Nom de la ressource de dépendance.

resourceType

string

Type de ressource de dépendance.

DeploymentExtended

Informations relatives au déploiement.

Nom Type Description
id

string

ID du déploiement.

location

string

emplacement du déploiement.

name

string

Le nom du déploiement.

properties

DeploymentPropertiesExtended

Propriétés de déploiement.

tags

object

Balises de déploiement

type

string

Type du déploiement.

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Complète. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

Nom Type Description
Complete

string

Incremental

string

DeploymentProperties

Propriétés de déploiement.

Nom Type Description
debugSetting

DebugSetting

Paramètre de débogage du déploiement.

expressionEvaluationOptions

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué. Applicable uniquement aux modèles imbriqués. Si elle n’est pas spécifiée, la valeur par défaut est externe.

mode

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Complète. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

onErrorDeployment

OnErrorDeployment

Déploiement sur le comportement d’erreur.

parameters

object

Paires nom et valeur qui définissent les paramètres de déploiement du modèle. Vous utilisez cet élément lorsque vous souhaitez fournir les valeurs de paramètre directement dans la demande plutôt que de créer un lien vers un fichier de paramètres existant. Utilisez la propriété parametersLink ou la propriété parameters, mais pas les deux. Il peut s’agir d’un JObject ou d’une chaîne JSON bien formée.

parametersLink

ParametersLink

URI du fichier de paramètres. Vous utilisez cet élément pour établir un lien vers un fichier de paramètres existant. Utilisez la propriété parametersLink ou la propriété parameters, mais pas les deux.

template

object

Contenu du modèle. Vous utilisez cet élément lorsque vous souhaitez transmettre la syntaxe du modèle directement dans la demande plutôt que de créer un lien vers un modèle existant. Il peut s’agir d’un JObject ou d’une chaîne JSON bien formée. Utilisez la propriété templateLink ou la propriété template, mais pas les deux.

templateLink

TemplateLink

URI du modèle. Utilisez la propriété templateLink ou la propriété template, mais pas les deux.

DeploymentPropertiesExtended

Propriétés de déploiement avec des détails supplémentaires.

Nom Type Description
correlationId

string

ID de corrélation du déploiement.

debugSetting

DebugSetting

Paramètre de débogage du déploiement.

dependencies

Dependency[]

Liste des dépendances de déploiement.

duration

string

Durée du déploiement du modèle.

error

ErrorResponse

Réponse d’erreur
Erreur de déploiement.

mode

DeploymentMode

Mode de déploiement. Les valeurs possibles sont Incrémentielle et Complète.

onErrorDeployment

OnErrorDeploymentExtended

Déploiement sur le comportement d’erreur.

outputResources

ResourceReference[]

Tableau de ressources approvisionnées.

outputs

object

Paires clé/valeur qui représentent la sortie du déploiement.

parameters

object

Paramètres de déploiement.

parametersLink

ParametersLink

URI référençant les paramètres.

providers

Provider[]

Liste des fournisseurs de ressources nécessaires au déploiement.

provisioningState

ProvisioningState

Indique l’état de l’approvisionnement.

templateHash

string

Hachage produit pour le modèle.

templateLink

TemplateLink

URI référençant le modèle.

timestamp

string

Horodatage du déploiement du modèle.

validatedResources

ResourceReference[]

Tableau de ressources validées.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorResponse

Réponse d’erreur

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorResponse[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué.

Nom Type Description
scope

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

Nom Type Description
Inner

string

NotSpecified

string

Outer

string

OnErrorDeployment

Déploiement sur le comportement d’erreur.

Nom Type Description
deploymentName

string

Déploiement à utiliser en cas d’erreur.

type

OnErrorDeploymentType

Type de comportement de déploiement sur erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

OnErrorDeploymentExtended

Déploiement sur le comportement d’erreur avec des détails supplémentaires.

Nom Type Description
deploymentName

string

Déploiement à utiliser en cas d’erreur.

provisioningState

string

État de l’approvisionnement pour le déploiement en cas d’erreur.

type

OnErrorDeploymentType

Type de comportement de déploiement sur erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

OnErrorDeploymentType

Type de comportement de déploiement sur erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

Nom Type Description
LastSuccessful

string

SpecificDeployment

string

Entité représentant la référence aux paramètres de déploiement.

Nom Type Description
contentVersion

string

S’il est inclus, doit correspondre à ContentVersion dans le modèle.

uri

string

URI du fichier de paramètres.

Provider

Informations sur le fournisseur de ressources.

Nom Type Description
id

string

ID du fournisseur.

namespace

string

Espace de noms du fournisseur de ressources.

providerAuthorizationConsentState

ProviderAuthorizationConsentState

État du consentement d’autorisation du fournisseur.

registrationPolicy

string

Stratégie d’inscription du fournisseur de ressources.

registrationState

string

État d’inscription du fournisseur de ressources.

resourceTypes

ProviderResourceType[]

Collection de types de ressources de fournisseur.

ProviderAuthorizationConsentState

État du consentement d’autorisation du fournisseur.

Nom Type Description
Consented

string

NotRequired

string

NotSpecified

string

Required

string

ProviderExtendedLocation

Emplacement étendu du fournisseur.

Nom Type Description
extendedLocations

string[]

Emplacements étendus pour l’emplacement Azure.

location

string

Emplacement Azure.

type

string

Type d’emplacement étendu.

ProviderResourceType

Type de ressource géré par le fournisseur de ressources.

Nom Type Description
aliases

Alias[]

Alias pris en charge par ce type de ressource.

apiProfiles

ApiProfile[]

Profils d’API pour le fournisseur de ressources.

apiVersions

string[]

Version de l'API.

capabilities

string

Fonctionnalités supplémentaires offertes par ce type de ressource.

defaultApiVersion

string

Version de l’API par défaut.

locationMappings

ProviderExtendedLocation[]

Mappages d’emplacements pris en charge par ce type de ressource.

locations

string[]

Collection d’emplacements où ce type de ressource peut être créé.

properties

object

Propriétés.

resourceType

string

Type de ressource.

zoneMappings

ZoneMapping[]

ProvisioningState

Indique l’état de l’approvisionnement.

Nom 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

Modèle d’ID de ressource.

Nom Type Description
id

string

ID de ressource complet.

ScopedDeployment

Paramètres de l’opération de déploiement.

Nom Type Description
location

string

Emplacement où stocker les données de déploiement.

properties

DeploymentProperties

Propriétés de déploiement.

tags

object

Balises de déploiement

Entité représentant la référence au modèle.

Nom Type Description
contentVersion

string

S’il est inclus, doit correspondre à ContentVersion dans le modèle.

id

string

ID de ressource d’une spécification de modèle. Utilisez la propriété id ou uri, mais pas les deux.

queryString

string

Chaîne de requête (par exemple, un jeton SAS) à utiliser avec l’URI templateLink.

relativePath

string

La propriété relativePath peut être utilisée pour déployer un modèle lié à un emplacement par rapport au parent. Si le modèle parent a été lié à un TemplateSpec, cela fait référence à un artefact dans templateSpec. Si le parent a été lié à un URI, le déploiement enfant est une combinaison des URI parent et relativePath

uri

string

URI du modèle à déployer. Utilisez la propriété uri ou id, mais pas les deux.

ZoneMapping

Nom Type Description
location

string

Emplacement du mappage de zone.

zones

string[]