Deployment Stacks - List At Management Group

Szolgáltatás:

Resource Management

API-verzió:

2022-08-01-preview

Felsorolja az üzembe helyezési verméket a megadott hatókörben.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
managementGroupId	path	True	string minLength: 1	A felügyeleti csoport azonosítója.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Válaszok

Name	Típus	Description
200 OK	DeploymentStackListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

List management group Deployment stacks

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

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

Definíciók

Name	Description
ActionOnUnmanage	Meghatározza a verem frissítése vagy törlése után már nem felügyelt erőforrások viselkedését.
createdByType	Az erőforrást létrehozó identitás típusa.
DenySettings	Meghatározza, hogy az üzembe helyezési verem által üzembe helyezett erőforrások hogyan legyenek zárolva.
DenySettingsMode	denyBeállítások mód, amely meghatározza a megtagadott műveleteket.
DenyStatusMode	az erőforrásra alkalmazott denyAssignment beállítások.
DeploymentParameter	A sablon üzembe helyezési paramétere.
DeploymentStack	Üzembehelyezési veremobjektum.
DeploymentStackListResult	A DeploymentStack listaművelet válasza.
DeploymentStackProvisioningState	Az üzembehelyezési verem állapota.
DeploymentStacksDebugSetting	A hibakeresési beállítás.
DeploymentStacksParametersLink	Az üzembehelyezési paraméterekre mutató hivatkozást képviselő entitás.
DeploymentStacksTemplateLink	A sablonra mutató hivatkozást képviselő entitás.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
KeyVaultParameterReference	Azure Key Vault paraméterreferencia.
KeyVaultReference	Azure Key Vault referencia.
ManagedResourceReference	A felügyelt erőforrásmodell.
ResourceReference	A resourceId modell.
ResourceReferenceExtended	A resourceId kiterjesztett modell. Ez a sikertelen erőforrások resourceId és a megfelelő hiba dokumentálására szolgál.
ResourceStatusMode	Az erőforrás aktuális felügyeleti állapota az üzembe helyezési veremben.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UnmanageActionManagementGroupMode	Megad egy műveletet egy újonnan nem felügyelt erőforráshoz.
UnmanageActionResourceGroupMode	Megad egy műveletet egy újonnan nem kezelt erőforrás-csoportra.
UnmanageActionResourceMode	Megad egy műveletet egy újonnan nem felügyelt erőforráshoz.

ActionOnUnmanage

Tárgy

Meghatározza a verem frissítése vagy törlése után már nem felügyelt erőforrások viselkedését.

Name	Típus	Description
managementGroups	UnmanageActionManagementGroupMode	Meghatározza egy műveletet egy újonnan nem kezelt erőforrás-kezelő csoport számára.
resourceGroups	UnmanageActionResourceGroupMode	Megad egy műveletet egy újonnan nem kezelt erőforrás-csoportra.
resources	UnmanageActionResourceMode	Megad egy műveletet egy újonnan nem felügyelt erőforráshoz.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DenySettings

Tárgy

Meghatározza, hogy az üzembe helyezési verem által üzembe helyezett erőforrások hogyan legyenek zárolva.

Name	Típus	Description
applyToChildScopes	boolean	A DenySettings minden megtagadási hozzárendeléssel rendelkező felügyelt erőforrás gyermekerőforrás-hatókörére lesz alkalmazva.
excludedActions	string[]	A denySettings szolgáltatásból kizárt szerepköralapú felügyeleti műveletek listája. Legfeljebb 200 művelet engedélyezett. Ha a denySetting mód "denyWriteAndDelete" értékre van állítva, akkor a rendszer automatikusan hozzáfűzi a következő műveleteket a "excludedActions" elemhez: "*/read" és "Microsoft.Authorization/locks/delete". Ha a denySetting mód "denyDelete" értékre van állítva, akkor a rendszer automatikusan hozzáfűzi a következő műveleteket a "excludedActions" elemhez: "Microsoft.Authorization/locks/delete". Az ismétlődő műveletek el lesznek távolítva.
excludedPrincipals	string[]	A zárolásból kizárt AAD-egyszerű azonosítók listája. Legfeljebb 5 tag engedélyezett.
mode	DenySettingsMode	denyBeállítások mód, amely meghatározza a megtagadott műveleteket.

DenySettingsMode

Felsorolás

denyBeállítások mód, amely meghatározza a megtagadott műveleteket.

Érték	Description
denyDelete	A jogosult felhasználók elolvashatják és módosíthatják az erőforrásokat, de nem törölhetők.
denyWriteAndDelete	A jogosult felhasználók olvashatnak egy erőforrásból, de nem módosíthatják vagy törölhetik azokat.
none	A rendszer nem alkalmazott denyAssignments elemet.

DenyStatusMode

Felsorolás

az erőforrásra alkalmazott denyAssignment beállítások.

