Using azure-goverance until there is an official service slug. Added docs to the governance landing page for now. Pasted in standard preview alerts

cynthn · cynthn · commit ae868dc853f8 · 2025-05-05T16:27:59.000-07:00
diff --git a/articles/governance/index.yml b/articles/governance/index.yml
@@ -44,11 +44,13 @@ productDirectory:
       imageSrc: ./media/management-groups.svg
       links:
         - url: ./service-groups/overview.md
+          text: Developer overview
+        - url: ./service-groups/create-service-group-rest-api.md
+          text: Create a service group using the REST API
+        - url: ./service-groups/create-service-group-member-rest-api.md
+          text: Connect resources or resource containers to service groups 
+        - url: ./service-groups/manage-service-groups.md
           text: Manage Service Groups
-        - url: ./Manage Azure Service Groups/manage-service-groups.md
-          text: Protect your resource hierarchy
-        - url: ./management-groups/index.yml
-          text: See more >
     - title: Azure Policy
       imageSrc: ./media/azure-policy.svg
       links:
diff --git a/articles/governance/service-groups/create-service-group-member-rest-api.md b/articles/governance/service-groups/create-service-group-member-rest-api.md
@@ -1,19 +1,21 @@
 ---
-title: Quickstart: Connect service group members with REST API
+title: "Quickstart: Connect Service Group members using the REST API"
 description: In this quickstart, you use REST API to connect a resource to a service group with a service group member relationship.
 author: rthorn17
 ms.author: rithorn
-ms.service: Azure Service Groups
-ms.topic: quickstart  #Don't change
+ms.service: azure-governance
+ms.topic: quickstart
 ms.date: 5/19/2025
 ---
 
 
 # Quickstart: Connect resources or resource containers to service groups with Service Group Member Relationships 
  
-Service Groups are designed to be flexible and scalable, allowing organizations to adapt their resource management strategies as their needs evolve. To connect resources, resource groups, or subscriptions to a Service Group, you need to create a new Service Group Member Relationship. For more information on service groups, see [Getting started with Service Groups](overview.md).
-
+To connect resources, resource groups, or subscriptions to a Service Group (preview), you need to create a new Service Group Member Relationship. For more information on service groups, see [Getting started with Service Groups](overview.md).
 
+> [!IMPORTANT]
+> Azure Service Groups is currently in PREVIEW. For more information about participating in the preview, see [TBD Link]().
+> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 ## Prerequisites
 
@@ -26,9 +28,9 @@ Service Groups are designed to be flexible and scalable, allowing organizations
 ## Create in REST API
 
 For REST API, use the
-[Service Groups Member- Create or Update]() endpoint to create a new service group member. 
+[Service Groups Member- Create or Update]() endpoint to create a new service group member.
 
-In this example, we're connecting a Virtual Machine [VM1] to a Service Group [Contoso]. 
+In this example, we're connecting a Virtual Machine [VM1] to a Service Group [Contoso].
 
 1. Service Group: **groupId** is _Contoso_
 1. Virtual Machine: The **resourceID** is _VM1_
@@ -76,19 +78,13 @@ To remove the service group created in this document, use the
 - No Request Body
 
 
-## Next step -or- Related content
+## Next step
 
 In this quickstart, you created a service group to help create different views in Azure. The
 service group can have member subscriptions, resource groups, resources, or other service groups.
 
 To learn more about service groups and how to manage your service group hierarchy, continue to:
 
 > [!div class="nextstepaction"]
-> [Manage your resources with service groups]()
-
-
--or-
+> [Manage your resources with service groups](manaage-service-groups.md)
 
-- [Related article title](link.md)
-- [Related article title](link.md)
-- [Related article title](link.md)
diff --git a/articles/governance/service-groups/create-service-group-rest-api.md b/articles/governance/service-groups/create-service-group-rest-api.md
@@ -3,17 +3,19 @@ title: Quickstart: Create a service group with REST API
 description: In this quickstart, you use REST API to create a service group to organize your resources.
 author: rthorn17
 ms.author: rithorn
-ms.service: Azure Service Groups
-ms.topic: quickstart  #Don't change
+ms.service: azure-governance
+ms.topic: quickstart  
 ms.date: 5/19/2025
 ---
 
 
-# Quickstart: Create a service group with REST API
+# Quickstart: Create a service group (preview) with REST API
  
-Service groups in Azure are a low-privilege-based grouping of resources across subscriptions. They provide a way to manage resources with minimal permissions, ensuring that resources can be grouped and managed without granting excessive access. Service Groups are designed to complement existing organizational structures like Resource Groups, Subscriptions, and Management Groups by offering a flexible and secure way to aggregate resources for specific purposes. For more information on service groups, see [Getting started with Service Groups](overview.md).
-
+With Azure Service Groups (preview) you can create low-privilege-based groupings of resources across subscriptions. They provide a way to manage resources with minimal permissions, ensuring that resources can be grouped and managed without granting excessive access. Service Groups are designed to complement existing organizational structures like Resource Groups, Subscriptions, and Management Groups by offering a flexible and secure way to aggregate resources for specific purposes. For more information on service groups, see [Getting started with Service Groups](overview.md).
 
