다음을 통해 공유


Guest Configuration Assignments - Subscription List

구독에 대한 모든 게스트 구성 할당을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments?api-version=2022-01-25

URI 매개 변수

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

string

Microsoft Azure 구독을 고유하게 식별하는 구독 ID입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True

string

클라이언트 API 버전.

응답

Name 형식 Description
200 OK

GuestConfigurationAssignmentList

정상

204 No Content

내용 없음

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 사용자 계정 가장

예제

List all guest configuration assignments for a subscription

샘플 요청

GET https://management.azure.com/subscriptions/mySubscriptionId/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments?api-version=2022-01-25

샘플 응답

[
  {
    "location": "centraluseuap",
    "id": "/subscriptions/subscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/AuditSecureProtocol2",
    "name": "AuditSecureProtocol2",
    "properties": {
      "complianceStatus": "Compliant",
      "assignmentHash": "content hash",
      "latestReportId": "/subscriptions/subscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/AuditSecureProtocol2/reports/7367cbb8-ae99-47d0-a33b-a283564d2cb1",
      "lastComplianceStatusChecked": "2018-08-29T22:14:13Z",
      "context": null,
      "guestConfiguration": {
        "kind": null,
        "name": "AuditSecureProtocol2",
        "version": "1.0.0.3",
        "contentUri": "https://mystorageaccount.blob.core.windows.net/builtinconfig/AuditSecureProtocol2/AuditSecureProtocol2_1.0.0.3.zip",
        "contentHash": "content hash",
        "configurationParameter": [],
        "configurationSetting": null
      },
      "provisioningState": null
    }
  },
  {
    "location": "centraluseuap",
    "id": "/subscriptions/subscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/myAssignment",
    "name": "myAssignment",
    "properties": {
      "complianceStatus": "Compliant",
      "assignmentHash": "content hash",
      "latestReportId": "/subscriptions/subscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/myAssignment/reports/7367cbb8-ae99-47d0-a33b-a283564d2cb1",
      "lastComplianceStatusChecked": "2018-08-29T22:14:13Z",
      "context": null,
      "guestConfiguration": {
        "kind": null,
        "name": "myAssignment",
        "version": "1.0.0.3",
        "contentUri": "https://mystorageaccount.blob.core.windows.net/builtinconfig/myAssignment/myAssignment.0.0.3.zip",
        "contentHash": "content hash",
        "configurationParameter": [],
        "configurationSetting": null
      },
      "provisioningState": null
    }
  }
]

정의

Name Description
actionAfterReboot

구성을 적용하는 동안 다시 부팅하면 어떤 일이 일어나는지 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다.

AssignmentInfo

게스트 구성 할당에 대한 정보입니다.

AssignmentReport
AssignmentReportResource

게스트 구성 할당 리소스입니다.

AssignmentReportResourceComplianceReason

게스트 구성 할당 리소스의 규정 준수 이유 및 코드입니다.

assignmentType

구성의 할당 유형 및 실행을 지정합니다. 가능한 값은 Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect 및 ApplyAndMonitor입니다.

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

ConfigurationInfo

구성에 대한 정보입니다.

configurationMode

LCM(로컬 Configuration Manager)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor및 ApplyAndAutoCorrect입니다.

ConfigurationParameter

구성 매개 변수를 나타냅니다.

ConfigurationSetting

LCM의 구성 설정(로컬 Configuration Manager).

createdByType

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

Error
ErrorResponse

작업 실패에 대한 오류 응답

GuestConfigurationAssignment

게스트 구성 할당은 컴퓨터와 게스트 구성 간의 연결입니다.

GuestConfigurationAssignmentList

게스트 구성 할당 목록 작업의 응답입니다.

GuestConfigurationAssignmentProperties

게스트 구성 할당 속성입니다.

GuestConfigurationNavigation

게스트 구성은 DSC 구성 및 해당 종속성을 캡슐화하는 아티팩트입니다. 아티팩트 는 DSC 구성(MOF)과 종속 리소스 및 모듈과 같은 기타 종속성을 포함하는 zip 파일입니다.

kind

게스트 구성의 종류입니다. 예: DSC

provisioningState

응답에만 표시되는 프로비전 상태입니다.

systemData

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

type

보고서 유형, 일관성 또는 초기

VMInfo

VM에 대한 정보입니다.

VMSSVMInfo

VMSS VM에 대한 정보

actionAfterReboot

구성을 적용하는 동안 다시 부팅하면 어떤 일이 일어나는지 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다.

