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.
# AWS Config Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS Config.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `delete-config-rule`
Das folgende Codebeispiel zeigt, wie Sie`delete-config-rule`.
**AWS CLI**
**Um eine AWS Config-Regel zu löschen**
Der folgende Befehl löscht eine AWS Config-Regel mit dem Namen`MyConfigRule`:
```
aws configservice delete-config-rule --config-rule-name MyConfigRule
```
+ Einzelheiten zur API finden Sie [DeleteConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-config-rule.html)in der *AWS CLI Befehlsreferenz.*
### `delete-delivery-channel`
Das folgende Codebeispiel zeigt die Verwendung`delete-delivery-channel`.
**AWS CLI**
**So löschen Sie einen Bereitstellungskanal**
Mit dem folgendem Befehl wird der Standard-Bereitstellungskanal gelöscht:
```
aws configservice delete-delivery-channel --delivery-channel-name default
```
+ Einzelheiten zur API finden Sie [DeleteDeliveryChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-delivery-channel.html)in der *AWS CLI Befehlsreferenz*.
### `delete-evaluation-results`
Das folgende Codebeispiel zeigt die Verwendung`delete-evaluation-results`.
**AWS CLI**
**Um Bewertungsergebnisse manuell zu löschen**
Der folgende Befehl löscht die aktuellen Auswertungsergebnisse für die AWS verwaltete Regel s3-: bucket-versioning-enabled
```
aws configservice delete-evaluation-results --config-rule-name s3-bucket-versioning-enabled
```
+ Einzelheiten zur API finden Sie [DeleteEvaluationResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/delete-evaluation-results.html)in der *AWS CLI Befehlsreferenz.*
### `deliver-config-snapshot`
Das folgende Codebeispiel zeigt die Verwendung`deliver-config-snapshot`.
**AWS CLI**
**So stellen Sie einen Konfigurations-Snapshot bereit**
Mit dem folgenden Befehl wird ein Konfigurations-Snapshot an den Amazon-S3-Bucket übermittelt, der zum Standard-Bereitstellungskanal gehört:
```
aws configservice deliver-config-snapshot --delivery-channel-name default
```
Ausgabe:
```
{
"configSnapshotId": "d0333b00-a683-44af-921e-examplefb794"
}
```
+ Einzelheiten zur API finden Sie [DeliverConfigSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/deliver-config-snapshot.html)in der *AWS CLI Befehlsreferenz*.
### `describe-compliance-by-config-rule`
Das folgende Codebeispiel zeigt die Verwendung`describe-compliance-by-config-rule`.
**AWS CLI**
**Um Compliance-Informationen für Ihre AWS Config-Regeln zu erhalten**
Der folgende Befehl gibt Konformitätsinformationen für jede AWS Config-Regel zurück, gegen die eine oder mehrere AWS Ressourcen verstoßen:
```
aws configservice describe-compliance-by-config-rule --compliance-types NON_COMPLIANT
```
In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen der zugehörigen Regel nicht entsprechen. Die folgende Ausgabe gibt beispielsweise an, dass 3 Ressourcen der Regel mit dem Namen `InstanceTypesAreT2micro` nicht entsprechen.
Ausgabe:
```
{
"ComplianceByConfigRules": [
{
"Compliance": {
"ComplianceContributorCount": {
"CappedCount": 3,
"CapExceeded": false
},
"ComplianceType": "NON_COMPLIANT"
},
"ConfigRuleName": "InstanceTypesAreT2micro"
},
{
"Compliance": {
"ComplianceContributorCount": {
"CappedCount": 10,
"CapExceeded": false
},
"ComplianceType": "NON_COMPLIANT"
},
"ConfigRuleName": "RequiredTagsForVolumes"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeComplianceByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-compliance-by-config-rule.html)unter *AWS CLI Befehlsreferenz*.
### `describe-compliance-by-resource`
Das folgende Codebeispiel zeigt die Verwendung`describe-compliance-by-resource`.
**AWS CLI**
**Um Compliance-Informationen für Ihre AWS Ressourcen zu erhalten**
Der folgende Befehl gibt Konformitätsinformationen für jede EC2-Instance zurück, die von AWS Config aufgezeichnet wurde und gegen eine oder mehrere Regeln verstößt:
```
aws configservice describe-compliance-by-resource --resource-type AWS::EC2::Instance --compliance-types NON_COMPLIANT
```
In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, gegen wie viele Regeln die Ressource verstößt. Die folgende Ausgabe gibt beispielsweise an, dass die Instance `i-1a2b3c4d` gegen 2 Regeln verstößt.
Ausgabe:
```
{
"ComplianceByResources": [
{
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-1a2b3c4d",
"Compliance": {
"ComplianceContributorCount": {
"CappedCount": 2,
"CapExceeded": false
},
"ComplianceType": "NON_COMPLIANT"
}
},
{
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-2a2b3c4d ",
"Compliance": {
"ComplianceContributorCount": {
"CappedCount": 3,
"CapExceeded": false
},
"ComplianceType": "NON_COMPLIANT"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeComplianceByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-compliance-by-resource.html)in der *AWS CLI Befehlsreferenz*.
### `describe-config-rule-evaluation-status`
Das folgende Codebeispiel zeigt die Verwendung`describe-config-rule-evaluation-status`.
**AWS CLI**
**Um Statusinformationen für eine AWS Config-Regel abzurufen**
Der folgende Befehl gibt die Statusinformationen für eine AWS Config-Regel mit dem Namen zurück`MyConfigRule`:
```
aws configservice describe-config-rule-evaluation-status --config-rule-names MyConfigRule
```
Ausgabe:
```
{
"ConfigRulesEvaluationStatus": [
{
"ConfigRuleArn": "arn:aws:config:us-east-1:123456789012:config-rule/config-rule-abcdef",
"FirstActivatedTime": 1450311703.844,
"ConfigRuleId": "config-rule-abcdef",
"LastSuccessfulInvocationTime": 1450314643.156,
"ConfigRuleName": "MyConfigRule"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeConfigRuleEvaluationStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-config-rule-evaluation-status.html)in der *AWS CLI Befehlsreferenz*.
### `describe-config-rules`
Das folgende Codebeispiel zeigt die Verwendung`describe-config-rules`.
**AWS CLI**
**Um Details für eine AWS Config-Regel abzurufen**
Der folgende Befehl gibt Details für eine AWS Config-Regel mit dem Namen zurück`InstanceTypesAreT2micro`:
```
aws configservice describe-config-rules --config-rule-names InstanceTypesAreT2micro
```
Ausgabe:
```
{
"ConfigRules": [
{
"ConfigRuleState": "ACTIVE",
"Description": "Evaluates whether EC2 instances are the t2.micro type.",
"ConfigRuleName": "InstanceTypesAreT2micro",
"ConfigRuleArn": "arn:aws:config:us-east-1:123456789012:config-rule/config-rule-abcdef",
"Source": {
"Owner": "CUSTOM_LAMBDA",
"SourceIdentifier": "arn:aws:lambda:us-east-1:123456789012:function:InstanceTypeCheck",
"SourceDetails": [
{
"EventSource": "aws.config",
"MessageType": "ConfigurationItemChangeNotification"
}
]
},
"InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}",
"Scope": {
"ComplianceResourceTypes": [
"AWS::EC2::Instance"
]
},
"ConfigRuleId": "config-rule-abcdef"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeConfigRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-config-rules.html)in der *AWS CLI Befehlsreferenz*.
### `describe-configuration-recorder-status`
Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-recorder-status`.
**AWS CLI**
**So rufen Sie Statusinformationen für den Konfigurations-Recorder ab**
Der folgende Befehl gibt den Status des Standardkonfigurations-Recorders zurück:
```
aws configservice describe-configuration-recorder-status
```
Ausgabe:
```
{
"ConfigurationRecordersStatus": [
{
"name": "default",
"lastStatus": "SUCCESS",
"recording": true,
"lastStatusChangeTime": 1452193834.344,
"lastStartTime": 1441039997.819,
"lastStopTime": 1441039992.835
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeConfigurationRecorderStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-configuration-recorder-status.html)in der *AWS CLI Befehlsreferenz*.
### `describe-configuration-recorders`
Das folgende Codebeispiel zeigt die Verwendung`describe-configuration-recorders`.
**AWS CLI**
**So rufen Sie Details zum Konfigurations-Recorder ab**
Der folgende Befehl gibt Details zum Standardkonfigurations-Recorder zurück:
```
aws configservice describe-configuration-recorders
```
Ausgabe:
```
{
"ConfigurationRecorders": [
{
"recordingGroup": {
"allSupported": true,
"resourceTypes": [],
"includeGlobalResourceTypes": true
},
"roleARN": "arn:aws:iam::123456789012:role/config-ConfigRole-A1B2C3D4E5F6",
"name": "default"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeConfigurationRecorders](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-configuration-recorders.html)in der *AWS CLI Befehlsreferenz*.
### `describe-delivery-channel-status`
Das folgende Codebeispiel zeigt die Verwendung`describe-delivery-channel-status`.
**AWS CLI**
**So rufen Sie Statusinformationen für den Bereitstellungskanal ab**
Der folgende Befehl gibt den Status des Bereitstellungskanals zurück:
```
aws configservice describe-delivery-channel-status
```
Ausgabe:
```
{
"DeliveryChannelsStatus": [
{
"configStreamDeliveryInfo": {
"lastStatusChangeTime": 1452193834.381,
"lastStatus": "SUCCESS"
},
"configHistoryDeliveryInfo": {
"lastSuccessfulTime": 1450317838.412,
"lastStatus": "SUCCESS",
"lastAttemptTime": 1450317838.412
},
"configSnapshotDeliveryInfo": {
"lastSuccessfulTime": 1452185597.094,
"lastStatus": "SUCCESS",
"lastAttemptTime": 1452185597.094
},
"name": "default"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeDeliveryChannelStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-delivery-channel-status.html)in der *AWS CLI Befehlsreferenz*.
### `describe-delivery-channels`
Das folgende Codebeispiel zeigt die Verwendung`describe-delivery-channels`.
**AWS CLI**
**So rufen Sie Details über den Bereitstellungskanal ab**
Der folgende Befehl gibt Details über den Bereitstellungskanal zurück:
```
aws configservice describe-delivery-channels
```
Ausgabe:
```
{
"DeliveryChannels": [
{
"snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
"name": "default",
"s3BucketName": "config-bucket-123456789012"
}
]
}
```
+ Einzelheiten zur API finden Sie [DescribeDeliveryChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-delivery-channels.html)in der *AWS CLI Befehlsreferenz*.
### `get-compliance-details-by-config-rule`
Das folgende Codebeispiel zeigt die Verwendung`get-compliance-details-by-config-rule`.
**AWS CLI**
**Um die Auswertungsergebnisse für eine AWS Config-Regel abzurufen**
Der folgende Befehl gibt die Auswertungsergebnisse für alle Ressourcen zurück, die nicht einer AWS Config-Regel mit dem Namen entsprechen`InstanceTypesAreT2micro`:
```
aws configservice get-compliance-details-by-config-rule --config-rule-name InstanceTypesAreT2micro --compliance-types NON_COMPLIANT
```
Ausgabe:
```
{
"EvaluationResults": [
{
"EvaluationResultIdentifier": {
"OrderingTimestamp": 1450314635.065,
"EvaluationResultQualifier": {
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-1a2b3c4d",
"ConfigRuleName": "InstanceTypesAreT2micro"
}
},
"ResultRecordedTime": 1450314645.261,
"ConfigRuleInvokedTime": 1450314642.948,
"ComplianceType": "NON_COMPLIANT"
},
{
"EvaluationResultIdentifier": {
"OrderingTimestamp": 1450314635.065,
"EvaluationResultQualifier": {
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-2a2b3c4d",
"ConfigRuleName": "InstanceTypesAreT2micro"
}
},
"ResultRecordedTime": 1450314645.18,
"ConfigRuleInvokedTime": 1450314642.902,
"ComplianceType": "NON_COMPLIANT"
},
{
"EvaluationResultIdentifier": {
"OrderingTimestamp": 1450314635.065,
"EvaluationResultQualifier": {
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-3a2b3c4d",
"ConfigRuleName": "InstanceTypesAreT2micro"
}
},
"ResultRecordedTime": 1450314643.346,
"ConfigRuleInvokedTime": 1450314643.124,
"ComplianceType": "NON_COMPLIANT"
}
]
}
```
+ Einzelheiten zur API finden Sie [GetComplianceDetailsByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-details-by-config-rule.html)in der *AWS CLI Befehlsreferenz*.
### `get-compliance-details-by-resource`
Das folgende Codebeispiel zeigt die Verwendung`get-compliance-details-by-resource`.
**AWS CLI**
**Um die Evaluierungsergebnisse für eine AWS Ressource abzurufen**
Der folgende Befehl gibt die Auswertungsergebnisse für jede Regel zurück, der die EC2-Instance `i-1a2b3c4d` nicht entspricht:
```
aws configservice get-compliance-details-by-resource --resource-type AWS::EC2::Instance --resource-id i-1a2b3c4d --compliance-types NON_COMPLIANT
```
Ausgabe:
```
{
"EvaluationResults": [
{
"EvaluationResultIdentifier": {
"OrderingTimestamp": 1450314635.065,
"EvaluationResultQualifier": {
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-1a2b3c4d",
"ConfigRuleName": "InstanceTypesAreT2micro"
}
},
"ResultRecordedTime": 1450314643.288,
"ConfigRuleInvokedTime": 1450314643.034,
"ComplianceType": "NON_COMPLIANT"
},
{
"EvaluationResultIdentifier": {
"OrderingTimestamp": 1450314635.065,
"EvaluationResultQualifier": {
"ResourceType": "AWS::EC2::Instance",
"ResourceId": "i-1a2b3c4d",
"ConfigRuleName": "RequiredTagForEC2Instances"
}
},
"ResultRecordedTime": 1450314645.261,
"ConfigRuleInvokedTime": 1450314642.948,
"ComplianceType": "NON_COMPLIANT"
}
]
}
```
+ Einzelheiten zur API finden Sie [GetComplianceDetailsByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-details-by-resource.html)in der *AWS CLI Befehlsreferenz*.
### `get-compliance-summary-by-config-rule`
Das folgende Codebeispiel zeigt die Verwendung`get-compliance-summary-by-config-rule`.
**AWS CLI**
**Um die Konformitätsübersicht für Ihre AWS Config-Regeln abzurufen**
Der folgende Befehl gibt die Anzahl der Regeln zurück, die konform sind, und die Anzahl derer, die nicht konform sind:
```
aws configservice get-compliance-summary-by-config-rule
```
In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Regeln konform bzw. nicht konform sind.
Ausgabe:
```
{
"ComplianceSummary": {
"NonCompliantResourceCount": {
"CappedCount": 3,
"CapExceeded": false
},
"ComplianceSummaryTimestamp": 1452204131.493,
"CompliantResourceCount": {
"CappedCount": 2,
"CapExceeded": false
}
}
}
```
+ Einzelheiten zur API finden Sie [GetComplianceSummaryByConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-summary-by-config-rule.html)in der *AWS CLI Befehlsreferenz*.
### `get-compliance-summary-by-resource-type`
Das folgende Codebeispiel zeigt die Verwendung`get-compliance-summary-by-resource-type`.
**AWS CLI**
**So rufen Sie die Compliance-Zusammenfassung für alle Ressourcentypen ab**
Der folgende Befehl gibt die Anzahl der AWS Ressourcen zurück, die nicht konform sind, und die Anzahl, die konform sind:
```
aws configservice get-compliance-summary-by-resource-type
```
In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen konform bzw. nicht konform sind.
Ausgabe:
```
{
"ComplianceSummariesByResourceType": [
{
"ComplianceSummary": {
"NonCompliantResourceCount": {
"CappedCount": 16,
"CapExceeded": false
},
"ComplianceSummaryTimestamp": 1453237464.543,
"CompliantResourceCount": {
"CappedCount": 10,
"CapExceeded": false
}
}
}
]
}
```
**So rufen Sie die Compliance-Zusammenfassung für einen bestimmten Ressourcentyp ab**
Der folgende Befehl gibt die Anzahl der EC2-Instances zurück, die nicht konform sind, und die Anzahl derer, die konform sind:
```
aws configservice get-compliance-summary-by-resource-type --resource-types AWS::EC2::Instance
```
In der Ausgabe gibt der Wert für jedes `CappedCount`-Attribut an, wie viele Ressourcen konform bzw. nicht konform sind.
Ausgabe:
```
{
"ComplianceSummariesByResourceType": [
{
"ResourceType": "AWS::EC2::Instance",
"ComplianceSummary": {
"NonCompliantResourceCount": {
"CappedCount": 3,
"CapExceeded": false
},
"ComplianceSummaryTimestamp": 1452204923.518,
"CompliantResourceCount": {
"CappedCount": 7,
"CapExceeded": false
}
}
}
]
}
```
+ Einzelheiten zur API finden Sie unter [GetComplianceSummaryByResourceType AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-summary-by-resource-type.html)*Befehlsreferenz.*
### `get-resource-config-history`
Das folgende Codebeispiel zeigt die Verwendung`get-resource-config-history`.
**AWS CLI**
**Um den Konfigurationsverlauf einer AWS Ressource abzurufen**
Der folgende Befehl gibt eine Liste von Konfigurationselementen für eine EC2-Instance mit der ID `i-1a2b3c4d` zurück:
```
aws configservice get-resource-config-history --resource-type AWS::EC2::Instance --resource-id i-1a2b3c4d
```
+ Einzelheiten zur API finden Sie [GetResourceConfigHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-resource-config-history.html)in der *AWS CLI Befehlsreferenz*.
### `get-status`
Das folgende Codebeispiel zeigt die Verwendung`get-status`.
**AWS CLI**
**Um den Status für AWS Config abzurufen**
Der folgende Befehl gibt den Status des Bereitstellungskanals und Konfigurations-Recorders zurück:
```
aws configservice get-status
```
Ausgabe:
```
Configuration Recorders:
name: default
recorder: ON
last status: SUCCESS
Delivery Channels:
name: default
last stream delivery status: SUCCESS
last history delivery status: SUCCESS
last snapshot delivery status: SUCCESS
```
+ Einzelheiten zur API finden Sie [GetStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-status.html)in der *AWS CLI Befehlsreferenz*.
### `list-discovered-resources`
Das folgende Codebeispiel zeigt die Verwendung`list-discovered-resources`.
**AWS CLI**
**Um Ressourcen aufzulisten, die AWS Config entdeckt hat**
Der folgende Befehl listet die EC2-Instances auf, die AWS Config entdeckt hat:
```
aws configservice list-discovered-resources --resource-type AWS::EC2::Instance
```
Ausgabe:
```
{
"resourceIdentifiers": [
{
"resourceType": "AWS::EC2::Instance",
"resourceId": "i-1a2b3c4d"
},
{
"resourceType": "AWS::EC2::Instance",
"resourceId": "i-2a2b3c4d"
},
{
"resourceType": "AWS::EC2::Instance",
"resourceId": "i-3a2b3c4d"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListDiscoveredResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/list-discovered-resources.html)in der *AWS CLI Befehlsreferenz.*
### `put-config-rule`
Das folgende Codebeispiel zeigt die Verwendung`put-config-rule`.
**AWS CLI**
**So fügen Sie eine AWS verwaltete Konfigurationsregel hinzu**
Der folgende Befehl stellt JSON-Code zum Hinzufügen einer AWS verwalteten Config-Regel bereit:
```
aws configservice put-config-rule --config-rule file://RequiredTagsForEC2Instances.json
```
`RequiredTagsForEC2Instances.json` ist eine JSON-Datei, die die Regelkonfiguration enthält:
```
{
"ConfigRuleName": "RequiredTagsForEC2Instances",
"Description": "Checks whether the CostCenter and Owner tags are applied to EC2 instances.",
"Scope": {
"ComplianceResourceTypes": [
"AWS::EC2::Instance"
]
},
"Source": {
"Owner": "AWS",
"SourceIdentifier": "REQUIRED_TAGS"
},
"InputParameters": "{\"tag1Key\":\"CostCenter\",\"tag2Key\":\"Owner\"}"
}
```
Für das `ComplianceResourceTypes` Attribut beschränkt dieser JSON-Code den Bereich auf Ressourcen des `AWS::EC2::Instance` Typs, sodass AWS Config nur EC2-Instances anhand der Regel auswertet. Da es sich bei der Regel um eine verwaltete Regel handelt, ist das `Owner`-Attribut auf `AWS` und das `SourceIdentifier`-Attribut auf den Regelbezeichner `REQUIRED_TAGS` festgelegt. Für das `InputParameters`-Attribut werden die Tag-Schlüssel, `Owner` und `CostCenter`, die die Regel benötigt, angegeben.
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Um die Regelkonfiguration zu überprüfen, führen Sie den describe-config-rules Befehl aus und geben Sie den Regelnamen an.
**So fügen Sie eine vom Kunden verwaltete Konfigurationsregel hinzu**
Der folgende Befehl stellt JSON-Code zum Hinzufügen einer vom Kunden verwalteten Konfigurationsregel bereit:
```
aws configservice put-config-rule --config-rule file://InstanceTypesAreT2micro.json
```
`InstanceTypesAreT2micro.json` ist eine JSON-Datei, die die Regelkonfiguration enthält:
```
{
"ConfigRuleName": "InstanceTypesAreT2micro",
"Description": "Evaluates whether EC2 instances are the t2.micro type.",
"Scope": {
"ComplianceResourceTypes": [
"AWS::EC2::Instance"
]
},
"Source": {
"Owner": "CUSTOM_LAMBDA",
"SourceIdentifier": "arn:aws:lambda:us-east-1:123456789012:function:InstanceTypeCheck",
"SourceDetails": [
{
"EventSource": "aws.config",
"MessageType": "ConfigurationItemChangeNotification"
}
]
},
"InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}"
}
```
Für das `ComplianceResourceTypes` Attribut beschränkt dieser JSON-Code den Bereich auf Ressourcen des `AWS::EC2::Instance` Typs, sodass AWS Config nur EC2-Instances anhand der Regel auswertet. Da es sich bei dieser Regel um eine vom Kunden verwaltete Regel handelt`CUSTOM_LAMBDA`, ist das `Owner` Attribut auf und das `SourceIdentifier` Attribut auf den ARN der AWS Lambda-Funktion gesetzt. Das `SourceDetails`-Objekt ist erforderlich. Die für das `InputParameters` Attribut angegebenen Parameter werden an die AWS Lambda-Funktion übergeben, wenn AWS Config sie aufruft, um Ressourcen anhand der Regel auszuwerten.
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Um die Regelkonfiguration zu überprüfen, führen Sie den describe-config-rules Befehl aus und geben Sie den Regelnamen an.
+ Einzelheiten zur API finden Sie [PutConfigRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-config-rule.html)unter *AWS CLI Befehlsreferenz*.
### `put-configuration-recorder`
Das folgende Codebeispiel zeigt die Verwendung`put-configuration-recorder`.
**AWS CLI**
**Beispiel 1: So zeichnen Sie alle unterstützten Ressourcen auf**
Der folgende Befehl erstellt einen Konfigurations-Recorder, der Änderungen an allen unterstützten Ressourcentypen, einschließlich globaler Ressourcentypen, verfolgt:
```
aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group allSupported=true,includeGlobalResourceTypes=true
```
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen.
**Beispiel 2: So zeichnen Sie bestimmte Ressourcentypen auf**
Der folgende Befehl erstellt einen Konfigurations-Recorder, der nur Änderungen an den Ressourcentypen verfolgt, die in der JSON-Datei für die Option --recording-group angegeben sind:
```
aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group file://recordingGroup.json
```
RecordingGroup.json ist eine JSON-Datei, die die Arten von Ressourcen angibt, die Config aufzeichnet: AWS
```
{
"allSupported": false,
"includeGlobalResourceTypes": false,
"resourceTypes": [
"AWS::EC2::EIP",
"AWS::EC2::Instance",
"AWS::EC2::NetworkAcl",
"AWS::EC2::SecurityGroup",
"AWS::CloudTrail::Trail",
"AWS::EC2::Volume",
"AWS::EC2::VPC",
"AWS::IAM::User",
"AWS::IAM::Policy"
]
}
```
Bevor Sie resourceTypes für den Schlüssel ResourceTypes angeben können, müssen Sie die Optionen AllSupported und includeGlobalResource Types auf false setzen oder sie weglassen.
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen.
**Beispiel 3: So wählen Sie alle unterstützten Ressourcen mit Ausnahme bestimmter Ressourcentypen aus**
Der folgende Befehl erstellt einen Konfigurations-Recorder, der Änderungen an allen aktuell und künftig unterstützten Ressourcentypen verfolgt mit Ausnahme von Ressourcentypen, die in der JSON-Datei für die Option --recording-group angegeben sind:
```
aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group file://recordingGroup.json
```
RecordingGroup.json ist eine JSON-Datei, die die Arten von Ressourcen angibt, die Config aufzeichnet: AWS
```
{
"allSupported": false,
"exclusionByResourceTypes": {
"resourceTypes": [
"AWS::Redshift::ClusterSnapshot",
"AWS::RDS::DBClusterSnapshot",
"AWS::CloudFront::StreamingDistribution"
]
},
"includeGlobalResourceTypes": false,
"recordingStrategy": {
"useOnly": "EXCLUSION_BY_RESOURCE_TYPES"
},
}
```
Bevor Sie Ressourcentypen angeben können, die von der Aufzeichnung ausgeschlossen werden sollen: 1) Sie müssen die Optionen AllSupported und includeGlobalResource Types auf false setzen oder sie weglassen, und 2) Sie müssen das Feld UseOnly auf EXCLUSION\$1BY\$1RESOURCE\$1TYPES setzen. RecordingStrategy
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-configuration-recorders Befehl aus, um die Einstellungen Ihres Konfigurationsrekorders zu überprüfen.
+ Einzelheiten zur API finden Sie [PutConfigurationRecorder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-configuration-recorder.html)in der *AWS CLI Befehlsreferenz*.
### `put-delivery-channel`
Das folgende Codebeispiel zeigt die Verwendung`put-delivery-channel`.
**AWS CLI**
**So erstellen Sie einen Bereitstellungskanal**
Der folgende Befehl stellt die Einstellungen für den Bereitstellungskanal als JSON-Code zur Verfügung:
```
aws configservice put-delivery-channel --delivery-channel file://deliveryChannel.json
```
Die Datei `deliveryChannel.json` gibt die Attribute des Bereitstellungskanals an:
```
{
"name": "default",
"s3BucketName": "config-bucket-123456789012",
"snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
"configSnapshotDeliveryProperties": {
"deliveryFrequency": "Twelve_Hours"
}
}
```
In diesem Beispiel werden die folgenden Attribute festgelegt:
`name`: Der Name des Übermittlungskanals. Standardmäßig weist AWS Config den Namen einem neuen Lieferkanal `default` zu. Sie können den Namen des Lieferkanals nicht mit dem Befehl aktualisieren. `put-delivery-channel` Die Schritte zum Ändern des Namens finden Sie unter „Umbenennen des Bereitstellungskanals“.`s3BucketName` - Der Name des Amazon S3 S3-Buckets, für den AWS Config Konfigurations-Snapshots und Konfigurationsverlaufsdateien bereitstellt. Wenn Sie einen Bucket angeben, der zu einem anderen AWS Konto gehört, muss dieser Bucket über Richtlinien verfügen, die Config Zugriffsberechtigungen gewähren. AWS Weitere Informationen finden Sie unter „Berechtigungen für den Amazon-S3-Bucket“.
`snsTopicARN`— Der Amazon-Ressourcenname (ARN) des Amazon SNS-Themas, an das AWS Config Benachrichtigungen über Konfigurationsänderungen sendet. Wenn Sie ein Thema aus einem anderen Konto auswählen, muss das Thema über Richtlinien verfügen, die Config Zugriffsberechtigungen gewähren. AWS Weitere Informationen finden Sie unter „Berechtigungen für das Amazon-SNS-Thema“.
`configSnapshotDeliveryProperties`- Enthält das `deliveryFrequency` Attribut, das festlegt, wie oft AWS Config Konfigurations-Snapshots liefert und wie oft es Evaluierungen für periodische Config-Regeln aufruft.
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den describe-delivery-channels Befehl aus, um die Einstellungen Ihres Lieferkanals zu überprüfen.
+ Einzelheiten zur API finden Sie [PutDeliveryChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/put-delivery-channel.html)in der *AWS CLI Befehlsreferenz*.
### `start-config-rules-evaluation`
Das folgende Codebeispiel zeigt die Verwendung`start-config-rules-evaluation`.
**AWS CLI**
**So führen Sie eine On-Demand-Evaluierung für AWS Config-Regeln durch**
Mit dem folgenden Befehl wird eine Evaluierung für zwei AWS verwaltete Regeln gestartet:
```
aws configservice start-config-rules-evaluation --config-rule-names s3-bucket-versioning-enabled cloudtrail-enabled
```
+ Einzelheiten zur API finden Sie [StartConfigRulesEvaluation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/start-config-rules-evaluation.html)in der *AWS CLI Befehlsreferenz*.
### `start-configuration-recorder`
Das folgende Codebeispiel zeigt die Verwendung`start-configuration-recorder`.
**AWS CLI**
**Um den Konfigurationsrekorder zu starten**
Der folgende Befehl startet den Standard-Configuration-Recorder:
```
aws configservice start-configuration-recorder --configuration-recorder-name default
```
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den Befehl get-status aus, um zu überprüfen, ob AWS Config Ihre Ressourcen aufzeichnet.
+ Einzelheiten zur API finden Sie [StartConfigurationRecorder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/start-configuration-recorder.html)in der *AWS CLI Befehlsreferenz.*
### `stop-configuration-recorder`
Das folgende Codebeispiel zeigt die Verwendung`stop-configuration-recorder`.
**AWS CLI**
**Um den Konfigurationsrekorder zu stoppen**
Der folgende Befehl hält den Standard-Configuration-Recorder an:
```
aws configservice stop-configuration-recorder --configuration-recorder-name default
```
Wenn der Befehl erfolgreich ist, gibt AWS Config keine Ausgabe zurück. Führen Sie den Befehl get-status aus, um sicherzustellen, dass AWS Config Ihre Ressourcen nicht aufzeichnet.
+ Einzelheiten zur API finden Sie [StopConfigurationRecorder](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/stop-configuration-recorder.html)in der *AWS CLI Befehlsreferenz.*
### `subscribe`
Das folgende Codebeispiel zeigt die Verwendung`subscribe`.
**AWS CLI**
**Um AWS Config zu abonnieren**
Mit dem folgenden Befehl werden der Standardbereitstellungskanal und der Configuration Recorder erstellt: Der Befehl spezifiziert auch den Amazon S3 S3-Bucket und das Amazon SNS SNS-Thema, an das AWS Config Konfigurationsinformationen liefert:
```
aws configservice subscribe --s3-bucket config-bucket-123456789012 --sns-topic arn:aws:sns:us-east-1:123456789012:config-topic --iam-role arn:aws:iam::123456789012:role/ConfigRole-A1B2C3D4E5F6
```
Ausgabe:
```
Using existing S3 bucket: config-bucket-123456789012
Using existing SNS topic: arn:aws:sns:us-east-1:123456789012:config-topic
Subscribe succeeded:
Configuration Recorders: [
{
"recordingGroup": {
"allSupported": true,
"resourceTypes": [],
"includeGlobalResourceTypes": false
},
"roleARN": "arn:aws:iam::123456789012:role/ConfigRole-A1B2C3D4E5F6",
"name": "default"
}
]
Delivery Channels: [
{
"snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
"name": "default",
"s3BucketName": "config-bucket-123456789012"
}
]
```
+ Weitere API-Informationen finden Sie unter [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/subscribe.html) in der *AWS CLI -Befehlsreferenz*.