Microsoft.GuestConfiguration (stable:2024-04-05)

2025/07/16 • 27 updated methods

Operations_List (updated)
Description :  List the operations for the provider
Reference :  Link ¶

⚶ Changes

{
  "#id": "Operations_List",
  "Description": {
    "new": "List the operations for the provider",
    "old": "Lists all of the available GuestConfiguration REST API operations."
  },
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "The response model for the list of Automation operations.",
        "old": "The response model for the list of Automation operations"
      },
      "$properties": [
        {
          "#name": "value",
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "Description": {
              "new": "GuestConfiguration REST API operation.",
              "old": "GuestConfiguration REST API operation"
            },
            "$properties": [
              {
                "#name": "name",
                "Description": {
                  "new": "Operation name: For example, providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/write or read.",
                  "old": "Operation name: For ex. providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/write or read"
                }
              },
              {
                "#name": "display",
                "Description": {
                  "new": "Provider, Resource, Operation, and description values.",
                  "old": "Provider, Resource, Operation and description values."
                },
                "$properties": [
                  {
                    "#name": "provider",
                    "Description": {
                      "new": "Service provider: Microsoft.GuestConfiguration.",
                      "old": "Service provider: Microsoft.GuestConfiguration"
                    }
                  },
                  {
                    "#name": "resource",
                    "Description": {
                      "new": "Resource on which the operation is performed.",
                      "old": "Resource on which the operation is performed:  For ex. "
                    }
                  },
                  {
                    "#name": "description",
                    "Description": {
                      "new": "Description about the operation.",
                      "old": "Description about operation."
                    }
                  }
                ]
              },
              {
                "#name": "properties",
                "Description": {
                  "new": "Additional properties of the operation.",
                  "old": "Provider, Resource, Operation and description values."
                }
              }
            ]
          }
        },
        {
          "@added_9d21e91223da4b9e979b4026179ee85e": {
            "#name": "nextLink",
            "Required": false,
            "Type": "string"
          }
        }
      ]
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.GuestConfiguration/operations
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of Automation operations supported by the Automation resource provider. ,
Required: True ,
}
[
{
name:
{
Description: Operation name: For example, providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/write or read. ,
Required: False ,
}
string ,
display:
{
Description: Provider, Resource, Operation, and description values. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft.GuestConfiguration. ,
Required: False ,
}
string ,
resource:
{
Description: Resource on which the operation is performed. ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: Read, write, delete, etc. ,
Required: False ,
}
string ,
description:
{
Description: Description about the operation. ,
Required: False ,
}
string ,
}
,
properties:
{
Description: Additional properties of the operation. ,
Required: False ,
}
{
statusCode:
{
Description: Service provider: Microsoft.GuestConfiguration ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_SubscriptionList (updated)
Description :  List all guest configuration assignments for a subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_SubscriptionList",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_bcd8582f7b82453ab4a3b87a3f85ed7b": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentsVMSS_List (updated)
Description :  List all guest configuration assignments for VMSS.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentsVMSS_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_21ad8f77e5d447f38dfd783b16370f66": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentsVMSS_Get (updated)
Description :  Get information about a guest configuration assignment for VMSS
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentsVMSS_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
name:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentsVMSS_CreateOrUpdate (updated)
Description :  Creates an association between a VMSS and guest configuration
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentsVMSS_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "name",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment."
      }
    },
    {
      "parameters": {
        "$properties": {
          "properties": [
            {
              "#name": "latestReportId",
              "Description": {
                "new": "Id of the latest report for the guest configuration assignment.",
                "old": "Id of the latest report for the guest configuration assignment. "
              }
            },
            {
              "#name": "parameterHash",
              "Description": {
                "new": "parameter hash for the guest configuration assignment.",
                "old": "parameter hash for the guest configuration assignment. "
              }
            },
            {
              "latestAssignmentReport": [
                {
                  "resources": {
                    "$properties": [
                      {
                        "#name": "properties",
                        "Type": {
                          "new": "string",
                          "old": "object"
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "vmssVMList": {
                "$properties": [
                  {
                    "#name": "latestReportId",
                    "Description": {
                      "new": "Id of the latest report for the guest configuration assignment.",
                      "old": "Id of the latest report for the guest configuration assignment. "
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
name:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the create or update guest configuration assignment. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentsVMSS_Delete (updated)
Description :  Delete a guest configuration assignment for VMSS
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentsVMSS_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
name:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentReportsVMSS_List (updated)
Description :  List all reports for the VMSS guest configuration assignment, latest report first.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentReportsVMSS_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "details": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        },
        "@added_69f264b42382467c914242e99e64e84c": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}/reports
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
name:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of reports for the guest configuration. Report contains information such as compliance status, reason and more. ,
Required: False ,
}
[
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentReportsVMSS_Get (updated)
Description :  Get a report for the VMSS guest configuration assignment, by reportId.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentReportsVMSS_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "details": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}/reports/{id}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmssName:
{
Description: The name of the virtual machine scale set. ,
Required: True ,
}
string ,
name:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
id:
{
Description: The GUID for the guest configuration assignment report. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_List (updated)
Description :  List all guest configuration assignments for a virtual machine.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_022c612684ee44f4a038a95a7e5a1090": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_Get (updated)
Description :  Get information about a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_CreateOrUpdate (updated)
Description :  Creates an association between a VM and guest configuration
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment."
      }
    },
    {
      "parameters": {
        "$properties": {
          "properties": [
            {
              "#name": "latestReportId",
              "Description": {
                "new": "Id of the latest report for the guest configuration assignment.",
                "old": "Id of the latest report for the guest configuration assignment. "
              }
            },
            {
              "#name": "parameterHash",
              "Description": {
                "new": "parameter hash for the guest configuration assignment.",
                "old": "parameter hash for the guest configuration assignment. "
              }
            },
            {
              "latestAssignmentReport": [
                {
                  "resources": {
                    "$properties": [
                      {
                        "#name": "properties",
                        "Type": {
                          "new": "string",
                          "old": "object"
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "vmssVMList": {
                "$properties": [
                  {
                    "#name": "latestReportId",
                    "Description": {
                      "new": "Id of the latest report for the guest configuration assignment.",
                      "old": "Id of the latest report for the guest configuration assignment. "
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the create or update guest configuration assignment. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_Delete (updated)
Description :  Delete a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment"
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentReports_List (updated)
Description :  List all reports for the guest configuration assignment, latest report first.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentReports_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "details": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        },
        "@added_40a0f345544d4ba3adf78d3cb24babf4": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of reports for the guest configuration. Report contains information such as compliance status, reason and more. ,
Required: False ,
}
[
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignmentReports_Get (updated)
Description :  Get a report for the guest configuration assignment, by reportId.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignmentReports_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "details": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports/{reportId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
reportId:
{
Description: The GUID for the guest configuration assignment report. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignments_List (updated)
Description :  List all guest configuration assignments for an ARC machine.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignments_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_a41a0315dad545558cd23c991a75bbe5": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignments_Get (updated)
Description :  Get information about a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignments_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignments_CreateOrUpdate (updated)
Description :  Creates an association between a Connected VM Sphere machine and guest configuration
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignments_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment."
      }
    },
    {
      "parameters": {
        "$properties": {
          "properties": [
            {
              "#name": "latestReportId",
              "Description": {
                "new": "Id of the latest report for the guest configuration assignment.",
                "old": "Id of the latest report for the guest configuration assignment. "
              }
            },
            {
              "#name": "parameterHash",
              "Description": {
                "new": "parameter hash for the guest configuration assignment.",
                "old": "parameter hash for the guest configuration assignment. "
              }
            },
            {
              "latestAssignmentReport": [
                {
                  "resources": {
                    "$properties": [
                      {
                        "#name": "properties",
                        "Type": {
                          "new": "string",
                          "old": "object"
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "vmssVMList": {
                "$properties": [
                  {
                    "#name": "latestReportId",
                    "Description": {
                      "new": "Id of the latest report for the guest configuration assignment.",
                      "old": "Id of the latest report for the guest configuration assignment. "
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the create or update guest configuration assignment. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignments_Delete (updated)
Description :  Delete a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignments_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment"
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignmentsReports_List (updated)
Description :  List all reports for the guest configuration assignment, latest report first.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignmentsReports_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "details": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        },
        "@added_6c2a0e926efc4cfea76975fd3f8b05fa": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of reports for the guest configuration. Report contains information such as compliance status, reason and more. ,
Required: False ,
}
[
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationConnectedVMwarevSphereAssignmentsReports_Get (updated)
Description :  Get a report for the guest configuration assignment, by reportId.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationConnectedVMwarevSphereAssignmentsReports_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "details": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/virtualmachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports/{reportId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
vmName:
{
Description: The name of the virtual machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
reportId:
{
Description: The GUID for the guest configuration assignment report. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationAssignments_RGList (updated)
Description :  List all guest configuration assignments for a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationAssignments_RGList",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_b6370c44df174a00877b314d27ca1551": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignments_List (updated)
Description :  List all guest configuration assignments for an ARC machine.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignments_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "latestReportId",
                "Description": {
                  "new": "Id of the latest report for the guest configuration assignment.",
                  "old": "Id of the latest report for the guest configuration assignment. "
                }
              },
              {
                "#name": "parameterHash",
                "Description": {
                  "new": "parameter hash for the guest configuration assignment.",
                  "old": "parameter hash for the guest configuration assignment. "
                }
              },
              {
                "latestAssignmentReport": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              },
              {
                "vmssVMList": {
                  "$properties": [
                    {
                      "#name": "latestReportId",
                      "Description": {
                        "new": "Id of the latest report for the guest configuration assignment.",
                        "old": "Id of the latest report for the guest configuration assignment. "
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "@added_f49c7a3922834a77ab644171cbe2b9d4": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the list guest configuration assignment operation. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignments_Get (updated)
Description :  Get information about a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignments_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignments_CreateOrUpdate (updated)
Description :  Creates an association between a ARC machine and guest configuration
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignments_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment."
      }
    },
    {
      "parameters": {
        "$properties": {
          "properties": [
            {
              "#name": "latestReportId",
              "Description": {
                "new": "Id of the latest report for the guest configuration assignment.",
                "old": "Id of the latest report for the guest configuration assignment. "
              }
            },
            {
              "#name": "parameterHash",
              "Description": {
                "new": "parameter hash for the guest configuration assignment.",
                "old": "parameter hash for the guest configuration assignment. "
              }
            },
            {
              "latestAssignmentReport": [
                {
                  "resources": {
                    "$properties": [
                      {
                        "#name": "properties",
                        "Type": {
                          "new": "string",
                          "old": "object"
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "vmssVMList": {
                "$properties": [
                  {
                    "#name": "latestReportId",
                    "Description": {
                      "new": "Id of the latest report for the guest configuration assignment.",
                      "old": "Id of the latest report for the guest configuration assignment. "
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "latestReportId",
            "Description": {
              "new": "Id of the latest report for the guest configuration assignment.",
              "old": "Id of the latest report for the guest configuration assignment. "
            }
          },
          {
            "#name": "parameterHash",
            "Description": {
              "new": "parameter hash for the guest configuration assignment.",
              "old": "parameter hash for the guest configuration assignment. "
            }
          },
          {
            "latestAssignmentReport": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "vmssVMList": {
              "$properties": [
                {
                  "#name": "latestReportId",
                  "Description": {
                    "new": "Id of the latest report for the guest configuration assignment.",
                    "old": "Id of the latest report for the guest configuration assignment. "
                  }
                }
              ]
            }
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the create or update guest configuration assignment. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Guest configuration assignment. ,
Required: False ,
}
{
targetResourceId:
{
Description: VM resource Id. ,
Required: False ,
}
string ,
guestConfiguration:
{
Description: The guest configuration to assign. ,
Required: False ,
}
{
kind:
{
Description: Kind of the guest configuration. For example:DSC ,
Enum:
{
DSC: No description available. ,
}
,
Required: False ,
}
enum ,
name:
{
Description: Name of the guest configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the guest configuration. ,
Required: False ,
}
string ,
contentUri:
{
Description: Uri of the storage where guest configuration package is uploaded. ,
Required: False ,
}
string ,
contentHash:
{
Description: Combined hash of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
contentManagedIdentity:
{
Description: Managed identity with storage access of the guest configuration package and configuration parameters. ,
Required: False ,
}
string ,
assignmentType:
{
Description: Specifies the assignment type and execution of the configuration. Possible values are Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect and ApplyAndMonitor. ,
Enum:
{
Audit: No description available. ,
DeployAndAutoCorrect: No description available. ,
ApplyAndAutoCorrect: No description available. ,
ApplyAndMonitor: No description available. ,
}
,
Required: False ,
}
enum ,
assignmentSource:
{
Description: Specifies the origin of the configuration. ,
Required: False ,
}
string ,
contentType:
{
Description: Specifies the content type of the configuration. Possible values could be Builtin or Custom. ,
Required: False ,
}
string ,
configurationParameter:
{
Description: The configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationProtectedParameter:
{
Description: The protected configuration parameters for the guest configuration. ,
Required: False ,
}
[
{
name:
{
Description: Name of the configuration parameter. ,
Required: False ,
}
string ,
value:
{
Description: Value of the configuration parameter. ,
Required: False ,
}
string ,
}
,
]
,
configurationSetting:
{
Description: The configuration setting for the guest configuration. ,
Required: False ,
}
{
configurationMode:
{
Description: Specifies how the LCM(Local Configuration Manager) actually applies the configuration to the target nodes. Possible values are ApplyOnly, ApplyAndMonitor, and ApplyAndAutoCorrect. ,
Enum:
{
ApplyOnly: No description available. ,
ApplyAndMonitor: No description available. ,
ApplyAndAutoCorrect: No description available. ,
}
,
Required: False ,
}
enum ,
allowModuleOverwrite:
{
Description: If true - new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. Otherwise, false ,
Required: False ,
}
boolean ,
actionAfterReboot:
{
Description: Specifies what happens after a reboot during the application of a configuration. The possible values are ContinueConfiguration and StopConfiguration ,
Enum:
{
ContinueConfiguration: No description available. ,
StopConfiguration: No description available. ,
}
,
Required: False ,
}
enum ,
refreshFrequencyMins:
{
Description: The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30. ,
Format: float ,
Required: False ,
}
number ,
rebootIfNeeded:
{
Description: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is false. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the xPendingReboot module. ,
Required: False ,
}
boolean ,
configurationModeFrequencyMins:
{
Description: How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15. ,
Format: float ,
Required: False ,
}
number ,
}
,
}
,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
lastComplianceStatusChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
parameterHash:
{
Description: parameter hash for the guest configuration assignment. ,
Required: False ,
}
string ,
latestAssignmentReport:
{
Description: Last reported guest configuration assignment report. ,
Required: False ,
}
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
context:
{
Description: The source which initiated the guest configuration assignment. Ex: Azure Policy ,
Required: False ,
}
string ,
assignmentHash:
{
Description: Combined hash of the configuration package and parameters. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The provisioning state, which only appears in the response. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Created: No description available. ,
}
,
Required: False ,
}
enum ,
resourceType:
{
Description: Type of the resource - VMSS / VM ,
Required: False ,
}
string ,
vmssVMList:
{
Description: The list of VM Compliance data for VMSS ,
Required: False ,
}
[
{
vmId:
{
Description: UUID of the VM. ,
Required: False ,
}
string ,
vmResourceId:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
latestReportId:
{
Description: Id of the latest report for the guest configuration assignment. ,
Required: False ,
}
string ,
lastComplianceChecked:
{
Description: Date and time when last compliance status was checked. ,
Format: date-time ,
Required: False ,
}
string ,
}
,
]
,
}
,
systemData:
{
Description: Azure Resource Manager metadata containing createdBy and modifiedBy information. ,
Required: False ,
}
{
createdBy:
{
Description: The identity that created the resource. ,
Required: False ,
}
string ,
createdByType:
{
Description: The type of identity that created the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
createdAt:
{
Description: The timestamp of resource creation (UTC). ,
Format: date-time ,
Required: False ,
}
string ,
lastModifiedBy:
{
Description: The identity that last modified the resource. ,
Required: False ,
}
string ,
lastModifiedByType:
{
Description: The type of identity that last modified the resource. ,
Enum:
{
User: No description available. ,
Application: No description available. ,
ManagedIdentity: No description available. ,
Key: No description available. ,
}
,
Required: False ,
}
enum ,
lastModifiedAt:
{
Description: The timestamp of resource last modification (UTC) ,
Format: date-time ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignments_Delete (updated)
Description :  Delete a guest configuration assignment
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignments_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    },
    {
      "#name": "guestConfigurationAssignmentName",
      "Description": {
        "new": "The guest configuration assignment name.",
        "old": "Name of the guest configuration assignment"
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignmentReports_List (updated)
Description :  List all reports for the guest configuration assignment, latest report first.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignmentReports_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "details": [
                  {
                    "resources": {
                      "$properties": [
                        {
                          "#name": "properties",
                          "Type": {
                            "new": "string",
                            "old": "object"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            ]
          }
        },
        "@added_6a47944c97794e54b789d5f5315833bf": {
          "#name": "nextLink",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of reports for the guest configuration. Report contains information such as compliance status, reason and more. ,
Required: False ,
}
[
{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}
GuestConfigurationHCRPAssignmentReports_Get (updated)
Description :  Get a report for the guest configuration assignment, by reportId.
Reference :  Link ¶

⚶ Changes

{
  "#id": "GuestConfigurationHCRPAssignmentReports_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Subscription ID which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The resource group name."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "details": [
              {
                "resources": {
                  "$properties": [
                    {
                      "#name": "properties",
                      "Type": {
                        "new": "string",
                        "old": "object"
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    },
    "default": {
      "Description": {
        "new": "Error response of an operation failure.",
        "old": "Error response of an operation failure"
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports/{reportId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
machineName:
{
Description: The name of the ARC machine. ,
Required: True ,
}
string ,
guestConfigurationAssignmentName:
{
Description: The guest configuration assignment name. ,
Required: True ,
}
string ,
reportId:
{
Description: The GUID for the guest configuration assignment report. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: ARM resource id of the report for the guest configuration assignment. ,
Required: False ,
}
string ,
name:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the guest configuration report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
reportId:
{
Description: GUID that identifies the guest configuration assignment report under a subscription, resource group. ,
Required: False ,
}
string ,
assignment:
{
Description: Configuration details of the guest configuration assignment. ,
Required: False ,
}
{
name:
{
Description: Name of the guest configuration assignment. ,
Required: False ,
}
string ,
configuration:
{
Description: Information about the configuration. ,
Required: False ,
}
{
name:
{
Description: Name of the configuration. ,
Required: False ,
}
string ,
version:
{
Description: Version of the configuration. ,
Required: False ,
}
string ,
}
,
}
,
vm:
{
Description: Information about the VM. ,
Required: False ,
}
{
id:
{
Description: Azure resource Id of the VM. ,
Required: False ,
}
string ,
uuid:
{
Description: UUID(Universally Unique Identifier) of the VM. ,
Required: False ,
}
string ,
}
,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
details:
{
Description: Details of the assignment report. ,
Required: False ,
}
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
startTime:
{
Description: Start date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
endTime:
{
Description: End date and time of the guest configuration assignment compliance status check. ,
Format: date-time ,
Required: False ,
}
string ,
jobId:
{
Description: GUID of the report. ,
Required: False ,
}
string ,
operationType:
{
Description: Type of report, Consistency or Initial ,
Enum:
{
Consistency: No description available. ,
Initial: No description available. ,
}
,
Required: False ,
}
enum ,
resources:
{
Description: The list of resources for which guest configuration assignment compliance is checked. ,
Required: False ,
}
[
{
complianceStatus:
{
Description: A value indicating compliance status of the machine for the assigned guest configuration. ,
Enum:
{
Compliant: No description available. ,
NonCompliant: No description available. ,
Pending: No description available. ,
}
,
Required: False ,
}
enum ,
resourceId:
{
Description: Name of the guest configuration assignment resource setting. ,
Required: False ,
}
string ,
reasons:
{
Description: Compliance reason and reason code for a resource. ,
Required: False ,
}
[
{
phrase:
{
Description: Reason for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
code:
{
Description: Code for the compliance of the guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
properties:
{
Description: Properties of a guest configuration assignment resource. ,
Required: False ,
}
string ,
}
,
]
,
}
,
vmssResourceId:
{
Description: Azure resource Id of the VMSS. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Required: False ,
}
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
message:
{
Description: Detail error message indicating why the operation failed. ,
Required: False ,
}
string ,
}
,
}