Share via


Resource Groups - List

구독에 대한 모든 리소스 그룹을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups?api-version=2021-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups?$filter={$filter}&$top={$top}&api-version=2021-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
subscriptionId
path True

string

Microsoft Azure 구독 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

$filter
query

string

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

태그 이름 및 값을 기준으로 필터링할 수 있습니다. 예를 들어 태그 이름 및 값을 필터링하려면 $filter=tagName eq 'tag1' 및 tagValue eq 'Value1'을 사용합니다.

$top
query

integer

int32

반환할 결과 수입니다. null이 전달되면 는 모든 리소스 그룹을 반환합니다.

응답

Name 형식 Description
200 OK

ResourceGroupListResult

OK - 리소스 그룹의 배열을 반환합니다.

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

정의

Name Description
CloudError

리소스 관리 요청에 대한 오류 응답입니다.

ErrorAdditionalInfo

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

ErrorResponse

오류 응답

ResourceGroup

리소스 그룹 정보입니다.

ResourceGroupListResult

리소스 그룹의 목록입니다.

ResourceGroupProperties

리소스 그룹 속성입니다.

CloudError

리소스 관리 요청에 대한 오류 응답입니다.

Name 형식 Description
error

ErrorResponse

오류 응답
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorResponse

오류 응답

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorResponse[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ResourceGroup

리소스 그룹 정보입니다.

Name 형식 Description
id

string

리소스 그룹의 ID입니다.

location

string

리소스 그룹의 위치입니다. 리소스 그룹을 만든 후에는 변경할 수 없습니다. 지원되는 Azure 위치 중 하나여야 합니다.

managedBy

string

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

name

string

리소스 그룹의 이름.

properties

ResourceGroupProperties

리소스 그룹 속성입니다.

tags

object

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

type

string

리소스 그룹의 형식입니다.

ResourceGroupListResult

리소스 그룹의 목록입니다.

Name 형식 Description
nextLink

string

다음 결과 집합을 가져오는 데 사용할 URL입니다.

value

ResourceGroup[]

리소스 그룹의 배열입니다.

ResourceGroupProperties

리소스 그룹 속성입니다.

Name 형식 Description
provisioningState

string

프로비저닝 상태입니다.