{"type":"api","title":"Get Config Group Association","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/8bb2440c-2dd0-310b-8b55-fbbf55ba4b5c","info":{"title":"UX 2.0 Configuration","description":"Configuration of UX 2.0 device, policy, and topology\n\nIncludes API operations for the following\n- Configuration Groups (SD-WAN and SD-Routing)\n- Policy Groups\n- Topology Groups\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Configuration - Configuration Group"],"description":"Get devices association with a config group","operationId":"GetConfigGroupAssociation","parameters":[{"name":"configGroupId","in":"path","required":true,"schema":{"type":"string"}},{"name":"associatedGroups","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"devices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the device","pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"},"site-name":{"type":"string","description":"Name of the site"},"host-name":{"type":"string","description":"Host name of the device"},"site-id":{"type":"string","description":"Identifier for the site"},"deviceModel":{"type":"string","description":"Model of the device"},"tags":{"type":"array","description":"Tags associated with the device","items":{"type":"string"}},"device-lock":{"type":"string","description":"Indicates if the device is locked"},"addedByRule":{"type":"boolean","description":"Indicates if the device was added by a rule"},"configStatusMessage":{"type":"string","description":"Configuration status message"},"deviceIP":{"type":"string","description":"IP address of the device","format":"ipv4"},"configGroupLastUpdatedOn":{"type":"string","description":"Timestamp of the last update to the config group","format":"date-time"},"unsupportedFeatures":{"type":"array","description":"List of unsupported features","items":{"type":"string"}},"hierarchyNamePath":{"type":"string","description":"Hierarchy name path"},"hierarchyTypePath":{"type":"string","description":"Hierarchy type path"},"configGroupUpToDate":{"type":"string","description":"Indicates if the config group is up to date"},"groupTopologyLabel":{"type":"string","description":"Label indicating the topology information about the device. e.g.: Device1, Device2, Primary, Secondary"}},"required":["id","site-name","host-name","site-id","deviceModel","tags","device-lock","addedByRule","configStatusMessage","deviceIP","configGroupLastUpdatedOn","unsupportedFeatures","hierarchyNamePath","hierarchyTypePath","configGroupUpToDate"]}}},"required":["devices"],"additionalProperties":false,"$$ref":"#/components/schemas/ConfiggroupCommonAssociateGetResponse_SchemaPayload"},"examples":{"Config Group Associate":{"description":"Config Group Associate","value":{"devices":[{"id":"C8K-0f43906e-bd8f-443c-83f2-11eb85e45a51","site-name":"SITE_500","host-name":"vm5","site-id":"500","deviceModel":"vedge-C8000V","tags":[],"device-lock":"No","addedByRule":false,"configStatusMessage":"","deviceIP":"172.16.255.15","configGroupLastUpdatedOn":"","unsupportedFeatures":[],"hierarchyNamePath":"Global/SITE_500","hierarchyTypePath":"GLOBAL/SITE","configGroupUpToDate":"False"}]},"$$ref":"#/components/examples/ComViptelaVmanageServerConfiggroupGetResponseAssociate"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Config Group \u003e Device-read","method":"get","path":"/v1/config-group/{configGroupId}/device/associate"}}