As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Identificação de recursos com AWS API Cloud Control
Cada tipo de recurso tem uma propriedade que é definida como seu *identificador principal*. O valor dessa propriedade deve ser exclusivo para cada recurso desse tipo em um determinado Conta da AWS Região da AWS e. Por exemplo, muitos tipos de recursos incluem uma propriedade `Name` que deve ser exclusiva para cada recurso desse tipo. Em alguns casos, o identificador primário é definido como uma combinação de várias propriedades que, juntas, formam um identificador exclusivo. Ao usar esse identificador primário, combinado com o tipo de recurso, você pode especificar exatamente em qual recurso deseja realizar operações de recursos, como `update-resource` ou `delete-resource`.
Além disso, alguns tipos de recursos definem *identificadores secundários* que também podem ser usados para identificar exclusivamente recursos desse tipo.
Para determinar qual propriedade do recurso (ou combinação de propriedades) é o identificador principal de um tipo de recurso, consulte o atributo `primaryIdentifier` do esquema do tipo de recurso. O esquema também inclui identificadores secundários definidos. Para obter mais informações, consulte [Visualizando esquemas de tipos de recursos](resource-types.md#resource-types-schemas).
## Obtendo o identificador primário de um recurso
Você pode encontrar o *valor* do identificador de um recurso específico usando os comandos da API de Controle da Nuvem. Cada um dos seguintes comandos retorna um objeto `ProgressEvent` que contém o identificador primário dos recursos especificados:
+
```
cancel-resource-request
```
+
```
create-resource
```
+
```
get-resource-request-status
```
+
```
list-resource-requests
```
## Utilizando o identificador primário de um recurso
Ao usar os comandos da API de Controle da Nuvem, você pode especificar o identificador primário ou qualquer identificador secundário definido para o tipo de recurso em seu esquema de recursos. Só é possível especificar um identificador. Os identificadores primários podem ser especificados como uma string ou JSON; os identificadores secundários devem ser especificados como JSON.
Para identificadores primários compostos (ou seja, aqueles que consistem em várias propriedades de recursos agrupadas), para especificar o identificador primário como uma string, liste os valores da propriedade *na ordem em que foram especificados* na definição do identificador primário, separados por `|`.
Por exemplo, o identificador primário do recurso é definido como:
`"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]`
Portanto, para especificar o identificador primário de um recurso como uma string, use o formato a seguir.
`DatabaseName|TableName`
Por exemplo, dado um banco de dados com um nome de banco de dados `MyDatabase` e nome de tabela de `MyTable`, você especifica `MyDatabase|MyTable`.
Para identificadores de compostos especificados como JSON, a ordem das propriedades não é necessária, como mostrado no exemplo a seguir.
```
{
"TableName": "MyTable",
"DatabaseName": "MyDatabase"
}
```
Para obter mais informações sobre identificadores de recursos, consulte [primaryidentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) na *interface de linha de CloudFormation comando User Move for* Extension Development.