Alibaba Cloud Resource Orchestration Service Ref function - Resource Orchestration Service

Devuelve el valor de un parámetro, recurso o variable local especificado.

Nota

La función Ref no acepta otras funciones como entrada. El valor debe ser una cadena que especifique el nombre de un recurso o parámetro.

Declaración

JSON
```
{
 "Ref": "logicalName"
}
```
YAML
- Sintaxis para el nombre completo de la función:
```
Ref: logicalName
```
- Sintaxis para la forma abreviada:
```
!Ref logicalName
```

Parámetros

logicalName: El nombre del recurso o parámetro al que se desea hacer referencia.

Valor devuelto

El valor del recurso o parámetro.

Ejemplos

Referencia a un nombre de recurso

En el siguiente ejemplo se utiliza Ref para obtener el ID de la VPC y asociar dicha VPC con un vSwitch:

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
Resources:
  Vpc:
    Type: ALIYUN::ECS::VPC
    Properties:
      CidrBlock: 192.168.0.0/16
      VpcName: MyVPC
  OtherVSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      ZoneId: cn-beijing-h
      VpcId: !Ref Vpc
      CidrBlock: 192.168.1.0/24
      VSwitchName: OtherSubnet

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": null,
  "Resources": {
    "Vpc": {
      "Type": "ALIYUN::ECS::VPC",
      "Properties": {
        "CidrBlock": "192.168.0.0/16",
        "VpcName": "MyVPC"
      }
    },
    "OtherVSwitch": {
      "Type": "ALIYUN::ECS::VSwitch",
      "Properties": {
        "ZoneId": "cn-beijing-h",
        "VpcId": {
          "Ref": "Vpc"
        },
        "CidrBlock": "192.168.1.0/24",
        "VSwitchName": "OtherSubnet"
      }
    }
  }
}

Referencia a un nombre de parámetro

En el siguiente ejemplo se usa Ref para pasar el parámetro regionParam a la función FindInMap, la cual busca el ID de imagen correspondiente a la instancia WebServer:

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  regionParam:
    Description: the region where you want to create the ECS instance
    Type: String
    AllowedValues:
      - hangzhou
      - beijing
Mappings:
  RegionMap:
    hangzhou:
      '32': m-25l0rcfjo
      '64': m-25l0rcfj1
    beijing:
      '32': m-25l0rcfj2
      '64': m-25l0rcfj3
Resources:
  WebServer:
    Type: ALIYUN::ECS::Instance
    Properties:
      ImageId:
        !FindInMap
          - RegionMap
          - !Ref regionParam
          - '32'
      InstanceType: ecs.t1.small
      SecurityGroupId: sg-25zwc****
      ZoneId: cn-beijing-b
      Tags:
        - Key: tiantt
          Value: ros
        - Key: tiantt1
          Value: ros1

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "regionParam": {
      "Description": "the region where you want to create the ECS instance",
      "Type": "String",
      "AllowedValues": [
        "hangzhou",
        "beijing"
      ]
    }
  },
  "Mappings": {
    "RegionMap": {
      "hangzhou": {
        "32": "m-25l0rcfjo",
        "64": "m-25l0rcfj1"
      },
      "beijing": {
        "32": "m-25l0rcfj2",
        "64": "m-25l0rcfj3"
      }
    }
  },
  "Resources": {
    "WebServer": {
      "Type": "ALIYUN::ECS::Instance",
      "Properties": {
        "ImageId": {
          "Fn::FindInMap": [
            "RegionMap",
            {
              "Ref": "regionParam"
            },
            "32"
          ]
        },
        "InstanceType": "ecs.t1.small",
        "SecurityGroupId": "sg-25zwc****",
        "ZoneId": "cn-beijing-b",
        "Tags": [
          {
            "Key": "key1",
            "Value": "value1"
          },
          {
            "Key": "key2",
            "Value": "value2"
          }
        ]
      }
    }
  }
}

Referencia a una variable local (Locals)

En el siguiente ejemplo se emplea Ref para hacer referencia a la variable local VpcCount, cuyo valor calcula Fn::Add a partir de los parámetros P1 y P2.

YAML

ROSTemplateFormatVersion: 2015-09-01
Parameters:
  P1:
    Type: Number
    Default: 1
  P2:
    Type: Number
    Default: 2
Locals:
  VpcCount:
    Value:
      Fn::Add:
        - Ref: P1
        - Ref: P2
Resources:
  Vpc:
    Type: ALIYUN::ECS::VPC
    Count: 
      Ref: VpcCount

JSON

{
  "ROSTemplateFormatVersion": {},
  "Parameters": {
    "P1": {
      "Type": "Number",
      "Default": 1
    },
    "P2": {
      "Type": "Number",
      "Default": 2
    }
  },
  "Locals": {
    "VpcCount": {
      "Value": {
        "Fn::Add": [
          {
            "Ref": "P1"
          },
          {
            "Ref": "P2"
          }
        ]
      }
    }
  },
  "Resources": {
    "Vpc": {
      "Type": "ALIYUN::ECS::VPC",
      "Count": {
        "Ref": "VpcCount"
      }
    }
  }
}