Deployments - Create Or Update At Subscription Scope

Distribuerar resurser i prenumerationsomfånget.
Du kan ange mallen och parametrarna direkt i begäran eller länka till JSON-filer.

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

URI-parametrar

Name I Obligatorisk Typ Description
deploymentName
path True

string

Namnet på distributionen.

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

subscriptionId
path True

string

Prenumerations-ID för Microsoft Azure.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
properties True

DeploymentProperties

Distributionsegenskaperna.

location

string

Platsen där distributionsdata ska lagras.

tags

object

Distributionstaggar

Svar

Name Typ Description
200 OK

DeploymentExtended

OK – Returnerar information om distributionen, inklusive etableringsstatus.

201 Created

DeploymentExtended

Skapad – returnerar information om distributionen, inklusive etableringsstatus.

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Create a deployment that will deploy a templateSpec with the given resourceId

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01

{
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Succeeded",
    "timestamp": "2020-06-05T01:51:58.6288067Z",
    "duration": "PT1.2637681S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [],
    "dependencies": [],
    "outputResources": []
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Accepted",
    "timestamp": "2020-06-05T01:51:58.6288067Z",
    "duration": "PT1.2637681S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [],
    "dependencies": []
  }
}

Definitioner

Name Description
Alias

Aliastypen.

AliasPath

Typ av sökvägar för alias.

AliasPathAttributes

Attributen för token som aliassökvägen refererar till.

AliasPathMetadata
AliasPathTokenType

Typ av token som aliassökvägen refererar till.

AliasPattern

Typ av mönster för en aliassökväg.

AliasPatternType

Typ av aliasmönster

AliasType

Aliastypen.

ApiProfile
BasicDependency

Information om distributionsberoende.

CloudError

Ett felsvar för en resurshanteringsbegäran.

DebugSetting

Felsökningsinställningen.

Dependency

Information om distributionsberoende.

Deployment

Parametrar för distributionsåtgärd.

DeploymentExtended

Distributionsinformation.

DeploymentMode

Läget som används för att distribuera resurser. Det här värdet kan vara antingen Inkrementellt eller Slutfört. I inkrementellt läge distribueras resurser utan att befintliga resurser som inte ingår i mallen tas bort. I fullständigt läge distribueras resurser och befintliga resurser i resursgruppen som inte ingår i mallen tas bort. Var försiktig när du använder läget Slutför eftersom du oavsiktligt kan ta bort resurser.

DeploymentProperties

Distributionsegenskaper.

DeploymentPropertiesExtended

Distributionsegenskaper med ytterligare information.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorResponse

Felsvar

ExpressionEvaluationOptions

Anger om malluttryck utvärderas inom omfånget för den överordnade mallen eller den kapslade mallen.

ExpressionEvaluationOptionsScopeType

Omfånget som ska användas för utvärdering av parametrar, variabler och funktioner i en kapslad mall.

OnErrorDeployment

Distribution vid felbeteende.

OnErrorDeploymentExtended

Distribution av felbeteende med ytterligare information.

OnErrorDeploymentType

Distributionen på felbeteendetypen. Möjliga värden är LastSuccessful och SpecificDeployment.

ParametersLink

Entitet som representerar referensen till distributionsparametrarna.

Provider

Information om resursprovidern.

ProviderAuthorizationConsentState

Tillstånd för medgivande för providerauktorisering.

ProviderExtendedLocation

Providerns utökade plats.

ProviderResourceType

Resurstyp som hanteras av resursprovidern.

ProvisioningState

Anger etableringsstatus.

ResourceReference

Resurs-ID-modellen.

TemplateLink

Entitet som representerar referensen till mallen.

ZoneMapping

Alias

Aliastypen.

Name Typ Description
defaultMetadata

AliasPathMetadata

Standardmetadata för aliassökväg. Gäller för standardsökvägen och för alla aliassökvägar som inte har metadata

defaultPath

string

Standardsökvägen för ett alias.

defaultPattern

AliasPattern

Standardmönstret för ett alias.

