

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.

# Vereinfacht AWS-Service Informationen für den programmatischen Zugriff

AWS stellt Servicereferenzinformationen im JSON-Format bereit, um die Automatisierung von Arbeitsabläufen zur Richtlinienverwaltung zu optimieren. Mit den Servicereferenzinformationen können Sie überall auf verfügbare Operationen, Aktionen, Ressourcen und Bedingungsschlüssel zugreifen AWS-Services aus maschinenlesbaren Dateien. Zu den Servicereferenzinformationen gehören neben den Autorisierungsdetails auch Metadaten, einschließlich Informationen über die IAM-Aktion, auf die zuletzt zugegriffen wurde, und Daten zur Generierung von IAM Access Analyzer-Richtlinien.

Sicherheitsadministratoren können Leitplanken einrichten, und Entwickler können den angemessenen Zugriff auf Anwendungen sicherstellen, indem sie die verfügbaren Aktionen, Ressourcen und Bedingungsschlüssel für jede Anwendung identifizieren AWS-Service. AWS bietet Servicereferenzinformationen für AWS-Services damit Sie die Metadaten in Ihre Arbeitsabläufe zur Richtlinienverwaltung integrieren können.

AWS bietet auch eine konsolidierte Liste globaler Bedingungsschlüssel, die für alle Bereiche gelten AWS-Services. Sie können die entdecken `aws:`Schlüssel mit Präfix, die in den IAM-Richtlinien aller Dienste aus einer einzigen maschinenlesbaren Datei verwendet werden können.
+ Eine Bestandsaufnahme der Aktionen, Ressourcen und Bedingungsschlüssel zur Verwendung in IAM-Richtlinien finden Sie in der [Referenz zur Serviceautorisierung](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html) Seite für die AWS-Service. Aktionen, Ressourcen und Bedingungsschlüssel für Dienste, die ein Dienstpräfix gemeinsam haben, können in der Serviceautorisierungsreferenz auf mehrere Seiten aufgeteilt werden.
+ Für eine Liste von AWS-Services und Aktionen, für die Informationen zum letzten Zugriff auf die IAM-Aktion angezeigt werden, finden Sie unter [IAM-Aktion, letzter Zugriff, Informationsdienste und Aktionen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_last-accessed-action-last-accessed.html) im IAM-Benutzerhandbuch.
+ Für eine Liste von AWS-Services und Aktionen, für die IAM Access Analyzer Richtlinien mit Informationen auf Aktionsebene generiert, finden Sie unter [Dienste zur Generierung von Richtlinien durch IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-generation-action-last-accessed-support.html) im IAM-Benutzerhandbuch.

