你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Guest Configuration Assignment Reports VM SS - Get

服务:: Guest Configuration

API 版本:: 2024-04-05

按 reportId 获取 VMSS 来宾配置分配的报告。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}/reports/{id}?api-version=2024-04-05

URI 参数

名称	在	必需	类型	说明
id	path	True	string	来宾配置分配报告的 GUID。
name	path	True	string	来宾配置分配名称。
resourceGroupName	path	True	string pattern: ^[-\w\._]+$	资源组名称。
subscriptionId	path	True	string	唯一标识 azure 订阅Microsoft的订阅 ID。订阅 ID 构成了每个服务调用的 URI 的一部分。
vmssName	path	True	string	虚拟机规模集的名称。
api-version	query	True	string	客户端 API 版本。

响应

名称	类型	说明
200 OK	GuestConfigurationAssignmentReport	还行。此响应是由于以下两个原因之一：1。报告已成功返回 2。已找到来宾配置分配，但尚未注册 VM，因此未返回任何报告。
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Get a guest configuration assignment report by Id for a virtual machine scale set

示例请求

HTTP

GET https://management.azure.com/subscriptions/mySubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachineScaleSets/myvmss/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/AuditSecureProtocol/reports/7367cbb8-ae99-47d0-a33b-a283564d2cb1?api-version=2024-04-05

示例响应

状态代码:: 200

{
  "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachineScaleSets/myvmss/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/AuditSecureProtocol/reports/7367cbb8-ae99-47d0-a33b-a283564d2cb1",
  "name": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
  "properties": {
    "complianceStatus": "Compliant",
    "assignment": {
      "name": "AuditSecureProtocol",
      "configuration": {
        "name": "AuditSecureProtocol",
        "version": "1.0.0.0"
      }
    },
    "reportId": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
    "vm": {
      "id": "/subscriptions/mySubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachineScaleSets/myvmss/virtualMachines/1",
      "uuid": "vmuuid"
    },
    "details": {
      "complianceStatus": "Compliant",
      "startTime": "2018-08-29T22:13:53Z",
      "endTime": "2018-08-29T22:14:13Z",
      "jobId": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
      "resources": [
        {
          "complianceStatus": "Compliant",
          "reasons": [
            {
              "phrase": "Operation successful.",
              "code": "DSC::RESOURCE::SUCCESS"
            }
          ],
          "properties": {
            "ConfigurationName": "IsWebServerSecure",
            "DependsOn": null,
            "IsSingleInstance": "Yes",
            "ModuleName": "SecureProtocolWebServer",
            "ModuleVersion": "1.0.0.3",
            "Protocols": [
              {
                "Ensure": "Absent",
                "Protocol": "SSL 2.0"
              },
              {
                "Ensure": "Absent",
                "Protocol": "SSL 3.0"
              },
              {
                "Ensure": "Absent",
                "Protocol": "TLS 1.0"
              },
              {
                "Ensure": "Absent",
                "Protocol": "PCT 1.0"
              },
              {
                "Ensure": "Absent",
                "Protocol": "Multi-Protocol Unified Hello"
              },
              {
                "Ensure": "Absent",
                "Protocol": "TLS 1.1"
              },
              {
                "Ensure": "Absent",
                "Protocol": "TLS 1.2"
              }
            ],
            "PsDscRunAsCredential": null,
            "Reasons": null,
            "ResourceId": "[SecureWebServer]s1",
            "SourceInfo": null
          }
        }
      ],
      "operationType": "Consistency"
    },
    "startTime": "2018-08-29T22:13:53Z",
    "endTime": "2018-08-29T22:14:13Z"
  }
}

定义

名称	说明
AssignmentInfo	有关来宾配置分配的信息。
AssignmentReportDetails	来宾配置分配报告的详细信息。
AssignmentReportResource	来宾配置分配资源。
AssignmentReportResourceComplianceReason	来宾配置分配资源符合性的原因和代码。
complianceStatus	一个值，指示已分配来宾配置的计算机的符合性状态。
ConfigurationInfo	有关配置的信息。
Error
ErrorResponse	操作失败的错误响应
GuestConfigurationAssignmentReport	报告来宾配置分配。报告包含合规性状态、原因等信息。
GuestConfigurationAssignmentReportProperties	报告来宾配置分配。报告包含合规性状态、原因等信息。
type	报表类型、一致性或初始类型
VMInfo	有关 VM 的信息。

