Aracılığıyla paylaş


Deployment Stacks - List At Management Group

Belirtilen kapsamdaki Dağıtım yığınlarını listeler.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks?api-version=2022-08-01-preview

URI Parametreleri

Name İçinde Gerekli Tür Description
managementGroupId
path True

string

minLength: 1

Yönetim grubu kimliği.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK

DeploymentStackListResult

Azure işlemi başarıyla tamamlandı.

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı.

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

List management group Deployment stacks

Örnek isteği

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks?api-version=2022-08-01-preview

Örnek yanıt

{
  "value": [
    {
      "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/simpleDeploymentStack",
      "type": "Microsoft.Resources/deploymentStacks",
      "name": "simpleDeploymentStack",
      "location": "eastus",
      "tags": {
        "tagkey": "tagVal"
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "Application",
        "createdAt": "2020-02-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
      },
      "properties": {
        "actionOnUnmanage": {
          "resources": "delete",
          "resourceGroups": "delete",
          "managementGroups": "detach"
        },
        "denySettings": {
          "mode": "denyDelete",
          "excludedPrincipals": [
            "principal"
          ],
          "excludedActions": [
            "action"
          ],
          "applyToChildScopes": false
        },
        "parameters": {
          "parameter1": {
            "value": "a string"
          }
        },
        "outputs": {
          "myOut": "myVal"
        },
        "duration": "PT1D12H"
      }
    },
    {
      "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/simpleDeploymentStack2",
      "type": "Microsoft.Resources/deploymentStacks",
      "name": "simpleDeploymentStack2",
      "location": "eastus",
      "tags": {
        "tagkey": "tagVal"
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "Application",
        "createdAt": "2020-02-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
      },
      "properties": {
        "deploymentId": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deployments/simpleDeploymentStack2-20210301-3f41c",
        "provisioningState": "SucceededWithFailures",
        "resources": [
          {
            "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/templateSpecs/templateSpec/versions/1.0",
            "status": "managed",
            "denyStatus": "denyDelete"
          },
          {
            "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
            "status": "managed",
            "denyStatus": "denyDelete"
          }
        ],
        "actionOnUnmanage": {
          "resources": "delete",
          "resourceGroups": "delete",
          "managementGroups": "detach"
        },
        "denySettings": {
          "mode": "denyDelete",
          "excludedPrincipals": [
            "principal"
          ],
          "excludedActions": [
            "action"
          ],
          "applyToChildScopes": false
        },
        "parameters": {
          "parameter1": {
            "value": "a string"
          }
        },
        "outputs": {
          "myOut": "myVal"
        },
        "duration": "PT1D12H"
      }
    }
  ]
}

Tanımlar

Name Description
ActionOnUnmanage

Yığın güncelleştirildikten veya silindikten sonra artık yönetilmeyen kaynakların davranışını tanımlar.

createdByType

Kaynağı oluşturan kimliğin türü.

DenySettings

Dağıtım yığını tarafından dağıtılan kaynakların nasıl kilitleneceğini tanımlar.

DenySettingsMode

denySettings Reddedilen eylemleri tanımlayan mod.

DenyStatusMode

kaynağa uygulanan denyAssignment ayarları.

DeploymentParameter

Şablon için dağıtım parametresi.

DeploymentStack

Dağıtım yığını nesnesi.

DeploymentStackListResult

DeploymentStack liste işleminin yanıtı.

DeploymentStackProvisioningState

Dağıtım yığınının durumu.

DeploymentStacksDebugSetting

Hata ayıklama ayarı.

DeploymentStacksParametersLink

Dağıtım parametrelerine başvuruyu temsil eden varlık.

DeploymentStacksTemplateLink

Şablon başvuruyu temsil eden varlık.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

KeyVaultParameterReference

Azure Key Vault parametre başvurusu.

KeyVaultReference

Azure Key Vault başvurusu.

ManagedResourceReference

