You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/governance/service-groups/create-service-group-member-rest-api.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,13 +31,13 @@ To connect resources, resource groups, or subscriptions to a Service Group (prev
31
31
For REST API, use the
32
32
[Service Groups Member- Create or Update]() endpoint to create a new service group member.
33
33
34
-
In this example, we're connecting a Virtual Machine [VM1] to a Service Group[Contoso].
34
+
In this example, we're connecting a Virtual Machine [VM1] to a service group[Contoso].
35
35
36
36
1. Service Group: **groupId** is _Contoso_
37
37
1. Virtual Machine: The **resourceID** is _VM1_
38
38
1. Service Group Member: The **relationshipID** is _SGM1_
39
39
40
-
When you're adding a resource to a Service Group, you create service group member by extending the resource.
40
+
When you're adding a resource to a service group, you create service group member by extending the resource.
41
41
42
42
- REST API URI
43
43
@@ -52,7 +52,7 @@ specify the service group as the parent, use the **TargetID** property.
52
52
- REST API URI
53
53
54
54
```http
55
-
PUT https://management.azure.com/subscriptions/[SUBID]/resourceGroups/[RGID]/providers/microsoft.compute/virtualmachine/[VMID]/providers/Microsoft.Management/serviceGroups/SGM1?api-version=2024-02-01-preview
55
+
PUT https://management.azure.com/subscriptions/[SUBID]/resourceGroups/[RGID]/providers/microsoft.compute/virtualmachine/[VMID]/providers/Microsoft.Relationships/serviceGroupMember/SGM1?api-version=2024-02-01-preview
Copy file name to clipboardExpand all lines: articles/governance/service-groups/create-service-group-portal.md
+13-17Lines changed: 13 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ ms.date: 5/19/2025
11
11
12
12
# Quickstart: Create a service group (preview) in the portal
13
13
14
-
Azure Service Groups offer a flexible way to organize and manage resources across subscriptions and resource groups, parallel to any existing Azure resource hierarchy. They're ideal for scenarios requiring cross-boundary grouping, minimal permissions, and aggregations of data across resources. These features empower teams to create tailored resource collections that align with operational, organizational, or persona-based needs. This article helps give you an overview of what Service Groups are, the scenarios to use them for, and provide guidance on how to get started. For more information on service groups, see [Getting started with Service Groups](overview.md).
14
+
Azure Service Groups offer a flexible way to organize and manage resources across subscriptions and resource groups, parallel to any existing Azure resource hierarchy. They're ideal for scenarios requiring cross-boundary grouping, minimal permissions, and aggregations of data across resources. These features empower teams to create tailored resource collections that align with operational, organizational, or persona-based needs. This article helps give you an overview of what service groups are, the scenarios to use them for, and provide guidance on how to get started. For more information on service groups, see [Getting started with Service Groups](overview.md).
15
15
16
16
> [!IMPORTANT]
17
17
> Azure Service Groups is currently in PREVIEW.
@@ -26,35 +26,31 @@ Azure Service Groups offer a flexible way to organize and manage resources acros
26
26
## Create in Azure portal
27
27
28
28
1. Log into the [Azure portal](https://portal.azure.com).

37
34
38
-
1. Fill in the service group ID field
35
+
5. Fill in the service group ID field
39
36
40
-
- The **Service Group ID** is the directory unique identifier that is used to submit commands
37
+
* The **Service Group ID** is the directory unique identifier that is used to submit commands
41
38
on this service group. This identifier isn't editable after creation as it's used throughout
42
39
the Azure system to identify this group. The
43
40
[root service group](./overview.md#the-root-service-group) is
44
41
automatically created with an ID that is the Microsoft Entra ID. For all other
45
42
service groups, assign a unique ID.
46
-
- The display name field is the name that is displayed within the Azure portal. A separate
43
+
* The display name field is the name that is displayed within the Azure portal. A separate
47
44
display name is an optional field when creating the service group and can be changed at any time.
45
+
6. Select the **Parent Service Group**.
46
+
47
+
* If you don't have a parent service group, or don't know what to pick, select the Root Service Group which has same ID as the tenant's ID. _"Microsoft.Management/serviceGroups/]tenantId]"_
48
48
49
-
1. Select the **Parent Service Group**.
50
-
51
-
1. Select "Next"
52
-
53
-
1. The review page shows
49
+
7. Select "Next"
50
+
8. The review page shows
54
51
55
52

56
-
57
-
1. If all information is correct, select **Create**
53
+
9. If all information is correct, select **Create**
Copy file name to clipboardExpand all lines: articles/governance/service-groups/create-service-group-rest-api.md
+4-6Lines changed: 4 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,9 +28,7 @@ With Azure Service Groups (preview) you can create low-privilege-based groupings
28
28
29
29
## Create in REST API
30
30
31
-
For REST API, use the
32
-
[Service Groups - Create or Update]()
33
-
endpoint to create a new service group. In this example, the service group **groupId** is
31
+
In this example, the service group **groupId** is
34
32
_Contoso_.
35
33
36
34
- REST API URI
@@ -84,17 +82,17 @@ specify a different service group as the parent, use the **properties.parent.id*
84
82
```
85
83
86
84
## Verify your Service Group was created
87
-
Service Groups PUT or create call is an Asynchronous call which means that the response to the initial create call is an HTTP status code 201: Accepted. This response doesn't mean the Service group was successfully created, only that the Azure successfully received the request to create the Service Group.
85
+
Service Groups PUT or create call is an Asynchronous call which means that the response to the initial create call is that it was accepted. This response doesn't mean the service group was successfully created, only that the Azure successfully received the request to create the service group.
88
86
89
87
To check the operation was successful, you should do a GET call on the value returned in the **azure-asyncoperation** header. The URL provides the status of the created operation.
90
88
91
89
> ![NOTE]
92
-
> To avoid issues within scripts or templates, the automation should poll this provided URL before moving to the next step. If the automation moves to the next step before the operation has responded successful, the next operation will fail as the Service Group has not been created.
90
+
> To avoid issues within scripts or templates, the automation should poll this provided URL before moving to the next step. If the automation moves to the next step before the operation has responded successful, the next operation will fail as the service group has not been created.
93
91
94
92
## Clean up resources
95
93
96
94
To remove the service group created in this document, use the
0 commit comments