---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations"
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/guestDiagnosticSettingsAssociations`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Get a list of all guest diagnostic settings association in a resource group.

## Path parameters

- `resourceGroupName` string, required
- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request succeeded.

- GuestDiagnosticSettingsAssociationList: A list of guest diagnostic settings association.
  - `value` GuestDiagnosticSettingsAssociationResource[]: The list of guest diagnostic settings association.
    - `id` string: Azure resource Id
    - `name` string: Azure resource name
    - `type` string: Azure resource type
    - `location` string, required: Resource location
    - `tags` unknown
    - `properties` GuestDiagnosticSettingsAssociation, required: A guest diagnostic settings association.
      - `guestDiagnosticSettingsName` string, required: The guest diagnostic settings name.
  - `nextLink` string: Provides the link to retrieve the next set of elements.

## Other responses

- `default`: An error occurred and the list of guest diagnostic settings association could not be retrieved.

## Changes

- **2021-12-16** (2018-06-01-preview) `bcd374e29fd6`: 2 breaking
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2021-01-08** (2018-06-01-preview) `a1f7fa36c333`: 2 warning
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2019-06-21** (2018-06-01-preview) `a91744e36e2b`: 1 info
  - api operation id `guestDiagnosticsSettingsAssociation_ListByResourceGroup` removed and replaced with `GuestDiagnosticsSettingsAssociation_ListByResourceGroup`

[Operation history](https://skmtc.dev/azure/apis/guest-diagnostic-settings-association-api/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/microsoft.insights/guestDiagnosticSettingsAssociations/get.md)

---

[API](https://skmtc.dev/azure/apis/guest-diagnostic-settings-association-api.md) - [All operations](https://skmtc.dev/azure/apis/guest-diagnostic-settings-association-api/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/guest-diagnostic-settings-association-api/revisions/bcd374e29fd6?raw)
