Deployment Stacks - List At Management Group

Layanan:: Resource Management

Versi API:: 2022-08-01-preview

Mencantumkan tumpukan penyebaran pada cakupan yang ditentukan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
managementGroupId	path	True	string minLength: 1	ID grup manajemen.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	DeploymentStackListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List management group Deployment stacks

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 200

{
  "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"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
ActionOnUnmanage	Menentukan perilaku sumber daya yang tidak lagi dikelola setelah tumpukan diperbarui atau dihapus.
createdByType	Jenis identitas yang membuat sumber daya.
DenySettings	Menentukan bagaimana sumber daya yang disebarkan oleh tumpukan Penyebaran dikunci.
DenySettingsMode	denySettings Mode yang menentukan tindakan yang ditolak.
DenyStatusMode	pengaturan denyAssignment diterapkan ke sumber daya.
DeploymentParameter	Parameter penyebaran untuk templat.
DeploymentStack	Objek tumpukan penyebaran.
DeploymentStackListResult	Respons operasi daftar DeploymentStack.
DeploymentStackProvisioningState	Status tumpukan penyebaran.
DeploymentStacksDebugSetting	Pengaturan debug.
DeploymentStacksParametersLink	Entitas yang mewakili referensi ke parameter penyebaran.
DeploymentStacksTemplateLink	Entitas yang mewakili referensi ke templat.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
KeyVaultParameterReference	Referensi parameter Azure Key Vault.
KeyVaultReference	Referensi Azure Key Vault.
ManagedResourceReference	Model sumber daya terkelola.
ResourceReference	Model resourceId.
ResourceReferenceExtended	Model resourceId yang diperluas. Ini digunakan untuk mendokumentasikan sumber daya yang gagal dengan resourceId dan kesalahan yang sesuai.
ResourceStatusMode	Status manajemen sumber daya saat ini dalam tumpukan penyebaran.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UnmanageActionManagementGroupMode	Menentukan tindakan untuk sumber daya yang baru tidak dikelola.
UnmanageActionResourceGroupMode	Menentukan tindakan untuk grup sumber daya yang baru tidak dikelola.
UnmanageActionResourceMode	Menentukan tindakan untuk sumber daya yang baru tidak dikelola.

ActionOnUnmanage

Objek

Menentukan perilaku sumber daya yang tidak lagi dikelola setelah tumpukan diperbarui atau dihapus.

Nama	Jenis	Deskripsi
managementGroups	UnmanageActionManagementGroupMode	Menentukan tindakan untuk grup manajemen sumber daya yang baru tidak dikelola.
resourceGroups	UnmanageActionResourceGroupMode	Menentukan tindakan untuk grup sumber daya yang baru tidak dikelola.
resources	UnmanageActionResourceMode	Menentukan tindakan untuk sumber daya yang baru tidak dikelola.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DenySettings

Objek

Menentukan bagaimana sumber daya yang disebarkan oleh tumpukan Penyebaran dikunci.

Nama	Jenis	Deskripsi
applyToChildScopes	boolean	DenySettings akan diterapkan ke cakupan sumber daya turunan dari setiap sumber daya terkelola dengan penetapan tolak.
excludedActions	string[]	Daftar operasi manajemen berbasis peran yang dikecualikan dari denySettings. Hingga 200 tindakan diizinkan. Jika mode denySetting diatur ke 'denyWriteAndDelete', maka tindakan berikut secara otomatis ditambahkan ke 'excludedActions': '*/read' dan 'Microsoft.Authorization/locks/delete'. Jika mode denySetting diatur ke 'denyDelete', maka tindakan berikut secara otomatis ditambahkan ke 'excludedActions': 'Microsoft.Authorization/locks/delete'. Tindakan duplikat akan dihapus.
excludedPrincipals	string[]	Daftar ID utama AAD yang dikecualikan dari kunci. Hingga 5 prinsipal diizinkan.
mode	DenySettingsMode	denySettings Mode yang menentukan tindakan yang ditolak.

DenySettingsMode

Enumerasi

denySettings Mode yang menentukan tindakan yang ditolak.

Nilai	Deskripsi
denyDelete	Pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak dapat menghapus.
denyWriteAndDelete	Pengguna yang berwenang dapat membaca dari sumber daya, tetapi tidak dapat memodifikasi atau menghapusnya.
none	Tidak ada denyAssignments yang diterapkan.

DenyStatusMode

Enumerasi

pengaturan denyAssignment diterapkan ke sumber daya.

Nilai	Deskripsi
denyDelete	Pengguna yang berwenang dapat membaca dan memodifikasi sumber daya, tetapi tidak dapat menghapus.
notSupported	Jenis sumber daya tidak mendukung denyAssignments.
inapplicable	denyAssignments tidak didukung pada sumber daya di luar cakupan tumpukan penyebaran.
denyWriteAndDelete	Pengguna yang berwenang hanya dapat membaca dari sumber daya, tetapi tidak dapat mengubah atau menghapusnya.
removedBySystem	Penugasan penolakan telah dihapus oleh Azure karena perubahan manajemen sumber daya (pemindahan grup manajemen, dll.)
none	Tidak ada denyAssignments yang diterapkan.

DeploymentParameter

Objek

Parameter penyebaran untuk templat.

Nama	Jenis	Deskripsi
reference	KeyVaultParameterReference	Referensi parameter Azure Key Vault.
type	string	Jenis nilai.
value		Masukkan nilai ke parameter.

DeploymentStack

Objek

Objek tumpukan penyebaran.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geo-lokasi tempat sumber daya berada. Diperlukan untuk tumpukan cakupan grup langganan dan manajemen. Lokasi diwarisi dari grup sumber daya untuk tumpukan cakupan grup sumber daya.
name	string	Nama sumber daya
properties.actionOnUnmanage	ActionOnUnmanage	Menentukan perilaku sumber daya yang tidak lagi dikelola setelah tumpukan Penyebaran diperbarui atau dihapus.
properties.debugSetting	DeploymentStacksDebugSetting	Pengaturan debug penyebaran.
properties.deletedResources	ResourceReference[]	Array sumber daya yang dihapus selama pembaruan tumpukan Penyebaran terbaru. Dihapus berarti bahwa sumber daya dihapus dari templat dan operasi penghapusan yang relevan ditentukan.
properties.denySettings	DenySettings	Menentukan bagaimana sumber daya yang disebarkan oleh tumpukan dikunci.
properties.deploymentId	string	ResourceId dari sumber daya penyebaran yang dibuat oleh tumpukan penyebaran.
properties.deploymentScope	string	Cakupan tempat penyebaran awal harus dibuat. Jika cakupan tidak ditentukan, cakupan akan default ke cakupan tumpukan penyebaran. Cakupan yang valid adalah: grup manajemen (format: '/providers/Microsoft.Management/managementGroups/{managementGroupId}'), langganan (format: '/subscriptions/{subscriptionId}'), grup sumber daya (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}').
properties.description	string maxLength: 4096	Deskripsi tumpukan penyebaran. Panjang maksimum 4096 karakter.
properties.detachedResources	ResourceReference[]	Array sumber daya yang dilepas selama pembaruan tumpukan Penyebaran terbaru. Terpisah berarti bahwa sumber daya dihapus dari templat, tetapi tidak ada operasi penghapusan yang relevan yang ditentukan. Jadi, sumber daya masih ada sementara tidak lagi dikaitkan dengan tumpukan.
properties.duration	string	Durasi pembaruan tumpukan Penyebaran terakhir yang berhasil.
properties.error	ErrorDetail	Detail kesalahan.
properties.failedResources	ResourceReferenceExtended[]	Array sumber daya yang gagal mencapai status tujuan selama pembaruan terbaru. Setiap resourceId disertai dengan pesan kesalahan.
properties.outputs		Output sumber daya penyebaran yang dibuat oleh tumpukan penyebaran.
properties.parameters	<string, DeploymentParameter>	Pasangan nama dan nilai yang menentukan parameter penyebaran untuk templat. Gunakan elemen ini saat memberikan nilai parameter langsung dalam permintaan, daripada menautkan ke file parameter yang ada. Gunakan properti parametersLink atau properti parameter, tetapi tidak keduanya.
properties.parametersLink	DeploymentStacksParametersLink	URI file parameter. Gunakan elemen ini untuk menautkan ke file parameter yang ada. Gunakan properti parametersLink atau properti parameter, tetapi tidak keduanya.
properties.provisioningState	DeploymentStackProvisioningState	Status tumpukan penyebaran.
properties.resources	ManagedResourceReference[]	Array sumber daya yang saat ini dikelola oleh tumpukan penyebaran.
properties.template		Konten templat. Anda menggunakan elemen ini ketika Anda ingin meneruskan sintaks templat langsung dalam permintaan daripada menautkan ke templat yang ada. Ini bisa menjadi string JObject atau JSON yang terbentuk dengan baik. Gunakan properti templateLink atau properti templat, tetapi tidak keduanya.
properties.templateLink	DeploymentStacksTemplateLink	URI templat. Gunakan properti templateLink atau properti templat, tetapi tidak keduanya.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

DeploymentStackListResult

Objek

Respons operasi daftar DeploymentStack.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	DeploymentStack[]	Item DeploymentStack di halaman ini

DeploymentStackProvisioningState

Enumerasi

Status tumpukan penyebaran.

Nilai	Deskripsi
creating	Tumpukan penyebaran saat ini sedang dibuat
validating	Tumpukan penyebaran saat ini sedang divalidasi
waiting	Tumpukan penyebaran saat ini sedang menunggu
deploying	Tumpukan penyebaran saat ini sedang disebarkan
canceling	Tumpukan penyebaran dibatalkan
updatingDenyAssignments	Tumpukan penyebaran memperbarui penugasan tolak
deletingResources	Tumpukan penyebaran sedang menghapus sumber daya
succeeded	Tumpukan penyebaran berhasil diselesaikan
failed	Tumpukan penyebaran telah gagal
canceled	Tumpukan penyebaran telah dibatalkan
deleting	Tumpukan penyebaran sedang dihapus

DeploymentStacksDebugSetting

Objek

Pengaturan debug.

Nama	Jenis	Deskripsi
detailLevel	string	Menentukan tipe informasi yang akan dicatat untuk penelusuran kesalahan. Nilai yang diizinkan tidak ada, requestContent, responseContent, atau requestContent dan responseContent yang dipisahkan oleh koma. Defaultnya adalah tidak ada. Saat mengatur nilai ini, pertimbangkan dengan cermat jenis informasi yang sedang diteruskan selama penyebaran. Dengan mencatat informasi tentang permintaan atau respons, data sensitif yang diambil melalui operasi penyebaran berpotensi terekspos.

DeploymentStacksParametersLink

Objek

Entitas yang mewakili referensi ke parameter penyebaran.

Nama	Jenis	Deskripsi
contentVersion	string	Jika disertakan, harus cocok dengan ContentVersion dalam templat.
uri	string	URI file parameter.

DeploymentStacksTemplateLink

Objek

Entitas yang mewakili referensi ke templat.

Nama	Jenis	Deskripsi
contentVersion	string	Jika disertakan, harus cocok dengan ContentVersion dalam templat.
id	string	ResourceId dari Spesifikasi Templat. Gunakan properti id atau uri, tetapi tidak keduanya.
queryString	string	String kueri (misalnya, token SAS) yang akan digunakan dengan templateLink URI.
relativePath	string	Properti relativePath dapat digunakan untuk menyebarkan templat tertaut di lokasi yang relatif terhadap induk. Jika templat induk ditautkan dengan TemplateSpec, ini akan mereferensikan artefak di TemplateSpec. Jika induk ditautkan dengan URI, penyebaran turunan akan menjadi kombinasi dari URI induk dan relativePath.
uri	string	URI templat yang akan disebarkan. Gunakan properti uri atau id, tetapi tidak keduanya.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

KeyVaultParameterReference

Objek

Referensi parameter Azure Key Vault.

Nama	Jenis	Deskripsi
keyVault	KeyVaultReference	Referensi Azure Key Vault.
secretName	string	Nama rahasia Azure Key Vault.
secretVersion	string	Versi rahasia Azure Key Vault.

KeyVaultReference

Objek

Referensi Azure Key Vault.

Nama	Jenis	Deskripsi
id	string	ResourceId Azure Key Vault.

ManagedResourceReference

Objek

Model sumber daya terkelola.

Nama	Jenis	Nilai default	Deskripsi
denyStatus	DenyStatusMode	none	pengaturan denyAssignment diterapkan ke sumber daya.
id	string		ID Sumber Daya ARM dari sumber daya yang dikelola oleh tumpukan penyebaran.
status	ResourceStatusMode	none	Status manajemen sumber daya saat ini dalam tumpukan penyebaran.

ResourceReference

Objek

Model resourceId.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya ARM dari sumber daya yang dikelola oleh tumpukan penyebaran.

ResourceReferenceExtended

Objek

Model resourceId yang diperluas. Ini digunakan untuk mendokumentasikan sumber daya yang gagal dengan resourceId dan kesalahan yang sesuai.

Nama	Jenis	Deskripsi
error	ErrorDetail	Detail kesalahan.
id	string	ID Sumber Daya ARM dari sumber daya yang dikelola oleh tumpukan penyebaran.

ResourceStatusMode

Enumerasi

Status manajemen sumber daya saat ini dalam tumpukan penyebaran.

Nilai	Deskripsi
managed	Sumber daya ini dikelola oleh tumpukan penyebaran.
removeDenyFailed	Tidak dapat menghapus penetapan penolakan pada sumber daya.
deleteFailed	Tidak dapat menghapus sumber daya dari Azure. Penghapusan akan dicoba kembali pada penyebaran tumpukan berikutnya, atau dapat dihapus secara manual.
none	Tidak ada status manajemen.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UnmanageActionManagementGroupMode

Enumerasi

Menentukan tindakan untuk sumber daya yang baru tidak dikelola.

Nilai	Deskripsi
delete	Hapus grup manajemen dari Azure.
detach	Simpan grup manajemen di Azure.

UnmanageActionResourceGroupMode

Enumerasi

Menentukan tindakan untuk grup sumber daya yang baru tidak dikelola.

Nilai	Deskripsi
delete	Hapus grup sumber daya dari Azure.
detach	Simpan grup sumber daya di Azure.

UnmanageActionResourceMode

Enumerasi

Menentukan tindakan untuk sumber daya yang baru tidak dikelola.

Nilai	Deskripsi
delete	Menghapus sumber daya dari Azure
detach	Menyimpan sumber daya di Azure

Bagikan melalui

Deployment Stacks - List At Management Group

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

List management group Deployment stacks

Permintaan sampel

Respon sampel

Definisi

ActionOnUnmanage

createdByType

DenySettings

DenySettingsMode

DenyStatusMode

DeploymentParameter

DeploymentStack

DeploymentStackListResult

DeploymentStackProvisioningState

DeploymentStacksDebugSetting

DeploymentStacksParametersLink

DeploymentStacksTemplateLink

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

KeyVaultParameterReference

KeyVaultReference

ManagedResourceReference

ResourceReference

ResourceReferenceExtended

ResourceStatusMode

systemData

UnmanageActionManagementGroupMode

UnmanageActionResourceGroupMode

UnmanageActionResourceMode