

Hinweis zum Ende des Supports: Am 30. Juni 2027 AWS wird der Support für AMS Advanced eingestellt. Nach dem 30. Juni 2027 können Sie nicht mehr auf die AMS Advanced-Konsole oder die AMS Advanced-Ressourcen zugreifen. Weitere Informationen finden Sie unter [Ende des Supports für AMS Advanced](https://docs.aws.amazon.com/managedservices/latest/userguide/SunsetPlan.html). 

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.

# Identity and Access Management (IAM) \| Entität oder Richtlinie aktualisieren (Managed Automation)
<a name="management-advanced-identity-and-access-management-iam-update-entity-or-policy-managed-automation"></a>

Aktualisieren Sie den Benutzer, die Rolle oder die Richtlinie für Identity and Access Management (IAM).

**Vollständige Klassifizierung:** Verwaltung \| Erweiterte Stack-Komponenten \| Identity and Access Management (IAM) \| Entität oder Richtlinie aktualisieren (verwaltete Automatisierung)

## Typdetails ändern
<a name="ct-27tuth19k52b4-MAIu-table"></a>


****  

|  |  | 
| --- |--- |
| Typ-ID ändern | ct-27tuth19k52b4 | 
| Aktuelle Version | 2.0 | 
| Erwartete Ausführungsdauer | 240 Minuten | 
| AWS-Zulassung | Erforderlich | 
| Zustimmung durch den Kunden | Nicht erforderlich, wenn der Absender | 
| Ausführungsmodus | Manuell | 

## Zusätzliche Informationen
<a name="management-advanced-identity-and-access-management-iam-update-entity-or-policy-managed-automation-info"></a>

### Aktualisieren Sie die IAM-Entität oder -Richtlinie
<a name="ex-iam-resource-update-col"></a>

#### Aktualisieren von IAM-Ressourcen mit der Konsole
<a name="iam-resource-update-con"></a>

![Aktualisieren Sie den Änderungstyp der IAM Ressource mit Beschreibung, ID, Version und Details zum Ausführungsmodus.](http://docs.aws.amazon.com/de_de/managedservices/latest/ctref/images/guiIamResourceUpdateCT.png)


Funktionsweise

1. **Navigieren Sie zur Seite **RFC erstellen**: Klicken Sie im linken Navigationsbereich der AMS-Konsole auf RFCs, um die **RFCs-Listenseite** zu öffnen, und klicken Sie dann auf RFC erstellen.**

1. Wählen Sie in der Standardansicht „**Änderungstypen durchsuchen“ einen beliebten Änderungstyp** (CT) oder wählen Sie einen CT in der Ansicht „Nach Kategorie **auswählen**“ aus.
   + **Nach Änderungstyp suchen**: Sie können im Bereich **Schnellerstellung** auf ein beliebtes CT klicken, um sofort die Seite **RFC ausführen** zu öffnen. Beachten Sie, dass Sie mit Quick Create keine ältere CT-Version auswählen können.

     Verwenden Sie zum Sortieren von CTs den Bereich **Alle Änderungstypen** in der **Karten** - oder **Tabellenansicht**. Wählen Sie in beiden Ansichten ein CT aus und klicken Sie dann auf **RFC erstellen**, um die Seite **RFC ausführen** zu öffnen. Falls zutreffend, wird neben der Schaltfläche „**RFC **erstellen“ die Option Mit älterer Version** erstellen** angezeigt.
   + **Nach Kategorie auswählen**: Wählen Sie eine Kategorie, eine Unterkategorie, einen Artikel und einen Vorgang aus. Daraufhin wird das Feld mit den CT-Details geöffnet. Dort können Sie gegebenenfalls die Option „**Mit älterer Version erstellen**“ auswählen. Klicken Sie auf **RFC erstellen**, um die Seite **RFC ausführen** zu öffnen.

1. Öffnen Sie auf der Seite **RFC ausführen** den Bereich CT-Name, um das Feld mit den CT-Details zu sehen. Ein **Betreff** ist erforderlich (dieser wird für Sie ausgefüllt, wenn Sie Ihr CT in der Ansicht „**Änderungstypen durchsuchen**“ auswählen). Öffnen Sie den Bereich **Zusätzliche Konfiguration**, um Informationen zum RFC hinzuzufügen.

   Verwenden Sie im Bereich **Ausführungskonfiguration** die verfügbaren Dropdownlisten oder geben Sie Werte für die erforderlichen Parameter ein. Um optionale Ausführungsparameter zu konfigurieren, öffnen Sie den Bereich **Zusätzliche Konfiguration**.

1. Wenn Sie fertig sind, klicken Sie auf **Ausführen**. Wenn keine Fehler vorliegen, wird die Seite mit dem **RFC erfolgreich erstellt** mit den übermittelten RFC-Details und der ersten **Run-Ausgabe** angezeigt. 

1. Öffnen Sie den Bereich **Run-Parameter**, um die von Ihnen eingereichten Konfigurationen zu sehen. Aktualisieren Sie die Seite, um den RFC-Ausführungsstatus zu aktualisieren. Optional können Sie den RFC abbrechen oder eine Kopie davon mit den Optionen oben auf der Seite erstellen.

#### Aktualisieren von IAM-Ressourcen mit der CLI
<a name="iam-resource-update-cli"></a>

Funktionsweise

1. Verwenden Sie entweder Inline Create (Sie geben einen `create-rfc` Befehl mit allen RFC- und Ausführungsparametern aus) oder Template Create (Sie erstellen zwei JSON-Dateien, eine für die RFC-Parameter und eine für die Ausführungsparameter) und geben Sie den `create-rfc` Befehl mit den beiden Dateien als Eingabe aus. Beide Methoden werden hier beschrieben.

1. Reichen Sie den `aws amscm submit-rfc --rfc-id {{ID}}` Befehl RFC: mit der zurückgegebenen RFC-ID ein.

   Überwachen Sie den RFC: -Befehl. `aws amscm get-rfc --rfc-id {{ID}}`

Verwenden Sie diesen Befehl, um die Version des Änderungstyps zu überprüfen:

```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}}
```
**Anmerkung**  
Sie können alle `CreateRfc` Parameter mit jedem RFC verwenden, unabhängig davon, ob sie Teil des Schemas für den Änderungstyp sind oder nicht. Um beispielsweise Benachrichtigungen zu erhalten, wenn sich der RFC-Status ändert, fügen Sie diese Zeile dem RFC-Parameter-Teil der Anfrage hinzu (nicht den Ausführungsparametern). `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` Eine Liste aller CreateRfc Parameter finden Sie in der [AMS Change Management API-Referenz](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).

*INLINE-ERSTELLUNG*:

Geben Sie den Befehl create RFC mit den direkt angegebenen Ausführungsparametern aus (vermeiden Sie Anführungszeichen, wenn Sie die Ausführungsparameter inline angeben), und senden Sie dann die zurückgegebene RFC-ID. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

```
aws amscm create-rfc --change-type-id "ct-27tuth19k52b4" --change-type-version "1.0" --title "{{TestIamUpdate}}" --execution-parameters "{\"UseCase\":\"{{IAM_RESOURCE_DETAILS}}\",\"IAM Role\":[{\"RoleName\":\"{{ROLE_NAME}}\",\"TrustPolicy\":\"{{TRUST_POLICY}}\",\"RolePermissions\":\"{{ROLE_PERMISSIONS}}\"}],\"Operation\":\"Update\"}"
```

*VORLAGE ERSTELLEN*:

1. Gibt das JSON-Schema der Ausführungsparameter für diesen Änderungstyp in eine Datei aus. In diesem Beispiel wird sie wie folgt benannt UpdateIamResourceParams.json:

   ```
   aws amscm get-change-type-version --change-type-id "ct-27tuth19k52b4" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > UpdateIamResourceParams.json
   ```

1. Ändern und speichern Sie die UpdateIamResourceParams Datei. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

   ```
   {
     "UseCase": "{{IAM_RESOURCE_DETAILS}}",
     "IAM Role": [
       {
         "RoleName": "{{codebuild_ec2_test_role}}",
         "TrustPolicy": {
           "Version": "{{2008-10-17}}",
           "Statement": [
             {
               "Effect": "{{Allow}}",
               "Principal": {
                 "{{Service}}": "{{codebuild.amazonaws.com}}"
               },
               "Action": "{{sts:AssumeRole}}"
             }
           ]
         },
         "RolePermissions": {
           "Version": "{{2012-10-17}}",
           "Statement": [
             {
               "Effect": "{{Allow}}",
               "Action": [
                 "{{ec2:DescribeInstanceStatus}}"
               ],
               "Resource": "{{*}}"
             }
           ]
         }
       }
     ],
     "Operation": "Update"
   }
   ```

1. Gibt die JSON-Datei der RFC-Vorlage in eine Datei aus. In diesem Beispiel wird sie UpdateIamResourceRfc.json wie folgt benannt:

   ```
   aws amscm create-rfc --generate-cli-skeleton > UpdateIamResourceRfc.json
   ```

1. Ändern und speichern Sie die UpdateIamResourceRfc.json Datei. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

   ```
   {
   "ChangeTypeVersion": "1.0",
   "ChangeTypeId": "ct-27tuth19k52b4",
   "Title": "{{Update IAM Roles}}"
   }
   ```

1. Erstellen Sie den RFC und geben Sie die UpdateIamResourceRfc Datei und die UpdateIamResourceParams Datei an:

   ```
   aws amscm create-rfc --cli-input-json file://UpdateIamResourceRfc.json  --execution-parameters file://UpdateIamResourceParams.json
   ```

   Sie erhalten die ID des neuen RFC in der Antwort und können sie verwenden, um den RFC zu senden und zu überwachen. Bis Sie ihn abschicken, verbleibt der RFC im Bearbeitungszustand und startet nicht.

#### Tipps
<a name="ex-iam-resource-update-tip"></a>
+ Wichtig. Mit einigen Ausnahmen können wir die standardmäßigen AMS-IAM-Entitäten und die IAM-Entitäten des AMS Self-Service Provisioning Service (SSPS) nicht gemäß unseren technischen Standards aktualisieren oder ändern. Als Alternative können wir einen Klon dieser Entitäten mit einem benutzerdefinierten Namen und dem erforderlichen Berechtigungssatz für die Bereitstellung in Ihrem Konto erstellen. 
+ Bei der Verwendung manueller CTs (Genehmigung erforderlich) empfiehlt AMS, die ASAP-Option zu verwenden (wählen Sie ASAP in der Konsole, lassen Sie Start- und Endzeit leer API/CLI), da für diese CTs ein AMS-Operator erforderlich ist, der den RFC überprüft und möglicherweise mit Ihnen kommuniziert, bevor er genehmigt und ausgeführt werden kann.
+ Wir können die standardmäßigen AMS-IAM-Entitäten oder die IAM-Entitäten des AMS Self-Service Provisioning Service (SSPS) nicht aktualisieren oder ändern. Wenn Sie ähnliche Berechtigungen benötigen, die in den Standard- und SSPS IAM-Entitäten bereitgestellt werden, können wir einen Klon der Entitäten mit einem benutzerdefinierten Namen erstellen, den Sie uns in den RFC-Ausführungsparametern () angeben können. **UseCase**

Dies ist ein manueller Änderungstyp (ein AMS-Operator muss den CT überprüfen und ausführen), was bedeutet, dass die Ausführung des RFC länger dauern kann und Sie möglicherweise über die entsprechende Option auf der RFC-Detailseite mit AMS kommunizieren müssen. Wenn Sie einen RFC mit manueller Änderung planen, sollten Sie außerdem mindestens 24 Stunden einplanen. Erfolgt die Genehmigung nicht vor der geplanten Startzeit, wird der RFC automatisch abgelehnt.

## Eingabeparameter für die Ausführung
<a name="management-advanced-identity-and-access-management-iam-update-entity-or-policy-managed-automation-input"></a>

Ausführliche Informationen zu den Eingabeparametern der Ausführung finden Sie unter[Schema für den Änderungstyp ct-27tuth19k52b4](schemas.md#ct-27tuth19k52b4-schema-section).

## Beispiel: Erforderliche Parameter
<a name="management-advanced-identity-and-access-management-iam-update-entity-or-policy-managed-automation-ex-min"></a>

```
{
  "UseCase": "Use case...",
  "Operation": "Update"
}
```

## Beispiel: Alle Parameter
<a name="management-advanced-identity-and-access-management-iam-update-entity-or-policy-managed-automation-ex-max"></a>

```
{
  "UseCase": "Use case...",
  "IAM User": [
    {
      "UserName": "user-a",
      "UserPermissionPolicyName": "policy1",
      "UserPermissions": "Power User permissions",
      "Tags": [
        {
          "Key": "foo",
          "Value": "bar"
        },
        {
          "Key": "testkey",
          "Value": "testvalue"
        }
      ]
    }
  ],
  "IAM Role": [
    {
      "RoleName": "role-b",
      "TrustPolicy": "Trust policy example",
      "RolePermissions": "Role permissions example",
      "RolePermissionPolicyName": "role-b-policy",
      "ManagedPolicyArns": [
        "arn:aws:iam::123456789012:policy/policy01",
        "arn:aws:iam::123456789012:policy/policy02"
      ],
      "Tags": [
        {
          "Key": "foo",
          "Value": "bar"
        },
        {
          "Key": "testkey",
          "Value": "testvalue"
        }
      ]
    }
  ],
  "IAM Policy": [
    {
      "PolicyName": "policy1",
      "PolicyType": "managed",
      "PolicyDocument": "Policy document example 1",
      "RelatedResources": [
        "resourceA",
        "resourceB"
      ]
    },
    {
      "PolicyName": "policy2",
      "PolicyType": "managed",
      "PolicyDocument": "Policy document example 2",
      "RelatedResources": [
        "resourceC",
        "resourceD"
      ]
    }
  ],
  "Operation": "Update",
  "Priority": "Medium"
}
```