Deployments - Get
Obtient un déploiement.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
deployment
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[-\w\._\(\)]+$ |
Le nom du déploiement. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string |
ID d’abonnement Microsoft Azure. |
|
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
OK : retourne des informations sur le déploiement, y compris l’état d’approvisionnement. |
|
| Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Définitions
| Nom | Description |
|---|---|
| Alias |
Type d’alias. |
|
Alias |
Type des chemins d’accès pour l’alias. |
|
Alias |
Attributs du jeton auquel le chemin d’accès de l’alias fait référence. |
|
Alias |
|
|
Alias |
Type du jeton auquel le chemin d’accès de l’alias fait référence. |
|
Alias |
Type du modèle pour un chemin d’alias. |
|
Alias |
Type de modèle d’alias |
|
Alias |
Type de l’alias. |
|
Api |
|
|
Basic |
Informations sur les dépendances de déploiement. |
|
Cloud |
Réponse d’erreur pour une demande de gestion des ressources. |
|
Debug |
Paramètre de débogage. |
| Dependency |
Informations sur les dépendances de déploiement. |
|
Deployment |
|
|
Deployment |
Informations de déploiement. |
|
Deployment |
|
|
Deployment |
|
|
Deployment |
Mode utilisé pour déployer des ressources. Cette valeur peut être incrémentielle ou terminée. En mode incrémentiel, les ressources sont déployées sans supprimer les ressources existantes qui ne sont pas incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes dans le groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Veillez à utiliser le mode Complet, car vous pouvez supprimer involontairement des ressources. |
|
Deployment |
Propriétés de déploiement avec des détails supplémentaires. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Réponse d’erreur |
|
Extension |
|
|
Key |
Informations de référence sur les paramètres Azure Key Vault. |
|
Key |
Informations de référence sur Azure Key Vault. |
| Level |
Indique le niveau de réponse supplémentaire. |
|
On |
Déploiement sur le comportement des erreurs avec des détails supplémentaires. |
|
On |
Déploiement sur le type de comportement d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment. |
|
Parameters |
Entité représentant la référence aux paramètres de déploiement. |
| Provider |
Informations du fournisseur de ressources. |
|
Provider |
État du consentement d’autorisation du fournisseur. |
|
Provider |
Emplacement étendu du fournisseur. |
|
Provider |
Type de ressource géré par le fournisseur de ressources. |
|
Provisioning |
Indique l’état de l’approvisionnement. |
|
Resource |
Modèle ID de ressource. |
|
Template |
Entité représentant la référence au modèle. |
|
Validation |
Niveau de validation effectué sur le déploiement. |
|
Zone |
Alias
Type d’alias.
| Nom | Type | Description |
|---|---|---|
| defaultMetadata |
Métadonnées de chemin d’accès d’alias par défaut. S’applique au chemin d’accès par défaut et à tout chemin d’alias qui n’a pas de métadonnées |
|
| defaultPath |
string |
Chemin d’accès par défaut d’un alias. |
| defaultPattern |
Modèle par défaut d’un alias. |
|
| name |
string |
Nom de l’alias. |
| paths |
Chemins d’accès d’un alias. |
|
| type |
Type de l’alias. |
AliasPath
Type des chemins d’accès pour l’alias.
| Nom | Type | Description |
|---|---|---|
| apiVersions |
string[] |
Versions de l’API. |
| metadata |
Métadonnées du chemin d’accès de l’alias. Si elle est manquante, revenez aux métadonnées par défaut de l’alias. |
|
| path |
string |
Chemin d’accès d’un alias. |
| pattern |
Modèle pour un chemin d’alias. |
AliasPathAttributes
Attributs du jeton auquel le chemin d’accès de l’alias fait référence.
| Valeur | Description |
|---|---|
| None |
Jeton auquel le chemin d’accès de l’alias fait référence n’a aucun attribut. |
| Modifiable |
Le jeton auquel le chemin d’accès de l’alias fait référence est modifiable par les stratégies avec l’effet « modifier ». |
AliasPathMetadata
| Nom | Type | Description |
|---|---|---|
| attributes |
Attributs du jeton auquel le chemin d’accès de l’alias fait référence. |
|
| type |
Type du jeton auquel le chemin d’accès de l’alias fait référence. |
AliasPathTokenType
Type du jeton auquel le chemin d’accès de l’alias fait référence.
| Valeur | Description |
|---|---|
| NotSpecified |
Le type de jeton n’est pas spécifié. |
| Any |
Le type de jeton peut être n’importe quoi. |
| String |
Le type de jeton est chaîne. |
| Object |
Le type de jeton est objet. |
| Array |
Le type de jeton est tableau. |
| Integer |
Le type de jeton est entier. |
| Number |
Le type de jeton est number. |
| Boolean |
Le type de jeton est booléen. |
AliasPattern
Type du modèle pour un chemin d’alias.
| Nom | Type | Description |
|---|---|---|
| phrase |
string |
Expression de modèle d’alias. |
| type |
Type de modèle d’alias |
|
| variable |
string |
Variable de modèle d’alias. |
AliasPatternType
Type de modèle d’alias
| Valeur | Description |
|---|---|
| NotSpecified |
NotSpecified n’est pas autorisé. |
| Extract |
L’extraction est la seule valeur autorisée. |
AliasType
Type de l’alias.
| Valeur | Description |
|---|---|
| NotSpecified |
Le type d’alias est inconnu (identique au type d’alias non fourni). |
| PlainText |
La valeur de l’alias n’est pas secrète. |
| Mask |
La valeur de l’alias est 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 |
Réponse d’erreur |
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 ne sont aucune, requestContent, responseContent ou requestContent et responseContent séparées par une virgule. La valeur par défaut n’est aucune. Lors de la définition de cette valeur, tenez soigneusement compte du type d’informations que vous transmettez pendant le déploiement. En journalisant des informations sur la demande ou la réponse, vous pouvez potentiellement exposer des données sensibles récupérées par le biais des opérations de déploiement. |
Dependency
Informations sur les dépendances de déploiement.
| Nom | Type | Description |
|---|---|---|
| dependsOn |
Liste des 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. |
DeploymentDiagnosticsDefinition
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| level |
Indique le niveau de réponse supplémentaire. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
DeploymentExtended
Informations de 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 |
Propriétés de déploiement. |
|
| tags |
object |
Balises de déploiement |
| type |
string |
Type du déploiement. |
DeploymentExtensionConfigItem
| Nom | Type | Description |
|---|---|---|
| keyVaultReference |
Référence Azure Key Vault utilisée pour récupérer la valeur secrète de la propriété de configuration de l’extension. |
|
| type |
Type de valeur de la propriété extension config. |
|
| value |
Valeur de la propriété de configuration de l’extension. |
DeploymentExtensionDefinition
| Nom | Type | Description |
|---|---|---|
| alias |
string |
Alias de l’extension tel que défini dans le modèle de déploiement. |
| config |
<string,
Deployment |
La configuration de l’extension. |
| configId |
string |
ID de configuration de l’extension. Il identifie de manière unique un plan de contrôle de déploiement au sein d’une extension. |
| name |
string |
Nom de l’extension. |
| version |
string |
La version extension. |
DeploymentMode
Mode utilisé pour déployer des ressources. Cette valeur peut être incrémentielle ou terminée. En mode incrémentiel, les ressources sont déployées sans supprimer les ressources existantes qui ne sont pas incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes dans le groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Veillez à utiliser le mode Complet, car vous pouvez supprimer involontairement des ressources.
| Valeur | Description |
|---|---|
| Incremental | |
| Complete |
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 |
Paramètre de débogage du déploiement. |
|
| dependencies |
Liste des dépendances de déploiement. |
|
| diagnostics |
Contient les informations de diagnostic collectées lors du processus de validation. |
|
| duration |
string |
Durée du déploiement du modèle. |
| error |
Réponse d’erreur |
|
| extensions |
Les extensions utilisées dans ce déploiement. |
|
| mode |
Mode de déploiement. Les valeurs possibles sont Incrémentielles et Terminées. |
|
| onErrorDeployment |
Déploiement sur le comportement d’erreur. |
|
| outputResources |
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 |
URI référençant les paramètres. |
|
| providers |
Provider[] |
Liste des fournisseurs de ressources nécessaires au déploiement. |
| provisioningState |
Indique l’état de l’approvisionnement. |
|
| templateHash |
string |
Hachage produit pour le modèle. |
| templateLink |
URI référençant le modèle. |
|
| timestamp |
string (date-time) |
Horodatage du déploiement du modèle. |
| validatedResources |
Tableau de ressources validées. |
|
| validationLevel |
Niveau de validation du déploiement |
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émentaire. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ExtensionConfigPropertyType
| Valeur | Description |
|---|---|
| String |
Type de propriété représentant une valeur de chaîne. |
| Int |
Type de propriété représentant une valeur entière. |
| Bool |
Type de propriété représentant une valeur booléenne. |
| Array |
Type de propriété représentant une valeur de tableau. |
| Object |
Type de propriété représentant une valeur d’objet. |
| SecureString |
Type de propriété représentant une valeur de chaîne sécurisée. |
| SecureObject |
Type de propriété représentant une valeur d’objet sécurisé. |
KeyVaultParameterReference
Informations de référence sur les paramètres Azure Key Vault.
| Nom | Type | Description |
|---|---|---|
| keyVault |
Informations de référence sur Azure Key Vault. |
|
| secretName |
string |
Nom du secret Azure Key Vault. |
| secretVersion |
string |
Version du secret Azure Key Vault. |
KeyVaultReference
Informations de référence sur Azure Key Vault.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID de ressource Azure Key Vault. |
Level
Indique le niveau de réponse supplémentaire.
| Valeur | Description |
|---|---|
| Warning | |
| Info | |
| Error |
OnErrorDeploymentExtended
Déploiement sur le comportement des erreurs avec des détails supplémentaires.
| Nom | Type | Description |
|---|---|---|
| deploymentName |
string |
Déploiement à utiliser dans le cas d’erreur. |
| provisioningState |
string |
État du provisionnement pour le déploiement d’erreurs. |
| type |
Déploiement sur le type de comportement d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment. |
OnErrorDeploymentType
Déploiement sur le type de comportement d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.
| Valeur | Description |
|---|---|
| LastSuccessful | |
| SpecificDeployment |
ParametersLink
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 du fournisseur de ressources.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID du fournisseur. |
| namespace |
string |
Espace de noms du fournisseur de ressources. |
| 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 |
Collection de types de ressources de fournisseur. |
ProviderAuthorizationConsentState
État du consentement d’autorisation du fournisseur.
| Valeur | Description |
|---|---|
| NotSpecified | |
| Required | |
| NotRequired | |
| Consented |
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 |
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 |
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 |
ProvisioningState
Indique l’état de l’approvisionnement.
| Valeur | Description |
|---|---|
| NotSpecified | |
| Accepted | |
| Running | |
| Ready | |
| Creating | |
| Created | |
| Deleting | |
| Deleted | |
| Canceled | |
| Failed | |
| Succeeded | |
| Updating |
ResourceReference
Modèle ID de ressource.
| Nom | Type | Description |
|---|---|---|
| apiVersion |
string |
Version de l’API avec laquelle la ressource a été déployée. |
| extension |
L’extension avec laquelle la ressource a été déployée. |
|
| id |
string |
ID de ressource Azure complet. |
| identifiers |
object |
Identificateurs de ressources extensibles. |
| resourceType |
string |
Type de ressource. |
TemplateLink
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 l’ID ou la propriété uri, mais pas les deux. |
| queryString |
string |
Chaîne de requête (par exemple, un jeton SAP) à 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, il 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 l’URI ou la propriété ID, mais pas les deux. |
ValidationLevel
Niveau de validation effectué sur le déploiement.
| Valeur | Description |
|---|---|
| Template |
Une analyse statique du modèle est effectuée. |
| Provider |
L’analyse statique du modèle est effectuée et les déclarations de ressources sont envoyées aux fournisseurs de ressources pour validation sémantique. Vérifie que l’appelant dispose d’autorisations d’écriture RBAC sur chaque ressource. |
| ProviderNoRbac |
L’analyse statique du modèle est effectuée et les déclarations de ressources sont envoyées aux fournisseurs de ressources pour validation sémantique. Ignore la vérification que l’appelant dispose d’autorisations d’écriture RBAC sur chaque ressource. |
ZoneMapping
| Nom | Type | Description |
|---|---|---|
| location |
string |
Emplacement du mappage de zone. |
| zones |
string[] |