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.
# Cloud-Control-API-Ressourcenoperationen
Verwenden Sie AWS -Cloud-Control- API to do or other command verb construction operations create, read, update, remove und list (-L) -Operationen auf Ressourcen in Ihrem. AWS-Konto
**Topics**
+ [Voraussetzungen](#resource-operations-prerequisites)
+ [Anmeldeinformationen angeben](#resource-operations-permissions)
+ [Sicherstellen, dass Anfragen einzigartig sind](#resource-operations-idempotency)
+ [Überlegungen](#resource-operations-considerations)
+ [Erstellen einer Ressource](resource-operations-create.md)
+ [Eine Ressource aktualisieren](resource-operations-update.md)
+ [Eine Ressource löschen](resource-operations-delete.md)
+ [Ressourcen entdecken](resource-operations-list.md)
+ [Eine Ressource lesen](resource-operations-read.md)
+ [Verwaltung von Ressourcenanfragen](resource-operations-manage-requests.md)
+ [Identifizieren von Ressourcen mit AWS -Cloud-Control- API](resource-identifier.md)
## Voraussetzungen für die Verwendung von Ressourcen mit der Cloud Control API
Um eine bestimmte Ressource mithilfe der Cloud Control API bereitzustellen, muss dieser Ressourcentyp die Cloud Control API unterstützen und für die Verwendung in Ihrer verfügbar sein AWS-Konto.
+ **Ressourcen, die für die Verwendung in Ihrem verfügbar sind AWS-Konto**
Damit sie in Ihrem Konto verwendet werden können, müssen öffentliche Ressourcentypen aktiviert und private Ressourcentypen registriert sein. Unterstützte AWS Ressourcentypen sind öffentlich und immer aktiviert. Weitere Informationen finden Sie unter [Verwendung von Cloud Control API-Ressourcentypen](resource-types.md).
+ **Ressourcen, die die Cloud Control API unterstützen**
Eine Liste der AWS Ressourcentypen, die die Cloud Control API unterstützen, finden Sie unter[Die Cloud-Control-API unterstützende Ressourcentypen](supported-resources.md).
Öffentliche und private Ressourcentypen von Drittanbietern unterstützen die Cloud Control API.
Einzelheiten dazu, wie Sie feststellen können, ob ein bestimmter Ressourcentyp die Cloud Control API unterstützt, finden Sie unter[Feststellen, ob ein Ressourcentyp die Cloud Control API unterstützt](resource-types.md#resource-types-determine-support).
Informationen zur Verwendung von Ressourcentypen finden Sie unter[Verwendung von Cloud Control API-Ressourcentypen](resource-types.md).
## Anmeldeinformationen für die Cloud Control API angeben
Im Rahmen der Ausführung von Vorgängen mit AWS Ressourcen in Ihrem Namen muss die Cloud Control API die zugrunde liegenden AWS Dienste aufrufen, die diese Ressourcen tatsächlich bereitstellen. Zu diesem Zweck benötigt die Cloud Control API die erforderlichen Anmeldeinformationen für den Zugriff auf diese Dienste. Es gibt zwei Möglichkeiten, wie Sie die Cloud Control API aktivieren können, um diese Anmeldeinformationen abzurufen:
+ **Benutzeranmeldedaten**
Standardmäßig erstellt die Cloud Control API eine temporäre Sitzung mit Ihren AWS Benutzeranmeldedaten und verwendet diese, um alle erforderlichen Aufrufe an nachgelagerte AWS Dienste durchzuführen. Diese Sitzung dauert bis zu 24 Stunden. Danach schlagen alle verbleibenden Aufrufe AWS durch die Cloud Control API fehl.
+ **Anmeldeinformationen für die Servicerolle**
Sie können auch eine Servicerolle angeben, die die Cloud Control API während eines Ressourcenvorgangs übernehmen soll, wenn Sie die Ressourcenanfrage stellen. Neben anderen Vorteilen ermöglicht die Angabe einer Servicerolle der Cloud Control API, bis zu 36 Stunden lang Aufrufe an zugrunde liegende AWS Dienste zu tätigen.
Um eine Servicerolle zu verwenden, geben Sie den `RoleArn` Parameter der Ressourcenoperationsanforderung an.
Da die Cloud Control API-Aktionen Teil des CloudFormation Dienstes sind, wird die von Ihnen angegebene Servicerolle vom CloudFormation Dienst (`cloudformation.amazonaws.com`) übernommen. Weitere Informationen finden Sie unter [CloudFormation Servicerolle](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-servicerole.html) im *AWS CloudFormation Benutzerhandbuch*.
Die für jeden Resource-Handler erforderlichen Berechtigungen sind im `handlers` Abschnitt des Schemas des jeweiligen Ressourcentyps definiert. Weitere Hinweise zum Anzeigen des Ressourcenschemas finden Sie unter. [Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas) Der `handlers` Abschnitt ist im [Definitionsschema für den Ressourcentyp](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-handlers) definiert.
## Bei der Verwendung der Cloud Control API wird sichergestellt, dass Anfragen für den Betrieb von Ressourcen eindeutig sind
Als bewährte Methode empfehlen wir dringend, ein Idempotenz-Token für Anfragen zum Erstellen, Löschen und Aktualisieren von Ressourcenoperationen anzugeben. Geben Sie vorzugsweise ein Token an, das für jede Anfrage eindeutig ist, z. B. einen Universally Unique Identifier (UUID). Ein solches Token stellt sicher, dass Anfragen in Fällen, in denen eine Anfrage erneut versucht werden muss, eindeutig identifiziert werden können.
Die `update-resource` Operationen `create-resource``delete-resource`, und verwenden alle einen `client-token` Parameter, der auf ein Idempotenz-Token gesetzt werden kann.
## Überlegungen bei der Verwendung der Cloud Control API
Wir empfehlen, dass Sie bei der Ausführung von Ressourcenoperationen mit der Cloud Control API das folgende Dienstverhalten berücksichtigen:
+ Die Cloud Control API führt jeden Ressourcenvorgang einzeln und unabhängig von allen anderen Ressourcenoperationen aus.
+ Eine einzelne Anfrage für einen Ressourcenvorgang an die Cloud Control API kann tatsächlich aus mehreren Aufrufen des zugrunde liegenden Dienstes bestehen, der die Ressource bereitstellt. Aus diesem Grund schlägt eine Ressourcenanforderung möglicherweise fehl, wenn sie nur teilweise abgeschlossen ist, was dazu führt, dass nur einige der angeforderten Änderungen auf die Ressource angewendet werden.
+ Wenn ein Ressourcenvorgang zu irgendeinem Zeitpunkt fehlschlägt, setzt die Cloud Control API die Ressource nicht in ihren vorherigen Zustand zurück.
+ Mit der Cloud Control API können Sie jeweils nur einen Ressourcenvorgang für eine bestimmte Ressource ausführen. Die Ressource kann jedoch weiterhin direkt über den zugrunde liegenden Dienst, der sie bereitgestellt hat, betrieben werden. Von diesem Ansatz wird dringend abgeraten, da er zu unvorhersehbarem Verhalten führen kann.
# Eine Ressource erstellen mit AWS -Cloud-Control- API
Verwenden Sie den `create-resource` Befehl, um eine Ressource zu erstellen.
## Den gewünschten Status der Ressource zusammenstellen
Damit die Cloud Control API eine Ressource erstellen kann, müssen Sie den *gewünschten Status* der Ressource angeben, die Sie erstellen möchten. Der gewünschte Status besteht aus einer Liste der Ressourceneigenschaften, die Sie angeben möchten, und ihrer gewünschten Werte.
Die Eigenschaften einer Ressource sind in ihrem Ressourcentypschema definiert. Dazu gehören, ob die Eigenschaft erforderlich ist, gültige Werte und andere Eigenschaftseinschränkungen. Weitere Informationen zum Anzeigen von Definitionen von Ressourceneigenschaften finden Sie unter[Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas).
Der von Ihnen angegebene gewünschte Status muss für das Ressourcentypschema gültig sein.
Nehmen wir als Beispiel an, Sie möchten eine [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)Ressource mit einem bestimmten Namen und einer Aufbewahrungsrichtlinie von 90 Tagen erstellen. Als ersten Schritt müssen Sie den gewünschten Status der Ressource erstellen, formatiert als JSON-Text.
```
{
"LogGroupName": "CloudApiLogGroup",
"RetentionInDays": 90
}
```
Wenn Sie den `create-resource` Befehl aufrufen, können Sie den gewünschten Status direkt inline als Zeichenfolge übergeben oder, für kompliziertere Definitionen des gewünschten Status, einen Dateispeicherort angeben.
Der folgende Befehl AWS Command Line Interface (AWS CLI) erstellt die Ressource und gibt im `desired-state` Parameter an, auf welchen Wert die `RetentionInDays` Eigenschaft der Ressource gesetzt ist`90`, zusätzlich zur Angabe des Protokollgruppennamens.
```
$ aws cloudcontrol create-resource --type-name AWS::Logs::LogGroup \
--desired-state '{"LogGroupName": "CloudApiLogGroup", "RetentionInDays":90}'
```
## Nachverfolgen des Fortschritts einer Anfrage zum Erstellen einer Ressource
Der `create-resource` Befehl gibt ein `ProgressEvent` Objekt zurück, mit dem Sie den aktuellen Status Ihrer Anfrage zur Erstellung von Ressourcen überwachen können. Weitere Informationen finden Sie unter [Nachverfolgen des Fortschritts von Anfragen zu Ressourcenoperationen](resource-operations-manage-requests.md#resource-operations-manage-requests-track).
# Aktualisierung einer Ressource mit AWS -Cloud-Control- API
Verwenden Sie den `update-resource` Befehl, um Aktualisierungen an einer vorhandenen Ressource vorzunehmen. Dazu gehören Ressourcen, die ursprünglich nicht über die Cloud Control API bereitgestellt wurden.
**Wichtig**
Wir raten dringend davon ab, die Cloud Control API zu verwenden, um Ressourcen zu aktualisieren, die von anderen Diensten aktiv verwaltet werden. Dies kann zu unerwarteten Ergebnissen führen. Verwenden Sie die Cloud Control-API beispielsweise nicht, um Ressourcen zu aktualisieren, die derzeit Teil eines CloudFormation Stacks sind.
Um eine bestehende Ressource zu aktualisieren, müssen Sie die ID der Ressource angeben. Weitere Hinweise zum Ermitteln der ID einer Ressource finden Sie unter[Unter Verwendung des primären Bezeichners einer Ressource](resource-identifier.md#resource-identifier-using).
Beim Aktualisieren einer Ressource werden die Eigenschaftswerte der Ressource geändert. Die Eigenschaften einer Ressource sind in ihrem Ressourcentypschema definiert. Dazu gehören, ob die Eigenschaft erforderlich ist, gültige Werte und andere Eigenschaftseinschränkungen. Weitere Informationen zum Anzeigen von Definitionen von Ressourceneigenschaften finden Sie unter[Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas).
## Das Patch-Dokument erstellen
Um eine Ressource zu aktualisieren, definieren Sie die Aktualisierungen zunächst als eine Liste von *Patch-Vorgängen*, die in einem JSON-Patch-Dokument enthalten sind. Dieses Patch-Dokument muss dem im [https://datatracker.ietf.org/doc/html/rfc6902](https://datatracker.ietf.org/doc/html/rfc6902) -Patch definierten Standard entsprechen.
Jeder Patch-Vorgang definiert eine einzelne Aktualisierung einer bestimmten Ressourceneigenschaft. Die folgenden Eigenschaften sind erforderlich:
+ `op`: Der Operationstyp. Die Cloud Control API unterstützt alle in RFC 6902 definierten Operationen:`add`,,, `remove` `replace``move`, `copy` und. `test`
+ `path`: Der Pfad zur Ressourceneigenschaft, relativ zum `properties` Abschnitt des Ressourcenschemas.
Je nach Vorgang können zusätzliche Eigenschaften erforderlich sein. Einzelheiten finden Sie in RFC 6902.
Wenn Sie den `update-resource` Befehl verwenden, können Sie das Patch-Dokument direkt als Zeichenfolge oder einen Speicherort angeben.
Im folgenden Beispiel wird die Aufbewahrungsrichtlinie einer [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)Ressource mit `CloudControlApiLogGroup` dem Namen 90 Tage aktualisiert.
```
$ aws cloudcontrol update-resource --type-name AWS::Logs::LogGroup \
--identifier CloudControlApiLogGroup \
--patch-document '[{"op":"replace","path":"RetentionInDays","value":90}]'
```
## Wie aktualisiert die Cloud Control API Ressourcen
Um eine Ressource zu aktualisieren, ruft die Cloud Control API zunächst den aktuellen Status der Ressource ab und aktualisiert die Ressource dann in einem zweistufigen Prozess:
+ Die Cloud Control-API kombiniert die in der Aktualisierungsanforderung angegebenen Patch-Operationen mit dem aktuellen Status der Ressource, um den gewünschten Status der Ressource nach der Aktualisierung zu generieren. Operationen werden nacheinander in der Reihenfolge angewendet, in der sie im Patch-Dokument erscheinen. Jeder Vorgang in der Sequenz wird auf den aktuellen Status der Ressource angewendet. Der resultierende Ressourcenstatus wird zum Ziel des nächsten Vorgangs.
Zu diesem Zeitpunkt schlägt die gesamte Aktualisierungsanforderung fehl, wenn:
+ Ein in der Anfrage enthaltener Patch-Vorgang ist ungültig.
+ Ein Patch-Vorgang dieses `op` Typs `test` schlägt fehl.
In solchen Fällen schlägt die gesamte Aktualisierungsanforderung fehl und die Cloud Control API nimmt keine Aktualisierungen an der Ressource vor.
+ Die Cloud Control API ruft dann den Update-Handler des Ressourcentyps auf, um die Ressource zu aktualisieren.
Wenn der Aktualisierungshandler zu irgendeinem Zeitpunkt fehlschlägt, setzt die *Cloud Control-API die Ressource nicht in ihren vorherigen Zustand zurück.*
Stellen Sie sich zum Beispiel das folgende Patch-Dokument vor, das für die Aktualisierung einer [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)Ressource definiert ist. Das Dokument enthält zwei Patch-Operationen. Der erste Vorgang ist vom Typ `test` und überprüft, ob die Aufbewahrungsrichtlinie für die Ressource auf 3653 Tage festgelegt ist. Wenn das der Fall ist, besteht die Ressource den Test und die Cloud Control API fährt mit dem nächsten Vorgang fort. Dieser Vorgang ersetzt den aktuellen Wert der Aufbewahrungsrichtlinie durch 180 Tage. Wenn die Aufbewahrungsrichtlinie der Ressource auf einen anderen Wert als 3653 Tage festgelegt ist, schlägt der erste `test` Vorgang fehl und die Cloud Control API führt den zweiten `replace` Vorgang nie aus.
```
[
{
"op": "test",
"path": "/RetentionInDays",
"value":3653
},
{
"op": "replace",
"path": "/RetentionInDays",
"value":180
}
]
```
## Nachverfolgung des Fortschritts einer Anfrage zur Aktualisierung einer Ressource
Der `update-resource` Befehl gibt ein `ProgressEvent` Objekt zurück, mit dem Sie den aktuellen Status Ihrer Ressourcenbetriebsanforderung verfolgen können. Weitere Informationen finden Sie unter [Nachverfolgen des Fortschritts von Anfragen zu Ressourcenoperationen](resource-operations-manage-requests.md#resource-operations-manage-requests-track).
# Löschen einer Ressource mit AWS -Cloud-Control- API
Verwenden Sie den `delete-resource` Befehl, um eine vorhandene Ressource zu löschen. Sie können die Ressource löschen, unabhängig davon, ob die Ressource ursprünglich mit der Cloud Control API bereitgestellt wurde oder nicht.
**Wichtig**
Wir raten dringend davon ab, die Cloud Control API zum Löschen von Ressourcen zu verwenden, die von anderen Diensten aktiv verwaltet werden. Dies kann zu unerwarteten Ergebnissen führen. Verwenden Sie beispielsweise nicht die Cloud Control-API, um Ressourcen zu löschen, die derzeit Teil eines CloudFormation Stacks sind.
Um eine bestehende Ressource zu aktualisieren, müssen Sie die ID der Ressource angeben. Weitere Hinweise zum Ermitteln der ID einer Ressource finden Sie unter[Unter Verwendung des primären Bezeichners einer Ressource](resource-identifier.md#resource-identifier-using).
Im folgenden Beispiel wird eine [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)Ressource mit dem Namen von `CloudControlApiLogGroup` gelöscht.
```
$ aws cloudcontrol delete-resource \
--type-name AWS::Logs::LogGroup --identifier CloudControlApiLogGroup
```
## Verfolgen des Fortschritts einer Anfrage zum Löschen einer Ressource
Der `delete-resource` Befehl gibt ein `ProgressEvent` Objekt zurück, mit dem Sie den aktuellen Status Ihrer Ressourcenbetriebsanforderung verfolgen können. Weitere Informationen finden Sie unter [Nachverfolgen des Fortschritts von Anfragen zu Ressourcenoperationen](resource-operations-manage-requests.md#resource-operations-manage-requests-track).
# Entdecken Sie Ressourcen mit AWS -Cloud-Control- API
Verwenden Sie den `list-resources` Befehl, um die Ressourcen zu ermitteln, die derzeit in Ihrem AWS-Konto Land bereitgestellt werden. AWS-Region Dazu gehören alle Ressourcen des angegebenen Ressourcentyps, unabhängig davon, ob sie über die Cloud Control-API, direkt über den zugrunde liegenden Dienst oder über einen anderen Mechanismus (z. B. als Teil eines AWS CloudFormation Stacks) bereitgestellt wurden.
Zu den für jede Ressource zurückgegebenen Informationen gehören:
+ Die primäre Kennung der Ressource.
+ Optional kann es die Eigenschaften der *Ressource oder aller* Ressourcen enthalten und den aktuellen Status der Ressource detailliert beschreiben. Weitere Informationen finden Sie unter [Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas).
Das folgende Beispiel gibt eine Liste von `AWS::Logs::LogGroup` Ressourcen zurück.
```
$ aws cloudcontrol list-resources --type-name AWS::Logs::LogGroup
```
Die Cloud Control API gibt eine Liste der Ressourcen des angegebenen Ressourcentyps in Ihrem Konto zurück. `list-resources`Gibt beispielsweise die primäre Kennung und die Ressourceneigenschaften aller `AWS::Logs::LogGroup` Ressourcen in Ihrem Konto zurück, unabhängig davon, ob sie von der Cloud Control API bereitgestellt wurden. Die zurückgegebenen Informationen ähneln je nach den Ressourcen in Ihrem Konto den folgenden.
```
{
"TypeName": "AWS::Logs::LogGroup",
"ResourceDescriptions":
[
{
"Identifier": "CloudControlExample",
"Properties": '{"RetentionInDays":180, "LogGroupName": "CloudControlExample", "Arn": "arn:aws:logs:us-west-2:123456789012:log-group:CloudControlExample:*"}'
},
{
"Identifier": "AnotherLogGroupResourceExample",
"Properties": '{"RetentionInDays":90, "LogGroupName": "AnotherLogGroupResourceExample", "Arn": "arn:aws:logs:us-west-2:123456789012:log-group:AnotherLogGroupResourceExample:*"}'
}
]
}
```
Im folgenden Beispiel wird eine Liste von `AWS::Kinesis::Stream` Ressourcen angefordert.
```
$ aws cloudcontrol list-resources --type-name AWS::Kinesis::Stream
```
Für Kinesis-Streams gibt die Cloud Control-API die primäre Kennung jedes Streams zusammen mit einer *Teilmenge* der Ressourceneigenschaften zurück. In diesem Fall nur eine einzelne Eigenschaft,. `Name` Sie könnten dann den primären Bezeichner eines Streams mit verwenden`get-resource`, um den vollständigen aktuellen Status der Ressource anzufordern.
```
{
"TypeName": "AWS::Kinesis::Stream",
"ResourceDescriptions": [
{
"Identifier": "MyKinesisStream",
"Properties": '{"Name": "MyKinesisStream"}'
},
{
"Identifier": "AnotherStream",
"Properties": '{"Name": "AnotherStream"}'
}
]
}
```
## Ressourcen, die zusätzliche Informationen benötigen
Für bestimmte Ressourcen müssen Sie im Rahmen Ihrer Anfrage zusätzliche Informationen zu den Ressourcen angeben, die Sie auflisten möchten. In diesen Fällen müssen Sie den `ResourceModel` Parameter verwenden, um diese Eigenschaften anzugeben.
In der folgenden Tabelle sind diese Ressourcen und die Eigenschaften aufgeführt, die Sie bei Listenanfragen im `ResourceModel` Parameter angeben müssen.
| Ressourcen | Erforderliche Eigenschaften |
| --- | --- |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-documentationversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-documentationversion.html) | `RestApiId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-stage.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-stage.html) | `RestApiId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-resourceversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-resourceversion.html) | `TypeArn` oder `TypeName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-integration.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-integration.html) | `DomainName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-objecttype.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-objecttype.html) | `DomainName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewaymulticastgroupmember.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewaymulticastgroupmember.html) | `TransitGatewayMulticastDomainId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewaymulticastgroupsource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewaymulticastgroupsource.html) | `TransitGatewayMulticastDomainId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-taskset.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-taskset.html) | `Cluster`, `Service` und `ID` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-addon.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-addon.html) | `ClusterName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-fargateprofile.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-fargateprofile.html) | `ClusterName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listener.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listener.html) | `LoadBalancerArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listenerrule.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listenerrule.html) | `ListenerArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-schemaversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-schemaversion.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloudcontrolapi/latest/userguide/resource-operations-list.html) |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-schemaversionmetadata.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-schemaversionmetadata.html) | `SchemaVersionId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-accesspolicy.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-accesspolicy.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloudcontrolapi/latest/userguide/resource-operations-list.html) |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-dashboard.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-dashboard.html) | `ProjectId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-project.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-project.html) | `PortalId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kendra-datasource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kendra-datasource.html) | `IndexId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kendra-faq.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-kendra-faq.html) | `IndexId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowentitlement.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowentitlement.html) | `FlowArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowoutput.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowoutput.html) | `FlowArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowsource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowsource.html) | `FlowArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowvpcinterface.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediaconnect-flowvpcinterface.html) | `FlowArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediapackage-asset.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediapackage-asset.html) | `PackagingGroupId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediapackage-packagingconfiguration.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-mediapackage-packagingconfiguration.html) | `PackagingGroupId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-networkfirewall-loggingconfiguration.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-networkfirewall-loggingconfiguration.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/cloudcontrolapi/latest/userguide/resource-operations-list.html) |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-analysis.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-analysis.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dashboard.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dashboard.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-datasource.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-datasource.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-template.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-template.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-theme.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-theme.html) | `AwsAccountId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxytargetgroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbproxytargetgroup.html) | `DBProxyName` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3outposts-accesspoint.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3outposts-accesspoint.html) | `Bucket` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3outposts-bucket.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3outposts-bucket.html) | `OutpostId` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-assignment.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-assignment.html) | `InstanceArn`, `PermissionSetArn`, `PrincipalId`, `PrincipalType`, `TargetId`, und `TargetType` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-instanceaccesscontrolattributeconfiguration.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-instanceaccesscontrolattributeconfiguration.html) | `InstanceArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-permissionset.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sso-permissionset.html) | `InstanceArn` und `PermissionSetArn` |
| [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-wafv2-webacl.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-wafv2-webacl.html) | `Scope` |
# Eine Ressource lesen mit AWS -Cloud-Control- API
Mithilfe der primären ID einer Ressource können Sie den `get-resource` Befehl aufrufen, um detaillierte Informationen über die Ressource abzurufen. Hinweise zum Abrufen der primären ID einer Ressource finden Sie unter[Identifizieren von Ressourcen mit AWS -Cloud-Control- API](resource-identifier.md).
Zu den von zurückgegebenen Informationen `get-resource` gehört das Schema der Ressource, das den aktuellen Status der Ressource detailliert beschreibt, einschließlich Eigenschaftswerte, unterstützter Ereignisse und erforderlicher Berechtigungen. Weitere Informationen finden Sie unter [Schemas für Ressourcentypen anzeigen](resource-types.md#resource-types-schemas).
Das folgende Beispiel gibt den aktuellen Status einer `AWS::Logs::LogGroup` Ressource mit dem Namen zurück`LogGroupResourceExample`. Bei `AWS::Logs::LogGroup` Ressourcen ist der Name einer Protokollgruppe deren primärer Bezeichner.
```
$ aws cloudcontrol get-resource --type-name AWS::Logs::LogGroup --identifier LogGroupResourceExample
```
# Verwaltung von Betriebsanfragen für Ressourcen mit AWS -Cloud-Control- API
Da Ressourcenoperationen asynchron sind, geben Ressourcenanforderungen z. B. `create-resource` ein `ProgressEvent` Objekt `update-resource` zurück, das Informationen über den aktuellen Status Ihrer Anforderung zum Erstellen oder Aktualisieren von Ressourcen enthält.
Beispielsweise könnte eine Anfrage zur Erstellung einer Ressource zunächst das folgende `ProgressEvent` Objekt zurückgeben.
```
{
"ProgressEvent": {
"EventTime": "2021-08-09T18:17:15.219Z",
"TypeName": "AWS::Logs::LogGroup",
"OperationStatus": "IN_PROGRESS",
"Operation": "CREATE",
"Identifier": "LogGroupResourceExample",
"RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
}
}
```
Die im `ProgressEvent` Objekt zurückgegebenen Informationen enthalten ein Anforderungstoken, das Sie dann verwenden können, um eine Anforderung für einen Ressourcenvorgang nachzuverfolgen oder abzubrechen.
**Anmerkung**
Anfragen für Ressourcenoperationen laufen nach sieben Tagen ab.
## Liste der aktiven Anfragen für Ressourcenoperationen
Verwenden Sie den `list-resource-requests` Befehl, um eine Liste der aktiven Ressourcenoperationsanforderungen für ein AWS-Konto und zurückzugeben AWS-Region. Sie können die Liste nach Anforderungstyp und Status filtern.
Anfragen für Ressourcenoperationen laufen nach sieben Tagen ab.
Das folgende Beispiel gibt aktive Anfragen für Ressourcenoperationen zurück, filtert jedoch alle Anfragen zur Ressourcenerstellung heraus, die noch in Bearbeitung sind.
```
$ aws cloudcontrol list-resource-requests --resource-request-status-filter \
Operations=CREATE,OperationStatuses=IN_PROGRESS
```
Zu den Informationen, die für jeden Ressourcenvorgang zurückgegeben werden, gehört ein Anforderungstoken, mit dem Sie dann eine Anfrage für einen Ressourcenvorgang verfolgen oder stornieren können.
```
{
"ResourceRequestStatusSummaries": [
{
"EventTime": "2021-08-09T18:17:16.591Z",
"TypeName": "AWS::Logs::LogGroup",
"OperationStatus": "SUCCESS",
"Operation": "CREATE",
"Identifier": "LogGroupResourceExample",
"RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
}
]
}
```
## Nachverfolgen des Fortschritts von Anfragen zu Ressourcenoperationen
Verwenden Sie den `get-resource-request-status` Befehl, um den Fortschritt Ihrer Ressourcenbetriebsanforderung zu verfolgen. Dieser Befehl verwendet das Anforderungstoken, das in dem `ProgressEvent` Objekt enthalten ist, das bei der ersten Anforderung eines Ressourcenvorgangs generiert wurde. (Sie können das Anforderungstoken für eine Ressourcenoperationsanforderung auch mithilfe des `list-resource-requests` Befehls abrufen.) Der `get-resource-request-status` Befehl gibt ein aktualisiertes `ProgressEvent` Objekt zurück, das Informationen zum aktuellen Status der Anforderung enthält.
Sehen Sie sich das folgende Beispiel an.
```
$ aws cloudcontrol get-resource-request-status \
--request-token 5f40c577-3534-4b20-9599-0b0123456789
```
## Anfragen für Ressourcenoperationen werden storniert
Verwenden Sie den `cancel-resource-request` Befehl, um eine Anforderung für einen Ressourcenvorgang abzubrechen, die gerade bearbeitet wird. Da Sie für eine bestimmte Ressource jeweils nur einen einzigen Vorgang ausführen können, kann es vorkommen, dass Sie den aktuellen Ressourcenvorgang abbrechen müssen, um die Ressource verfügbar zu machen, sodass ein weiterer Vorgang mit ihr ausgeführt werden kann.
Das Stornieren einer Ressourcenanforderung garantiert nicht, dass die Cloud Control API alle Ressourcenoperationen sofort abbrechen kann. Stattdessen hört die Cloud Control API auf, weitere Aufrufe an den Ressourcen-Event-Handler zu tätigen. Eine einzelne Anforderung für einen Ressourcenvorgang an die Cloud Control API kann tatsächlich aus mehreren Aufrufen des zugrunde liegenden Dienstes bestehen, der die Ressource bereitstellt. Aus diesem Grund kann das Stornieren einer Anforderung für einen Ressourcenvorgang dazu führen, dass die Anfrage teilweise abgeschlossen wird, sodass nur einige der angeforderten Änderungen auf die Ressource angewendet werden. Die Cloud Control API setzt die Ressource nicht in ihren vorherigen Zustand zurück.
Nur Anfragen für Ressourcenoperationen mit dem Status `PENDING` oder `IN_PROGRESS` können storniert werden.
**Anmerkung**
Durch das Aufrufen werden zwar die von der Cloud Control API ausgeführten Operationen `CancelResourceRequest` abgebrochen, es werden jedoch keine asynchronen Vorgänge beendet, die möglicherweise bereits auf nachgelagerten Diensten gestartet wurden.
# Identifizieren von Ressourcen mit AWS -Cloud-Control- API
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
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
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*.