다음을 통해 공유


Azure 리소스 관리자

Azure Resource Manager는 모든 Azure 리소스를 관리하기 위해 API를 노출합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 모든 Power Automate 지역
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps Premium 모든 Power Apps 지역
Power Automate Premium 모든 Power Automate 지역
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://azure.microsoft.com/features/resource-manager/

알려진 문제 및 제한 사항

  • "APIM 토큰 헤더에서 연결 참조 이름 'shared_office365'에 대한 유효한 연결을 찾을 수 없습니다"라는 메시지가 표시되는 경우 다음을 수행하여 문제를 해결할 수 있습니다.
    • 브라우저의 캐시를 지웁다.
    • 연결을 삭제한 다음 다시 추가합니다.
  • 구독 리소스 태그 나열 작업은 태그 데이터를 관리하는 기본 서비스 내의 제한 사항으로 인해 삭제된 태그 데이터를 끌어올 수 있습니다.
  • 기본적으로 Power Automate의 ARM 커넥터는 Azure Key Vault 비밀에 대한 직접 사용자 역할 할당을 지원하지 않습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 1200 60초

동작

공급자에서 리소스 읽기

리소스 개체를 읽습니다.

공급자에서 리소스 작업 호출

Azure 리소스에 대한 작업을 호출합니다.

구독 리소스 태그 값 만들기 또는 업데이트

구독 리소스 태그 값을 만들거나 업데이트합니다.

구독 리소스 태그 값 삭제

구독 리소스 태그 값을 삭제합니다.

구독 리소스 태그 나열

모든 구독 리소스 태그를 나열합니다.

구독 리소스 태그 이름 만들기 또는 업데이트

구독 리소스 태그 이름을 만들거나 업데이트합니다.

구독 리소스 태그 이름 삭제

구독 리소스 태그 이름을 삭제합니다.

구독 목록

보안 주체가 액세스할 수 있는 모든 구독의 목록을 가져옵니다.

구독 위치를 나열합니다.

구독에 사용할 수 있는 위치를 나열합니다.

구독 읽기

특정 구독에 대한 세부 정보를 읽습니다.

구독별 리소스 나열

특정 구독에서 모든 리소스를 읽습니다. 결과는 1,000개 이상의 레코드로 페이지를 매깁니다.

기존 리소스 그룹 업데이트

기존 리소스 그룹을 업데이트합니다. 리소스가 없으면 이 요청이 실패합니다.

리소스 공급자 나열

구독에 사용할 수 있는 리소스 공급자를 나열합니다.

리소스 공급자 등록

구독에 사용할 리소스 공급자를 등록합니다. 그러면 서비스에 대한 사용 권한이 구독에 프로비전됩니다.

리소스 공급자 등록 취소

구독에서 공급자 등록을 취소합니다. 구독에 해당 리소스 공급자의 리소스가 있는 경우 이 작업이 실패합니다.

리소스 공급자 읽기

구독 내에서 특정 리소스 공급자를 읽습니다.

리소스 그룹 나열

구독 내의 모든 리소스 그룹을 나열합니다. 결과는 1,000개 이상의 레코드로 페이지를 매깁니다.

리소스 그룹 만들기 또는 업데이트

리소스 그룹을 만들거나 업데이트합니다. 응답 코드를 사용하여 만들기(201) 또는 업데이트(200)를 구분할 수 있습니다.

리소스 그룹 삭제

구독 내에서 특정 리소스 그룹을 삭제합니다.

리소스 그룹 읽기

구독 내의 특정 리소스 그룹을 읽습니다.

리소스 그룹 템플릿 내보내기

기존 리소스 그룹에서 배포 템플릿을 내보냅니다. 이는 기본 리소스에 Microsoft에서 정의한 스키마가 있는 경우에만 성공할 수 있습니다.

리소스 그룹별 리소스 나열

리소스 그룹의 모든 리소스를 나열합니다.

리소스 만들기 또는 업데이트

리소스를 만들거나 업데이트합니다. 응답 코드를 사용하여 만들기(201) 또는 업데이트(200)를 구분할 수 있습니다.

리소스 삭제

리소스를 삭제합니다.

리소스 읽기

리소스 개체를 읽습니다.

리소스 작업 호출