Yönetilen kaynak modeli.

ResourceReference

resourceId modeli.

ResourceReferenceExtended

resourceId genişletilmiş modeli. Bu, başarısız kaynakları bir resourceId ve buna karşılık gelen bir hatayla belgelemek için kullanılır.

ResourceStatusMode

Dağıtım yığınındaki kaynağın geçerli yönetim durumu.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

UnmanageActionManagementGroupMode

Yeni yönetilmeyen bir kaynak için bir eylem belirtir.

UnmanageActionResourceGroupMode

Yeni yönetilmeyen bir kaynak grubu için bir eylem belirtir.

UnmanageActionResourceMode

Yeni yönetilmeyen bir kaynak için bir eylem belirtir.

ActionOnUnmanage

Yığın güncelleştirildikten veya silindikten sonra artık yönetilmeyen kaynakların davranışını tanımlar.

Name Tür Description
managementGroups

UnmanageActionManagementGroupMode

Yeni yönetilmeyen bir kaynak yönetim grubu için bir eylem belirtir.

resourceGroups

UnmanageActionResourceGroupMode

Yeni yönetilmeyen bir kaynak grubu için bir eylem belirtir.

resources

UnmanageActionResourceMode

Yeni yönetilmeyen bir kaynak için bir eylem belirtir.

createdByType

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

DenySettings

Dağıtım yığını tarafından dağıtılan kaynakların nasıl kilitleneceğini tanımlar.

Name Tür Description
applyToChildScopes

boolean

DenySettings, reddetme ataması olan her yönetilen kaynağın alt kaynak kapsamlarına uygulanır.

excludedActions

string[]

denySettings dışında tutulan rol tabanlı yönetim işlemlerinin listesi. En fazla 200 eyleme izin verilir. denySetting modu 'denyWriteAndDelete' olarak ayarlanırsa, şu eylemler 'excludedActions' öğesine otomatik olarak eklenir: '*/read' ve 'Microsoft.Authorization/locks/delete'. denySetting modu 'denyDelete' olarak ayarlanırsa, aşağıdaki eylemler 'excludedActions' öğesine otomatik olarak eklenir: 'Microsoft.Authorization/locks/delete'. Yinelenen eylemler kaldırılır.

excludedPrincipals

string[]

Kilit dışında tutulan AAD asıl kimliklerinin listesi. En fazla 5 sorumluya izin verilir.

mode

DenySettingsMode

denySettings Reddedilen eylemleri tanımlayan mod.

DenySettingsMode

denySettings Reddedilen eylemleri tanımlayan mod.

Değer Description
denyDelete

Yetkili kullanıcılar kaynakları okuyabilir ve değiştirebilir, ancak silemez.

denyWriteAndDelete

Yetkili kullanıcılar bir kaynaktan okuyabilir, ancak değiştiremez veya silemez.

none

DenyAssignments uygulanmadı.

DenyStatusMode

kaynağa uygulanan denyAssignment ayarları.

Değer Description
denyDelete

Yetkili kullanıcılar kaynakları okuyabilir ve değiştirebilir, ancak silemez.

notSupported

Kaynak türü denyAssignments'ı desteklemez.

inapplicable

denyAssignments, dağıtım yığını kapsamı dışındaki kaynaklarda desteklenmez.

denyWriteAndDelete

Yetkili kullanıcılar yalnızca kaynaktan okuyabilir, ancak değiştiremez veya silemez.

removedBySystem

Kaynak yönetimi değişikliği (yönetim grubu taşıma vb.) nedeniyle Reddetme ataması Azure tarafından kaldırıldı

none

DenyAssignments uygulanmadı.

DeploymentParameter

Şablon için dağıtım parametresi.

Name Tür Description
reference

KeyVaultParameterReference

Azure Key Vault parametre başvurusu.

type

string

Değerin türü.

value

Parametreye değer girin.

DeploymentStack

Dağıtım yığını nesnesi.

