Guest Configuration Connected VM warev Sphere Assignments Reports - Get

Referentie

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 pattern: ^[-\w\._]+$	De naam van de resourcegroep.
subscriptionId	path	True	string	Abonnements-id die het Microsoft Azure-abonnement uniek identificeert. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
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	Client-API-versie.

Antwoorden

Name	Type	Description
200 OK	GuestConfigurationAssignmentReport	OK. Dit antwoord heeft een van de volgende twee redenen: 1. Het rapport is geretourneerd met succes 2. De toewijzing van de gastconfiguratie is gevonden, maar de computer is nog niet geregistreerd, dus er is geen rapport geretourneerd.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

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

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/getGuestConfigurationConnectedVMwarevSphereAssignmentReportById.json
// this example is just showing the usage of "GuestConfigurationConnectedVMwarevSphereAssignmentsReports_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://learn.microsoft.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 GuestConfigurationVMwarevSphereAssignmentResource created on azure
// for more information of creating GuestConfigurationVMwarevSphereAssignmentResource, please refer to the document of GuestConfigurationVMwarevSphereAssignmentResource
string subscriptionId = "mySubscriptionid";
string resourceGroupName = "myResourceGroupName";
string vmName = "myvm";
string guestConfigurationAssignmentName = "AuditSecureProtocol";
ResourceIdentifier guestConfigurationVMwarevSphereAssignmentResourceId = GuestConfigurationVMwarevSphereAssignmentResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName, guestConfigurationAssignmentName);
GuestConfigurationVMwarevSphereAssignmentResource guestConfigurationVMwarevSphereAssignment = client.GetGuestConfigurationVMwarevSphereAssignmentResource(guestConfigurationVMwarevSphereAssignmentResourceId);

// invoke the operation
string reportId = "7367cbb8-ae99-47d0-a33b-a283564d2cb1";
GuestConfigurationAssignmentReport result = await guestConfigurationVMwarevSphereAssignment.GetGuestConfigurationConnectedVMwarevSphereAssignmentsReportAsync(reportId);

Console.WriteLine($"Succeeded: {result}");

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

Voorbeeldrespons

Statuscode:: 200

{
  "id": "/subscriptions/mysubscriptionid/resourceGroups/myResourceGroupName/providers/Microsoft.Connectedvmwarevsphere/virtualmachines/myvm/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.Connectedvmwarevsphere/virtualmachines/myvm",
      "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"
  }
}

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	object	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.

Delen via

Guest Configuration Connected VM warev Sphere Assignments Reports - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

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

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AssignmentInfo

AssignmentReportDetails

AssignmentReportResource

AssignmentReportResourceComplianceReason

complianceStatus

ConfigurationInfo

Error

ErrorResponse

GuestConfigurationAssignmentReport

GuestConfigurationAssignmentReportProperties

type

VMInfo

Aanvullende resources