name

string

Aliasnamnet.

paths

AliasPath[]

Sökvägarna för ett alias.

type

AliasType

Aliastypen.

AliasPath

Typ av sökvägar för alias.

Name Typ Description
apiVersions

string[]

API-versionerna.

metadata

AliasPathMetadata

Aliassökvägens metadata. Om det saknas återgår du till aliasets standardmetadata.

path

string

Sökvägen till ett alias.

pattern

AliasPattern

Mönstret för en aliassökväg.

AliasPathAttributes

Attributen för token som aliassökvägen refererar till.

Name Typ Description
Modifiable

string

Den token som aliassökvägen refererar till kan ändras av principer med effekten "ändra".

None

string

Den token som aliassökvägen refererar till har inga attribut.

AliasPathMetadata

Name Typ Description
attributes

AliasPathAttributes

Attributen för token som aliassökvägen refererar till.

type

AliasPathTokenType

Typ av token som aliassökvägen refererar till.

AliasPathTokenType

Typ av token som aliassökvägen refererar till.

Name Typ Description
Any

string

Tokentypen kan vara vad som helst.

Array

string

Tokentypen är matris.

Boolean

string

Tokentypen är boolesk.

Integer

string

Tokentypen är heltal.

NotSpecified

string

Tokentypen har inte angetts.

Number

string

Tokentypen är tal.

Object

string

Tokentypen är objekt.

String

string

Tokentypen är sträng.

AliasPattern

Typ av mönster för en aliassökväg.

Name Typ Description
phrase

string

Frasen aliasmönster.

type

AliasPatternType

Typ av aliasmönster

variable

string

Aliasmönstervariabeln.

AliasPatternType

Typ av aliasmönster

Name Typ Description
Extract

string

Extrahering är det enda tillåtna värdet.

NotSpecified

string

NotSpecified tillåts inte.

AliasType

Aliastypen.

Name Typ Description
Mask

string

Aliasvärdet är hemligt.

NotSpecified

string

Aliastypen är okänd (samma som att inte ange aliastyp).

PlainText

string

Aliasvärdet är inte hemligt.

ApiProfile

Name Typ Description
apiVersion

string

API-versionen.

profileVersion

string

Profilversionen.

BasicDependency

Information om distributionsberoende.

Name Typ Description
id

string

ID för beroendet.

resourceName

string

Namnet på beroenderesursen.

resourceType

string

Beroenderesurstypen.

CloudError

Ett felsvar för en resurshanteringsbegäran.

Name Typ Description
error

ErrorResponse

Felsvar
Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.)

DebugSetting

Felsökningsinställningen.

Name Typ Description
detailLevel

string

Anger vilken typ av information som ska loggas för felsökning. De tillåtna värdena är none, requestContent, responseContent eller både requestContent och responseContent avgränsade med ett kommatecken. Standardvärdet är none. När du anger det här värdet bör du noga överväga vilken typ av information du skickar in under distributionen. Genom att logga information om begäran eller svaret kan du potentiellt exponera känsliga data som hämtas via distributionsåtgärderna.

Dependency

Information om distributionsberoende.

Name Typ Description
dependsOn

BasicDependency[]

Listan över beroenden.

id

string

ID för beroendet.

resourceName

string

Namnet på beroenderesursen.

resourceType

string

Beroenderesurstypen.

Deployment

Parametrar för distributionsåtgärd.

Name Typ Description
location

string

Platsen där distributionsdata ska lagras.

properties

DeploymentProperties

Distributionsegenskaperna.

tags

object

Distributionstaggar

DeploymentExtended

Distributionsinformation.

Name Typ Description
id

string

ID för distributionen.

location

string

platsen för distributionen.

name

string

Namnet på distributionen.

properties

DeploymentPropertiesExtended

Distributionsegenskaper.

tags

object

Distributionstaggar

type

string

Typ av distribution.

DeploymentMode