Érték	Description
denyDelete	A jogosult felhasználók elolvashatják és módosíthatják az erőforrásokat, de nem törölhetők.
notSupported	Az erőforrás típusa nem támogatja a denyAssignments parancsot.
inapplicable	A denyAssignments nem támogatott az üzembe helyezési verem hatókörén kívüli erőforrásokon.
denyWriteAndDelete	A jogosult felhasználók csak egy erőforrásból olvashatnak, de nem módosíthatják vagy törölhetik azt.
removedBySystem	A megtagadási hozzárendelést az Azure eltávolította egy erőforrás-kezelési változás (felügyeleti csoport áthelyezése stb.) miatt.
none	A rendszer nem alkalmazott denyAssignments elemet.

DeploymentParameter

Tárgy

A sablon üzembe helyezési paramétere.

Name	Típus	Description
reference	KeyVaultParameterReference	Azure Key Vault paraméterreferencia.
type	string	Az érték típusa.
value		Adja meg a paraméter értékét.

DeploymentStack

Tárgy

Üzembehelyezési veremobjektum.

Name	Típus	Description
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az erőforrás földrajzi helye. Az előfizetés és a felügyeleti csoport hatókörébe tartozó vermekhez szükséges. A hely az erőforráscsoport-hatókörű vermek erőforráscsoportjától öröklődik.
name	string	Az erőforrás neve
properties.actionOnUnmanage	ActionOnUnmanage	Meghatározza az üzembe helyezési verem frissítése vagy törlése után már nem felügyelt erőforrások viselkedését.
properties.debugSetting	DeploymentStacksDebugSetting	Az üzembe helyezés hibakeresési beállítása.
properties.deletedResources	ResourceReference[]	A legutóbbi üzembe helyezési verem frissítése során törölt erőforrások tömbje. A törölt azt jelenti, hogy az erőforrást eltávolították a sablonból, és megadták a megfelelő törlési műveleteket.
properties.denySettings	DenySettings	Meghatározza, hogy a verem által üzembe helyezett erőforrások hogyan legyenek zárolva.
properties.deploymentId	string	Az üzembe helyezési verem által létrehozott üzembehelyezési erőforrás resourceId azonosítója.
properties.deploymentScope	string	Az a hatókör, amelyen a kezdeti üzembe helyezést létre kell hozni. Ha nincs megadva hatókör, az alapértelmezés szerint az üzembehelyezési verem hatóköre lesz. Érvényes hatókörök: felügyeleti csoport (formátum: "/providers/Microsoft.Management/managementGroups/{managementGroupId}"), előfizetés (formátum: "/subscriptions/{subscriptionId}"), erőforráscsoport (formátum: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}").
properties.description	string maxLength: 4096	Az üzembehelyezési verem leírása. Maximális hossza 4096 karakter.
properties.detachedResources	ResourceReference[]	A legutóbbi üzembe helyezési verem frissítése során leválasztott erőforrások tömbje. A leválasztott azt jelenti, hogy az erőforrás el lett távolítva a sablonból, de nem adott meg releváns törlési műveleteket. Így az erőforrás továbbra is létezik, miközben már nincs társítva a veremhez.
properties.duration	string	Az utolsó sikeres központi telepítési verem frissítésének időtartama.
properties.error	ErrorDetail	A hiba részletei.
properties.failedResources	ResourceReferenceExtended[]	Olyan erőforrások tömbje, amelyek a legutóbbi frissítés során nem érték el a célállapotot. Minden resourceId hibaüzenet kísér.
properties.outputs		Az üzembe helyezési verem által létrehozott üzembe helyezési erőforrás kimenetei.
properties.parameters	<string,  DeploymentParameter>	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 adja meg a paraméterértékeket, és nem egy meglévő paraméterfájlhoz kapcsolódik. Használja a parametersLink tulajdonságot vagy a paramétertulajdonságot, de mindkettőt nem.
properties.parametersLink	DeploymentStacksParametersLink	A paraméterfájl URI-ja. Ezzel az elemet használva hivatkozhat egy meglévő paraméterfájlra. Használja a parametersLink tulajdonságot vagy a paramétertulajdonságot, de mindkettőt nem.
properties.provisioningState	DeploymentStackProvisioningState	Az üzembehelyezési verem állapota.
properties.resources	ManagedResourceReference[]	Az üzembe helyezési verem által jelenleg felügyelt erőforrások tömbje.
properties.template		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.
properties.templateLink	DeploymentStacksTemplateLink	A sablon URI-ja. Használja a templateLink tulajdonságot vagy a sablontulajdonságot, de mindkettőt nem.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

DeploymentStackListResult

Tárgy

A DeploymentStack listaművelet válasza.

Name	Típus	Description
nextLink	string (uri)	A következő oldalra mutató link
value	DeploymentStack[]	A DeploymentStack elemek ezen az oldalon

DeploymentStackProvisioningState

Felsorolás

Az üzembehelyezési verem állapota.

Érték	Description
creating	Az üzembe helyezési verem jelenleg létrehozása folyamatban van
validating	Az üzembe helyezési verem ellenőrzése jelenleg folyamatban van
waiting	Az üzembe helyezési verem jelenleg várakozik
deploying	Az üzembe helyezési verem jelenleg üzembe helyezés alatt áll
canceling	Az üzembe helyezési verem megszakad
updatingDenyAssignments	Az üzembe helyezési verem frissíti a megtagadási hozzárendeléseket
deletingResources	Az üzembe helyezési verem erőforrásokat töröl
succeeded	Az üzembe helyezési verem sikeresen befejeződött
failed	Az üzembe helyezési verem meghiúsult
canceled	Az üzembe helyezési verem megszakadt
deleting	Az üzembe helyezési verem törlődik

