다음을 통해 공유


Device Groups - Get

DeviceGroup을 가져옵니다. '.default' 및 '.unassigned'는 시스템 정의 값이며 제품 또는 디바이스 그룹 이름에 사용할 수 없습니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureSphere/catalogs/{catalogName}/products/{productName}/deviceGroups/{deviceGroupName}?api-version=2024-04-01

URI 매개 변수

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

string

카탈로그 이름

regex 패턴: ^[A-Za-z0-9_-]{1,50}$

deviceGroupName
path True

string

디바이스 그룹의 이름입니다.

regex 패턴: ^[A-Za-z0-9]{1,2}$|^[A-Za-z0-9][A-Za-z0-9\s]{1,48}[A-Za-z0-9]$|^\.default$|^\.unassigned$

productName
path True

string

제품 이름입니다.

regex 패턴: ^[\w][\w\s]{1,48}[\w]$|^\.default$|^\.unassigned$

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

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

응답

Name 형식 Description
200 OK

DeviceGroup

Azure 작업이 성공적으로 완료되었습니다.

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name Description
user_impersonation 사용자 계정 가장

예제

DeviceGroups_Get

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/MyProduct1/deviceGroups/MyDeviceGroup1?api-version=2024-04-01

샘플 응답

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup1/providers/Microsoft.AzureSphere/catalogs/MyCatalog1/products/MyProduct1/devicegroups/MyDeviceGroup1",
  "type": "microsoft.azureSphere/catalogs/products/devicegroups",
  "properties": {
    "description": "The description of MyDeviceGroup1",
    "osFeedType": "Retail",
    "updatePolicy": "UpdateAll"
  }
}

정의

Name Description
AllowCrashDumpCollection

크래시 덤프 값을 허용합니다.

createdByType

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

DeviceGroup

제품 리소스에 속하는 디바이스 그룹 리소스입니다.

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

OSFeedType

OS 피드 형식 값입니다.

ProvisioningState

리소스의 프로비전 상태입니다.

RegionalDataBoundary

지역 데이터 경계 값입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

UpdatePolicy

정책 값을 업데이트합니다.

AllowCrashDumpCollection

크래시 덤프 값을 허용합니다.

Name 형식 Description
Disabled

string

크래시 덤프 수집 사용 안 함

Enabled

string

크래시 덤프 수집 사용

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DeviceGroup

제품 리소스에 속하는 디바이스 그룹 리소스입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

리소스의 이름입니다.

properties.allowCrashDumpsCollection

AllowCrashDumpCollection

사용자가 크래시 덤프 수집을 허용하는지 정의하는 플래그입니다.

properties.description

string

디바이스 그룹에 대한 설명입니다.

properties.hasDeployment

boolean

디바이스 그룹에 대한 배포 상태입니다.

properties.osFeedType

OSFeedType

디바이스 그룹의 운영 체제 피드 유형입니다.

properties.provisioningState

ProvisioningState

마지막 작업의 상태입니다.

properties.regionalDataBoundary

RegionalDataBoundary

디바이스 그룹에 대한 지역 데이터 경계입니다.

properties.updatePolicy

UpdatePolicy

디바이스 그룹의 정책을 업데이트합니다.

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

OSFeedType

OS 피드 형식 값입니다.

Name 형식 Description
Retail

string

소매 OS 피드 유형입니다.

RetailEval

string

소매 평가 OS 피드 유형입니다.

ProvisioningState

리소스의 프로비전 상태입니다.

Name 형식 Description
Accepted

string

리소스 만들기 요청이 수락되었습니다.

Canceled

string

리소스 만들기가 취소되었습니다.

Deleting

string

리소스가 삭제되고 있습니다.

Failed

string

리소스를 만들지 못했습니다.

Provisioning

string

리소스가 프로비전되고 있습니다.

Succeeded

string

리소스가 생성되었습니다.

Updating

string

리소스가 업데이트되고 있습니다.

RegionalDataBoundary

지역 데이터 경계 값입니다.

Name 형식 Description
EU

string

EU 데이터 경계

None

string

데이터 경계 없음

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

UpdatePolicy

정책 값을 업데이트합니다.

Name 형식 Description
No3rdPartyAppUpdates

string

타사 앱 정책에 대한 업데이트가 없습니다.

UpdateAll

string

모든 정책을 업데이트합니다.