Name Tür Description
id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Kaynağın bulunduğu coğrafi konum. Abonelik ve yönetim grubu kapsamlı yığınlar için gereklidir. Konum, kaynak grubu kapsamlı yığınlar için kaynak grubundan devralınır.

name

string

Kaynağın adı

properties.actionOnUnmanage

ActionOnUnmanage

Dağıtım yığını güncelleştirildikten veya silindikten sonra artık yönetilmeyen kaynakların davranışını tanımlar.

properties.debugSetting

DeploymentStacksDebugSetting

Dağıtımın hata ayıklama ayarı.

properties.deletedResources

ResourceReference[]

En son Dağıtım yığını güncelleştirmesi sırasında silinen bir dizi kaynak. Silindi, kaynağın şablondan kaldırıldığı ve ilgili silme işlemlerinin belirtildiği anlamına gelir.

properties.denySettings

DenySettings

Yığın tarafından dağıtılan kaynakların nasıl kilitlendiğini tanımlar.

properties.deploymentId

string

Dağıtım yığını tarafından oluşturulan dağıtım kaynağının resourceId değeri.

properties.deploymentScope

string

İlk dağıtımın oluşturulması gereken kapsam. Kapsam belirtilmezse, varsayılan olarak dağıtım yığınının kapsamına ayarlanır. Geçerli kapsamlar şunlardır: yönetim grubu (biçim: '/providers/Microsoft.Management/managementGroups/{managementGroupId}'), abonelik (biçim: '/subscriptions/{subscriptionId}'), kaynak grubu (biçim: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}').

properties.description

string

maxLength: 4096

Dağıtım yığını açıklaması. En fazla 4096 karakter uzunluğu.

properties.detachedResources

ResourceReference[]

En son Dağıtım yığını güncelleştirmesi sırasında ayrılan bir dizi kaynak. Ayrılmış, kaynağın şablondan kaldırıldığı, ancak ilgili silme işleminin belirtilmediği anlamına gelir. Bu nedenle, kaynak artık yığınla ilişkilendirilmese de var olmaya devam eder.

properties.duration

string

Son başarılı Dağıtım yığını güncelleştirmesinin süresi.

properties.error

ErrorDetail

Hata ayrıntısı.

properties.failedResources

ResourceReferenceExtended[]

En son güncelleştirme sırasında hedef durumuna ulaşamayan bir kaynak dizisi. Her resourceId'ye bir hata iletisi eşlik eder.

properties.outputs

Dağıtım yığını tarafından oluşturulan dağıtım kaynağının çıktıları.

properties.parameters

<string,  DeploymentParameter>

Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini mevcut bir parametre dosyasına bağlamak yerine doğrudan istekte sağlarken bu öğeyi kullanın. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın.

properties.parametersLink

DeploymentStacksParametersLink

Parametre dosyasının URI'sini. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanın. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın.

properties.provisioningState

DeploymentStackProvisioningState

Dağıtım yığınının durumu.

properties.resources

ManagedResourceReference[]

Şu anda dağıtım yığını tarafından yönetilen bir kaynak dizisi.

properties.template

Şablon içeriği. Şablon söz dizimini var olan 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 şablon özelliğini kullanın, ancak ikisini birden kullanmayın.

properties.templateLink

DeploymentStacksTemplateLink

Şablonun URI'sini. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.

systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.

tags

object

Kaynak etiketleri.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

DeploymentStackListResult

DeploymentStack liste işleminin yanıtı.

Name Tür Description
nextLink

string (uri)

Öğelerin bir sonraki sayfasına bağlantı

value

DeploymentStack[]

Bu sayfadaki DeploymentStack öğeleri

DeploymentStackProvisioningState

Dağıtım yığınının durumu.

Değer Description
creating

Dağıtım yığını şu anda oluşturuluyor

validating

Dağıtım yığını şu anda doğrulanıyor

waiting