Azure 리소스에 대한 작업을 호출합니다.

배포 템플릿 내보내기

이전 리소스 그룹 배포에서 템플릿을 내보냅니다.

템플릿 배포 나열

모든 리소스 그룹 템플릿 배포를 나열합니다. 이 작업은 지금까지 프로비전된 내용을 파악하는 데 유용합니다.

템플릿 배포 만들기 또는 업데이트

명명된 리소스 그룹 템플릿 배포를 만들거나 업데이트합니다. 요청이 성공하려면 템플릿 및 매개 변수가 필요합니다.

템플릿 배포 삭제

리소스 그룹 템플릿 배포를 삭제합니다. 리소스는 삭제되지 않습니다. 템플릿 배포에 대한 메타데이터만 있습니다.

템플릿 배포 유효성 검사

배포 템플릿의 유효성을 검사합니다. 이 작업에는 부작용이 없으며 템플릿 배포에서 구문 또는 논리적 오류를 테스트하는 데 사용할 수 있습니다.

템플릿 배포 읽기

리소스 그룹 내에서 템플릿 배포를 읽습니다.

템플릿 배포 작업 읽기

특정 리소스 그룹 템플릿 배포 작업을 읽습니다. 이는 실패한 템플릿 배포 문제를 해결하는 데 유용합니다.

템플릿 배포 작업을 나열합니다.

모든 템플릿 배포 작업을 나열합니다. 이는 실패한 템플릿 배포 문제를 해결하는 데 유용합니다.

템플릿 배포 취소

현재 실행 중인 템플릿 배포를 취소합니다. 보류 중인 모든 템플릿 작업이 일시 중단됩니다.

공급자에서 리소스 읽기

리소스 개체를 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

반환

리소스 정보입니다.

공급자에서 리소스 작업 호출

Azure 리소스에 대한 작업을 호출합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

반환

작업의 응답입니다.

응답
object

구독 리소스 태그 값 만들기 또는 업데이트

구독 리소스 태그 값을 만들거나 업데이트합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

태그 이름
tagName True string

태그의 이름입니다.

태그 값
tagValue True string

태그의 값입니다.

반환

태그 정보입니다.

TagValue

구독 리소스 태그 값 삭제

구독 리소스 태그 값을 삭제합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

태그 이름
tagName True string

태그의 이름입니다.

태그 값
tagValue True string

태그의 값입니다.

구독 리소스 태그 나열

모든 구독 리소스 태그를 나열합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

반환

구독 태그 목록입니다.

구독 리소스 태그 이름 만들기 또는 업데이트

구독 리소스 태그 이름을 만들거나 업데이트합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

태그 이름
tagName True string

태그의 이름입니다.

반환

태그 세부 정보입니다.

구독 리소스 태그 이름 삭제

구독 리소스 태그 이름을 삭제합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

태그 이름
tagName True string

태그의 이름입니다.

구독 목록

보안 주체가 액세스할 수 있는 모든 구독의 목록을 가져옵니다.

반환

구독 목록 작업 응답입니다.

구독 위치를 나열합니다.

구독에 사용할 수 있는 위치를 나열합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

반환

위치 목록 작업 응답입니다.

구독 읽기

특정 구독에 대한 세부 정보를 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

반환

구독 정보입니다.

구독별 리소스 나열

특정 구독에서 모든 리소스를 읽습니다. 결과는 1,000개 이상의 레코드로 페이지를 매깁니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

Filter
$filter string

작업에 적용할 필터입니다.

확장
$expand string

$expand 쿼리 매개 변수입니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

반환

리소스 목록입니다.

기존 리소스 그룹 업데이트

기존 리소스 그룹을 업데이트합니다. 리소스가 없으면 이 요청이 실패합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

아이디
id string

리소스 그룹의 ID(예: /subscriptions/XXX/resourceGroups/YYY)입니다.

이름
name string

리소스 그룹의 이름입니다.

위치
location True string

리소스 그룹의 위치입니다. 리소스 그룹을 만든 후에는 변경할 수 없습니다. 지원되는 Azure 위치(예: 미국 서부, 미국 동부, 서유럽, 동아시아 등) 중 하나여야 합니다.

에 의해 관리됨
managedBy string

이 리소스 그룹을 관리하는 리소스의 ID입니다.