Name 형식 Description
ContinueConfiguration

string

StopConfiguration

string

AssignmentInfo

게스트 구성 할당에 대한 정보입니다.

Name 형식 Description
configuration

ConfigurationInfo

구성에 대한 정보입니다.

name

string

게스트 구성 할당의 이름입니다.

AssignmentReport

Name 형식 Description
assignment

AssignmentInfo

게스트 구성 할당의 구성 세부 정보입니다.

complianceStatus

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

endTime

string

게스트 구성 할당 준수 상태 검사 종료 날짜 및 시간입니다.

id

string

게스트 구성 할당에 대한 보고서의 ARM 리소스 ID입니다.

operationType

type

보고서 유형, 일관성 또는 초기

reportId

string

구독, 리소스 그룹에서 게스트 구성 할당 보고서를 식별하는 GUID입니다.

resources

AssignmentReportResource[]

게스트 구성 할당 준수를 확인할 리소스 목록입니다.

startTime

string

게스트 구성 할당 준수 상태 검사 시작 날짜 및 시간입니다.

vm

VMInfo

VM에 대한 정보입니다.

AssignmentReportResource

게스트 구성 할당 리소스입니다.

Name 형식 Description
complianceStatus

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

properties

object

게스트 구성 할당 리소스의 속성입니다.

reasons

AssignmentReportResourceComplianceReason[]

리소스에 대한 규정 준수 이유 및 이유 코드입니다.

resourceId

string

게스트 구성 할당 리소스 설정의 이름입니다.

AssignmentReportResourceComplianceReason

게스트 구성 할당 리소스의 규정 준수 이유 및 코드입니다.

Name 형식 Description
code

string

게스트 구성 할당 리소스의 준수를 위한 코드입니다.

phrase

string

게스트 구성 할당 리소스를 준수하는 이유입니다.

assignmentType

구성의 할당 유형 및 실행을 지정합니다. 가능한 값은 Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect 및 ApplyAndMonitor입니다.

Name 형식 Description
ApplyAndAutoCorrect

string

ApplyAndMonitor

string

Audit

string

DeployAndAutoCorrect

string

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

Name 형식 Description
Compliant

string

NonCompliant

string

Pending

string

ConfigurationInfo

구성에 대한 정보입니다.

Name 형식 Description
name

string

구성의 이름입니다.

version

string

구성의 버전입니다.

configurationMode

LCM(로컬 Configuration Manager)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor및 ApplyAndAutoCorrect입니다.

Name 형식 Description
ApplyAndAutoCorrect

string

ApplyAndMonitor

string

ApplyOnly

string

ConfigurationParameter

구성 매개 변수를 나타냅니다.

Name 형식 Description
name

string

구성 매개 변수의 이름입니다.

value

string

구성 매개 변수의 값입니다.

ConfigurationSetting

LCM의 구성 설정(로컬 Configuration Manager).

Name 형식 Default value Description
actionAfterReboot

actionAfterReboot

구성을 적용하는 동안 다시 부팅하면 어떤 일이 일어나는지 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다.

allowModuleOverwrite

boolean

true인 경우 - 끌어오기 서비스에서 다운로드한 새 구성은 대상 노드의 이전 구성을 덮어쓸 수 있습니다. 그렇지 않으면 false입니다.

configurationMode

configurationMode

LCM(로컬 Configuration Manager)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor및 ApplyAndAutoCorrect입니다.

configurationModeFrequencyMins

number

15

현재 구성이 확인 및 적용되는 분 단위 빈도입니다. 이 속성은 ConfigurationMode 속성이 ApplyOnly로 설정되어 있을 경우 무시됩니다. 기본값은 15입니다.

rebootIfNeeded

boolean

다시 부팅이 필요한 구성이 적용된 후 노드를 자동으로 다시 부팅하려면 이 값을 true로 설정합니다. 그렇지 않으면 다시 부팅해야 하는 구성에 대해 노드를 수동으로 다시 부팅해야 합니다. 기본값은 false입니다. DSC 이외의 다른 항목(예: Windows Installer)에서 재부팅 조건을 시행하는 경우 이 설정을 사용하려면 설정을 xPendingReboot 모듈과 결합합니다.

refreshFrequencyMins

number

30

LCM에서 업데이트된 구성을 가져오기 위해 풀 서비스를 확인하는 분 단위 시간 간격입니다. 이 값은 LCM이 끌어오기 모드로 구성되지 않은 경우 무시됩니다. 기본값은 30입니다.

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

Error

Name 형식 Description
code

