

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Identifizieren von Ressourcen mit AWS -Cloud-Control- API
<a name="resource-identifier"></a>

Jeder Ressourcentyp hat eine Eigenschaft, die als *primärer Bezeichner* definiert ist. Der Wert dieser Eigenschaft muss für jede Ressource dieses Typs in einem bestimmten AWS-Konto und eindeutig sein AWS-Region. Beispielsweise enthalten viele Ressourcentypen eine `Name` Eigenschaft, die für jede Ressource dieses Typs eindeutig sein muss. In einigen Fällen ist der primäre Bezeichner als eine Kombination mehrerer Eigenschaften definiert, die zusammen einen eindeutigen Bezeichner bilden. Mithilfe dieser primären Kennung in Kombination mit dem Ressourcentyp können Sie genau angeben, für welche Ressource Sie Ressourcenoperationen wie `update-resource` oder ausführen möchten`delete-resource`.

Darüber hinaus definieren einige Ressourcentypen *sekundäre Identifikatoren*, die auch zur eindeutigen Identifizierung von Ressourcen dieses Typs verwendet werden können.

Um zu bestimmen, welche Ressourceneigenschaft (oder Kombination von Eigenschaften) der primäre Bezeichner für einen Ressourcentyp ist, beziehen Sie sich auf das `primaryIdentifier` Attribut des Ressourcentypschemas. Das Schema enthält auch definierte sekundäre Identifikatoren. Weitere Informationen finden Sie unter [Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas).

## Den primären Bezeichner einer Ressource abrufen
<a name="resource-identifier-getting"></a>

Sie können den *Identifikationswert* für eine bestimmte Ressource mithilfe von Cloud Control API-Befehlen ermitteln. Jeder der folgenden Befehle gibt ein `ProgressEvent` Objekt zurück, das den primären Bezeichner der angegebenen Ressourcen enthält:
+ 

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

  ```
  create-resource
  ```
+ 

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

  ```
  list-resource-requests
  ```

## Unter Verwendung des primären Bezeichners einer Ressource
<a name="resource-identifier-using"></a>

Wenn Sie Cloud-Control-API-Befehle verwenden, können Sie den primären Bezeichner oder einen beliebigen sekundären Bezeichner angeben, der für den Ressourcentyp in seinem Ressourcenschema definiert ist. Sie können nur einen Bezeichner angeben. Primäre Bezeichner können als Zeichenfolge oder JSON angegeben werden; sekundäre Bezeichner müssen als JSON angegeben werden.

Um bei zusammengesetzten primären Bezeichnern (d. h. solchen, die aus mehreren aneinandergereihten Ressourceneigenschaften bestehen) den primären Bezeichner als Zeichenfolge anzugeben, listen Sie die Eigenschaftswerte *in der Reihenfolge auf, in der sie in der Definition des primären Bezeichners angegeben sind,* getrennt durch. `|`

Der primäre Bezeichner für die Ressource ist beispielsweise wie folgt definiert:

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

Um also den primären Bezeichner einer Ressource als Zeichenfolge anzugeben, verwenden Sie das folgende Format.

`DatabaseName|TableName`

Wenn Sie beispielsweise eine Datenbank mit dem Datenbanknamen `MyDatabase` und dem Tabellennamen von angeben`MyTable`, geben Sie an`MyDatabase|MyTable`.

Für zusammengesetzte Bezeichner, die als JSON angegeben sind, ist die Reihenfolge der Eigenschaften nicht erforderlich, wie im folgenden Beispiel gezeigt.

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

Weitere Informationen zu Ressourcen-Identifikatoren finden Sie unter [primaryidentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) im Abschnitt *User Move for Extension Development für die CloudFormation Befehlszeilenschnittstelle*.