태그들
tags object

리소스 그룹에 연결된 태그입니다.

프로비전 상태
provisioningState string

프로비전 상태입니다.

반환

리소스 그룹 정보입니다.

리소스 공급자 나열

구독에 사용할 수 있는 리소스 공급자를 나열합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

확장
$expand string

$expand 쿼리 매개 변수입니다.

반환

리소스 공급자 목록입니다.

리소스 공급자 등록

구독에 사용할 리소스 공급자를 등록합니다. 그러면 서비스에 대한 사용 권한이 구독에 프로비전됩니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

반환

리소스 공급자 정보입니다.

Provider

리소스 공급자 등록 취소

구독에서 공급자 등록을 취소합니다. 구독에 해당 리소스 공급자의 리소스가 있는 경우 이 작업이 실패합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

반환

리소스 공급자 정보입니다.

Provider

리소스 공급자 읽기

구독 내에서 특정 리소스 공급자를 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

확장
$expand string

$expand 쿼리 매개 변수입니다.

반환

리소스 공급자 정보입니다.

Provider

리소스 그룹 나열

구독 내의 모든 리소스 그룹을 나열합니다. 결과는 1,000개 이상의 레코드로 페이지를 매깁니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

Filter
$filter string

작업에 적용할 필터입니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

반환

리소스 그룹 목록입니다.

리소스 그룹 만들기 또는 업데이트

리소스 그룹을 만들거나 업데이트합니다. 응답 코드를 사용하여 만들기(201) 또는 업데이트(200)를 구분할 수 있습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹 이름
resourceGroupName True string

만들거나 업데이트할 리소스 그룹의 이름입니다.

아이디
id string

리소스 그룹의 ID(예: /subscriptions/XXX/resourceGroups/YYY)입니다.

이름
name string

리소스 그룹의 이름입니다.

위치
location True string

리소스 그룹의 위치입니다. 리소스 그룹을 만든 후에는 변경할 수 없습니다. 지원되는 Azure 위치(예: 미국 서부, 미국 동부, 서유럽, 동아시아 등) 중 하나여야 합니다.

에 의해 관리됨
managedBy string

이 리소스 그룹을 관리하는 리소스의 ID입니다.

태그들
tags object

리소스 그룹에 연결된 태그입니다.

프로비전 상태
provisioningState string

프로비전 상태입니다.

반환

리소스 그룹 정보입니다.

리소스 그룹 삭제

구독 내에서 특정 리소스 그룹을 삭제합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

리소스 그룹 읽기

구독 내의 특정 리소스 그룹을 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

반환

리소스 그룹 정보입니다.

리소스 그룹 템플릿 내보내기

기존 리소스 그룹에서 배포 템플릿을 내보냅니다. 이는 기본 리소스에 Microsoft에서 정의한 스키마가 있는 경우에만 성공할 수 있습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

resources
resources array of string

리소스의 ID입니다. 현재 지원되는 유일한 문자열은 '*'(모든 리소스)입니다. 향후 API 업데이트는 특정 리소스 내보내기를 지원합니다.

options
options string

템플릿 내보내기 옵션입니다. 지원되는 값으로는 'IncludeParameterDefaultValue', 'IncludeComments' 또는 'IncludeParameterDefaultValue, IncludeComments

반환

리소스 그룹별 리소스 나열

리소스 그룹의 모든 리소스를 나열합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

Filter
$filter string

작업에 적용할 필터입니다.

확장
$expand string

$expand 쿼리 매개 변수입니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

반환

리소스 목록입니다.

리소스 만들기 또는 업데이트

리소스를 만들거나 업데이트합니다. 응답 코드를 사용하여 만들기(201) 또는 업데이트(200)를 구분할 수 있습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

아이디
id string

리소스 ID

이름
name string

리소스 이름

유형
type string

리소스 종류

위치
location string

리소스 위치

태그들
tags object

리소스 태그

아이디
name string

계획 ID입니다.

게시자
publisher string

게시자 ID입니다.

제품
product string

제품 ID입니다.

승격 코드
promotionCode string

승격 코드입니다.

Kind
kind string

리소스의 종류입니다.

에 의해 관리됨
managedBy string

이 리소스를 관리하는 리소스의 ID입니다.

이름
name string