Der Inhalt der Serviceautorisierungsreferenz kann unterschiedlich dargestellt werden oder andere Metadaten enthalten. Weitere Informationen finden Sie unter [Zusätzliche Felddefinitionen](#service-reference-additional-field-definitions).

Die Servicereferenzinformationen enthalten auch Metadaten zu Vorgängen, einschließlich Informationen zu autorisierten Aktionen und den Methodennamen in SDKs.

Möglicherweise ist ein zusätzlicher Kontext mit dem Wert von Bedingungsschlüsseln verfügbar, um die Festlegung des Gültigkeitsbereichs zu erleichtern. Zum Beispiel der Wert von `iam:PassedToService` kann erscheinen, wenn die Aktion `iam:PassRole` wird durch eine Operation autorisiert.

Diese Zuordnung von Vorgang zu Aktion wird nicht für alle Dienste unterstützt. Dienste, die diese Zuordnung noch nicht unterstützen, lassen den AuthorizedAction Eigentum. Darüber hinaus enthalten die Informationen zu autorisierten Aktionen für Operationen keine Berechtigungen, die möglicherweise für Operationen erforderlich sind, die in Ihrem Namen mit [Zugriffssitzungen weiterleiten](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).

**Anmerkung**  
Es kann bis zu 24 Stunden dauern, bis Änderungen an den Servicereferenzinformationen in der Metadatenliste für den Dienst übernommen werden.

**Zugriff AWS-Service Referenzinformationen**

1. Navigieren Sie zu den Servicereferenzinformationen, um auf die Liste der AWS-Services für die Referenzinformationen verfügbar sind.

   Es gibt drei Haupteinstiegspunkte:

   [https://servicereference.us-east-1.amazonaws.com/](https://servicereference.us-east-1.amazonaws.com/) zeigt eine Liste von AWS-Services für die Referenzinformationen verfügbar sind.

   Das folgende Beispiel zeigt eine unvollständige Liste von Diensten und URLs für ihre jeweiligen Referenzinformationen:

   ```JSON
   [ 
       { 
           "service": "s3", 
           "url": "https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json" 
       }, 
       { 
           "service": "dynamodb", 
           "url": "https://servicereference.us-east-1.amazonaws.com/v1/dynamodb/dynamodb.json" 
       }, 
       …
   ]
   ```

   [https://servicereference.us-east-1.amazonaws.com/v1/global-condition-keys.json](https://servicereference.us-east-1.amazonaws.com/v1/global-condition-keys.json) zeigt die globalen Bedingungsschlüssel an, die Sie in IAM-Richtlinien in allen Bereichen verwenden können AWS-Services.

   Das folgende Beispiel zeigt eine unvollständige Liste der globalen Bedingungsschlüssel:

   ```JSON
   [ {
     "Name" : "aws:AssumedRoot",
     "Description" : "Filters access based on whether the request was made using temporary security credentials for AssumeRoot",
     "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html",
     "Types" : [ "Bool" ]
   }, {
     "Name" : "aws:CalledVia",
     "Description" : "Filters access by the services that make the request on behalf of the IAM principal",
     "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-calledvia",
     "Types" : [ "ArrayOfString" ]
   }, {
     "Name" : "aws:ChatbotSourceArn",
     "Description" : "This key identifies the chatbot configuration ARN associated with the assume role session initiated by AWS Chatbot.",
     "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-chatbotsourcearn",
     "Types" : [ "ARN", "String" ]
   }, {
     "Name" : "aws:CurrentTime",
     "Description" : "Filters access by the time and date when the request was made",
     "DocPage" : "/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-currenttime",
     "Types" : [ "Date" ]
   } ]
   ```

   [https://servicereference.us-east-1.amazonaws.com/v1/mapping.json](https://servicereference.us-east-1.amazonaws.com/v1/mapping.json) zeigt eine Zuordnung von SDK-Diensten zu der Position in der Dienstreferenz an, unter der Informationen zu finden sind.

   Das folgende Beispiel zeigt eine unvollständige Liste von Zuordnungen:

   ```JSON
   {
     "SDK" : {
       "Python" : {
         "Boto3" : {
           "accessanalyzer" : {
             "service" : "access-analyzer",
             "url" : "https://servicereference.us-east-1.amazonaws.com/v1/access-analyzer/access-analyzer.json"
           },
           "account" : {
             "service" : "account",
             "url" : "https://servicereference.us-east-1.amazonaws.com/v1/account/account.json"
           },
           "amp" : {
             "service" : "aps",
             "url" : "https://servicereference.us-east-1.amazonaws.com/v1/aps/aps.json"
           },
           ...
         }
       }
     }
   }
   ```

1. Wählen Sie einen Dienst aus und navigieren Sie zur Serviceinformationsseite im `url` Feld für den Service, um eine Liste mit Aktionen, Ressourcen und Bedingungsschlüsseln für den Service anzuzeigen.

   Das folgende Beispiel zeigt eine unvollständige Liste von Service-Referenzinformationen für Amazon S3:

   ```JSON
   {
       "Name": "s3",
       "ServiceName": "S3",
       "Actions": [
           {
               "Name": "GetObject",
               "ActionConditionKeys": [
                   "s3:AccessGrantsInstanceArn",
                   "s3:AccessPointNetworkOrigin",
                   "s3:DataAccessPointAccount",
                   "s3:DataAccessPointArn",
                   "s3:ExistingObjectTag/key",
                   "s3:ResourceAccount",
                   "s3:TlsVersion",
                   "s3:authType",
                   "s3:if-match",
                   "s3:if-none-match",
                   "s3:signatureAge",
                   "s3:signatureversion",
                   "s3:x-amz-content-sha256"
               ],
               "Annotations" : {
               "Properties" : {
                       "IsDataPlane" : true,
                       "IsList" : false,
                       "IsPermissionManagement" : false,
                       "IsTaggingOnly" : false,
                       "IsWrite" : false
                   }
               },
               "Resources": [
                   {
                       "Name": "object"
                   }
               ],
               "SupportedBy" : {
                   "IAM Access Analyzer Policy Generation" : false,
                   "IAM Action Last Accessed" : false
               }
           },
           {
               "Name": "ListBucket",
               "ActionConditionKeys": [
                   "s3:AccessGrantsInstanceArn",
                   "s3:AccessPointNetworkOrigin",
                   "s3:DataAccessPointAccount",
                   "s3:DataAccessPointArn",
                   "s3:ResourceAccount",
                   "s3:TlsVersion",
                   "s3:authType",
                   "s3:delimiter",
                   "s3:max-keys",
                   "s3:prefix",
                   "s3:signatureAge",
                   "s3:signatureversion",
                   "s3:x-amz-content-sha256"
               ],
               "Annotations" : {
                   "Properties" : {
                       "IsDataPlane" : true,
                       "IsList" : true,
                       "IsPermissionManagement" : false,
                       "IsTaggingOnly" : false,
                       "IsWrite" : false
                   }
               },
               "Resources": [
                   {
                       "Name": "bucket"
                   }
               ],
               "SupportedBy" : {
                   "IAM Access Analyzer Policy Generation" : false,
                   "IAM Action Last Accessed" : false
               }
           },
           ...
       ],
       "ConditionKeys": [
           {
               "Name": "s3:TlsVersion",
               "Types": [
                   "Numeric"
               ]
           },
           {
               "Name": "s3:authType",
               "Types": [
                   "String"
               ]
           },
           ...
       ],
       "Operations": [
           {
               "Name" : "GetObject",
               "AuthorizedActions" : [
                   {
                       "Name" : "GetObject",
                       "Service" : "s3"
                   }, {
                       "Name" : "GetObject",
                       "Service" : "s3-object-lambda"
                   }, {
                       "Name" : "GetObjectLegalHold",
                       "Service" : "s3"
                   }, {
                       "Name" : "GetObjectRetention",
                       "Service" : "s3"
                   }, {
                       "Name" : "GetObjectTagging",
                       "Service" : "s3"
                   }, {
                       "Name" : "GetObjectVersion",
                       "Service" : "s3"
                   }
               ],
               "SDK" : [
                   {
                       "Name" : "s3",
                       "Method" : "get_object",
                       "Package" : "Boto3"
                   }
               ]
           },
           ...
       ],
       "Resources": [
           {
               "Name": "accesspoint",
               "ARNFormats": [
                   "arn:${Partition}:s3:${Region}:${Account}:accesspoint/${AccessPointName}"
               ]
           },
           {
               "Name": "bucket",
               "ARNFormats": [
                   "arn:${Partition}:s3:::${BucketName}"
               ]
           }
           ...
       ],
       "Version": "v1.5"
   }
   ```

   Das `ServiceName` Feld enthält einen für Menschen lesbaren Namen für AWS-Service, wie `S3` für die `s3` Service. Es erscheint auf der obersten Ebene der Service-Referenzdatei, unmittelbar nach dem `Name` Feld.

1. Laden Sie die JSON-Datei von der Service-URL herunter, um sie in Ihren Workflows zur Richtlinienerstellung zu verwenden.

## Glossar
<a name="service-reference-glossary"></a>
+ Betrieb — Eine API, die aufgerufen werden kann, normalerweise über ein SDK
+ Aktion — Berechtigung, die bei der Ausführung einer Operation autorisiert wird

## Zusätzliche Felddefinitionen
<a name="service-reference-additional-field-definitions"></a>

**Eigenschaften der Aktion** Stellen Sie zusätzliche Metadaten zu Serviceaktionen bereit, um sie anhand ihres Berechtigungsbereichs zu kategorisieren. Diese Eigenschaften finden Sie unter `Annotations` Feld für jede Aktion. Die Metadaten bestehen aus fünf booleschen Werten:
+ `IsDataPlane` — Gibt an, dass die Aktion auf die Daten oder Inhalte einer Ressource angewendet wird, anstatt die Ressource selbst zu erstellen, zu konfigurieren oder zu verwalten. Diese Eigenschaft ist abgeleitet von AWS CloudTrail Ereigniskategorien der Operationen, die die Aktion autorisieren.

  **Beispiel** — Diese Immobilie ist `true` für den Amazon S3 `GetObject` Aktion, die Objektinhalte liest, und `false` zum `CreateBucket`, das die Ressource erstellt und konfiguriert (eine Operation auf der Steuerungsebene).

  Bei einigen Aktionen wird diese Eigenschaft weggelassen. Eine Aktion hat `IsDataPlane` nur, wenn mindestens eine Operation, die sie autorisiert, eine CloudTrail Kategorie des Ereignisses. Wenn die Eigenschaft nicht existiert, ist die Aktion noch nicht klassifiziert.
+ `IsList` — Zeigt an, dass die Aktion Ressourcen, einschließlich grundlegender Metadaten, erkennt und auflistet, ohne auf den Ressourceninhalt zuzugreifen.

  **Beispiel** — Diese Immobilie ist `true` für den Amazon S3 `ListBucket` Aktion, die Bucket-Listen zurückgibt, ohne auf die Objekte selbst zuzugreifen.
+ `IsPermissionManagement` — Zeigt an, dass die Aktion IAM-Berechtigungen oder Zugangsdaten ändern kann.

  **Beispiel** — Diese Immobilie ist `true` für die meisten IAM und AWS Organizations Aktionen und für Amazon S3-Aktionen wie `PutBucketPolicy` und `DeleteBucketPolicy`.
+ `IsTaggingOnly` — Zeigt an, dass die Aktion nur Tags ändert.

  **Beispiel** — Diese Immobilie ist `true` für die IAM-Aktionen `TagRole` und `UntagRole`, und `false` zum `CreateRole`, das umfassendere Berechtigungen gewährt, die über das Taggen hinausgehen.
+ `IsWrite` — Zeigt an, dass durch die Aktion Ressourcen geändert werden können, was auch Tag-Änderungen beinhalten kann.

  **Beispiel** — Diese Immobilie ist `true` für die Amazon S3-Aktionen `CreateBucket`, `DeleteBucket`, und `PutObject`, die Ressourcen modifizieren.

**Anmerkung**  
Diese Eigenschaften schließen sich nicht gegenseitig aus. Für eine Aktion können mehrere Eigenschaften auf gesetzt sein `true`.  
Es ist auch möglich, dass alle Immobilien `false`, wie bei Amazon S3 `GetBucketPolicy` Aktion. Dies bedeutet, dass die Aktion nur Leseberechtigungen für die Bucket-Konfiguration gewährt.

Diese Eigenschaften können verwendet werden, um Erkenntnisse für Dienste zu generieren. Das folgende Beispiel zeigt, welche Berechtigungen mit `s3` Präfix ermöglicht das Ändern von Ressourcen:

```JSON
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \
    jq '.Actions[] | select(.Annotations.Properties.IsWrite == true) | .Name'

"AssociateAccessGrantsIdentityCenter"
"BypassGovernanceRetention"
"CreateAccessGrant"
"CreateAccessGrantsInstance"
"CreateAccessGrantsLocation"
...
```

Das folgende Beispiel zeigt, welche Berechtigungen mit dem `s3` Präfix gewährt Zugriff auf Daten und nicht auf die Dienstkonfiguration:

```JSON
> curl https://servicereference.us-east-1.amazonaws.com/v1/s3/s3.json | \
    jq '.Actions[] | select(.Annotations.Properties.IsDataPlane == true) | .Name'

"AbortMultipartUpload"
"BypassGovernanceRetention"
"DeleteObject"
"DeleteObjectVersion"
"GetObject"
...
```

Das folgende Beispiel zeigt, welche Aktionsbedingungstasten mit `lambda` Präfix, das Sie verwenden können, um den Zugriff auf Aktionen zur Rechteverwaltung einzuschränken:

```JSON
> curl https://servicereference.us-east-1.amazonaws.com/v1/lambda/lambda.json | \
    jq '.Actions[] | select(.Annotations.Properties.IsPermissionManagement == true) | {Name: .Name, ActionConditionKeys: (.ActionConditionKeys // [])}'
 
{
   "Name": "AddLayerVersionPermission",
    "ActionConditionKeys": []
}
{
    "Name": "AddPermission",
    "ActionConditionKeys": [
        "lambda:FunctionUrlAuthType",
        "lambda:Principal"
    ]
}
{
    "Name": "DisableReplication",
    "ActionConditionKeys": []
}
{
    "Name": "EnableReplication",
    "ActionConditionKeys": []
}
{
    "Name": "RemoveLayerVersionPermission",
    "ActionConditionKeys": []
}
{
    "Name": "RemovePermission",
    "ActionConditionKeys": [
        "lambda:FunctionUrlAuthType",
        "lambda:Principal"
    ]
}
```