Deployment Stacks - List At Management Group

서비스:: Resource Management

API 버전:: 2022-08-01-preview

지정된 범위의 배포 스택을 나열합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
managementGroupId	path	True	string minLength: 1	관리 그룹 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	DeploymentStackListResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

List management group Deployment stacks

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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"
      }
    }
  ]
}

정의

Name	Description
ActionOnUnmanage	스택이 업데이트되거나 삭제된 후 더 이상 관리되지 않는 리소스의 동작을 정의합니다.
createdByType	리소스를 만든 ID의 형식입니다.
DenySettings	배포 스택에 의해 배포된 리소스가 잠그는 방법을 정의합니다.
DenySettingsMode	denySettings 거부된 작업을 정의하는 모드입니다.
DenyStatusMode	리소스에 적용된 denyAssignment 설정입니다.
DeploymentParameter	템플릿에 대한 배포 매개 변수입니다.
DeploymentStack	배포 스택 개체입니다.
DeploymentStackListResult	DeploymentStack 목록 작업의 응답입니다.
DeploymentStackProvisioningState	배포 스택의 상태입니다.
DeploymentStacksDebugSetting	디버그 설정입니다.
DeploymentStacksParametersLink	배포 매개 변수에 대한 참조를 나타내는 엔터티입니다.
DeploymentStacksTemplateLink	템플릿에 대한 참조를 나타내는 엔터티입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
KeyVaultParameterReference	Azure Key Vault 매개 변수 참조.
KeyVaultReference	Azure Key Vault 참조.
ManagedResourceReference	관리되는 리소스 모델입니다.
ResourceReference	resourceId 모델입니다.
ResourceReferenceExtended	resourceId 확장 모델입니다. 이는 resourceId 및 해당 오류와 함께 실패한 리소스를 문서화하는 데 사용됩니다.
ResourceStatusMode	배포 스택에 있는 리소스의 현재 관리 상태입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UnmanageActionManagementGroupMode	새로 관리되지 않는 리소스에 대한 작업을 지정합니다.
UnmanageActionResourceGroupMode	새로 관리되지 않은 자원 그룹에 대한 행동을 지정합니다.
UnmanageActionResourceMode	새로 관리되지 않는 리소스에 대한 작업을 지정합니다.

ActionOnUnmanage

Object

스택이 업데이트되거나 삭제된 후 더 이상 관리되지 않는 리소스의 동작을 정의합니다.

Name	형식	Description
managementGroups	UnmanageActionManagementGroupMode	새로 관리되지 않은 자원 관리 그룹에 대한 행동을 지정합니다.
resourceGroups	UnmanageActionResourceGroupMode	새로 관리되지 않은 자원 그룹에 대한 행동을 지정합니다.
resources	UnmanageActionResourceMode	새로 관리되지 않는 리소스에 대한 작업을 지정합니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DenySettings

Object

배포 스택에 의해 배포된 리소스가 잠그는 방법을 정의합니다.

Name	형식	Description
applyToChildScopes	boolean	DenySettings는 거부 할당이 있는 모든 관리되는 리소스의 자식 리소스 범위에 적용됩니다.
excludedActions	string[]	denySettings에서 제외되는 역할 기반 관리 작업 목록입니다. 최대 200개까지 작업이 허용됩니다. denySetting 모드가 'denyWriteAndDelete'로 설정된 경우 'excludedActions', '*/read' 및 'Microsoft.Authorization/locks/delete'에 다음 작업이 자동으로 추가됩니다. denySetting 모드가 'denyDelete'로 설정된 경우 'excludedActions'에 다음 작업이 자동으로 추가됩니다. 'Microsoft.Authorization/locks/delete'. 중복 작업이 제거됩니다.
excludedPrincipals	string[]	잠금에서 제외된 AAD 보안 주체 ID 목록입니다. 최대 5개의 보안 주체가 허용됩니다.
mode	DenySettingsMode	denySettings 거부된 작업을 정의하는 모드입니다.

DenySettingsMode

열거형

denySettings 거부된 작업을 정의하는 모드입니다.

값	Description
denyDelete	권한 있는 사용자는 리소스를 읽고 수정할 수 있지만 삭제할 수는 없습니다.
denyWriteAndDelete	권한이 부여된 사용자는 리소스에서 읽을 수 있지만 수정하거나 삭제할 수는 없습니다.
none	denyAssignments가 적용되지 않았습니다.

DenyStatusMode

열거형

리소스에 적용된 denyAssignment 설정입니다.