Läget som används för att distribuera resurser. Det här värdet kan vara antingen Inkrementellt eller Slutfört. I inkrementellt läge distribueras resurser utan att befintliga resurser som inte ingår i mallen tas bort. I fullständigt läge distribueras resurser och befintliga resurser i resursgruppen som inte ingår i mallen tas bort. Var försiktig när du använder läget Slutför eftersom du oavsiktligt kan ta bort resurser.

Name Typ Description
Complete

string

Incremental

string

DeploymentProperties

Distributionsegenskaper.

Name Typ Description
debugSetting

DebugSetting

Felsökningsinställningen för distributionen.

expressionEvaluationOptions

ExpressionEvaluationOptions

Anger om malluttryck utvärderas inom omfånget för den överordnade mallen eller den kapslade mallen. Gäller endast kapslade mallar. Om det inte anges är standardvärdet yttre.

mode

DeploymentMode

Läget som används för att distribuera resurser. Det här värdet kan vara antingen Inkrementellt eller Slutfört. I inkrementellt läge distribueras resurser utan att befintliga resurser som inte ingår i mallen tas bort. I fullständigt läge distribueras resurser och befintliga resurser i resursgruppen som inte ingår i mallen tas bort. Var försiktig när du använder läget Slutför eftersom du oavsiktligt kan ta bort resurser.

onErrorDeployment

OnErrorDeployment

Distributionen på felbeteende.

parameters

object

Namn- och värdepar som definierar distributionsparametrarna för mallen. Du använder det här elementet när du vill ange parametervärdena direkt i begäran i stället för att länka till en befintlig parameterfil. Använd antingen egenskapen parametersLink eller parameteregenskapen, men inte båda. Det kan vara en JObject- eller en välformulerad JSON-sträng.

parametersLink

ParametersLink

URI för parameterfilen. Du använder det här elementet för att länka till en befintlig parameterfil. Använd antingen egenskapen parametersLink eller parameteregenskapen, men inte båda.

template

object

Mallinnehållet. Du använder det här elementet när du vill skicka mallsyntaxen direkt i begäran i stället för att länka till en befintlig mall. Det kan vara en JObject- eller välformad JSON-sträng. Använd antingen egenskapen templateLink eller mallegenskapen, men inte båda.

templateLink

TemplateLink

URI:n för mallen. Använd antingen egenskapen templateLink eller mallegenskapen, men inte båda.

DeploymentPropertiesExtended

Distributionsegenskaper med ytterligare information.

Name Typ Description
correlationId

string

Korrelations-ID för distributionen.

debugSetting

DebugSetting

Felsökningsinställningen för distributionen.

dependencies

Dependency[]

Listan över distributionsberoenden.

duration

string

Varaktigheten för malldistributionen.

error

ErrorResponse

Felsvar
Distributionsfelet.

mode

DeploymentMode

Distributionsläget. Möjliga värden är Inkrementella och Slutför.

onErrorDeployment

OnErrorDeploymentExtended

Distributionen på felbeteende.

outputResources

ResourceReference[]

Matris med etablerade resurser.

outputs

object

Nyckel/värde-par som representerar distributionsutdata.

parameters

object

Distributionsparametrar.

parametersLink

ParametersLink

Den URI som refererar till parametrarna.

providers

Provider[]

Listan över resursprovidrar som behövs för distributionen.

provisioningState

ProvisioningState

Anger etableringsstatus.

templateHash

string

Den hash som skapats för mallen.

templateLink

TemplateLink

URI:n som refererar till mallen.

timestamp

string

Tidsstämpeln för malldistributionen.

validatedResources

ResourceReference[]

Matris med verifierade resurser.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Den ytterligare informationen.

type

string

Ytterligare informationstyp.

ErrorResponse

