Skip to content

Commit aa9340d

Browse files
author
Rich Thorn
committed
updates casing and table consolidated
1 parent 21ef480 commit aa9340d

File tree

5 files changed

+46
-80
lines changed

5 files changed

+46
-80
lines changed

articles/governance/service-groups/create-service-group-member-rest-api.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,13 +31,13 @@ To connect resources, resource groups, or subscriptions to a Service Group (prev
3131
For REST API, use the
3232
[Service Groups Member- Create or Update]() endpoint to create a new service group member.
3333

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].
3535

3636
1. Service Group: **groupId** is _Contoso_
3737
1. Virtual Machine: The **resourceID** is _VM1_
3838
1. Service Group Member: The **relationshipID** is _SGM1_
3939

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.
4141

4242
- REST API URI
4343

@@ -52,7 +52,7 @@ specify the service group as the parent, use the **TargetID** property.
5252
- REST API URI
5353

5454
```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
5656
```
5757

5858
- Request Body

articles/governance/service-groups/create-service-group-portal.md

Lines changed: 13 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.date: 5/19/2025
1111

1212
# Quickstart: Create a service group (preview) in the portal
1313

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).
1515

1616
> [!IMPORTANT]
1717
> Azure Service Groups is currently in PREVIEW.
@@ -26,35 +26,31 @@ Azure Service Groups offer a flexible way to organize and manage resources acros
2626
## Create in Azure portal
2727

2828
1. Log into the [Azure portal](https://portal.azure.com).
29-
30-
1. Select **All services** > **Management + governance**.
31-
32-
1. Select **Service Groups**.
33-
34-
1. Select **+ Add service group**.
29+
2. Select **All services** > **Management + governance**.
30+
3. Select **Service Groups**.
31+
4. Select **+ Add Service Group**.
3532

3633
![Screenshot of new SG screen](./media/create_SG.png)
3734

38-
1. Fill in the service group ID field
35+
5. Fill in the service group ID field
3936

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
4138
on this service group. This identifier isn't editable after creation as it's used throughout
4239
the Azure system to identify this group. The
4340
[root service group](./overview.md#the-root-service-group) is
4441
automatically created with an ID that is the Microsoft Entra ID. For all other
4542
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
4744
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]"_
4848

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
5451

5552
![The review page for creating a new service group](./media/create_review_sg.png)
56-
57-
1. If all information is correct, select **Create**
53+
9. If all information is correct, select **Create**
5854

5955
## Clean up resources
6056

articles/governance/service-groups/create-service-group-rest-api.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,7 @@ With Azure Service Groups (preview) you can create low-privilege-based groupings
2828

2929
## Create in REST API
3030

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
3432
_Contoso_.
3533

3634
- REST API URI
@@ -84,17 +82,17 @@ specify a different service group as the parent, use the **properties.parent.id*
8482
```
8583

8684
## 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.
8886

8987
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.
9088

9189
> ![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.
9391
9492
## Clean up resources
9593

9694
To remove the service group created in this document, use the
97-
[Management Groups - Delete]() endpoint:
95+
Service Group Delete endpoint:
9896

9997
- REST API URI
10098

0 commit comments

Comments
 (0)