값	Description
denyDelete	권한 있는 사용자는 리소스를 읽고 수정할 수 있지만 삭제할 수는 없습니다.
notSupported	리소스 종류는 denyAssignments를 지원하지 않습니다.
inapplicable	denyAssignments는 배포 스택의 범위를 벗어난 리소스에서 지원되지 않습니다.
denyWriteAndDelete	권한 있는 사용자는 리소스에서만 읽을 수 있지만 수정하거나 삭제할 수는 없습니다.
removedBySystem	리소스 관리 변경(관리 그룹 이동 등)으로 인해 Azure에서 거부 할당이 제거되었습니다.
none	denyAssignments가 적용되지 않았습니다.

DeploymentParameter

Object

템플릿에 대한 배포 매개 변수입니다.

Name	형식	Description
reference	KeyVaultParameterReference	Azure Key Vault 매개 변수 참조.
type	string	값 형식입니다.
value		매개변수에 값을 입력합니다.

DeploymentStack

Object

배포 스택 개체입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	리소스가 있는 지리적 위치입니다. 구독 및 관리 그룹 범위 스택에 필요합니다. 위치는 리소스 그룹 범위 스택의 리소스 그룹에서 상속됩니다.
name	string	리소스의 이름
properties.actionOnUnmanage	ActionOnUnmanage	배포 스택이 업데이트되거나 삭제된 후 더 이상 관리되지 않는 리소스의 동작을 정의합니다.
properties.debugSetting	DeploymentStacksDebugSetting	배포의 디버그 설정입니다.
properties.deletedResources	ResourceReference[]	가장 최근의 배포 스택 업데이트 중에 삭제된 리소스의 배열입니다. 삭제됨은 리소스가 템플릿에서 제거되고 관련 삭제 작업이 지정되었음을 의미합니다.
properties.denySettings	DenySettings	스택에 의해 배포된 리소스가 잠기는 방법을 정의합니다.
properties.deploymentId	string	배포 스택에서 만든 배포 리소스의 resourceId입니다.
properties.deploymentScope	string	초기 배포를 만들어야 하는 범위입니다. 범위를 지정하지 않으면 기본적으로 배포 스택의 범위가 됩니다. 유효한 범위는 관리 그룹(형식: '/providers/Microsoft.Management/managementGroups/{managementGroupId}'), 구독(형식: '/subscriptions/{subscriptionId}'), 리소스 그룹(형식: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}')입니다.
properties.description	string maxLength: 4096	배포 스택 설명입니다. 최대 길이는 4096자입니다.
properties.detachedResources	ResourceReference[]	가장 최근의 배포 스택 업데이트 중에 분리된 리소스 배열입니다. 분리됨은 리소스가 템플릿에서 제거되었지만 관련 삭제 작업이 지정되지 않았음을 의미합니다. 따라서 리소스는 더 이상 스택과 연결되지 않는 동안 여전히 존재합니다.
properties.duration	string	마지막으로 성공한 배포 스택 업데이트의 기간입니다.
properties.error	ErrorDetail	오류 세부 정보입니다.
properties.failedResources	ResourceReferenceExtended[]	가장 최근 업데이트 중에 목표 상태에 도달하지 못한 리소스의 배열입니다. 각 resourceId에는 오류 메시지가 함께 표시됩니다.
properties.outputs		배포 스택에서 만든 배포 리소스의 출력입니다.
properties.parameters	<string, DeploymentParameter>	템플릿의 배포 매개 변수를 정의하는 이름 및 값 쌍입니다. 기존 매개 변수 파일에 연결하는 대신 요청에 직접 매개 변수 값을 제공할 때 이 요소를 사용합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다.
properties.parametersLink	DeploymentStacksParametersLink	매개 변수 파일의 URI입니다. 이 요소를 사용하여 기존 매개 변수 파일에 연결합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다.
properties.provisioningState	DeploymentStackProvisioningState	배포 스택의 상태입니다.
properties.resources	ManagedResourceReference[]	현재 배포 스택에서 관리되는 리소스의 배열입니다.
properties.template		템플릿 콘텐츠입니다. 기존 템플릿에 연결하는 대신 요청에 직접 템플릿 구문을 전달하려는 경우 이 요소를 사용합니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다.
properties.templateLink	DeploymentStacksTemplateLink	템플릿의 URI입니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

DeploymentStackListResult

Object

DeploymentStack 목록 작업의 응답입니다.

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	DeploymentStack[]	이 페이지의 DeploymentStack 항목

DeploymentStackProvisioningState

열거형

배포 스택의 상태입니다.

값	Description
creating	배포 스택이 현재 생성되고 있습니다.
validating	배포 스택이 현재 검증되고 있습니다.
waiting	배포 스택이 현재 대기 중입니다.
deploying	배포 스택이 현재 배포 중입니다.
canceling	배포 스택이 취소되고 있습니다.
updatingDenyAssignments	배포 스택이 거부 할당을 업데이트하고 있습니다.
deletingResources	배포 스택이 리소스를 삭제하고 있습니다.
succeeded	배포 스택이 성공적으로 완료되었습니다.
failed	배포 스택이 실패했습니다.
canceled	배포 스택이 취소되었습니다.
deleting	배포 스택이 삭제되고 있습니다.