string

오류 코드

message

string

작업이 실패한 이유를 나타내는 세부 오류 메시지입니다.

ErrorResponse

작업 실패에 대한 오류 응답

Name 형식 Description
error

Error

GuestConfigurationAssignment

게스트 구성 할당은 컴퓨터와 게스트 구성 간의 연결입니다.

Name 형식 Description
id

string

게스트 구성 할당의 ARM 리소스 ID입니다.

location

string

VM이 있는 지역입니다.

name

string

게스트 구성 할당의 이름입니다.

properties

GuestConfigurationAssignmentProperties

게스트 구성 할당의 속성입니다.

systemData

systemData

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

type

string

리소스 형식입니다.

GuestConfigurationAssignmentList

게스트 구성 할당 목록 작업의 응답입니다.

Name 형식 Description
value

GuestConfigurationAssignment[]

게스트 구성 할당 작업 목록의 결과입니다.

GuestConfigurationAssignmentProperties

게스트 구성 할당 속성입니다.

Name 형식 Description
assignmentHash

string

구성 패키지 및 매개 변수의 결합된 해시입니다.

complianceStatus

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

context

string

게스트 구성 할당을 시작한 원본입니다. 예: Azure Policy

guestConfiguration

GuestConfigurationNavigation

할당할 게스트 구성입니다.

lastComplianceStatusChecked

string

마지막 규정 준수 상태 확인한 날짜 및 시간입니다.

latestAssignmentReport

AssignmentReport

마지막으로 보고된 게스트 구성 할당 보고서입니다.

latestReportId

string

게스트 구성 할당에 대한 최신 보고서의 ID입니다.

parameterHash

string

게스트 구성 할당에 대한 매개 변수 해시입니다.

provisioningState

provisioningState

응답에만 표시되는 프로비전 상태입니다.

resourceType

string

리소스 유형 - VMSS/VM

targetResourceId

string

VM 리소스 ID입니다.

vmssVMList

VMSSVMInfo[]

VMSS에 대한 VM 준수 데이터 목록

GuestConfigurationNavigation

게스트 구성은 DSC 구성 및 해당 종속성을 캡슐화하는 아티팩트입니다. 아티팩트 는 DSC 구성(MOF)과 종속 리소스 및 모듈과 같은 기타 종속성을 포함하는 zip 파일입니다.

Name 형식 Description
assignmentSource

string

구성의 원본을 지정합니다.

assignmentType

assignmentType

구성의 할당 유형 및 실행을 지정합니다. 가능한 값은 Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect 및 ApplyAndMonitor입니다.

configurationParameter

ConfigurationParameter[]

게스트 구성에 대한 구성 매개 변수입니다.

configurationProtectedParameter

ConfigurationParameter[]

게스트 구성에 대한 보호된 구성 매개 변수입니다.

configurationSetting

ConfigurationSetting

게스트 구성에 대한 구성 설정입니다.

contentHash

string

게스트 구성 패키지 및 구성 매개 변수의 결합된 해시입니다.

contentType

string

구성의 콘텐츠 형식을 지정합니다. 가능한 값은 Builtin 또는 Custom일 수 있습니다.

contentUri

string

게스트 구성 패키지가 업로드되는 스토리지의 URI입니다.

kind

kind

게스트 구성의 종류입니다. 예: DSC

name

string

게스트 구성의 이름입니다.

version

string

게스트 구성의 버전입니다.

kind

게스트 구성의 종류입니다. 예: DSC

Name 형식 Description
DSC

string

provisioningState

응답에만 표시되는 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Created

string

Failed

string

Succeeded

string

systemData

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

Name 형식 Description
createdAt

string

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

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

type

보고서 유형, 일관성 또는 초기

Name 형식 Description
Consistency

string

Initial

string

VMInfo

VM에 대한 정보입니다.

Name 형식 Description
id

string

VM의 Azure 리소스 ID입니다.

uuid

string

VM의 UUID(범용 고유 식별자)입니다.

VMSSVMInfo

VMSS VM에 대한 정보

Name 형식 Description
complianceStatus

complianceStatus

할당된 게스트 구성에 대한 컴퓨터의 규정 준수 상태 나타내는 값입니다.

lastComplianceChecked

string

마지막 규정 준수 상태 확인한 날짜 및 시간입니다.

latestReportId

string

게스트 구성 할당에 대한 최신 보고서의 ID입니다.

vmId

string

VM의 UUID입니다.

vmResourceId

string

VM의 Azure 리소스 ID입니다.