adds resourceGroupName to function docs (#8140)

* add resourceGroupName

Author: ykethan

src/pages/[platform]/build-a-backend/functions/configure-functions/index.mdx

@@ -90,3 +90,14 @@ export const myDemoFunction = defineFunction({
   entry: './path/to/handler.ts' // this path should either be absolute or relative to the current file
 });
 ```
+
+## `resourceGroupName`
+
+By default, functions are grouped together in a resource group named `function`. You can override this to group related function with other Amplify resources like `auth`, `data`, `storage`, or separate them into your own custom group.
+This is typically useful when you have resources that depend on each other and you want to group them together.
+
+```ts title="amplify/functions/my-demo-function/resource.ts"
+export const myDemoFunction = defineFunction({
+  resourceGroupName: 'data'
+});
+```

src/pages/[platform]/build-a-backend/functions/examples/add-user-to-group/index.mdx

@@ -53,7 +53,8 @@ export const postConfirmation = defineFunction({
   // optionally define an environment variable for your group name
   environment: {
     GROUP_NAME: 'EVERYONE'
-  }
+  },
+  resourceGroupName: 'auth'
 });
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/custom-auth-flows/index.mdx

@@ -53,6 +53,7 @@ import { defineFunction } from "@aws-amplify/backend"
 
 export const createAuthChallenge = defineFunction({
   name: "create-auth-challenge",
+  resourceGroupName: 'auth'
 })
 ```
 
@@ -89,6 +90,7 @@ import { defineFunction } from "@aws-amplify/backend"
 
 export const defineAuthChallenge = defineFunction({
   name: "define-auth-challenge",
+  resourceGroupName: 'auth'
 })
 ```
 
@@ -183,6 +185,7 @@ import { defineFunction, secret } from "@aws-amplify/backend"
 
 export const verifyAuthChallengeResponse = defineFunction({
   name: "verify-auth-challenge-response",
+  resourceGroupName: 'auth'
 })
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/custom-message/index.mdx

@@ -45,6 +45,7 @@ import { defineFunction } from '@aws-amplify/backend';
 
 export const customMessage = defineFunction({
   name: "custom-message",
+  resourceGroupName: 'auth'
 });
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/dynamo-db-stream/index.mdx

@@ -46,6 +46,7 @@ import { defineFunction } from "@aws-amplify/backend";
 
 export const myDynamoDBFunction = defineFunction({
   name: "dynamoDB-function",
+  resourceGroupName: "data",
 });
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/google-recaptcha-challenge/index.mdx

@@ -44,6 +44,7 @@ import { defineFunction } from "@aws-amplify/backend"
 
 export const createAuthChallenge = defineFunction({
   name: "create-auth-challenge",
+  resourceGroupName: 'auth'
 })
 ```
 
@@ -79,6 +80,7 @@ import { defineFunction } from "@aws-amplify/backend"
 
 export const defineAuthChallenge = defineFunction({
   name: "define-auth-challenge",
+  resourceGroupName: 'auth'
 })
 ```
 
@@ -144,6 +146,7 @@ export const verifyAuthChallengeResponse = defineFunction({
   environment: {
     GOOGLE_RECAPTCHA_SECRET_KEY: secret("GOOGLE_RECAPTCHA_SECRET_KEY"),
   },
+  resourceGroupName: 'auth'
 })
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/override-token/index.mdx

@@ -45,6 +45,7 @@ import { defineFunction } from '@aws-amplify/backend';
 
 export const preTokenGeneration = defineFunction({
   name: 'pre-token-generation',
+  resourceGroupName: 'auth'
 });
 ```
 

src/pages/[platform]/build-a-backend/functions/examples/s3-upload-confirmation/index.mdx

@@ -47,6 +47,7 @@ export const storage = defineStorage({
   triggers: {
     onUpload: defineFunction({
       entry: './on-upload-handler.ts'
+      resourceGroupName: 'storage',
     })
   }
 });

src/pages/[platform]/build-a-backend/functions/examples/user-attribute-validation/index.mdx

@@ -37,7 +37,8 @@ To get started, create a new directory and a resource file, `amplify/auth/pre-si
 import { defineFunction } from '@aws-amplify/backend';
 
 export const preSignUp = defineFunction({
-  name: "pre-sign-up"
+  name: "pre-sign-up",
+  resourceGroupName: 'auth'
 });
 ```