Guest Configuration Connected VM warev Sphere Assignments Reports - Get

Service:

Guest Configuration

API-versie:

2024-04-05

Haal een rapport op voor de toewijzing van de gastconfiguratie op basis van reportId.

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

URI-parameters

Name	In	Vereist	Type	Description
guestConfigurationAssignmentName	path	True	string pattern: ^[^<>%&:\\?/#]*$	De naam van de toewijzing van de gastconfiguratie.
reportId	path	True	string	De GUID voor het rapport gastconfiguratietoewijzing.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
vmName	path	True	string pattern: ^[a-zA-Z0-9][-a-zA-Z0-9_.]*[a-zA-Z0-9]$	De naam van de virtuele machine.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	GuestConfigurationAssignmentReport	De Azure-bewerking is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

{
  "name": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
  "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Connectedvmwarevsphere/virtualmachines/myvm/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/AuditSecureProtocol/reports/7367cbb8-ae99-47d0-a33b-a283564d2cb1",
  "properties": {
    "assignment": {
      "name": "AuditSecureProtocol",
      "configuration": {
        "name": "AuditSecureProtocol",
        "version": "1.0.0.0"
      }
    },
    "complianceStatus": "Compliant",
    "endTime": "2018-08-29T22:14:13Z",
    "reportId": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
    "startTime": "2018-08-29T22:13:53Z",
    "vm": {
      "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Connectedvmwarevsphere/virtualmachines/myvm",
      "uuid": "vmuuid"
    },
    "details": {
      "complianceStatus": "Compliant",
      "endTime": "2018-08-29T22:14:13Z",
      "jobId": "7367cbb8-ae99-47d0-a33b-a283564d2cb1",
      "operationType": "Consistency",
      "resources": [
        {
          "complianceStatus": "Compliant",
          "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
          },
          "reasons": [
            {
              "code": "DSC::RESOURCE::SUCCESS",
              "phrase": "Operation successful."
            }
          ]
        }
      ],
      "startTime": "2018-08-29T22:13:53Z"
    }
  }
}

Definities

Name	Description
AssignmentInfo	Informatie over de toewijzing van de gastconfiguratie.
AssignmentReportDetails	Details van het rapport gastconfiguratietoewijzing.
AssignmentReportResource	De resource voor de toewijzing van gastconfiguraties.
AssignmentReportResourceComplianceReason	Reden en code voor de naleving van de toewijzingsresource van de gastconfiguratie.
ComplianceStatus	Een waarde die de nalevingsstatus van de machine aangeeft voor de toegewezen gastconfiguratie.
ConfigurationInfo	Informatie over de configuratie.
Error
ErrorResponse	Foutreactie van een bewerkingsfout.
GuestConfigurationAssignmentReport	Rapport voor de toewijzing van de gastconfiguratie. Rapport bevat informatie zoals nalevingsstatus, reden en meer.
GuestConfigurationAssignmentReportProperties	Rapport voor de toewijzing van de gastconfiguratie. Rapport bevat informatie zoals nalevingsstatus, reden en meer.
Type	Type rapport, consistentie of initiële
VMInfo	Informatie over de VIRTUELE machine.

AssignmentInfo

Object

Informatie over de toewijzing van de gastconfiguratie.

Name	Type	Description
configuration	ConfigurationInfo	Informatie over de configuratie.
name	string	Naam van de toewijzing van de gastconfiguratie.

AssignmentReportDetails

Object

Details van het rapport gastconfiguratietoewijzing.

Name	Type	Description
complianceStatus	ComplianceStatus	Een waarde die de nalevingsstatus van de machine aangeeft voor de toegewezen gastconfiguratie.
endTime	string (date-time)	Einddatum en tijd van de nalevingsstatus van de gastconfiguratietoewijzing.
jobId	string	GUID van het rapport.
operationType	Type	Type rapport, consistentie of initiële
resources	AssignmentReportResource[]	De lijst met resources waarvoor naleving van gastconfiguratietoewijzingen is gecontroleerd.
startTime	string (date-time)	Begindatum en -tijd van de nalevingsstatus van de gastconfiguratietoewijzing.

AssignmentReportResource

Object

De resource voor de toewijzing van gastconfiguraties.

Name	Type	Description
complianceStatus	ComplianceStatus	Een waarde die de nalevingsstatus van de machine aangeeft voor de toegewezen gastconfiguratie.
properties		Eigenschappen van een resource voor gastconfiguratietoewijzing.
reasons	AssignmentReportResourceComplianceReason[]	Reden en reden voor naleving voor een resource.
resourceId	string	Naam van de resource-instelling van de gastconfiguratietoewijzing.

AssignmentReportResourceComplianceReason

Object

Reden en code voor de naleving van de toewijzingsresource van de gastconfiguratie.

Name	Type	Description
code	string	Code voor de naleving van de resource voor gastconfiguratietoewijzing.
phrase	string	Reden voor de naleving van de toewijzingsresource van de gastconfiguratie.

ComplianceStatus

Inventarisatie

Een waarde die de nalevingsstatus van de machine aangeeft voor de toegewezen gastconfiguratie.

Waarde	Description
Compliant
NonCompliant
Pending

ConfigurationInfo

Object

Informatie over de configuratie.

Name	Type	Description
name	string	Naam van de configuratie.
version	string	Versie van de configuratie.

Error

Object

Name	Type	Description
code	string	Foutcode.
message	string	Detailfoutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Object

Foutreactie van een bewerkingsfout.

Name	Type	Description
error	Error

GuestConfigurationAssignmentReport

Object

Rapport voor de toewijzing van de gastconfiguratie. Rapport bevat informatie zoals nalevingsstatus, reden en meer.

Name	Type	Description
id	string	ARM-resource-id van het rapport voor de toewijzing van de gastconfiguratie.
name	string	GUID die het rapport voor gastconfiguratietoewijzing identificeert onder een abonnement, resourcegroep.
properties	GuestConfigurationAssignmentReportProperties	Eigenschappen van het gastconfiguratierapport.

GuestConfigurationAssignmentReportProperties

Object

Rapport voor de toewijzing van de gastconfiguratie. Rapport bevat informatie zoals nalevingsstatus, reden en meer.

Name	Type	Description
assignment	AssignmentInfo	Configuratiedetails van de toewijzing van de gastconfiguratie.
complianceStatus	ComplianceStatus	Een waarde die de nalevingsstatus van de machine aangeeft voor de toegewezen gastconfiguratie.
details	AssignmentReportDetails	Details van het toewijzingsrapport.
endTime	string (date-time)	Einddatum en tijd van de nalevingsstatus van de gastconfiguratietoewijzing.
reportId	string	GUID die het rapport voor gastconfiguratietoewijzing identificeert onder een abonnement, resourcegroep.
startTime	string (date-time)	Begindatum en -tijd van de nalevingsstatus van de gastconfiguratietoewijzing.
vm	VMInfo	Informatie over de VIRTUELE machine.
vmssResourceId	string	Azure-resource-id van de VMSS.

Type

Inventarisatie

Type rapport, consistentie of initiële

Waarde	Description
Consistency
Initial

VMInfo

Object

Informatie over de VIRTUELE machine.

Name	Type	Description
id	string	Azure-resource-id van de VIRTUELE machine.
uuid	string	UUID (Universally Unique Identifier) van de VIRTUELE machine.