SKU 이름입니다.

계층
tier string

sku 계층입니다.

Size
size string

sku 크기입니다.

패밀리
family string

sku 패밀리입니다.

Model
model string

sku 모델입니다.

Capacity
capacity integer

sku 용량입니다.

보안 주체 ID
principalId string

리소스 ID의 보안 주체 ID입니다.

테넌트 ID
tenantId string

리소스의 테넌트 ID입니다.

유형
type string

ID 형식입니다.

속성
properties object

리소스 속성입니다.

반환

리소스 정보입니다.

리소스 삭제

리소스를 삭제합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

리소스 읽기

리소스 개체를 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

반환

리소스 정보입니다.

리소스 작업 호출

Azure 리소스에 대한 작업을 호출합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

리소스 공급자
resourceProviderNamespace True string

리소스 공급자의 네임스페이스입니다.

짧은 리소스 ID
shortResourceId True string

리소스 이름 및 리소스 종류를 포함하여 리소스의 짧은 ID입니다. 예를 들어 sites/mySite

클라이언트 API 버전
x-ms-api-version True string

사용할 API 버전입니다.

작업 이름
actionName True string

호출할 리소스 작업의 이름

반환

작업 작업의 응답입니다.

작업 응답
object

배포 템플릿 내보내기

이전 리소스 그룹 배포에서 템플릿을 내보냅니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

반환

배포 내보내기 결과입니다.

템플릿 배포 나열

모든 리소스 그룹 템플릿 배포를 나열합니다. 이 작업은 지금까지 프로비전된 내용을 파악하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

Filter
$filter string

작업에 적용할 필터입니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

반환

배포 목록입니다.

템플릿 배포 만들기 또는 업데이트

명명된 리소스 그룹 템플릿 배포를 만들거나 업데이트합니다. 요청이 성공하려면 템플릿 및 매개 변수가 필요합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

배포의 이름입니다.

템플릿 콘텐츠
template object

템플릿 콘텐츠입니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. 템플릿 또는 TemplateLink 중 하나만 사용합니다.

템플릿 URI
uri True string

템플릿을 참조하는 URI입니다.

템플릿 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

매개 변수
parameters object

배포 매개 변수입니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. 매개 변수 또는 ParametersLink 중 하나만 사용합니다.

매개 변수 URI
uri True string

템플릿을 참조하는 URI입니다.

매개 변수 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

배포 모드
mode True string

배포 모드입니다.

세부 정보 수준
detailLevel string

디버그 세부 정보 수준입니다.

배포 대기
wait boolean

작업이 배포가 완료될 때까지 기다려야 하는 경우

반환

배포 정보입니다.

템플릿 배포 삭제

리소스 그룹 템플릿 배포를 삭제합니다. 리소스는 삭제되지 않습니다. 템플릿 배포에 대한 메타데이터만 있습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

템플릿 배포 유효성 검사

배포 템플릿의 유효성을 검사합니다. 이 작업에는 부작용이 없으며 템플릿 배포에서 구문 또는 논리적 오류를 테스트하는 데 사용할 수 있습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

템플릿 콘텐츠
template object

템플릿 콘텐츠입니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. 템플릿 또는 TemplateLink 중 하나만 사용합니다.

템플릿 URI
uri True string

템플릿을 참조하는 URI입니다.

템플릿 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

매개 변수
parameters object

배포 매개 변수입니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. 매개 변수 또는 ParametersLink 중 하나만 사용합니다.

매개 변수 URI
uri True string

템플릿을 참조하는 URI입니다.

매개 변수 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

배포 모드
mode True string

배포 모드입니다.

세부 정보 수준
detailLevel string

디버그 세부 정보 수준입니다.

반환

템플릿 배포 응답의 유효성을 검사하는 정보입니다.

템플릿 배포 읽기

리소스 그룹 내에서 템플릿 배포를 읽습니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

배포 대기
wait boolean

작업이 배포가 완료될 때까지 기다려야 하는 경우

반환

배포 정보입니다.

템플릿 배포 작업 읽기

특정 리소스 그룹 템플릿 배포 작업을 읽습니다. 이는 실패한 템플릿 배포 문제를 해결하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

작업 ID
operationId True string

작업 ID입니다.

반환