DeploymentStacksDebugSetting

Tárgy

A hibakeresési beállítás.

Name	Típus	Description
detailLevel	string	Megadja a hibakereséshez naplózni kívánt információk típusát. Az engedélyezett értékek a következők: requestContent, responseContent, vagy requestContent és responseContent vesszővel elválasztva. Az alapértelmezett érték nincs. Ennek az értéknek a beállításakor gondosan vegye figyelembe az üzembe helyezés során átadott információk típusát. A kéréssel vagy válaszsal kapcsolatos információk naplózásával az üzembe helyezési műveletek során lekért bizalmas adatok potenciálisan közzétehetők.

DeploymentStacksParametersLink

Tárgy

Az üzembehelyezési paraméterekre mutató hivatkozást képviselő entitás.

Name	Típus	Description
contentVersion	string	Ha szerepel a sablonban, meg kell egyeznie a ContentVersion-nal.
uri	string	A paraméterfájl URI-ja.

DeploymentStacksTemplateLink

Tárgy

A sablonra mutató hivatkozást képviselő entitás.

Name	Típus	Description
contentVersion	string	Ha szerepel a sablonban, meg kell egyeznie a ContentVersion-nal.
id	string	A sablon specifikációjának resourceId. Használja a vagy az uri tulajdonságot, de ne mindkettőt.
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 képest egy csatolt sablon helyezhető üzembe egy helyen. Ha a szülősablon egy TemplateSpec-hez volt csatolva, az a TemplateSpec egyik összetevőjére fog hivatkozni. Ha a szülő URI-val van összekapcsolva, a gyermek üzembe helyezése a szülő és a relativePath URI-k kombinációja lesz.
uri	string	Az üzembe helyezendő sablon URI-ja. Használja az uri vagy az azonosító tulajdonságot, de mindkettőt nem.

ErrorAdditionalInfo

Tárgy

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 információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

KeyVaultParameterReference

Tárgy

Azure Key Vault paraméterreferencia.

Name	Típus	Description
keyVault	KeyVaultReference	Azure Key Vault referencia.
secretName	string	Azure Key Vault titkos kód neve.
secretVersion	string	Azure Key Vault titkos verzió.

KeyVaultReference

Tárgy

Azure Key Vault referencia.

Name	Típus	Description
id	string	Azure Key Vault resourceId.

ManagedResourceReference

Tárgy

A felügyelt erőforrásmodell.

Name	Típus	Alapértelmezett érték	Description
denyStatus	DenyStatusMode	none	az erőforrásra alkalmazott denyAssignment beállítások.
id	string		Az üzembe helyezési verem által kezelt erőforrás ARM-erőforrás-azonosítója.
status	ResourceStatusMode	none	Az erőforrás aktuális felügyeleti állapota az üzembe helyezési veremben.

ResourceReference

Tárgy

A resourceId modell.

Name	Típus	Description
id	string	Az üzembe helyezési verem által kezelt erőforrás ARM-erőforrás-azonosítója.

ResourceReferenceExtended

Tárgy

A resourceId kiterjesztett modell. Ez a sikertelen erőforrások resourceId és a megfelelő hiba dokumentálására szolgál.

Name	Típus	Description
error	ErrorDetail	A hiba részletei.
id	string	Az üzembe helyezési verem által kezelt erőforrás ARM-erőforrás-azonosítója.

ResourceStatusMode

Felsorolás

Az erőforrás aktuális felügyeleti állapota az üzembe helyezési veremben.

Érték	Description
managed	Ezt az erőforrást az üzembe helyezési verem felügyeli.
removeDenyFailed	Az erőforrás megtagadási hozzárendelése nem távolítható el.
deleteFailed	Az erőforrás nem törölhető az Azure-ból. A törlés újrapróbálkozott a következő veremtelepítéskor, vagy manuálisan is törölhető.
none	Nincs felügyeleti állapot.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UnmanageActionManagementGroupMode

Felsorolás

Megad egy műveletet egy újonnan nem felügyelt erőforráshoz.

Érték	Description
delete	Töröld a menedzsment csoportokat az Azure-ból.
detach	Tartsd meg a menedzsment csoportokat Azure-ban.

UnmanageActionResourceGroupMode

Felsorolás

Megad egy műveletet egy újonnan nem kezelt erőforrás-csoportra.

Érték	Description
delete	Töröld az erőforrás-csoportokat az Azure-ból.
detach	Az erőforráscsoportokat az Azure-ban tartsák.

UnmanageActionResourceMode

Felsorolás

Megad egy műveletet egy újonnan nem felügyelt erőforráshoz.

Érték	Description
delete	Delete the resources from Azure
detach	Tartsd az erőforrásokat Azure-ban