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
URI Parametreleri
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ü. |
İstek Gövdesi
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 |
Yanıtlar
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ı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
Create deployment at tenant scope.
Ö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"
}
}
Tanımlar
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 |
Alias
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ü. |
AliasPath
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. |
AliasPathAttributes
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. |
AliasPathMetadata
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ü. |
AliasPathTokenType
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. |
AliasPattern
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. |
AliasPatternType
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. |
AliasType
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. |
ApiProfile
Name | Tür | Description |
---|---|---|
apiVersion |
string |
API sürümü. |
profileVersion |
string |
Profil sürümü. |
BasicDependency
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ü. |
CloudError
Kaynak yönetimi isteği için hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı |
DebugSetting
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. |
Dependency
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ü. |
DeploymentExtended
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ü. |
DeploymentMode
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 |
DeploymentProperties
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. |
DeploymentPropertiesExtended
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. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorResponse
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. |
ExpressionEvaluationOptions
Ş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. |
ExpressionEvaluationOptionsScopeType
İç 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 |
OnErrorDeployment
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. |
OnErrorDeploymentExtended
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. |
OnErrorDeploymentType
Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.
Name | Tür | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
ParametersLink
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. |
Provider
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. |
ProviderAuthorizationConsentState
Sağlayıcı yetkilendirme onayı durumu.
Name | Tür | Description |
---|---|---|
Consented |
string |
|
NotRequired |
string |
|
NotSpecified |
string |
|
Required |
string |
ProviderExtendedLocation
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ü. |
ProviderResourceType
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 |
ProvisioningState
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 |
ResourceReference
Kaynak kimliği modeli.
Name | Tür | Description |
---|---|---|
id |
string |
Tam kaynak kimliği. |
ScopedDeployment
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 |
TemplateLink
Ş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. |
ZoneMapping
Name | Tür | Description |
---|---|---|
location |
string |
Bölge eşlemesinin konumu. |
zones |
string[] |