Guest Configuration Connected VM warev Sphere Assignments Reports - Get

Referência

Serviço:: Guest Configuration

Versão da API:: 2024-04-05

Obtenha um relatório para a atribuição de configuração de convidado, por 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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
guestConfigurationAssignmentName	path	True	string pattern: ^[^<>%&:\\?/#]*$	O nome da atribuição de configuração de convidado.
reportId	path	True	string	O GUID para o relatório de atribuição de configuração de convidado.
resourceGroupName	path	True	string pattern: ^[-\w\._]+$	O nome do grupo de recursos.
subscriptionId	path	True	string	ID da assinatura que identifica exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
vmName	path	True	string pattern: ^[a-zA-Z0-9][-a-zA-Z0-9_.]*[a-zA-Z0-9]$	O nome da máquina virtual.
api-version	query	True	string	Versão da API do cliente.

Respostas

Nome	Tipo	Description
200 OK	GuestConfigurationAssignmentReport	OKEY. Essa resposta se deve a um destes dois motivos: 1. O relatório foi retornado com êxito 2. A atribuição de configuração de convidado foi encontrada, mas o computador ainda não foi registrado, portanto, nenhum relatório foi retornado.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Resposta de exemplo

Código de status:: 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"
  }
}

Definições

Nome	Description
AssignmentInfo	Informações sobre a atribuição de configuração de convidado.
AssignmentReportDetails	Detalhes do relatório de atribuição de configuração de convidado.
AssignmentReportResource	O recurso de atribuição de configuração de convidado.
AssignmentReportResourceComplianceReason	Motivo e código para a conformidade do recurso de atribuição de configuração de convidado.
complianceStatus	Um valor que indica o status de conformidade do computador para a configuração de convidado atribuída.
ConfigurationInfo	Informações sobre a configuração.
Error
ErrorResponse	Resposta de erro de uma falha de operação
GuestConfigurationAssignmentReport	Relatório da atribuição de configuração de convidado. O relatório contém informações como status de conformidade, motivo e muito mais.
GuestConfigurationAssignmentReportProperties	Relatório da atribuição de configuração de convidado. O relatório contém informações como status de conformidade, motivo e muito mais.
type	Tipo de relatório, consistência ou inicial
VMInfo	Informações sobre a VM.

AssignmentInfo

Objeto

Informações sobre a atribuição de configuração de convidado.

Nome	Tipo	Description
configuration	ConfigurationInfo	Informações sobre a configuração.
name	string	Nome da atribuição de configuração de convidado.

AssignmentReportDetails

Objeto

Detalhes do relatório de atribuição de configuração de convidado.

Nome	Tipo	Description
complianceStatus	complianceStatus	Um valor que indica o status de conformidade do computador para a configuração de convidado atribuída.
endTime	string (date-time)	Data e hora de término da verificação de status de conformidade da atribuição de configuração de convidado.
jobId	string	GUID do relatório.
operationType	type	Tipo de relatório, consistência ou inicial
resources	AssignmentReportResource[]	A lista de recursos para os quais a conformidade da atribuição de configuração de convidado é verificada.
startTime	string (date-time)	Data e hora de início da verificação de status de conformidade da atribuição de configuração de convidado.

AssignmentReportResource

Objeto

O recurso de atribuição de configuração de convidado.

Nome	Tipo	Description
complianceStatus	complianceStatus	Um valor que indica o status de conformidade do computador para a configuração de convidado atribuída.
properties	object	Propriedades de um recurso de atribuição de configuração de convidado.
reasons	AssignmentReportResourceComplianceReason[]	Motivo de conformidade e código de motivo para um recurso.
resourceId	string	Nome da configuração de recurso de atribuição de configuração de convidado.

AssignmentReportResourceComplianceReason

Objeto

Motivo e código para a conformidade do recurso de atribuição de configuração de convidado.

Nome	Tipo	Description
code	string	Código para a conformidade do recurso de atribuição de configuração de convidado.
phrase	string	Motivo para a conformidade do recurso de atribuição de configuração de convidado.

complianceStatus

Enumeração

Um valor que indica o status de conformidade do computador para a configuração de convidado atribuída.

Valor	Description
Compliant
NonCompliant
Pending

ConfigurationInfo

Objeto

Informações sobre a configuração.

Nome	Tipo	Description
name	string	Nome da configuração.
version	string	Versão da configuração.

Error

Objeto

Nome	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro de detalhe indicando por que a operação falhou.

ErrorResponse

Objeto

Resposta de erro de uma falha de operação

Nome	Tipo	Description
error	Error

GuestConfigurationAssignmentReport

Objeto

Relatório da atribuição de configuração de convidado. O relatório contém informações como status de conformidade, motivo e muito mais.

Nome	Tipo	Description
id	string	ID de recurso do ARM do relatório para a atribuição de configuração de convidado.
name	string	GUID que identifica o relatório de atribuição de configuração de convidado em uma assinatura, grupo de recursos.
properties	GuestConfigurationAssignmentReportProperties	Propriedades do relatório de configuração de convidado.

GuestConfigurationAssignmentReportProperties

Objeto

Relatório da atribuição de configuração de convidado. O relatório contém informações como status de conformidade, motivo e muito mais.

Nome	Tipo	Description
assignment	AssignmentInfo	Detalhes de configuração da atribuição de configuração de convidado.
complianceStatus	complianceStatus	Um valor que indica o status de conformidade do computador para a configuração de convidado atribuída.
details	AssignmentReportDetails	Detalhes do relatório de atribuição.
endTime	string (date-time)	Data e hora de término da verificação de status de conformidade da atribuição de configuração de convidado.
reportId	string	GUID que identifica o relatório de atribuição de configuração de convidado em uma assinatura, grupo de recursos.
startTime	string (date-time)	Data e hora de início da verificação de status de conformidade da atribuição de configuração de convidado.
vm	VMInfo	Informações sobre a VM.
vmssResourceId	string	ID de recurso do Azure do VMSS.

type

Enumeração

Tipo de relatório, consistência ou inicial

Valor	Description
Consistency
Initial

VMInfo

Objeto

Informações sobre a VM.

Nome	Tipo	Description
id	string	ID de recurso do Azure da VM.
uuid	string	UUID(Identificador Universalmente Exclusivo) da VM.

Compartilhar via

Guest Configuration Connected VM warev Sphere Assignments Reports - Get

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

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

Solicitação de exemplo

Resposta de exemplo

Definições

AssignmentInfo

AssignmentReportDetails

AssignmentReportResource

AssignmentReportResourceComplianceReason

complianceStatus

ConfigurationInfo

Error

ErrorResponse

GuestConfigurationAssignmentReport

GuestConfigurationAssignmentReportProperties

type

VMInfo