Deployments - Create Or Update At Tenant Scope
Kaynakları kiracı kapsamında dağıtır.
Şablonu ve parametreleri doğrudan istekte sağlayabilir veya JSON dosyalarına bağlanabilirsiniz.
PUT https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
Dağıtımın adı. Normal ifade deseni: |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
Name | Gerekli | Tür | Description |
---|---|---|---|
location | True |
string |
Dağıtım verilerini depolama konumu. |
properties | True |
Dağıtım özellikleri. |
|
tags |
object |
Dağıtım etiketleri |
Name | Tür | Description |
---|---|---|
200 OK |
Tamam - Sağlama durumu da dahil olmak üzere dağıtım hakkındaki bilgileri döndürür. |
|
201 Created |
Oluşturuldu - Sağlama durumu da dahil olmak üzere dağıtım hakkındaki bilgileri döndürür. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnek isteği
PUT https://management.azure.com/providers/Microsoft.Resources/deployments/tenant-dep01?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"
}
}
Örnek yanıt
{
"id": "/providers/Microsoft.Resources/deployments/tenant-dep01",
"name": "tenant-dep01",
"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.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
},
"tags": {
"tagKey1": "tag-value-1",
"tagKey2": "tag-value-2"
}
}
{
"id": "/providers/Microsoft.Resources/deployments/tenant-dep01",
"name": "tenant-dep01",
"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.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
},
"tags": {
"tagKey1": "tag-value-1",
"tagKey2": "tag-value-2"
}
}
Name | Description |
---|---|
Alias |
Diğer ad türü. |
Alias |
Diğer ad için yolların türü. |
Alias |
Diğer ad yolunun başvurduğunu belirtecin öznitelikleri. |
Alias |
|
Alias |
Diğer ad yolunun başvurduğunu belirtecin türü. |
Alias |
Diğer ad yolu için desenin türü. |
Alias |
Diğer ad deseninin türü |
Alias |
Diğer adın türü. |
Api |
|
Basic |
Dağıtım bağımlılığı bilgileri. |
Cloud |
Kaynak yönetimi isteği için hata yanıtı. |
Debug |
Hata ayıklama ayarı. |
Dependency |
Dağıtım bağımlılığı bilgileri. |
Deployment |
Dağıtım bilgileri. |
Deployment |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil olmayan mevcut kaynaklar silinir. Kaynakları istemeden sildiğinizden, Tamamlama modunu kullanırken dikkatli olun. |
Deployment |
Dağıtım özellikleri. |
Deployment |
Ek ayrıntılarla birlikte dağıtım özellikleri. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata Yanıtı |
Expression |
Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe yerleştirilmiş şablon kapsamında mı değerlendirildiğini belirtir. |
Expression |
İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam. |
On |
Hata davranışında dağıtım. |
On |
Ek ayrıntılarla birlikte hata davranışında dağıtım. |
On |
Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir. |
Parameters |
Dağıtım parametrelerine başvuruyu temsil eden varlık. |
Provider |
Kaynak sağlayıcısı bilgileri. |
Provider |
Sağlayıcı yetkilendirme onayı durumu. |
Provider |
Sağlayıcının genişletilmiş konumu. |
Provider |
Kaynak sağlayıcısı tarafından yönetilen kaynak türü. |
Provisioning |
Sağlama durumunu belirtir. |
Resource |
Kaynak kimliği modeli. |
Scoped |
Dağıtım işlemi parametreleri. |
Template |
Şablon başvuruyu temsil eden varlık. |
Zone |
Diğer ad türü.
Name | Tür | Description |
---|---|---|
defaultMetadata |
Varsayılan diğer ad yolu meta verileri. Varsayılan yol ve meta veri içermeyen diğer ad yolları için geçerlidir |
|
defaultPath |
string |
Diğer ad için varsayılan yol. |
defaultPattern |
Diğer ad için varsayılan desen. |
|
name |
string |
Diğer ad. |
paths |
Diğer adın yolları. |
|
type |
Diğer adın türü. |
Diğer ad için yolların türü.
Name | Tür | Description |
---|---|---|
apiVersions |
string[] |
API sürümleri. |
metadata |
Diğer ad yolunun meta verileri. Eksikse diğer adın varsayılan meta verilerine geri dönün. |
|
path |
string |
Diğer adın yolu. |
pattern |
Diğer ad yolunun deseni. |
Diğer ad yolunun başvurduğunu belirtecin öznitelikleri.
Name | Tür | Description |
---|---|---|
Modifiable |
string |
Diğer ad yolunun başvurduğunu belirteç, 'modify' etkisine sahip ilkeler tarafından değiştirilebilir. |
None |
string |
Diğer ad yolunun başvurduğunu belirtecin özniteliği yok. |
Name | Tür | Description |
---|---|---|
attributes |
Diğer ad yolunun başvurduğunu belirtecin öznitelikleri. |
|
type |
Diğer ad yolunun başvurduğunu belirtecin türü. |
Diğer ad yolunun başvurduğunu belirtecin türü.
Name | Tür | Description |
---|---|---|
Any |
string |
Belirteç türü herhangi bir şey olabilir. |
Array |
string |
Belirteç türü dizidir. |
Boolean |
string |
Belirteç türü boole şeklindedir. |
Integer |
string |
Belirteç türü tamsayıdır. |
NotSpecified |
string |
Belirteç türü belirtilmemiş. |
Number |
string |
Belirteç türü sayıdır. |
Object |
string |
Belirteç türü nesnedir. |
String |
string |
Belirteç türü dizedir. |
Diğer ad yolu için desenin türü.
Name | Tür | Description |
---|---|---|
phrase |
string |
Diğer ad deseni tümceciği. |
type |
Diğer ad deseninin türü |
|
variable |
string |
Diğer ad desen değişkeni. |
Diğer ad deseninin türü
Name | Tür | Description |
---|---|---|
Extract |
string |
Ayıkla, izin verilen tek değerdir. |
NotSpecified |
string |
NotSpecified'e izin verilmiyor. |
Diğer adın türü.
Name | Tür | Description |
---|---|---|
Mask |
string |
Diğer ad değeri gizlidir. |
NotSpecified |
string |
Diğer ad türü bilinmiyor (diğer ad türü sağlamamayla aynıdır). |
PlainText |
string |
Diğer ad değeri gizli değil. |
Name | Tür | Description |
---|---|---|
apiVersion |
string |
API sürümü. |
profileVersion |
string |
Profil sürümü. |
Dağıtım bağımlılığı bilgileri.
Name | Tür | Description |
---|---|---|
id |
string |
Bağımlılığın kimliği. |
resourceName |
string |
Bağımlılık kaynak adı. |
resourceType |
string |
Bağımlılık kaynak türü. |
Kaynak yönetimi isteği için hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı |
Hata ayıklama ayarı.
Name | Tür | Description |
---|---|---|
detailLevel |
string |
Hata ayıklama için günlüğe kaydedilecek bilgi türünü belirtir. İzin verilen değerler hiçbiri, requestContent, responseContent veya virgülle ayrılmış requestContent ve responseContent değerleridir. Varsayılan değer none'dır. Bu değeri ayarlarken, dağıtım sırasında geçirdiğiniz bilgi türünü dikkatle göz önünde bulundurun. İstek veya yanıt hakkındaki bilgileri günlüğe kaydederek, dağıtım işlemleri aracılığıyla alınan hassas verileri potansiyel olarak kullanıma açabilirsiniz. |
Dağıtım bağımlılığı bilgileri.
Name | Tür | Description |
---|---|---|
dependsOn |
Bağımlılık listesi. |
|
id |
string |
Bağımlılığın kimliği. |
resourceName |
string |
Bağımlılık kaynak adı. |
resourceType |
string |
Bağımlılık kaynak türü. |
Dağıtım bilgileri.
Name | Tür | Description |
---|---|---|
id |
string |
Dağıtımın kimliği. |
location |
string |
dağıtımın konumu. |
name |
string |
Dağıtımın adı. |
properties |
Dağıtım özellikleri. |
|
tags |
object |
Dağıtım etiketleri |
type |
string |
Dağıtımın türü. |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil olmayan mevcut kaynaklar silinir. Kaynakları istemeden sildiğinizden, Tamamlama modunu kullanırken dikkatli olun.
Name | Tür | Description |
---|---|---|
Complete |
string |
|
Incremental |
string |
Dağıtım özellikleri.
Name | Tür | Description |
---|---|---|
debugSetting |
Dağıtımın hata ayıklama ayarı. |
|
expressionEvaluationOptions |
Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe yerleştirilmiş şablon kapsamında mı değerlendirildiğini belirtir. Yalnızca iç içe yerleştirilmiş şablonlar için geçerlidir. Belirtilmezse, varsayılan değer dıştır. |
|
mode |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil olmayan mevcut kaynaklar silinir. Kaynakları istemeden sildiğinizden, Tamamlama modunu kullanırken dikkatli olun. |
|
onErrorDeployment |
Hata davranışında dağıtım. |
|
parameters |
object |
Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini varolan bir parametre dosyasına bağlamak yerine doğrudan istekte sağlamak istediğinizde bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. Bu bir JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. |
parametersLink |
Parametre dosyasının URI'sini. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. |
|
template |
object |
Şablon içeriği. Şablon söz dizimini varolan bir şablona bağlamak yerine doğrudan istekte geçirmek istediğinizde bu öğeyi kullanırsınız. JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. templateLink özelliğini veya template özelliğini kullanın, ancak ikisini birden kullanmayın. |
templateLink |
Şablonun URI'si. templateLink özelliğini veya template özelliğini kullanın, ancak ikisini birden kullanmayın. |
Ek ayrıntılarla birlikte dağıtım özellikleri.
Name | Tür | Description |
---|---|---|
correlationId |
string |
Dağıtımın bağıntı kimliği. |
debugSetting |
Dağıtımın hata ayıklama ayarı. |
|
dependencies |
Dağıtım bağımlılıklarının listesi. |
|
duration |
string |
Şablon dağıtımının süresi. |
error |
Hata Yanıtı |
|
mode |
Dağıtım modu. Olası değerler Artımlı ve Tamamlandı'dır. |
|
onErrorDeployment |
Hata davranışında dağıtım. |
|
outputResources |
Sağlanan kaynak dizisi. |
|
outputs |
object |
Dağıtım çıkışını temsil eden anahtar/değer çiftleri. |
parameters |
object |
Dağıtım parametreleri. |
parametersLink |
Parametrelere başvuran URI. |
|
providers |
Provider[] |
Dağıtım için gereken kaynak sağlayıcılarının listesi. |
provisioningState |
Sağlama durumunu belirtir. |
|
templateHash |
string |
Şablon için oluşturulan karma. |
templateLink |
Şablona başvuran URI. |
|
timestamp |
string |
Şablon dağıtımının zaman damgası. |
validatedResources |
Doğrulanmış kaynak dizisi. |
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
Hata Yanıtı
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe yerleştirilmiş şablon kapsamında mı değerlendirildiğini belirtir.
Name | Tür | Description |
---|---|---|
scope |
İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam. |
İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam.
Name | Tür | Description |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
Hata davranışında dağıtım.
Name | Tür | Description |
---|---|---|
deploymentName |
string |
Hata durumunda kullanılacak dağıtım. |
type |
Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir. |
Ek ayrıntılarla birlikte hata davranışında dağıtım.
Name | Tür | Description |
---|---|---|
deploymentName |
string |
Hata durumunda kullanılacak dağıtım. |
provisioningState |
string |
Hata dağıtımında için sağlamanın durumu. |
type |
Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir. |
Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.
Name | Tür | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
Dağıtım parametrelerine başvuruyu temsil eden varlık.
Name | Tür | Description |
---|---|---|
contentVersion |
string |
Varsa, şablondaki ContentVersion ile eşleşmelidir. |
uri |
string |
Parametre dosyasının URI'sini. |
Kaynak sağlayıcısı bilgileri.
Name | Tür | Description |
---|---|---|
id |
string |
Sağlayıcı kimliği. |
namespace |
string |
Kaynak sağlayıcısının ad alanı. |
providerAuthorizationConsentState |
Sağlayıcı yetkilendirme onayı durumu. |
|
registrationPolicy |
string |
Kaynak sağlayıcısının kayıt ilkesi. |
registrationState |
string |
Kaynak sağlayıcısının kayıt durumu. |
resourceTypes |
Sağlayıcı kaynak türlerinin koleksiyonu. |
Sağlayıcı yetkilendirme onayı durumu.
Name | Tür | Description |
---|---|---|
Consented |
string |
|
NotRequired |
string |
|
NotSpecified |
string |
|
Required |
string |
Sağlayıcının genişletilmiş konumu.
Name | Tür | Description |
---|---|---|
extendedLocations |
string[] |
Azure konumu için genişletilmiş konumlar. |
location |
string |
Azure konumu. |
type |
string |
Genişletilmiş konum türü. |
Kaynak sağlayıcısı tarafından yönetilen kaynak türü.
Name | Tür | Description |
---|---|---|
aliases |
Alias[] |
Bu kaynak türü tarafından desteklenen diğer adlar. |
apiProfiles |
Kaynak sağlayıcısı için API profilleri. |
|
apiVersions |
string[] |
API sürümü. |
capabilities |
string |
Bu kaynak türü tarafından sunulan ek özellikler. |
defaultApiVersion |
string |
Varsayılan API sürümü. |
locationMappings |
Bu kaynak türü tarafından desteklenen konum eşlemeleri. |
|
locations |
string[] |
Bu kaynak türünün oluşturulabileceği konumların koleksiyonu. |
properties |
object |
Özellikleri. |
resourceType |
string |
Kaynak türü. |
zoneMappings |
Sağlama durumunu belirtir.
Name | Tür | 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 |
Kaynak kimliği modeli.
Name | Tür | Description |
---|---|---|
id |
string |
Tam kaynak kimliği. |
Dağıtım işlemi parametreleri.
Name | Tür | Description |
---|---|---|
location |
string |
Dağıtım verilerini depolama konumu. |
properties |
Dağıtım özellikleri. |
|
tags |
object |
Dağıtım etiketleri |
Şablon başvuruyu temsil eden varlık.
Name | Tür | Description |
---|---|---|
contentVersion |
string |
Varsa, şablondaki ContentVersion ile eşleşmelidir. |
id |
string |
Şablon Belirtiminin kaynak kimliği. Kimlik veya uri özelliğini kullanın, ancak ikisini birden kullanmayın. |
queryString |
string |
templateLink URI'siyle kullanılacak sorgu dizesi (örneğin, sas belirteci). |
relativePath |
string |
relativePath özelliği, bağlı şablonu üst öğeye göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa, bu şablon TemplateSpec'teki bir yapıta başvurur. Üst öğe bir URI ile bağlantılıysa, alt dağıtım üst ve relativePath URI'lerinin bir bileşimi olacaktır |
uri |
string |
Dağıtılacak şablonun URI'si. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın. |
Name | Tür | Description |
---|---|---|
location |
string |
Bölge eşlemesinin konumu. |
zones |
string[] |