Dağıtım yığını şu anda bekliyor

deploying

Dağıtım yığını şu anda dağıtılıyor

canceling

Dağıtım yığını iptal ediliyor

updatingDenyAssignments

Dağıtım yığını reddetme atamalarını güncelleştiriyor

deletingResources

Dağıtım yığını kaynakları siliyor

succeeded

Dağıtım yığını başarıyla tamamlandı

failed

Dağıtım yığını başarısız oldu

canceled

Dağıtım yığını iptal edildi

deleting

Dağıtım yığını siliniyor

DeploymentStacksDebugSetting

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 hem requestContent hem de responseContent virgülle ayrılmış değerlerdir. Varsayılan değer yoktur. Bu değeri ayarlarken, dağıtım sırasında geçirilen 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 veriler potansiyel olarak ortaya çıkabilir.

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.

Şablon başvuruyu temsil eden varlık.

Name Tür Description
contentVersion

string

Varsa, şablondaki ContentVersion ile eşleşmelidir.

id

string

Bir Şablon Belirtiminin resourceId. id 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 şablona göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa bu, TemplateSpec içindeki bir yapıta başvurur. Üst öğe bir URI ile bağlanmışsa, alt dağıtım üst ve relativePath URI'lerinin bir birleşimi olur.

uri

string

Dağıtılacak şablonun URI'sini. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

KeyVaultParameterReference

Azure Key Vault parametre başvurusu.

Name Tür Description
keyVault

KeyVaultReference

Azure Key Vault başvurusu.

secretName

string

Azure Key Vault gizli dizi adı.

secretVersion

string

Azure Key Vault gizli dizi sürümü.

KeyVaultReference

Azure Key Vault başvurusu.

Name Tür Description
id

string

Azure Key Vault resourceId.

ManagedResourceReference

Yönetilen kaynak modeli.

Name Tür Default value Description
denyStatus

DenyStatusMode

none

kaynağa uygulanan denyAssignment ayarları.

id

string

Dağıtım yığını tarafından yönetilen bir kaynağın ARM Kaynak Kimliği.

status

ResourceStatusMode

none

Dağıtım yığınındaki kaynağın geçerli yönetim durumu.

ResourceReference

resourceId modeli.

Name Tür Description
id

string

Dağıtım yığını tarafından yönetilen bir kaynağın ARM Kaynak Kimliği.

ResourceReferenceExtended

resourceId genişletilmiş modeli. Bu, başarısız kaynakları bir resourceId ve buna karşılık gelen bir hatayla belgelemek için kullanılır.

Name Tür Description
error

ErrorDetail

Hata ayrıntısı.

id

string

Dağıtım yığını tarafından yönetilen bir kaynağın ARM Kaynak Kimliği.

ResourceStatusMode

Dağıtım yığınındaki kaynağın geçerli yönetim durumu.

Değer Description
managed

Bu kaynak dağıtım yığını tarafından yönetilir.

removeDenyFailed

Kaynakta reddetme ataması kaldırılamıyor.

deleteFailed

Kaynak Azure'dan silinemiyor. Silme işlemi sonraki yığın dağıtımında yeniden denenecek veya el ile silinebilir.

none

Yönetim durumu yok.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

UnmanageActionManagementGroupMode

Yeni yönetilmeyen bir kaynak için bir eylem belirtir.

Değer Description
delete

Azure'dan yönetim gruplarını sil.

detach

Yönetim gruplarını Azure'da tutun.

UnmanageActionResourceGroupMode

Yeni yönetilmeyen bir kaynak grubu için bir eylem belirtir.

Değer Description
delete

Azure'dan kaynak gruplarını sil.

detach

Kaynak gruplarını Azure'da tutun.

UnmanageActionResourceMode

Yeni yönetilmeyen bir kaynak için bir eylem belirtir.

Değer Description
delete

Azure kaynaklarını sil

detach

Kaynakları Azure'da tutun