AssignmentInfo

Object

有关来宾配置分配的信息。

名称	类型	说明
configuration	ConfigurationInfo	有关配置的信息。
name	string	来宾配置分配的名称。

AssignmentReportDetails

Object

来宾配置分配报告的详细信息。

名称	类型	说明
complianceStatus	complianceStatus	一个值，指示已分配来宾配置的计算机的符合性状态。
endTime	string (date-time)	来宾配置分配符合性状态检查的结束日期和时间。
jobId	string	报表的 GUID。
operationType	type	报表类型、一致性或初始类型
resources	AssignmentReportResource[]	检查来宾配置分配符合性的资源列表。
startTime	string (date-time)	来宾配置分配符合性状态检查的开始日期和时间。

AssignmentReportResource

Object

来宾配置分配资源。

名称	类型	说明
complianceStatus	complianceStatus	一个值，指示已分配来宾配置的计算机的符合性状态。
properties	object	来宾配置分配资源的属性。
reasons	AssignmentReportResourceComplianceReason[]	资源的符合性原因和原因代码。
resourceId	string	来宾配置分配资源设置的名称。

AssignmentReportResourceComplianceReason

Object

来宾配置分配资源符合性的原因和代码。

名称	类型	说明
code	string	来宾配置分配资源的符合性代码。
phrase	string	来宾配置分配资源的符合性的原因。

complianceStatus

枚举

一个值，指示已分配来宾配置的计算机的符合性状态。

值	说明
Compliant
NonCompliant
Pending

ConfigurationInfo

Object

有关配置的信息。

名称	类型	说明
name	string	配置的名称。
version	string	配置的版本。

Error

Object

名称	类型	说明
code	string	错误代码。
message	string	详细错误消息，指示操作失败的原因。

ErrorResponse

Object

操作失败的错误响应

名称	类型	说明
error	Error

GuestConfigurationAssignmentReport

Object

报告来宾配置分配。报告包含合规性状态、原因等信息。

名称	类型	说明
id	string	来宾配置分配报表的 ARM 资源 ID。
name	string	用于标识订阅、资源组下来宾配置分配报告的 GUID。
properties	GuestConfigurationAssignmentReportProperties	来宾配置报表的属性。

GuestConfigurationAssignmentReportProperties

Object

报告来宾配置分配。报告包含合规性状态、原因等信息。

名称	类型	说明
assignment	AssignmentInfo	来宾配置分配的配置详细信息。
complianceStatus	complianceStatus	一个值，指示已分配来宾配置的计算机的符合性状态。
details	AssignmentReportDetails	工作分配报告的详细信息。
endTime	string (date-time)	来宾配置分配符合性状态检查的结束日期和时间。
reportId	string	用于标识订阅、资源组下来宾配置分配报告的 GUID。
startTime	string (date-time)	来宾配置分配符合性状态检查的开始日期和时间。
vm	VMInfo	有关 VM 的信息。
vmssResourceId	string	VMSS 的 Azure 资源 ID。

type

枚举

报表类型、一致性或初始类型

值	说明
Consistency
Initial

VMInfo

Object

有关 VM 的信息。

名称	类型	说明
id	string	VM 的 Azure 资源 ID。
uuid	string	VM 的 UUID（通用唯一标识符）。

通过

Guest Configuration Assignment Reports VM SS - Get

URI 参数

响应

安全性

azure_auth

作用域

示例

Get a guest configuration assignment report by Id for a virtual machine scale set

示例请求

示例响应

定义

AssignmentInfo

AssignmentReportDetails

AssignmentReportResource

AssignmentReportResourceComplianceReason

complianceStatus

ConfigurationInfo

Error

ErrorResponse

GuestConfigurationAssignmentReport

GuestConfigurationAssignmentReportProperties

type

VMInfo