Deployments - Create Or Update At Scope

Référence

Service:: Resource Management

Version d'API:: 2021-04-01

Déploie des ressources dans une étendue donnée.
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/{scope}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01

Paramètres URI

Nom Dans Obligatoire Type Description

Nom	Dans	Obligatoire	Type	Description
deploymentName	path	True	string	Le nom du déploiement. Modèle d’expression régulière: `^[-\w\._\(\)]+$`
scope	path	True	string	Étendue des ressources.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

deploymentName

path

True

string

Le nom du déploiement.

Modèle d’expression régulière: ^[-\w\._]+$

scope

path

True

string

Étendue des ressources.

api-version

query

True

string

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

Corps de la demande

Nom	Obligatoire	Type	Description
properties	True	DeploymentProperties	Propriétés de déploiement.
location		string	Emplacement où stocker les données 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
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

Exemples

Create deployment at a given scope.

Exemple de requête

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"
  },
  "tags": {
    "tagKey1": "tag-value-1",
    "tagKey2": "tag-value-2"
  }
}

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PutDeploymentAtScope.json
func ExampleDeploymentsClient_BeginCreateOrUpdateAtScope() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdateAtScope(ctx, "providers/Microsoft.Management/managementGroups/my-management-group-id", "my-deployment", armresources.Deployment{
		Location: to.Ptr("eastus"),
		Properties: &armresources.DeploymentProperties{
			Mode:       to.Ptr(armresources.DeploymentModeIncremental),
			Parameters: map[string]any{},
			TemplateLink: &armresources.TemplateLink{
				URI: to.Ptr("https://example.com/exampleTemplate.json"),
			},
		},
		Tags: map[string]*string{
			"tagKey1": to.Ptr("tag-value-1"),
			"tagKey2": to.Ptr("tag-value-2"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DeploymentExtended = armresources.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armresources.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armresources.Dependency{
	// 			{
	// 				DependsOn: []*armresources.BasicDependency{
	// 					{
	// 						ID: to.Ptr("/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyDefinitions/policy-definition-name"),
	// 						ResourceName: to.Ptr("policy-definition-name"),
	// 						ResourceType: to.Ptr("Microsoft.Authorization/policyDefinitions"),
	// 				}},
	// 				ID: to.Ptr("/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyAssignments/location-lock"),
	// 				ResourceName: to.Ptr("location-lock"),
	// 				ResourceType: to.Ptr("Microsoft.Authorization/policyAssignments"),
	// 		}},
	// 		Duration: to.Ptr("PT1.2970875S"),
	// 		Mode: to.Ptr(armresources.DeploymentModeIncremental),
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armresources.Provider{
	// 			{
	// 				Namespace: to.Ptr("Microsoft.Authorization"),
	// 				ResourceTypes: []*armresources.ProviderResourceType{
	// 					{
	// 						Locations: []*string{
	// 							nil},
	// 							ResourceType: to.Ptr("policyDefinitions"),
	// 						},
	// 						{
	// 							Locations: []*string{
	// 								nil},
	// 								ResourceType: to.Ptr("policyAssignments"),
	// 						}},
	// 					},
	// 					{
	// 						Namespace: to.Ptr("Microsoft.Resources"),
	// 						ResourceTypes: []*armresources.ProviderResourceType{
	// 							{
	// 								Locations: []*string{
	// 									to.Ptr("eastus")},
	// 									ResourceType: to.Ptr("deployments"),
	// 							}},
	// 					}},
	// 					ProvisioningState: to.Ptr(armresources.ProvisioningStateSucceeded),
	// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-04-24T22:52:38.789Z"); return t}()),
	// 				},
	// 				Tags: map[string]*string{
	// 					"tagKey1": to.Ptr("tag-value-1"),
	// 					"tagKey2": to.Ptr("tag-value-2"),
	// 				},
	// 			}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PutDeploymentAtScope.json
 */
async function createDeploymentAtAGivenScope() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const scope = "providers/Microsoft.Management/managementGroups/my-management-group-id";
  const deploymentName = "my-deployment";
  const parameters = {
    location: "eastus",
    properties: {
      mode: "Incremental",
      parameters: {},
      templateLink: { uri: "https://example.com/exampleTemplate.json" },
    },
    tags: { tagKey1: "tag-value-1", tagKey2: "tag-value-2" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAtScopeAndWait(
    scope,
    deploymentName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;

// Generated from example definition: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PutDeploymentAtScope.json
// this example is just showing the usage of "Deployments_CreateOrUpdateAtScope" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ArmDeploymentResource created on azure
// for more information of creating ArmDeploymentResource, please refer to the document of ArmDeploymentResource
string scope = "providers/Microsoft.Management/managementGroups/my-management-group-id";
string deploymentName = "my-deployment";
ResourceIdentifier armDeploymentResourceId = ArmDeploymentResource.CreateResourceIdentifier(scope, deploymentName);
ArmDeploymentResource armDeployment = client.GetArmDeploymentResource(armDeploymentResourceId);

// invoke the operation
ArmDeploymentContent content = new ArmDeploymentContent(new ArmDeploymentProperties(ArmDeploymentMode.Incremental)
{
    TemplateLink = new ArmDeploymentTemplateLink()
    {
        Uri = new Uri("https://example.com/exampleTemplate.json"),
    },
    Parameters = BinaryData.FromObjectAsJson(new Dictionary<string, object>()
    {
    }),
})
{
    Location = new AzureLocation("eastus"),
    Tags =
    {
    ["tagKey1"] = "tag-value-1",
    ["tagKey2"] = "tag-value-2",
    },
};
ArmOperation<ArmDeploymentResource> lro = await armDeployment.UpdateAsync(WaitUntil.Completed, content);
ArmDeploymentResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "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"
      }
    ]
  },
  "tags": {
    "tagKey1": "tag-value-1",
    "tagKey2": "tag-value-2"
  }
}

Code d’état:: 201

{
  "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"
      }
    ]
  },
  "tags": {
    "tagKey1": "tag-value-1",
    "tagKey2": "tag-value-2"
  }
}

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.
Deployment	Paramètres de l’opération 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.
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.

Deployment

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

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

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 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.

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 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[]

Partager via

Deployments - Create Or Update At Scope

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create deployment at a given scope.

Exemple de requête

Exemple de réponse

Définitions

Alias

AliasPath

AliasPathAttributes

AliasPathMetadata

AliasPathTokenType

AliasPattern

AliasPatternType

AliasType

ApiProfile

BasicDependency

CloudError

DebugSetting

Dependency

Deployment

DeploymentExtended

DeploymentMode

DeploymentProperties

DeploymentPropertiesExtended

ErrorAdditionalInfo

ErrorResponse

ExpressionEvaluationOptions

ExpressionEvaluationOptionsScopeType

OnErrorDeployment

OnErrorDeploymentExtended

OnErrorDeploymentType

ParametersLink

Provider

ProviderAuthorizationConsentState

ProviderExtendedLocation

ProviderResourceType

ProvisioningState

ResourceReference

TemplateLink

ZoneMapping

Ressources supplémentaires