Guest Configuration Assignments - Subscription List

リファレンス

サービス:: Guest Configuration

API バージョン:: 2024-04-05

サブスクリプションのすべてのゲスト構成の割り当てを一覧表示します。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments?api-version=2024-04-05

URI パラメーター

名前	/	必須	型	説明
subscriptionId	path	True	string	Microsoft Azure サブスクリプションを一意に識別するサブスクリプション ID。サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。
api-version	query	True	string	クライアント API のバージョン。

応答

名前	型	説明
200 OK	GuestConfigurationAssignmentList	わかりました
204 No Content		コンテンツなし
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

List all guest configuration assignments for a subscription

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/mySubscriptionId/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments?api-version=2024-04-05

応答のサンプル

状態コード:: 200

[
  {
    "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
    }
  }
]

状態コード:: 204

定義

名前	説明
actionAfterReboot	構成の適用中に再起動した後の動作を指定します。指定できる値は ContinueConfiguration と StopConfiguration です。
AssignmentInfo	ゲスト構成の割り当てに関する情報。
AssignmentReport
AssignmentReportResource	ゲスト構成の割り当てリソース。
AssignmentReportResourceComplianceReason	ゲスト構成割り当てリソースのコンプライアンスの理由とコード。
assignmentType	構成の割り当ての種類と実行を指定します。指定できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。
complianceStatus	割り当てられたゲスト構成のマシンのコンプライアンス状態を示す値。
ConfigurationInfo	構成に関する情報。
configurationMode	LCM (ローカル構成マネージャー) が実際にターゲットノードに構成を適用する方法を指定します。指定できる値は、ApplyOnly、ApplyAndMonitor、ApplyAndAutoCorrect です。
ConfigurationParameter	構成パラメーターを表します。
ConfigurationSetting	LCM の構成設定 (ローカル構成マネージャー)。
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 です。

名前	型	説明
ContinueConfiguration	string
StopConfiguration	string

AssignmentInfo

ゲスト構成の割り当てに関する情報。

名前	型	説明
configuration	ConfigurationInfo	構成に関する情報。
name	string	ゲスト構成割り当ての名前。

AssignmentReport

名前	型	説明
assignment	AssignmentInfo	ゲスト構成割り当ての構成の詳細。
complianceStatus	complianceStatus	割り当てられたゲスト構成のマシンのコンプライアンス状態を示す値。
endTime	string	ゲスト構成の割り当てコンプライアンス状態チェックの終了日時。
id	string	ゲスト構成割り当てのレポートの ARM リソース ID。
operationType	type	レポートの種類、整合性、または初期
reportId	string	サブスクリプションのリソースグループの下にあるゲスト構成割り当てレポートを識別する GUID。
resources	AssignmentReportResource[]	ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。
startTime	string	ゲスト構成の割り当てコンプライアンス状態チェックの開始日時。
vm	VMInfo	VM に関する情報。

AssignmentReportResource

ゲスト構成の割り当てリソース。

名前	型	説明
complianceStatus	complianceStatus	割り当てられたゲスト構成のマシンのコンプライアンス状態を示す値。
properties	object	ゲスト構成割り当てリソースのプロパティ。
reasons	AssignmentReportResourceComplianceReason[]	リソースのコンプライアンス理由と理由コード。
resourceId	string	ゲスト構成割り当てリソース設定の名前。

AssignmentReportResourceComplianceReason

ゲスト構成割り当てリソースのコンプライアンスの理由とコード。

名前	型	説明
code	string	ゲスト構成の割り当てリソースに準拠するためのコード。
phrase	string	ゲスト構成割り当てリソースのコンプライアンスの理由。

assignmentType

構成の割り当ての種類と実行を指定します。指定できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。

名前	型	説明
ApplyAndAutoCorrect	string
ApplyAndMonitor	string
Audit	string
DeployAndAutoCorrect	string

complianceStatus

割り当てられたゲスト構成のマシンのコンプライアンス状態を示す値。

名前	型	説明
Compliant	string
NonCompliant	string
Pending	string

ConfigurationInfo

構成に関する情報。

名前	型	説明
name	string	構成の名前。
version	string	構成のバージョン。

configurationMode

LCM (ローカル構成マネージャー) が実際にターゲットノードに構成を適用する方法を指定します。指定できる値は、ApplyOnly、ApplyAndMonitor、ApplyAndAutoCorrect です。

名前	型	説明
ApplyAndAutoCorrect	string
ApplyAndMonitor	string
ApplyOnly	string

ConfigurationParameter

構成パラメーターを表します。

名前	型	説明
name	string	構成パラメーターの名前。
value	string	構成パラメーターの値。

ConfigurationSetting

LCM の構成設定 (ローカル構成マネージャー)。

名前	型	規定値	説明
actionAfterReboot	actionAfterReboot		構成の適用中に再起動した後の動作を指定します。指定できる値は ContinueConfiguration と StopConfiguration です。
allowModuleOverwrite	boolean		true の場合、プルサービスからダウンロードされた新しい構成は、ターゲットノード上の古い構成を上書きできます。それ以外の場合は false
configurationMode	configurationMode		LCM (ローカル構成マネージャー) が実際にターゲットノードに構成を適用する方法を指定します。指定できる値は、ApplyOnly、ApplyAndMonitor、ApplyAndAutoCorrect です。
configurationModeFrequencyMins	number	15	現在の構成を確認して適用する頻度 (分単位)。 ConfigurationMode プロパティが ApplyOnly に設定されている場合、このプロパティは無視されます。既定値は 15 です。
rebootIfNeeded	boolean		再起動を必要とする構成が適用された後にノードを自動的に再起動するには、これを true に設定します。それ以外の場合は、必要な構成に対してノードを手動で再起動する必要があります。既定値は false です。 DSC 以外 (Windows インストーラーなど) によって再起動条件が適用された場合にこの設定を使用するには、この設定を xPendingReboot モジュールと組み合わせます。
refreshFrequencyMins	number	30	LCM がプルサービスをチェックして更新された構成を取得する時間間隔 (分)。 LCM がプルモードで構成されていない場合、この値は無視されます。既定値は 30 です。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

Error

名前	型	説明
code	string	エラーコード。
message	string	操作が失敗した理由を示す詳細エラーメッセージ。

ErrorResponse

操作エラーのエラー応答

名前	型	説明
error	Error