+> [!IMPORTANT]
+> Azure Service Groups is currently in PREVIEW. For more information about participating in the preview, see [TBD Link]().
+> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 ## Prerequisites
 
@@ -101,20 +103,7 @@ To remove the service group created in this document, use the
 
 - No Request Body
 
-
-## Next step -or- Related content
-
-In this quickstart, you created a service group to help create different views in Azure. The
-service group can have member subscriptions, resource groups, resources, or other service groups.
-
-To learn more about service groups and how to manage your service group hierarchy, continue to:
-
-> [!div class="nextstepaction"]
-> [Manage your resources with service groups]()
-
-
--or-
-
-- [Related article title](link.md)
-- [Related article title](link.md)
-- [Related article title](link.md)
+## Related content
+* [What are Azure Service Groups?](overview.md)
+* [How to: Manage Service Groups](manaage-service-groups.md)
+* [Connect service group members with REST API](create-service-group-member-rest-api.md)
diff --git a/articles/governance/service-groups/manage-service-groups.md b/articles/governance/service-groups/manage-service-groups.md
@@ -1,9 +1,9 @@
 ---
-title: Manage Resouces Across Subscriptions and Resource Groups with Azure Service Groups 
-description: "Learn how to create, update, read, and delete Azure Service Groups and its members"
+title: Manage resouces across subscriptions and resource groups with Azure Service Groups 
+description: "Learn how to create, update, read, and delete Azure Service Groups and members"
 author: rthorn17
 ms.author: rithorn
-ms.service: governance  ## is service-groups going to be an official service slug?
+ms.service: azure-governance  ## is service-groups going to be an official service slug?
 ms.topic: how-to
 ms.date: 05/19/2025
 ---
@@ -15,7 +15,7 @@ You can group resources, across subscriptions, by creating Azure Service Groups.
 For more information on service groups, see [Getting started with Service Groups](overview.md).
 
 > [!IMPORTANT]
-> Service Groups is currently in PREVIEW. For more information about participating in the preview, see [TBD Link]().
+> Azure Service Groups is currently in PREVIEW. For more information about participating in the preview, see [TBD Link]().
 > See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 
@@ -345,30 +345,8 @@ The valid values are:
 * UserExplicitlyCreated: A user created the relationship.
 
 
-
-  
-
-
-
-
-
-
 ## Related content
-
-- [Related article title](link.md)
-- [Related article title](link.md)
-- [Related article title](link.md)
-
-<!-- Optional: Related content - H2
-
-Consider including a "Related content" H2 section that 
-lists links to 1 to 3 articles the user might find helpful.
-
--->
-
-<!--
-
-Remove all comments except the customer intent
-before you sign off or merge to the main branch.
-
---> 
+* [What are Azure Service Groups?](overview.md)
+* [Quickstart: Create a service group (preview) with REST API](create-service-group-rest-api.md)
+* [Quickstart: Connect resources or resource containers to service groups with Service Group Member Relationships](create-service-group-member-rest-api.md)
+* [Connect service group members with REST API](create-service-group-member-rest-api.md)
diff --git a/articles/governance/service-groups/overview.md b/articles/governance/service-groups/overview.md
@@ -3,8 +3,8 @@ title: "Get started with Service Groups"
 description: "Learn how to use and manage resources with Service Groups."
 author: rthorn17
 ms.author: rithorn
-ms.service: Service Groups
-ms.topic: concept-article #Don't change
+ms.service: governance
+ms.topic: overview
 ms.date: 05/19/2025
 ---
 
@@ -99,15 +99,8 @@ Service Groups creates the Root Service Group on the first request received with
 Access to the root has to be given from a user with "microsoft.authorization/roleassignments/write" permissions at the tenant level. For example, the Tenant's Global Administrator can elevate their access on the tenant to have these permissions. [Details on elevating Tenant Global Administrator Accesses](https://learn.microsoft.com/en-us/azure/role-based-access-control/elevate-access-global-admin?tabs=azure-portal%2Centra-audit-logs)
 
 
-## Next step -or- Related content
+## Related content
+* [Quickstart: Create a service group with REST API](service-groups\create-service-group-rest-api.md)
+* [How to: Manage Service Groups](manaage-service-groups.md)
+* [Connect service group members with REST API](create-service-group-member-rest-api.md)
 
-> [!div class="nextstepaction"]
-> [Getting Started: Service Groups](link.md)
-
--or-
-
-* [How to: Connect Service Group Members](link.md)
-* [How to:](link.md)
-* [Related article title](link.md)
-* [Service Group REST API Spec]()
-* [Service Group Member REST API Spec]()
