Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `Ref`
<a name="intrinsic-function-reference-ref"></a>

La funzione intrinseca `Ref` restituisce il valore di un parametro, di una risorsa o di un’altra funzione intrinseca. Questa funzione viene comunemente utilizzata per creare riferimenti tra risorse all'interno di un CloudFormation modello. 

## Dichiarazione
<a name="ref-declaration"></a>

### JSON
<a name="intrinsic-function-reference-ref-syntax.json"></a>

```
{ "Ref" : "logicalName" }
```

```
{ "Ref" : "IntrinsicFunction" }
```

### YAML
<a name="intrinsic-function-reference-ref-syntax.yaml"></a>

Sintassi per il nome completo della funzione:

```
Ref: logicalName
```

```
Ref:
   IntrinsicFunction
```

Sintassi per la forma breve:

```
!Ref logicalName
```

```
!Ref
   IntrinsicFunction
```

## Parameters
<a name="ref-parameters"></a>

logicalName  
Il nome logico della risorsa o del parametro di riferimento desiderato.

IntrinsicFunction  
La funzione intrinseca che restituisce una stringa valida. Deve contenere riferimenti a parametri o identificatori e non deve contenere identificatori logici di risorse.

## Valore restituito
<a name="ref-return-value"></a>

Il valore restituito di `Ref` dipende dal tipo di entità a cui si fa riferimento:
+ Quando specifichi il nome logico di un parametro, viene restituito il valore del parametro. Per ulteriori informazioni, consultate la [Parameterssintassi CloudFormation del modello](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html).
+ Quando specifichi il nome logico di una risorsa, viene restituito un valore che usi per identificare quella risorsa. Di solito, è il nome della risorsa. Tuttavia, per alcune risorse, viene restituito un identificatore con un altro significato importante nel contesto della risorsa. Ad esempio, la risorsa `AWS::EC2::EIP` restituisce l’indirizzo IP e `AWS::EC2::Instance` restituisce l’ID dell’istanza. Per ulteriori informazioni sui valori `Ref` restituiti per una risorsa, consulta la documentazione per quella risorsa in [Informazioni di riferimento su proprietà e risorse](aws-template-resource-type-ref.md).
+ Quando si specifica una funzione intrinseca, viene restituito l’output di tale funzione.

## Esempi
<a name="ref-examples"></a>

### Crea riferimenti tra le risorse
<a name="intrinsic-function-reference-ref-example"></a>

La seguente dichiarazione di risorse per un indirizzo IP elastico richiede l’ID istanza di un’istanza EC2. Utilizza la funzione `Ref` per specificare l’ID di istanza della risorsa `MyEC2Instance` dichiarata altrove nel modello.

#### JSON
<a name="intrinsic-function-reference-ref-example.json"></a>

```
{
  "AWSTemplateFormatVersion":"2010-09-09",
  "Resources":{
  
      ...
  
    "MyEIP":{
      "Type":"AWS::EC2::EIP",
      "Properties":{
        "InstanceId":{
          "Ref":"MyEC2Instance"
        }
      }
    }
  }
}
```

#### YAML
<a name="intrinsic-function-reference-ref-example.yaml"></a>

```
AWSTemplateFormatVersion: 2010-09-09
Resources:

  ...

  MyEIP:
    Type: AWS::EC2::EIP
    Properties:
      InstanceId: !Ref MyEC2Instance
```

### Restituisce un identificatore di risorsa come output dello stack
<a name="intrinsic-function-reference-ref-example-2"></a>

Gli esempi seguenti mostrano come utilizzare la funzione `Ref` per restituire il nome di un bucket Amazon S3 con il nome logico `MyBucket` come output dello stack. 

#### JSON
<a name="intrinsic-function-reference-ref-example-2.json"></a>

```
{
  "AWSTemplateFormatVersion":"2010-09-09",
  "Resources":{
    "MyBucket":{
      "Type":"AWS::S3::Bucket",
      "Properties":{
        "BucketName":{
          "Fn::Sub": "${AWS::StackName}-mybucket"
        }
      }
    }
  },
  "Outputs":{
    "BucketNameOutput":{
      "Description":"The name of the S3 bucket",
      "Value":{
        "Ref":"MyBucket"
      }
    }
  }
}
```

#### YAML
<a name="intrinsic-function-reference-ref-example-2.yaml"></a>

```
AWSTemplateFormatVersion: 2010-09-09
Resources:
  MyBucket:
    Type: AWS::S3::Bucket
    Properties:
      BucketName: !Sub ${AWS::StackName}-mybucket

Outputs:
  BucketNameOutput:
    Description: The name of the S3 bucket
    Value: !Ref MyBucket
```

### Usa la funzione intrinseca `Fn::Join` all’interno della funzione `Ref`
<a name="ref-example-intrinsic-functions-multiple-stages"></a>

