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.
Aktionen, Ressourcen und Bedingungsschlüssel für Amazon-API-Gateway-Management
Amazon API Gateway Management (Dienstpräfix: apigateway) stellt die folgenden dienstspezifischen Operationen, Ressourcen, Aktionen und Bedingungsschlüssel zur Verwendung in IAM-Berechtigungsrichtlinien bereit.
Referenzen:
-
Erfahren Sie, wie Sie diesen Service konfigurieren.
-
Zeigen Sie eine Liste der API-Operationen an, die für diesen Service verfügbar sind.
-
Erfahren Sie, wie Sie diesen Service und seine Ressourcen mithilfe von IAM-Berechtigungsrichtlinien schützen.
-
Sehen Sie sich das an Referenz zur programmatischen Serviceautorisierung
für diesen Dienst.
Themen
Von Amazon API Gateway Management definierte API-Operationen
In der folgenden Tabelle werden API-Operationen den IAM-Aktionen zugeordnet, die sie autorisieren. Es werden nur Bedingungsschlüssel aufgeführt, die statische Werte für die angegebene API und Aktion haben. Den vollständigen Satz der Bedingungsschlüssel, die von jeder Aktion unterstützt werden, finden Sie in der Tabelle „Aktionen“.
| Operation | IAM-Aktion | Bedingungsschlüssel | Mögliche (n) Wert (e) | Zugriffsebene |
|---|---|---|---|---|
|
CreateApiKey |
Schreiben |
|||
Schreiben |
||||
|
CreateAuthorizer |
Schreiben |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
CreateBasePathMapping |
Schreiben |
|||
|
CreateDeployment |
Schreiben |
|||
|
CreateDocumentationPart |
Schreiben |
|||
|
CreateDocumentationVersion |
Schreiben |
|||
|
CreateDomainName |
Verwaltung von Berechtigungen, Schreiben |
|||
Schreiben |
||||
Schreiben |
||||
Verwaltung von Berechtigungen, Schreiben |
||||
|
CreateDomainNameAccessAssociation |
Verwaltung von Berechtigungen, Schreiben |
|||
Schreiben |
||||
Schreiben |
||||
|
CreateModel |
Schreiben |
|||
|
CreateRequestValidator |
Schreiben |
|||
|
CreateResource |
Schreiben |
|||
|
CreateRestApi |
Schreiben |
|||
Schreiben |
||||
Verwaltung von Berechtigungen, Schreiben |
||||
|
CreateStage |
Schreiben |
|||
Schreiben |
||||
|
CreateUsagePlan |
Schreiben |
|||
Schreiben |
||||
|
CreateUsagePlanKey |
Schreiben |
|||
|
CreateVpcLink |
Schreiben |
|||
Schreiben |
||||
|
DeleteApiKey |
Schreiben |
|||
|
DeleteAuthorizer |
Schreiben |
|||
|
DeleteBasePathMapping |
Schreiben |
|||
|
DeleteClientCertificate |
Schreiben |
|||
|
DeleteDeployment |
Schreiben |
|||
|
DeleteDocumentationPart |
Schreiben |
|||
|
DeleteDocumentationVersion |
Schreiben |
|||
|
DeleteDomainName |
Schreiben |
|||
Verwaltung von Berechtigungen, Schreiben |
||||
|
DeleteDomainNameAccessAssociation |
Schreiben |
|||
|
DeleteGatewayResponse |
Schreiben |
|||
|
DeleteIntegration |
Schreiben |
|||
|
DeleteIntegrationResponse |
Schreiben |
|||
|
DeleteMethod |
Schreiben |
|||
|
DeleteMethodResponse |
Schreiben |
|||
|
DeleteModel |
Schreiben |
|||
|
DeleteRequestValidator |
Schreiben |
|||
|
DeleteResource |
Schreiben |
|||
|
DeleteRestApi |
Schreiben |
|||
|
DeleteStage |
Schreiben |
|||
|
DeleteUsagePlan |
Schreiben |
|||
|
DeleteUsagePlanKey |
Schreiben |
|||
|
DeleteVpcLink |
Schreiben |
|||
|
FlushStageAuthorizersCache |
Schreiben |
|||
|
FlushStageCache |
Schreiben |
|||
|
GenerateClientCertificate |
Schreiben |
|||
Schreiben |
||||
|
GetAccount |
Lesen |
|||
|
GetApiKey |
Lesen |
|||
|
GetApiKeys |
Lesen |
|||
|
GetAuthorizer |
Lesen |
|||
|
GetAuthorizers |
Lesen |
|||
|
GetBasePathMapping |
Lesen |
|||
|
GetBasePathMappings |
Lesen |
|||
|
GetClientCertificate |
Lesen |
|||
|
GetClientCertificates |
Lesen |
|||
|
GetDeployment |
Lesen |
|||
|
GetDeployments |
Lesen |
|||
|
GetDocumentationPart |
Lesen |
|||
|
GetDocumentationParts |
Lesen |
|||
|
GetDocumentationVersion |
Lesen |
|||
|
GetDocumentationVersions |
Lesen |
|||
|
GetDomainName |
Lesen |
|||
|
GetDomainNameAccessAssociations |
Lesen |
|||
|
GetDomainNames |
Lesen |
|||
|
GetExport |
Lesen |
|||
|
GetGatewayResponse |
Lesen |
|||
|
GetGatewayResponses |
Lesen |
|||
|
GetIntegration |
Lesen |
|||
|
GetIntegrationResponse |
Lesen |
|||
|
GetMethod |
Lesen |
|||
|
GetMethodResponse |
Lesen |
|||
|
GetModel |
Lesen |
|||
|
GetModelTemplate |
Lesen |
|||
|
GetModels |
Lesen |
|||
|
GetRequestValidator |
Lesen |
|||
|
GetRequestValidators |
Lesen |
|||
|
GetResource |
Lesen |
|||
|
GetResources |
Lesen |
|||
|
GetRestApi |
Lesen |
|||
|
GetRestApis |
Lesen |
|||
|
GetSdk |
Lesen |
|||
|
GetSdkType |
Lesen |
|||
|
GetSdkTypes |
Lesen |
|||
|
GetStage |
Lesen |
|||
|
GetStages |
Lesen |
|||
|
GetTags |
Lesen |
|||
|
GetUsage |
Lesen |
|||
|
GetUsagePlan |
Lesen |
|||
|
GetUsagePlanKey |
Lesen |
|||
|
GetUsagePlanKeys |
Lesen |
|||
|
GetUsagePlans |
Lesen |
|||
|
GetVpcLink |
Lesen |
|||
|
GetVpcLinks |
Lesen |
|||
|
ImportApiKeys |
Write (Schreiben) |
|||
|
ImportDocumentationParts |
Schreiben |
|||
|
ImportRestApi |
Schreiben |
|||
Verwaltung von Berechtigungen, Schreiben |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
PutGatewayResponse |
Schreiben |
|||
|
PutIntegration |
Schreiben |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
PutIntegrationResponse |
Schreiben |
|||
|
PutMethod |
Schreiben |
|||
|
PutMethodResponse |
Schreiben |
|||
|
PutRestApi |
Schreiben |
|||
Verwaltung von Berechtigungen, Schreiben |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
RejectDomainNameAccessAssociation |
Verwaltung von Berechtigungen, Schreiben |
|||
|
TagResource |
Schreiben |
|||
Schreiben |
||||
Schreiben |
||||
|
TestInvokeAuthorizer |
Schreiben |
|||
|
TestInvokeMethod |
Schreiben |
|||
|
UntagResource |
Schreiben |
|||
Schreiben |
||||
|
UpdateAccount |
Schreiben |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
UpdateApiKey |
Schreiben |
|||
|
UpdateAuthorizer |
Schreiben |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
UpdateBasePathMapping |
Schreiben |
|||
|
UpdateClientCertificate |
Schreiben |
|||
|
UpdateDeployment |
Schreiben |
|||
|
UpdateDocumentationPart |
Schreiben |
|||
|
UpdateDocumentationVersion |
Schreiben |
|||
|
UpdateDomainName |
Verwaltung von Berechtigungen, Schreiben |
|||
Schreiben |
||||
Verwaltung von Berechtigungen, Schreiben |
||||
Verwaltung von Berechtigungen, Schreiben |
||||
Verwaltung von Berechtigungen, Schreiben |
||||
|
UpdateGatewayResponse |
Schreiben |
|||
|
UpdateIntegration |
Schreiben |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Schreiben |
||
|
UpdateIntegrationResponse |
Schreiben |
|||
|
UpdateMethod |
Schreiben |
|||
|
UpdateMethodResponse |
Schreiben |
|||
|
UpdateModel |
Schreiben |
|||
|
UpdateRequestValidator |
Schreiben |
|||
|
UpdateResource |
Schreiben |
|||
|
UpdateRestApi |
Schreiben |
|||
Verwaltung von Berechtigungen, Schreiben |
||||
|
UpdateStage |
Schreiben |
|||
|
UpdateUsage |
Schreiben |
|||
|
UpdateUsagePlan |
Schreiben |
|||
|
UpdateVpcLink |
Schreiben |
Von Amazon-API-Gateway-Management definierte Aktionen
Sie können die folgenden Aktionen im Element Action einer IAM-Richtlinienanweisung angeben. Für jede Aktion sind in der Tabelle die Ressourcentypen und Bedingungsschlüssel aufgeführt, die von dieser Aktion unterstützt werden. Verwenden Sie Richtlinien, um Berechtigungen zum Ausführen einer Operation in AWS zu erteilen. Wenn Sie eine Aktion in einer Richtlinie verwenden, erlauben oder verweigern Sie in der Regel den Zugriff auf die API-Operation oder den CLI-Befehl mit demselben Namen. Dabei kann es mitunter vorkommen, dass eine einzige Aktion den Zugriff auf mehr als eine Operation steuert. Alternativ erfordern einige Vorgänge mehrere verschiedene Aktionen.
Von Amazon-API-Gateway-Management definierte Ressourcentypen
Die folgenden Ressourcentypen werden von diesem Service definiert und können im Element Resource von IAM-Berechtigungsrichtlinienanweisungen verwendet werden.
| Ressourcentypen | ARN | Bedingungsschlüssel |
|---|---|---|
arn:${Partition}:apigateway:${Region}::/account |
||
arn:${Partition}:apigateway:${Region}::/apikeys/${ApiKeyId} |
||
arn:${Partition}:apigateway:${Region}::/apikeys |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers/${AuthorizerId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers/${AuthorizerId} |
apigateway:Request/AuthorizerType |
|
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings/${BasePath} |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings |
||
arn:${Partition}:apigateway:${Region}::/clientcertificates/${ClientCertificateId} |
||
arn:${Partition}:apigateway:${Region}::/clientcertificates |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments/${DeploymentId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments/${DeploymentId} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts/${DocumentationPartId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions/${DocumentationVersionId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName} |
apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion apigateway:Request/SecurityPolicy apigateway:Resource/EndpointType apigateway:Resource/MtlsTrustStoreUri apigateway:Resource/MtlsTrustStoreVersion apigateway:Resource/RoutingMode |
|
arn:${Partition}:apigateway:${Region}:${Account}:/domainnameaccessassociations/domainname/${DomainName}/${SourceType}/${SourceId} |
||
arn:${Partition}:apigateway:${Region}:${Account}:/domainnameaccessassociations |
apigateway:Request/AccessAssociationSource |
|
arn:${Partition}:apigateway:${Region}::/domainnames |
apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion apigateway:Request/SecurityPolicy |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses/${ResponseType} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses/${IntegrationResponseId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration/responses/${StatusCode} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType} |
apigateway:Request/ApiKeyRequired apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/responses/${StatusCode} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models/${ModelName} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}+${DomainIdentifier}/basepathmappings/${BasePath} |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}+${DomainIdentifier}/basepathmappings |
||
arn:${Partition}:apigateway:${Region}:${Account}:/domainnames/${DomainName}+${DomainIdentifier} |
apigateway:Request/EndpointType apigateway:Resource/EndpointType |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators/${RequestValidatorId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType apigateway:Request/SecurityPolicy apigateway:Resource/ApiKeyRequired apigateway:Resource/AuthorizerType apigateway:Resource/DisableExecuteApiEndpoint apigateway:Resource/EndpointType apigateway:Resource/RouteAuthorizationType |
|
arn:${Partition}:apigateway:${Region}::/restapis |
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName}/sdks/${SdkType} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName} |
apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat apigateway:Resource/AccessLoggingDestination |
|
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages |
apigateway:Request/AccessLoggingDestination |
|
arn:${Partition}:apigateway:${Region}::/tags/${UrlEncodedResourceARN} |
||
arn:${Partition}:apigateway:${Region}::/restapis/models/${ModelName}/template |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId} |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys/${Id} |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys |
||
arn:${Partition}:apigateway:${Region}::/usageplans |
||
arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId} |
||
arn:${Partition}:apigateway:${Region}::/vpclinks |
Bedingungsschlüssel für Amazon-API-Gateway-Management
Amazon-API-Gateway-Management definiert die folgenden Bedingungsschlüssel, die im Element Condition einer IAM-Richtlinie verwendet werden können.
| Bedingungsschlüssel | Beschreibung | Typ |
|---|---|---|
Filtert den Zugriff nach der Quelle der Zugriffszuordnung. Verfügbar während der CreateDomainNameAccessAssociation Betrieb |
String |
|
Filtert den Zugriff nach Zugriffsprotokoll-Ziel Verfügbar während der CreateStage und UpdateStage Operationen |
String |
|
Filtert den Zugriff nach Zugriffsprotokollformat. Verfügbar während der CreateStage und UpdateStage Operationen |
String |
|
Filtert den Zugriff danach, ob ein API-Schlüssel erforderlich ist oder nicht. Verfügbar während der CreateMethod und PutMethod Operationen. Auch als Sammlung beim Import und Reimport erhältlich |
ArrayOfBool |
|
Filtert den Zugriff nach API-Namen. Verfügbar während der CreateRestApi und UpdateRestApi Operationen |
String |
|
Filtert den Zugriff nach Berechtigungstyp in der Anfrage, zum Beispiel TOKEN, REQUEST, JWT. Verfügbar während CreateAuthorizer und UpdateAuthorizer. Auch beim Import und Reimport als verfügbar ArrayOfString |
ArrayOfString |
|
Filtert den Zugriff nach Status des standardmäßigen Execute-API-Endpunkts. Verfügbar während der CreateRestApi und DeleteRestApi Operationen |
Bool |
|
Filtert den Zugriff nach Domainnamen-ARN. Verfügbar während der CreateDomainNameAccessAssociation Betrieb |
ARN |
|
Filtert den Zugriff nach Endpunkttyp. Verfügbar während der CreateDomainName, UpdateDomainName, CreateRestApi, und UpdateRestApi Operationen |
ArrayOfString |
|
Filtert den Zugriff nach URI des Truststores, der für die gegenseitige TLS-Authentifizierung verwendet wird. Verfügbar während der CreateDomainName und UpdateDomainName Operationen |
String |
|
Filtert den Zugriff nach Version des Truststores, der für die gegenseitige TLS-Authentifizierung verwendet wird. Verfügbar während der CreateDomainName und UpdateDomainName Operationen |
String |
|
Filtert den Zugriff nach Berechtigungsart, zum Beispiel NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Verfügbar während der CreateMethod und PutMethod Operationen Auch als Sammlung beim Import verfügbar |
ArrayOfString |
|
Filtert den Zugriff nach dem Routing-Modus des Domainnamens. Verfügbar während der CreateDomainName und UpdateDomainName Operationen |
String |
|
Filtert den Zugriff nach TLS-Version. Verfügbar während der CreateDomain und UpdateDomain Operationen |
ArrayOfString |
|
Filtert den Zugriff nach dem Namen der Bereitstellung, die Sie erstellen möchten. Verfügbar während der CreateDeployment Betrieb |
String |
|
Filtert den Zugriff nach Zugriffsprotokoll-Ziel der aktuellen Stage-Ressource. Verfügbar während der UpdateStage und DeleteStage Operationen |
String |
|
Filtert den Zugriff nach Zugriffsprotokollformat der aktuellen Stage-Ressource. Verfügbar während der UpdateStage und DeleteStage Operationen |
String |
|
Filtert den Zugriff danach, ob ein API-Schlüssel für die vorhandene Methodenressource erforderlich ist oder nicht. Verfügbar während der PutMethod und DeleteMethod Operationen. Auch als Sammlung beim Reimport erhältlich |
ArrayOfBool |
|
Filtert den Zugriff nach dem API-Namen des vorhandenen RestApi Ressource. Verfügbar während UpdateRestApi und DeleteRestApi Operationen |
String |
|
Filtert den Zugriff nach dem aktuellen Berechtigungstyp, zum Beispiel TOKEN, REQUEST, JWT. Verfügbar während UpdateAuthorizer und DeleteAuthorizer Operationen. Auch beim Reimport als verfügbar ArrayOfString |
ArrayOfString |
|
Filtert den Zugriff nach dem Status des Standard-Execute-API-Endpunkts des aktuellen RestApi Ressource. Verfügbar während UpdateRestApi und DeleteRestApi Operationen |
Bool |
|
Filtert den Zugriff nach Endpunkttyp. Verfügbar während der UpdateDomainName, DeleteDomainName, UpdateRestApi, und DeleteRestApi Operationen |
ArrayOfString |
|
Filtert den Zugriff nach URI des Truststores, der für die gegenseitige TLS-Authentifizierung verwendet wird. Verfügbar während UpdateDomainName und DeleteDomainName Operationen |
String |
|
Filtert den Zugriff nach Version des Truststores, der für die gegenseitige TLS-Authentifizierung verwendet wird. Verfügbar während UpdateDomainName und DeleteDomainName Operationen |
String |
|
Filtert den Zugriff nach Berechtigungstyp der vorhandenen Methodenressource, zum Beispiel NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Verfügbar während der PutMethod und DeleteMethod Operationen. Auch als Sammlung beim Reimport erhältlich |
ArrayOfString |
|
Filtert den Zugriff nach dem Routing-Modus des Domainnamens. Verfügbar während der UpdateDomainName und DeleteDomainName Operationen |
String |
|
Filtert den Zugriff nach TLS-Version. Verfügbar während UpdateDomain und DeleteDomain Operationen |
ArrayOfString |
|
Filtert den Zugriff durch die Tag-Schlüssel-Wert-Paare in der Anforderung |
String |
|
Filtert den Zugriff über die Tags, die an die Ressource angehängt sind. |
String |
|
Filtert Aktionen nach den Tag-Schlüsseln in der Anforderung |
ArrayOfString |
