Deployments - Create Or Update At Subscription Scope
Erőforrásokat helyez üzembe az előfizetés hatókörében.
A sablont és a paramétereket közvetlenül a kérelemben vagy a JSON-fájlokra mutató hivatkozásban adhatja meg.
PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
Az üzembe helyezés neve. Reguláris kifejezési minta: |
subscription
|
path | True |
string |
A Microsoft Azure-előfizetés azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
properties | True |
Az üzembehelyezési tulajdonságok. |
|
location |
string |
Az üzembehelyezési adatok tárolásának helye. |
|
tags |
object |
Üzembehelyezési címkék |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK – Az üzembe helyezéssel kapcsolatos információkat adja vissza, beleértve a kiépítési állapotot is. |
|
201 Created |
Létrehozva – Az üzembe helyezéssel kapcsolatos információkat adja vissza, beleértve a kiépítési állapotot is. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
Create a deployment that will deploy a templateSpec with the given resourceId
Mintakérelem
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"
}
}
Mintaválasz
{
"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": []
}
}
Definíciók
Name | Description |
---|---|
Alias |
Az alias típusa. |
Alias |
Az alias elérési útjainak típusa. |
Alias |
Annak a jogkivonatnak az attribútumai, amelyekre az alias elérési útja hivatkozik. |
Alias |
|
Alias |
Annak a jogkivonatnak a típusa, amelyekre az alias elérési útja hivatkozik. |
Alias |
Az alias elérési útjának mintájának típusa. |
Alias |
Az aliasminta típusa |
Alias |
Az alias típusa. |
Api |
|
Basic |
Üzembehelyezési függőségi információk. |
Cloud |
Hibaválasz egy erőforrás-kezelési kérelemhez. |
Debug |
A hibakeresési beállítás. |
Dependency |
Üzembehelyezési függőségi információk. |
Deployment |
Üzembehelyezési művelet paraméterei. |
Deployment |
Üzembe helyezési információk. |
Deployment |
Az erőforrások üzembe helyezéséhez használt mód. Ez az érték növekményes vagy befejezett lehet. Növekményes módban az erőforrások a sablonban nem szereplő meglévő erőforrások törlése nélkül lesznek üzembe helyezve. Teljes módban az erőforrások üzembe lesznek helyezve, és a sablonban nem szereplő erőforráscsoportban lévő meglévő erőforrások törlődnek. Legyen óvatos a Teljes mód használata során, mivel előfordulhat, hogy véletlenül törli az erőforrásokat. |
Deployment |
Üzembehelyezési tulajdonságok. |
Deployment |
Üzembehelyezési tulajdonságok további részletekkel. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
Hibaválasz |
Expression |
Meghatározza, hogy a sablonkifejezések kiértékelése a szülősablon vagy a beágyazott sablon hatókörén belül történik-e. |
Expression |
A paraméterek, változók és függvények beágyazott sablonban való kiértékeléséhez használandó hatókör. |
On |
Üzembe helyezés hiba működés közben. |
On |
Üzembe helyezés hibaviselkedés esetén további részletekkel. |
On |
Az üzembe helyezés hibaviselkedési típuson. Lehetséges értékek: LastSuccessful és SpecificDeployment. |
Parameters |
Az üzembehelyezési paraméterekre mutató hivatkozást képviselő entitás. |
Provider |
Erőforrás-szolgáltató adatai. |
Provider |
A szolgáltató engedélyezési hozzájárulási állapota. |
Provider |
A szolgáltató kiterjesztett helye. |
Provider |
Az erőforrás-szolgáltató által kezelt erőforrástípus. |
Provisioning |
A kiépítés állapotát jelöli. |
Resource |
Az erőforrás-azonosító modellje. |
Template |
A sablonra mutató hivatkozást képviselő entitás. |
Zone |
Alias
Az alias típusa.
Name | Típus | Description |
---|---|---|
defaultMetadata |
Az alapértelmezett aliaselérési út metaadatai. Az alapértelmezett elérési útra és minden olyan aliasútvonalra vonatkozik, amely nem rendelkezik metaadatokkal |
|
defaultPath |
string |
Az alias alapértelmezett elérési útja. |
defaultPattern |
Az alias alapértelmezett mintája. |
|
name |
string |
Az alias neve. |
paths |
Egy alias elérési útjai. |
|
type |
Az alias típusa. |
AliasPath
Az alias elérési útjainak típusa.
Name | Típus | Description |
---|---|---|
apiVersions |
string[] |
Az API-verziók. |
metadata |
Az alias elérési útjának metaadatai. Ha hiányzik, térjen vissza az alias alapértelmezett metaadataira. |
|
path |
string |
Egy alias elérési útja. |
pattern |
Az alias elérési útjának mintája. |
AliasPathAttributes
Annak a jogkivonatnak az attribútumai, amelyekre az alias elérési útja hivatkozik.
Name | Típus | Description |
---|---|---|
Modifiable |
string |
Az alias elérési útja által hivatkozott jogkivonat módosítható a "módosítás" effektusú szabályzatokkal. |
None |
string |
Az alias elérési útja által hivatkozott tokennek nincsenek attribútumai. |
AliasPathMetadata
Name | Típus | Description |
---|---|---|
attributes |
Annak a jogkivonatnak az attribútumai, amelyekre az alias elérési útja hivatkozik. |
|
type |
Annak a jogkivonatnak a típusa, amelyekre az alias elérési útja hivatkozik. |
AliasPathTokenType
Annak a jogkivonatnak a típusa, amelyekre az alias elérési útja hivatkozik.
Name | Típus | Description |
---|---|---|
Any |
string |
A jogkivonat típusa bármi lehet. |
Array |
string |
A jogkivonat típusa tömb. |
Boolean |
string |
A jogkivonat típusa logikai. |
Integer |
string |
A token típusa egész szám. |
NotSpecified |
string |
A jogkivonat típusa nincs megadva. |
Number |
string |
A jogkivonat típusa szám. |
Object |
string |
A jogkivonat típusa objektum. |
String |
string |
A jogkivonat típusa sztring. |
AliasPattern
Az alias elérési útjának mintájának típusa.
Name | Típus | Description |
---|---|---|
phrase |
string |
Az alias mintakifejezés. |
type |
Az aliasminta típusa |
|
variable |
string |
Az alias mintaváltozója. |
AliasPatternType
Az aliasminta típusa
Name | Típus | Description |
---|---|---|
Extract |
string |
A kivonat az egyetlen engedélyezett érték. |
NotSpecified |
string |
A NotSpecified nem engedélyezett. |
AliasType
Az alias típusa.
Name | Típus | Description |
---|---|---|
Mask |
string |
Az alias értéke titkos. |
NotSpecified |
string |
Az alias típusa ismeretlen (ugyanaz, mintha nem ad meg aliastípust). |
PlainText |
string |
Az alias értéke nem titkos. |
ApiProfile
Name | Típus | Description |
---|---|---|
apiVersion |
string |
Az API verziója. |
profileVersion |
string |
A profil verziója. |
BasicDependency
Üzembehelyezési függőségi információk.
Name | Típus | Description |
---|---|---|
id |
string |
A függőség azonosítója. |
resourceName |
string |
A függőségi erőforrás neve. |
resourceType |
string |
A függőségi erőforrás típusa. |
CloudError
Hibaválasz egy erőforrás-kezelési kérelemhez.
Name | Típus | Description |
---|---|---|
error |
Hibaválasz |
DebugSetting
A hibakeresési beállítás.
Name | Típus | Description |
---|---|---|
detailLevel |
string |
Megadja a hibakereséshez naplózandó információk típusát. Az engedélyezett értékek: requestContent, responseContent vagy requestContent és responseContent vesszővel elválasztva. Az alapértelmezett érték a none. Az érték beállításakor gondosan vegye figyelembe, hogy milyen típusú információkat ad át az üzembe helyezés során. A kéréssel vagy válaszsal kapcsolatos információk naplózásával potenciálisan bizalmas adatokat tehet közzé, amelyeket az üzembehelyezési műveletek során kérnek le. |
Dependency
Üzembehelyezési függőségi információk.
Name | Típus | Description |
---|---|---|
dependsOn |
A függőségek listája. |
|
id |
string |
A függőség azonosítója. |
resourceName |
string |
A függőségi erőforrás neve. |
resourceType |
string |
A függőségi erőforrás típusa. |
Deployment
Üzembehelyezési művelet paraméterei.
Name | Típus | Description |
---|---|---|
location |
string |
Az üzembehelyezési adatok tárolásának helye. |
properties |
Az üzembehelyezési tulajdonságok. |
|
tags |
object |
Üzembehelyezési címkék |
DeploymentExtended
Üzembe helyezési információk.
Name | Típus | Description |
---|---|---|
id |
string |
Az üzembe helyezés azonosítója. |
location |
string |
az üzembe helyezés helye. |
name |
string |
Az üzembe helyezés neve. |
properties |
Üzembehelyezési tulajdonságok. |
|
tags |
object |
Üzembehelyezési címkék |
type |
string |
Az üzembe helyezés típusa. |
DeploymentMode
Az erőforrások üzembe helyezéséhez használt mód. Ez az érték növekményes vagy befejezett lehet. Növekményes módban az erőforrások a sablonban nem szereplő meglévő erőforrások törlése nélkül lesznek üzembe helyezve. Teljes módban az erőforrások üzembe lesznek helyezve, és a sablonban nem szereplő erőforráscsoportban lévő meglévő erőforrások törlődnek. Legyen óvatos a Teljes mód használata során, mivel előfordulhat, hogy véletlenül törli az erőforrásokat.
Name | Típus | Description |
---|---|---|
Complete |
string |
|
Incremental |
string |
DeploymentProperties
Üzembehelyezési tulajdonságok.
Name | Típus | Description |
---|---|---|
debugSetting |
Az üzembe helyezés hibakeresési beállítása. |
|
expressionEvaluationOptions |
Meghatározza, hogy a sablonkifejezések kiértékelése a szülősablon vagy a beágyazott sablon hatókörén belül történik-e. Csak beágyazott sablonokra alkalmazható. Ha nincs megadva, az alapértelmezett érték külső. |
|
mode |
Az erőforrások üzembe helyezéséhez használt mód. Ez az érték növekményes vagy befejezett lehet. Növekményes módban az erőforrások a sablonban nem szereplő meglévő erőforrások törlése nélkül lesznek üzembe helyezve. Teljes módban az erőforrások üzembe lesznek helyezve, és a sablonban nem szereplő erőforráscsoportban lévő meglévő erőforrások törlődnek. Legyen óvatos a Teljes mód használata során, mivel előfordulhat, hogy véletlenül törli az erőforrásokat. |
|
onErrorDeployment |
A hiba működésével kapcsolatos üzembe helyezés. |
|
parameters |
object |
Név- és értékpárok, amelyek meghatározzák a sablon üzembehelyezési paramétereit. Ezt az elemet akkor használja, ha közvetlenül a kérelemben szeretné megadni a paraméterértékeket, nem pedig egy meglévő paraméterfájlra mutató hivatkozást. Használja a parametersLink tulajdonságot vagy a parameters tulajdonságot, de mindkettőt nem. Ez lehet JObject vagy jól formázott JSON-sztring. |
parametersLink |
A paraméterfájl URI-ja. Ezzel az elemel hivatkozhat egy meglévő paraméterfájlra. Használja a parametersLink tulajdonságot vagy a parameters tulajdonságot, de mindkettőt nem. |
|
template |
object |
A sablon tartalma. Ezt az elemet akkor használja, ha a sablon szintaxisát közvetlenül a kérelemben szeretné átadni, nem pedig egy meglévő sablonra mutató hivatkozást. Ez lehet JObject vagy jól formázott JSON-sztring. Használja a templateLink tulajdonságot vagy a sablontulajdonságot, de mindkettőt nem. |
templateLink |
A sablon URI-ja. Használja a templateLink tulajdonságot vagy a sablontulajdonságot, de mindkettőt nem. |
DeploymentPropertiesExtended
Üzembehelyezési tulajdonságok további részletekkel.
Name | Típus | Description |
---|---|---|
correlationId |
string |
Az üzembe helyezés korrelációs azonosítója. |
debugSetting |
Az üzembe helyezés hibakeresési beállítása. |
|
dependencies |
Az üzembehelyezési függőségek listája. |
|
duration |
string |
A sablon üzembe helyezésének időtartama. |
error |
Hibaválasz |
|
mode |
Az üzembehelyezési mód. A lehetséges értékek növekményesek és készek. |
|
onErrorDeployment |
A hiba működésével kapcsolatos üzembe helyezés. |
|
outputResources |
Kiépített erőforrások tömbje. |
|
outputs |
object |
Az üzembehelyezési kimenetet jelképező kulcs-/értékpárok. |
parameters |
object |
Üzembehelyezési paraméterek. |
parametersLink |
A paraméterekre hivatkozó URI. |
|
providers |
Provider[] |
Az üzembe helyezéshez szükséges erőforrás-szolgáltatók listája. |
provisioningState |
A kiépítés állapotát jelöli. |
|
templateHash |
string |
A sablonhoz létrehozott kivonat. |
templateLink |
A sablonra hivatkozó URI. |
|
timestamp |
string |
A sablon üzembe helyezésének időbélyege. |
validatedResources |
Ellenőrzött erőforrások tömbje. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további adattípus. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ExpressionEvaluationOptions
Meghatározza, hogy a sablonkifejezések kiértékelése a szülősablon vagy a beágyazott sablon hatókörén belül történik-e.
Name | Típus | Description |
---|---|---|
scope |
A paraméterek, változók és függvények beágyazott sablonban való kiértékeléséhez használandó hatókör. |
ExpressionEvaluationOptionsScopeType
A paraméterek, változók és függvények beágyazott sablonban való kiértékeléséhez használandó hatókör.
Name | Típus | Description |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
OnErrorDeployment
Üzembe helyezés hiba működés közben.
Name | Típus | Description |
---|---|---|
deploymentName |
string |
A hibaesetben használni kívánt üzembe helyezés. |
type |
Az üzembe helyezés hibaviselkedési típuson. Lehetséges értékek: LastSuccessful és SpecificDeployment. |
OnErrorDeploymentExtended
Üzembe helyezés hibaviselkedés esetén további részletekkel.
Name | Típus | Description |
---|---|---|
deploymentName |
string |
A hibaesetben használandó üzembe helyezés. |
provisioningState |
string |
A hibaalapú üzembe helyezés kiépítésének állapota. |
type |
Az üzembe helyezés hibaviselkedési típuson. Lehetséges értékek: LastSuccessful és SpecificDeployment. |
OnErrorDeploymentType
Az üzembe helyezés hibaviselkedési típuson. Lehetséges értékek: LastSuccessful és SpecificDeployment.
Name | Típus | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
ParametersLink
Az üzembehelyezési paraméterekre mutató hivatkozást képviselő entitás.
Name | Típus | Description |
---|---|---|
contentVersion |
string |
Ha szerepel a fájlban, meg kell egyeznie a sablon ContentVersion elemével. |
uri |
string |
A paraméterfájl URI-ja. |
Provider
Erőforrás-szolgáltató adatai.
Name | Típus | Description |
---|---|---|
id |
string |
A szolgáltató azonosítója. |
namespace |
string |
Az erőforrás-szolgáltató névtere. |
providerAuthorizationConsentState |
A szolgáltató engedélyezési hozzájárulási állapota. |
|
registrationPolicy |
string |
Az erőforrás-szolgáltató regisztrációs szabályzata. |
registrationState |
string |
Az erőforrás-szolgáltató regisztrációs állapota. |
resourceTypes |
A szolgáltatói erőforrástípusok gyűjteménye. |
ProviderAuthorizationConsentState
A szolgáltató engedélyezési hozzájárulási állapota.
Name | Típus | Description |
---|---|---|
Consented |
string |
|
NotRequired |
string |
|
NotSpecified |
string |
|
Required |
string |
ProviderExtendedLocation
A szolgáltató kiterjesztett helye.
Name | Típus | Description |
---|---|---|
extendedLocations |
string[] |
Az Azure-hely kiterjesztett helyei. |
location |
string |
Az Azure helye. |
type |
string |
A kiterjesztett hely típusa. |
ProviderResourceType
Az erőforrás-szolgáltató által kezelt erőforrástípus.
Name | Típus | Description |
---|---|---|
aliases |
Alias[] |
Az ilyen erőforrástípus által támogatott aliasok. |
apiProfiles |
Az erőforrás-szolgáltató API-profiljai. |
|
apiVersions |
string[] |
Az API verziója. |
capabilities |
string |
Az erőforrástípus által kínált további képességek. |
defaultApiVersion |
string |
Az ALAPÉRTELMEZETT API-verzió. |
locationMappings |
Az erőforrástípus által támogatott helyleképezések. |
|
locations |
string[] |
Azon helyek gyűjteménye, ahol ez az erőforrástípus létrehozható. |
properties |
object |
A tulajdonságok. |
resourceType |
string |
Az erőforrás típusa. |
zoneMappings |
ProvisioningState
A kiépítés állapotát jelöli.
Name | Típus | 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
Az erőforrás-azonosító modellje.
Name | Típus | Description |
---|---|---|
id |
string |
A teljes erőforrás-azonosító. |
TemplateLink
A sablonra mutató hivatkozást képviselő entitás.
Name | Típus | Description |
---|---|---|
contentVersion |
string |
Ha szerepel a fájlban, meg kell egyeznie a sablon ContentVersion elemével. |
id |
string |
Egy sablonspecifikáció erőforrás-azonosítója. Használja az id vagy az uri tulajdonságot, de mindkettőt nem. |
queryString |
string |
A templateLink URI-val használandó lekérdezési sztring (például SAS-jogkivonat). |
relativePath |
string |
A relativePath tulajdonság használatával a szülőhöz viszonyított helyen helyezhet üzembe csatolt sablont. Ha a szülősablon egy TemplateSpec elemhez lett csatolva, az a TemplateSpec elemére fog hivatkozni. Ha a szülő URI-val lett összekapcsolva, a gyermek üzembe helyezése a szülő és a relatívPath URI-k kombinációja lesz |
uri |
string |
Az üzembe helyezendő sablon URI-ja. Használja az uri vagy az id tulajdonságot, de mindkettőt nem. |
ZoneMapping
Name | Típus | Description |
---|---|---|
location |
string |
A zónaleképezés helye. |
zones |
string[] |