Felsvar

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorResponse[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ExpressionEvaluationOptions

Anger om malluttryck utvärderas inom omfånget för den överordnade mallen eller den kapslade mallen.

Name Typ Description
scope

ExpressionEvaluationOptionsScopeType

Omfånget som ska användas för utvärdering av parametrar, variabler och funktioner i en kapslad mall.

ExpressionEvaluationOptionsScopeType

Omfånget som ska användas för utvärdering av parametrar, variabler och funktioner i en kapslad mall.

Name Typ Description
Inner

string

NotSpecified

string

Outer

string

OnErrorDeployment

Distribution vid felbeteende.

Name Typ Description
deploymentName

string

Distributionen som ska användas i felfall.

type

OnErrorDeploymentType

Distributionen på felbeteendetypen. Möjliga värden är LastSuccessful och SpecificDeployment.

OnErrorDeploymentExtended

Distribution av felbeteende med ytterligare information.

Name Typ Description
deploymentName

string

Distributionen som ska användas i ett felfall.

provisioningState

string

Tillståndet för etableringen för vid feldistributionen.

type

OnErrorDeploymentType

Distributionen av felbeteendetypen. Möjliga värden är LastSuccessful och SpecificDeployment.

OnErrorDeploymentType

Distributionen på felbeteendetypen. Möjliga värden är LastSuccessful och SpecificDeployment.

Name Typ Description
LastSuccessful

string

SpecificDeployment

string

Entitet som representerar referensen till distributionsparametrarna.

Name Typ Description
contentVersion

string

Om den ingår måste den matcha ContentVersion i mallen.

uri

string

URI:n för parameterfilen.

Provider

Information om resursprovidern.

Name Typ Description
id

string

Provider-ID:t.

namespace

string

Resursproviderns namnområde.

providerAuthorizationConsentState

ProviderAuthorizationConsentState

Tillstånd för medgivande för providerauktorisering.

registrationPolicy

string

Resursproviderns registreringsprincip.

registrationState

string

Resursproviderns registreringstillstånd.

resourceTypes

ProviderResourceType[]

Insamling av providerresurstyper.

ProviderAuthorizationConsentState

Tillstånd för medgivande för providerauktorisering.

Name Typ Description
Consented

string

NotRequired

string

NotSpecified

string

Required

string

ProviderExtendedLocation

Providerns utökade plats.

Name Typ Description
extendedLocations

string[]

De utökade platserna för Azure-platsen.

location

string

Azure-platsen.

type

string

Den utökade platstypen.

ProviderResourceType

Resurstyp som hanteras av resursprovidern.

Name Typ Description
aliases

Alias[]

Alias som stöds av den här resurstypen.

apiProfiles

ApiProfile[]

API-profilerna för resursprovidern.

apiVersions

string[]

API-versionen.

capabilities

string

De ytterligare funktioner som erbjuds av den här resurstypen.

defaultApiVersion

string

Standard-API-versionen.

locationMappings

ProviderExtendedLocation[]

Platsmappningar som stöds av den här resurstypen.

locations

string[]

Samlingen med platser där den här resurstypen kan skapas.

properties

object

Egenskaperna.

resourceType

string

Resurstypen.

zoneMappings

ZoneMapping[]

ProvisioningState

Anger etableringsstatus.

Name Typ 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

Resurs-ID-modellen.

Name Typ Description
id

string

Det fullständigt kvalificerade resurs-ID:t.

Entitet som representerar referensen till mallen.

Name Typ Description
contentVersion

string

Om den ingår måste den matcha ContentVersion i mallen.

id

string

Resurs-ID för en mallspecifikation. Använd antingen id- eller uri-egenskapen, men inte båda.

queryString

string

Frågesträngen (till exempel en SAS-token) som ska användas med malllänkens URI.

relativePath

string

Egenskapen relativePath kan användas för att distribuera en länkad mall på en plats i förhållande till den överordnade. Om den överordnade mallen länkades till en TemplateSpec refererar detta till en artefakt i TemplateSpec. Om den överordnade var länkad till en URI är den underordnade distributionen en kombination av de överordnade och relativaPath-URI:erna

uri

string

URI:n för mallen som ska distribueras. Använd antingen egenskapen URI eller ID, men inte båda.

ZoneMapping

Name Typ Description
location

string

Platsen för zonmappningen.

zones

string[]