

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Identificar los recursos con API de control de nube de AWS
<a name="resource-identifier"></a>

Cada tipo de recurso tiene una propiedad que se define como su *identificador principal*. El valor de esta propiedad debe ser único para cada recurso de ese tipo en una Cuenta de AWS y determinada Región de AWS. Por ejemplo, muchos tipos de recursos incluyen una propiedad `Name` que debe ser única para cada recurso de ese tipo. En algunos casos, el identificador principal se define como una combinación de varias propiedades que juntas forman un identificador único. Al usar este identificador principal, combinado con el tipo de recurso, puede especificar exactamente en qué recurso desea realizar operaciones de recursos, como `update-resource` o `delete-resource`.

Además, algunos tipos de recursos definen *identificadores secundarios* que también se pueden usar para identificar de forma exclusiva los recursos de ese tipo.

Para determinar qué propiedad (o combinación de propiedades) del recurso es el identificador principal de un tipo de recurso, consulte el atributo `primaryIdentifier` del esquema de tipos de recursos. El esquema también incluye los identificadores secundarios definidos. Para obtener más información, consulte [Visualización de esquemas de tipos de recursos](resource-types.md#resource-types-schemas).

## Obtención del identificador principal de un recurso
<a name="resource-identifier-getting"></a>

Puede encontrar el *valor* del identificador de un recurso específico mediante los comandos de la API de control en la nube. Cada uno de los siguientes comandos devuelve un objeto `ProgressEvent` que contiene el identificador principal de los recursos especificados:
+ 

  ```
  cancel-resource-request
  ```
+ 

  ```
  create-resource
  ```
+ 

  ```
  get-resource-request-status
  ```
+ 

  ```
  list-resource-requests
  ```

## Uso del identificador principal de un recurso
<a name="resource-identifier-using"></a>

Al usar los comandos de la API de control en la nube, puede especificar el identificador principal o cualquier identificador secundario definido para el tipo de recurso en su esquema de recursos. Solo puede especificar un identificador. Los identificadores principales se pueden especificar como una cadena o JSON; los identificadores secundarios se deben especificar como JSON.

En el caso de los identificadores principales compuestos (es decir, aquellos que constan de varias propiedades de recursos agrupadas), para especificar el identificador principal como una cadena, enumere los valores de las propiedades *en el orden en que se especifican* en la definición del identificador principal, separados por `|`.

Por ejemplo, el identificador principal del recurso se define como:

`"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]`

Por lo tanto, para especificar el identificador principal de un recurso como una cadena, utilice el siguiente formato.

`DatabaseName|TableName`

Por ejemplo, si se trata de una base de datos con nombre de base de datos `MyDatabase` y nombre de tabla `MyTable`, especifique `MyDatabase|MyTable`.

En el caso de los identificadores compuestos especificados como JSON, no es necesario que las propiedades estén ordenadas, como se muestra en el siguiente ejemplo.

```
{
  "TableName": "MyTable",
  "DatabaseName": "MyDatabase"
}
```

Para obtener más información sobre los identificadores de recursos, consulte [primaryidentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) en la *interfaz de línea de CloudFormation comandos User Move for* Extension Development.