배포 작업 정보입니다.

템플릿 배포 작업을 나열합니다.

모든 템플릿 배포 작업을 나열합니다. 이는 실패한 템플릿 배포 문제를 해결하는 데 유용합니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

Top
$top integer

쿼리 매개 변수입니다. 아무 값도 전달되지 않으면 모든 값이 반환됩니다.

반환

배포 작업 목록입니다.

템플릿 배포 취소

현재 실행 중인 템플릿 배포를 취소합니다. 보류 중인 모든 템플릿 작업이 일시 중단됩니다.

매개 변수

Name 필수 형식 Description
Subscription
subscriptionId True string

Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다.

리소스 그룹
resourceGroupName True string

리소스 그룹 이름

배포 이름
deploymentName True string

리소스 그룹 템플릿 배포의 이름입니다.

정의

위치

위치 정보입니다.

Name 경로 형식 Description
아이디
id string

위치의 정규화된 ID입니다. 예를 들어 /subscriptions/00000000-0000-0000-0000-000000000000000/locations/westus.

구독 ID
subscriptionId string

구독 ID입니다.

위치 이름
name string

위치 이름입니다.

표시 이름
displayName string

위치의 표시 이름입니다.

위도
latitude string

위치의 위도입니다.

경도
longitude string

위치의 경도입니다.

LocationListResult

위치 목록 작업 응답입니다.

Name 경로 형식 Description
value
value array of Location

위치입니다.

Subscription

구독 정보입니다.

Name 경로 형식 Description
아이디
id string

정규화된 ID입니다. 예를 들어 /subscriptions/00000000-0000-0000-0000-0000000000000000입니다.

구독 ID
subscriptionId string

구독 ID입니다.

테넌트 ID
tenantId string

테넌트 ID입니다.

표시 이름
displayName string

구독 표시 이름입니다.

state string

구독 상태입니다.

구독 정책
subscriptionPolicies SubscriptionPolicies

구독 정책.

권한 부여 원본
authorizationSource string

요청의 권한 부여 원본입니다. 유효한 값은 레거시, RoleBased, Bypassed, Direct 및 Management의 하나 이상의 조합입니다. 예를 들어 '레거시, RoleBased'입니다.

SubscriptionPolicies

구독 정책.

Name 경로 형식 Description
위치 배치 ID
locationPlacementId string

구독 위치 배치 ID입니다. ID는 구독에 대해 표시되는 지역을 나타냅니다. 예를 들어 위치 배치 ID가 Public_2014-09-01인 구독은 Azure 공용 지역에 액세스할 수 있습니다.

할당량 ID
quotaId string

구독 할당량 ID입니다.

지출 한도
spendingLimit string

구독 지출 한도입니다.

SubscriptionListResult

구독 목록 작업 응답입니다.

Name 경로 형식 Description
value
value array of Subscription

구독입니다.

다음 링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

템플릿링크

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

Name 경로 형식 Description
템플릿 URI
uri string

템플릿을 참조하는 URI입니다.

템플릿 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

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

Name 경로 형식 Description
매개 변수 URI
uri string

템플릿을 참조하는 URI입니다.

매개 변수 콘텐츠 버전
contentVersion string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

디버그 설정

Name 경로 형식 Description
세부 정보 수준
detailLevel string

디버그 세부 정보 수준입니다.

DeploymentExportResult

배포 내보내기 결과입니다.

Name 경로 형식 Description
Template
template object

템플릿 콘텐츠입니다.

ResourceManagementErrorWithDetails

Name 경로 형식 Description
코드
code string

서버에서 반환된 오류 코드입니다.

message
message string

서버에서 반환된 오류 메시지입니다.

target
target string

오류의 대상입니다.

details
details array of object

유효성 검사 오류입니다.

AliasPathType

별칭에 대한 경로의 형식입니다.

Name 경로 형식 Description
path
path string

별칭의 경로입니다.

api버전
apiVersions array of string

API 버전입니다.

AliasType

별칭 형식입니다.

Name 경로 형식 Description
이름
name string

별칭 이름입니다.

경로
paths array of AliasPathType

별칭의 경로입니다.

ProviderResourceType

리소스 공급자가 관리하는 리소스 종류입니다.

Name 경로 형식 Description
resourceType
resourceType string

