Skip to content

Commit 6399824

Browse files
committed
Add more details for the reference function
1 parent ecfafca commit 6399824

File tree

2 files changed

+4
-6
lines changed

2 files changed

+4
-6
lines changed

articles/azure-resource-manager/bicep/bicep-functions-resource.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,9 @@
11
---
22
title: Bicep functions - resources
33
description: Describes the functions to use in a Bicep file to retrieve values about resources.
4-
author: mumian
5-
ms.author: jgao
64
ms.topic: conceptual
75
ms.custom: devx-track-bicep
8-
ms.date: 11/03/2023
6+
ms.date: 2024-02-29
97
---
108

119
# Resource functions for Bicep
@@ -498,7 +496,7 @@ Namespace: [az](bicep-functions.md#namespaces-for-functions).
498496

499497
`reference(resourceName or resourceIdentifier, [apiVersion], ['Full'])`
500498

501-
Returns an object representing a resource's runtime state.
499+
Returns an object representing a resource's runtime state. The output and behavior of the `reference` function highly relies on how each resource provider (RP) implements its PUT and GET responses.
502500

503501
Namespace: [az](bicep-functions.md#namespaces-for-functions).
504502

articles/azure-resource-manager/templates/template-functions-resource.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Template functions - resources
33
description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve values about resources.
44
ms.topic: conceptual
5-
ms.date: 08/22/2023
5+
ms.date: 2024-02-29
66
ms.custom: devx-track-arm-template
77
---
88

@@ -414,7 +414,7 @@ In the templates with [symbolic names](./resource-declaration.md#use-symbolic-na
414414

415415
`reference(symbolicName or resourceIdentifier, [apiVersion], ['Full'])`
416416

417-
Returns an object representing a resource's runtime state. To return an array of objects representing a resource collections's runtime states, see [references](#references).
417+
Returns an object representing a resource's runtime state. The output and behavior of the `reference` function highly relies on how each resource provider (RP) implements its PUT and GET responses. To return an array of objects representing a resource collections's runtime states, see [references](#references).
418418

419419
Bicep provide the reference function, but in most cases, the reference function isn't required. It's recommended to use the symbolic name for the resource instead. See [reference](../bicep/bicep-functions-resource.md#reference).
420420

0 commit comments

Comments
 (0)