**Nota**  
Quando usi la trasformazione `AWS::LanguageExtensions`, puoi utilizzare `Ref` in combinazione con altre funzioni intrinseche. Per le funzioni supportate, consulta [Funzioni supportate](#ref-supported-functions).

Gli esempi seguenti mostrano come impostare gli identificatori di risorse utilizzando la funzione intrinseca `Fn::Sub`, le condizioni e l’input per il parametro `Stage`. Le funzioni `Ref` e le `Fn::GetAtt` funzioni fanno quindi riferimento ai valori appropriati, in base allo stage. `Fn::Sub`viene utilizzato innanzitutto con `Fn::GetAtt` per ottenere l'ARN della coda Amazon SQS appropriata per impostare le dimensioni dell'allarme Amazon. CloudWatch Successivamente, [`Fn::Join`](intrinsic-function-reference-join.md) viene utilizzato con `Ref` per creare il nome dell’argomento SNS per la proprietà `AlarmActions`. 

#### JSON
<a name="ref-example-intrinsic-functions-multiple-stages.json"></a>

```
{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Transform": "AWS::LanguageExtensions",
    "Parameters": {
        "Stage": {
            "Type": "String",
            "Default": "Dev",
            "AllowedValues": [
                "Dev",
                "Prod"
            ]
        }
    },
    "Conditions": {
        "isProd": {
            "Fn::Equals": [
                {"Ref": "Stage"},
                "Prod"
            ]
        },
        "isDev": {
            "Fn::Equals": [
                {"Ref": "Stage"},
                "Dev"
            ]
        }
    },
    "Resources": {
        "DevQueue": {
            "Type": "AWS::SQS::Queue",
            "Condition": "isDev",
            "Properties": {
                "QueueName": {"Fn::Sub": "My${Stage}Queue"}
            }
        },
        "ProdQueue": {
            "Type": "AWS::SQS::Queue",
            "Condition": "isProd",
            "Properties": {
                "QueueName": {"Fn::Sub": "My${Stage}Queue"}
            }
        },
        "DevTopic": {
            "Condition": "isDev",
            "Type": "AWS::SNS::Topic"
        },
        "ProdTopic": {
            "Condition": "isProd",
            "Type": "AWS::SNS::Topic"
        },
        "MyAlarm": {
            "Type": "AWS::CloudWatch::Alarm",
            "Properties": {
                "AlarmDescription": "Alarm if queue depth grows beyond 10 messages",
                "Namespace": "AWS/SQS",
                "MetricName": "ApproximateNumberOfMessagesVisible",
                "Dimensions":[
                    {
                        "Name": {"Fn::Sub": "${Stage}Queue"},
                        "Value": {"Fn::GetAtt": [{"Fn::Sub": "${Stage}Queue"}, "QueueName"]}
                    }
                ],
                "Statistic": "Sum",
                "Period": 300,
                "EvaluationPeriods": 1,
                "Threshold": 10,
                "ComparisonOperator": "GreaterThanThreshold",
                "AlarmActions": [
                    {
                        "Ref": {"Fn::Join": ["", [{"Ref": "Stage"}, "Topic"]]}
                    }
                ]
            }
        }
    }
}
```

#### YAML
<a name="ref-example-intrinsic-functions-multiple-stages.yaml"></a>

```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Parameters:
  Stage:
    Type: String
    Default: Dev
    AllowedValues:
      - Dev
      - Prod
Conditions:
  isProd: !Equals 
    - !Ref Stage
    - Prod
  isDev: !Equals 
    - !Ref Stage
    - Dev
Resources:
  DevQueue:
    Type: AWS::SQS::Queue
    Condition: isDev
    Properties:
      QueueName: !Sub My${Stage}Queue
  ProdQueu:
    Type: AWS::SQS::Queue
    Condition: isProd
    Properties:
      QueueName: !Sub My${Stage}Queue
  DevTopic:
    Condition: isDev
    Type: AWS::SNS::Topic
  ProdTopic:
    Condition: isProd
    Type: AWS::SNS::Topic
  MyAlarm:
    Type: AWS::CloudWatch::Alarm
    Properties:
      AlarmDescription: Alarm if queue depth grows beyond 10 messages
      Namespace: AWS/SQS
      MetricName: ApproximateNumberOfMessagesVisible
      Dimensions:
        - Name: !Sub '${Stage}Queue'
          Value: !GetAtt 
            - !Sub '${Stage}Queue'
            - QueueName
      Statistic: Sum
      Period: 300
      EvaluationPeriods: 1
      Threshold: 10
      ComparisonOperator: GreaterThanThreshold
      AlarmActions:
        - !Ref 
          'Fn::Join':
            - ''
            - - !Ref Stage
              - Topic
```

## Funzioni supportate
<a name="ref-supported-functions"></a>

Quando usi la [trasformazione AWS::LanguageExtensions](transform-aws-languageextensions.md), puoi utilizzare le seguenti funzioni all’interno della funzione `Ref`.
+ [`Fn::Base64`](intrinsic-function-reference-base64.md)
+ [`Fn::FindInMap`](intrinsic-function-reference-findinmap.md)
+ [`Fn::If`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-if)
+ [`Fn::ImportValue`](intrinsic-function-reference-importvalue.md)
+ [`Fn::Join`](intrinsic-function-reference-join.md)
+ [`Fn::Sub`](intrinsic-function-reference-sub.md)
+ [`Fn::ToJsonString`](intrinsic-function-reference-ToJsonString.md)
+ `Ref`