리소스 종류입니다.

위치
locations array of ObjectWithoutType

이 리소스 종류를 만들 수 있는 위치의 컬렉션입니다.

aliases
aliases array of AliasType

이 리소스 종류에서 지원하는 별칭입니다.

api버전
apiVersions array of string

api 버전입니다.

properties
properties object

속성입니다.

Provider

리소스 공급자 정보입니다.

Name 경로 형식 Description
아이디
id string

공급자 ID입니다.

네임스페이스
namespace string

공급자의 네임스페이스입니다.

등록 상태
registrationState string

공급자의 등록 상태입니다.

리소스 종류
resourceTypes array of ProviderResourceType

공급자 리소스 유형의 컬렉션입니다.

BasicDependency

배포 종속성 정보입니다.

Name 경로 형식 Description
아이디
id string

종속성의 ID입니다.

resourceType
resourceType string

종속성 리소스 종류입니다.

resourceName
resourceName string

종속성 리소스 이름입니다.

의존성

배포 종속성 정보입니다.

Name 경로 형식 Description
dependsOn
dependsOn array of BasicDependency

종속성 목록입니다.

아이디
id string

종속성의 ID입니다.

resourceType
resourceType string

종속성 리소스 종류입니다.

resourceName
resourceName string

종속성 리소스 이름입니다.

DeploymentPropertiesExtended

추가 세부 정보가 있는 배포 속성입니다.

Name 경로 형식 Description
provisioningState
provisioningState string

프로비전의 상태입니다.

correlationId
correlationId string

배포의 상관 관계 ID입니다.

시간표시
timestamp date-time

템플릿 배포의 타임스탬프입니다.

출력
outputs object

deploymentoutput을 나타내는 키/값 쌍입니다.

providers
providers array of Provider

배포에 필요한 리소스 공급자 목록입니다.

종속성
dependencies array of Dependency

배포 종속성 목록입니다.

템플릿
template object

템플릿 콘텐츠입니다. 템플릿 또는 TemplateLink 중 하나만 사용합니다.

템플릿링크
templateLink TemplateLink

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

parameters
parameters object

배포 매개 변수입니다. 매개 변수 또는 ParametersLink 중 하나만 사용합니다.

파라미터Link
parametersLink ParametersLink

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

배포 모드
mode string

배포 모드입니다.

디버그세팅
debugSetting DebugSetting

DeploymentValidateResult

템플릿 배포 응답의 유효성을 검사하는 정보입니다.

Name 경로 형식 Description
오류
error ResourceManagementErrorWithDetails
properties
properties DeploymentPropertiesExtended

추가 세부 정보가 있는 배포 속성입니다.

DeploymentExtended

배포 정보입니다.

Name 경로 형식 Description
아이디
id string

배포의 ID입니다.

이름
name string

배포의 이름입니다.

properties
properties DeploymentPropertiesExtended

추가 세부 정보가 있는 배포 속성입니다.

DeploymentListResult

배포 목록입니다.

Name 경로 형식 Description
value
value array of DeploymentExtended

배포 목록입니다.

다음 링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

ProviderListResult

리소스 공급자 목록입니다.

Name 경로 형식 Description
value
value array of Provider

리소스 공급자 목록입니다.

넥스트링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

GenericResource

리소스 정보입니다.

Name 경로 형식 Description
아이디
id string

리소스 ID

이름
name string

리소스 이름

유형
type string

리소스 종류

위치
location string

리소스 위치

태그들
tags object

리소스 태그

계획
plan Plan

리소스를 계획합니다.

Kind
kind string

리소스의 종류입니다.

에 의해 관리됨
managedBy string

이 리소스를 관리하는 리소스의 ID입니다.

SKU
sku Sku

리소스에 대한 SKU입니다.

아이덴티티
identity Identity

리소스의 ID입니다.

속성
properties object

리소스 속성입니다.

Plan

리소스를 계획합니다.

Name 경로 형식 Description
아이디
name string

계획 ID입니다.

게시자
publisher string

게시자 ID입니다.

제품
product string

제품 ID입니다.

승격 코드
promotionCode string

승격 코드입니다.

Sku

리소스에 대한 SKU입니다.

Name 경로 형식 Description
이름
name string

SKU 이름입니다.

