

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à.

# Identificazione delle risorse con AWS Cloud Control API
<a name="resource-identifier"></a>

Ogni tipo di risorsa ha una proprietà definita come identificatore *principale*. Il valore di questa proprietà deve essere unico per ogni risorsa di quel tipo in un dato Account AWS e Regione AWS. Ad esempio, molti tipi di risorse includono una `Name` proprietà che deve essere unica per ogni risorsa di quel tipo. In alcuni casi, l'identificatore primario è definito come una combinazione di più proprietà che insieme formano un identificatore univoco. Utilizzando questo identificatore primario, combinato con il tipo di risorsa, è possibile specificare esattamente su quale risorsa si desidera eseguire operazioni sulle risorse come o. `update-resource` `delete-resource`

Inoltre, alcuni tipi di risorse definiscono *identificatori secondari* che possono essere utilizzati anche per identificare in modo univoco risorse di quel tipo.

Per determinare quale proprietà della risorsa (o combinazione di proprietà) è l'identificatore principale di un tipo di risorsa, fate riferimento all'`primaryIdentifier`attributo dello schema del tipo di risorsa. Lo schema include anche identificatori secondari definiti. Per ulteriori informazioni, consulta [Visualizzazione degli schemi dei tipi di risorse](resource-types.md#resource-types-schemas).

## Ottenere l'identificatore principale di una risorsa
<a name="resource-identifier-getting"></a>

Puoi trovare il *valore* dell'identificatore per una risorsa specifica utilizzando i comandi dell'API Cloud Control. Ciascuno dei seguenti comandi restituisce un `ProgressEvent` oggetto che contiene l'identificatore principale delle risorse specificate:
+ 

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

  ```
  create-resource
  ```
+ 

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

  ```
  list-resource-requests
  ```

## Utilizzo dell'identificatore principale di una risorsa
<a name="resource-identifier-using"></a>

Quando utilizzi i comandi dell'API Cloud Control, puoi specificare l'identificatore primario o qualsiasi identificatore secondario definito per il tipo di risorsa nel relativo schema di risorse. Puoi specificare solo un identificatore. Gli identificatori primari possono essere specificati come stringa o JSON; gli identificatori secondari devono essere specificati come JSON.

Per gli identificatori primari composti (ovvero quelli costituiti da più proprietà di risorse unite insieme), per specificare l'identificatore primario come stringa, elencate i valori delle proprietà nell'*ordine in cui sono specificati nella definizione dell'*identificatore primario, separati da. `|`

Ad esempio, l'identificatore principale della risorsa è definito come:

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

Quindi, per specificare l'identificatore primario di una risorsa come stringa, si utilizza il seguente formato.

`DatabaseName|TableName`

Ad esempio, se si specifica un database con un nome di database `MyDatabase` e un nome di tabella di`MyTable`, si specifica`MyDatabase|MyTable`.

Per gli identificatori composti specificati come JSON, l'ordine delle proprietà non è richiesto, come illustrato nell'esempio seguente.

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

Per ulteriori informazioni sugli identificatori di risorse, vedere [primaryidentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) nell'*interfaccia a riga di CloudFormation comando User Move for Extension Development*.