Guest Configuration Assignments - Get

リファレンス

サービス:: Guest Configuration

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

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

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

URI パラメーター

名前	/	必須	型	説明
guestConfigurationAssignmentName	path	True	string	ゲスト構成の割り当て名。
resourceGroupName	path	True	string	リソースグループ名。正規表現パターン: `^[-\w\._]+$`
subscriptionId	path	True	string	Microsoft Azure サブスクリプションを一意に識別するサブスクリプション ID。サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。
vmName	path	True	string	仮想マシンの名前。正規表現パターン: `^[a-zA-Z0-9][-a-zA-Z0-9_.]*[a-zA-Z0-9]$`
api-version	query	True	string	クライアント API のバージョン。

応答

名前	型	説明
200 OK	GuestConfigurationAssignment	わかりました。ゲスト構成の割り当てが正常に返されました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

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

例

Get a guest configuration assignment

GET https://management.azure.com/subscriptions/mySubscriptionId/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/SecureProtocol?api-version=2024-04-05

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.GuestConfiguration.Models;
using Azure.ResourceManager.GuestConfiguration;

// Generated from example definition: specification/guestconfiguration/resource-manager/Microsoft.GuestConfiguration/stable/2024-04-05/examples/getGuestConfigurationAssignment.json
// this example is just showing the usage of "GuestConfigurationAssignments_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://video2.skills-academy.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ArmResource created on azure
// for more information of creating ArmResource, please refer to the document of ArmResource

// get the collection of this GuestConfigurationVmAssignmentResource
string subscriptionId = "mySubscriptionId";
string resourceGroupName = "myResourceGroupName";
string vmName = "myVMName";
ResourceIdentifier scopeId = new ResourceIdentifier(string.Format("/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.Compute/virtualMachines/{2}", subscriptionId, resourceGroupName, vmName));
GuestConfigurationVmAssignmentCollection collection = client.GetGuestConfigurationVmAssignments(scopeId);

// invoke the operation
string guestConfigurationAssignmentName = "SecureProtocol";
NullableResponse<GuestConfigurationVmAssignmentResource> response = await collection.GetIfExistsAsync(guestConfigurationAssignmentName);
GuestConfigurationVmAssignmentResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine($"Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    GuestConfigurationAssignmentData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

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

定義

名前	説明
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	ゲスト構成の割り当ては、マシンとゲスト構成の間の関連付けです。
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