계층
tier string

sku 계층입니다.

Size
size string

sku 크기입니다.

패밀리
family string

sku 패밀리입니다.

Model
model string

sku 모델입니다.

Capacity
capacity integer

sku 용량입니다.

아이덴티티

리소스의 ID입니다.

Name 경로 형식 Description
보안 주체 ID
principalId string

리소스 ID의 보안 주체 ID입니다.

테넌트 ID
tenantId string

리소스의 테넌트 ID입니다.

유형
type string

ID 형식입니다.

ResourceListResult

리소스 목록입니다.

Name 경로 형식 Description
value
value array of GenericResource

리소스 목록입니다.

다음 링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

리소스 그룹

리소스 그룹 정보입니다.

Name 경로 형식 Description
아이디
id string

리소스 그룹의 ID(예: /subscriptions/XXX/resourceGroups/YYY)입니다.

이름
name string

리소스 그룹의 이름입니다.

위치
location string

리소스 그룹의 위치입니다. 리소스 그룹을 만든 후에는 변경할 수 없습니다. 지원되는 Azure 위치(예: 미국 서부, 미국 동부, 서유럽, 동아시아 등) 중 하나여야 합니다.

에 의해 관리됨
managedBy string

이 리소스 그룹을 관리하는 리소스의 ID입니다.

태그들
tags object

리소스 그룹에 연결된 태그입니다.

properties
properties ResourceGroupProperties

리소스 그룹 속성입니다.

ResourceGroupProperties

리소스 그룹 속성입니다.

Name 경로 형식 Description
프로비전 상태
provisioningState string

프로비전 상태입니다.

ResourceGroupListResult

리소스 그룹 목록입니다.

Name 경로 형식 Description
value
value array of ResourceGroup

리소스 그룹 목록입니다.

다음 링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

TagCount

태그 수입니다.

Name 경로 형식 Description
유형
type string

개수 유형입니다.

가치
value integer

개수 값입니다.

TagValue

태그 정보입니다.

Name 경로 형식 Description
태그 ID
id string

태그 ID입니다.

태그 값
tagValue string

태그 값입니다.

태그 수
count TagCount

태그 수입니다.

TagDetails

태그 세부 정보입니다.

Name 경로 형식 Description
아이디
id string

태그 ID입니다.

이름
tagName string

태그 이름입니다.

태그 수
count TagCount

태그 수입니다.

values
values array of TagValue

태그 값 목록입니다.

TagsListResult

구독 태그 목록입니다.

Name 경로 형식 Description
value
value array of TagDetails

태그 목록입니다.

넥스트링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

TargetResource

대상 리소스입니다.

Name 경로 형식 Description
아이디
id string

리소스의 ID입니다.

이름
resourceName string

리소스의 이름입니다.

유형
resourceType string

리소스의 형식입니다.

HttpMessage

Name 경로 형식 Description
내용
content object

HTTP 메시지 콘텐츠입니다.

DeploymentOperationProperties

배포 작업 속성입니다.

Name 경로 형식 Description
provisioningState
provisioningState string

프로비전의 상태입니다.

시간표시
timestamp date-time

작업의 날짜 및 시간입니다.

serviceRequestId
serviceRequestId string

배포 작업 서비스 요청 ID입니다.

상태 코드
statusCode string

작업 상태 코드입니다.

상태 메시지
statusMessage object

작업 상태 메시지입니다.

대상 리소스
targetResource TargetResource

대상 리소스입니다.

request
request HttpMessage
response
response HttpMessage

DeploymentOperation

배포 작업 정보입니다.

Name 경로 형식 Description
아이디
id string

전체 배포 작업 ID입니다.

작업 ID
operationId string

배포 작업 ID입니다.

properties
properties DeploymentOperationProperties

배포 작업 속성입니다.

DeploymentOperationsListResult

배포 작업 목록입니다.

Name 경로 형식 Description
value
value array of DeploymentOperation

배포 목록입니다.

다음 링크
nextLink string

다음 결과 집합을 가져올 URL입니다.

ResourceGroupExportResult

Name 경로 형식 Description
Template
template object

템플릿 콘텐츠입니다.

오류
error ResourceManagementErrorWithDetails

ObjectWithoutType

객체

이것은 '객체' 유형입니다.