DeploymentStacksDebugSetting

Object

디버그 설정입니다.

Name	형식	Description
detailLevel	string	디버깅을 위해 기록할 정보의 유형을 지정합니다. 허용되는 값은 none, requestContent, responseContent 또는 requestContent와 responseContent를 모두 쉼표로 구분합니다. 기본값은 none입니다. 이 값을 설정할 때 배포 중에 전달되는 정보 유형을 신중하게 고려합니다. 요청 또는 응답에 대한 정보를 로깅하면 배포 작업을 통해 검색되는 중요한 데이터가 잠재적으로 노출될 수 있습니다.

DeploymentStacksParametersLink

Object

배포 매개 변수에 대한 참조를 나타내는 엔터티입니다.

Name	형식	Description
contentVersion	string	포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.
uri	string	매개 변수 파일의 URI입니다.

DeploymentStacksTemplateLink

Object

템플릿에 대한 참조를 나타내는 엔터티입니다.

Name	형식	Description
contentVersion	string	포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.
id	string	템플릿 사양의 resourceId입니다. id 또는 uri 속성 중 하나를 사용하되 둘 다 사용할 수는 없습니다.
queryString	string	templateLink URI와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다.
relativePath	string	relativePath 속성을 사용하여 부모에 상대적인 위치에 연결된 템플릿을 배포할 수 있습니다. 부모 템플릿이 TemplateSpec과 연결된 경우 TemplateSpec의 아티팩트를 참조합니다. 부모가 URI와 연결된 경우 자식 배포는 부모 및 relativePath URI의 조합이 됩니다.
uri	string	배포할 템플릿의 URI입니다. URI 또는 ID 속성을 사용하지만 둘 다 사용하지는 않습니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

KeyVaultParameterReference

Object

Azure Key Vault 매개 변수 참조.

Name	형식	Description
keyVault	KeyVaultReference	Azure Key Vault 참조.
secretName	string	Azure Key Vault 비밀 이름입니다.
secretVersion	string	Azure Key Vault 비밀 버전입니다.

KeyVaultReference

Object

Azure Key Vault 참조.

Name	형식	Description
id	string	Azure Key Vault resourceId입니다.

ManagedResourceReference

Object

관리되는 리소스 모델입니다.

Name	형식	Default value	Description
denyStatus	DenyStatusMode	none	리소스에 적용된 denyAssignment 설정입니다.
id	string		배포 스택에서 관리하는 리소스의 ARM 리소스 ID입니다.
status	ResourceStatusMode	none	배포 스택에 있는 리소스의 현재 관리 상태입니다.

ResourceReference

Object

resourceId 모델입니다.

Name	형식	Description
id	string	배포 스택에서 관리하는 리소스의 ARM 리소스 ID입니다.

ResourceReferenceExtended

Object

resourceId 확장 모델입니다. 이는 resourceId 및 해당 오류와 함께 실패한 리소스를 문서화하는 데 사용됩니다.

Name	형식	Description
error	ErrorDetail	오류 세부 정보입니다.
id	string	배포 스택에서 관리하는 리소스의 ARM 리소스 ID입니다.

ResourceStatusMode

열거형

배포 스택에 있는 리소스의 현재 관리 상태입니다.

값	Description
managed	이 리소스는 배포 스택에서 관리됩니다.
removeDenyFailed	리소스에 대한 거부 할당을 제거할 수 없습니다.
deleteFailed	Azure에서 리소스를 삭제할 수 없습니다. 삭제는 다음 스택 배포에서 다시 시도되거나 수동으로 삭제될 수 있습니다.
none	관리 상태가 없습니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UnmanageActionManagementGroupMode

열거형

새로 관리되지 않는 리소스에 대한 작업을 지정합니다.

값	Description
delete	Azure에서 관리 그룹을 삭제하세요.
detach	관리 그룹은 Azure에 두세요.

UnmanageActionResourceGroupMode

열거형

새로 관리되지 않은 자원 그룹에 대한 행동을 지정합니다.

값	Description
delete	Azure에서 리소스 그룹을 삭제하세요.
detach	리소스 그룹은 Azure에 유지하세요.

UnmanageActionResourceMode

열거형

새로 관리되지 않는 리소스에 대한 작업을 지정합니다.

값	Description
delete	Azure에서 리소스를 삭제하세요
detach	리소스는 Azure에 보관하세요

다음을 통해 공유

Deployment Stacks - List At Management Group

URI 매개 변수

응답

보안

azure_auth

범위

예제

List management group Deployment stacks

샘플 요청

샘플 응답

정의

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