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.

Verwendung von Cloud Control API-Ressourcentypen

Um einen Ressourcentyp mit verwenden zu können AWS -Cloud-Control- API, muss dieser Ressourcentyp in Ihrem AWS-Konto vorhanden und aktiviert sein. Unterstützte AWS Ressourcentypen sind öffentlich und immer aktiviert. Sie können wählen, ob Sie öffentliche Ressourcentypen, die von Drittanbietern angeboten werden, auch über die AWS CloudFormation Erweiterungsregistrierung aktivieren möchten.

Die Erweiterungsregistrierung ist eine Funktion von AWS CloudFormation , die detaillierte Informationen zu den Ressourcentypen enthält, die in Ihrem Konto verwendet werden können. Dazu können auch Ressourcentypen gehören, die von Drittanbietern veröffentlicht wurden, sowie solche, die von AWS veröffentlicht wurden. Mithilfe der Registrierung können Sie die Ressourcentypen in Ihrem Konto verwalten, darunter:

Sie können die AWS CloudFormation Registrierung auch verwenden, um das Schema eines Ressourcentyps einzusehen, das wichtige Informationen zur Verwendung der Ressource mit der Cloud Control API enthält, wie Eigenschaftsdefinitionen und Berechtigungsanforderungen. Weitere Informationen finden Sie unter Schemas für Ressourcentypen anzeigen.

Die Registrierung ist neben der CloudFormation API auch über die CloudFormation Konsole verfügbar.

Weitere Informationen zu den Verwaltungsoptionen für Ressourcentypen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der CloudFormation Registrierung.

Verwaltung von Ressourcentypen mithilfe der AWS CloudFormation API

Sie können nicht nur über die AWS CloudFormation Konsole auf die Erweiterungsregistrierung zugreifen, sondern auch die in der AWS CloudFormation API enthaltenen Operationen verwenden, um die Ressourcentypen in Ihrem Konto zu identifizieren und zu verwalten. In der folgenden Tabelle sind die API-Operationen aufgeführt, mit denen Sie die in Ihrem Konto verfügbaren Ressourcentypen ermitteln, aktivieren und konfigurieren können.

Feststellen, ob ein Ressourcentyp die Cloud Control API unterstützt

Standardmäßig unterstützen in der CloudFormation Registrierung veröffentlichte Ressourcentypen automatisch Cloud Control API-Ressourcenoperationen. Dazu gehören private Ressourcentypen sowie öffentliche Ressourcentypen von Drittanbietern. Die AWS CloudFormation Registrierung enthält jedoch auch ältere Ressourcentypen, die als nicht bereitstellbar eingestuft sind. Diese Ressourcentypen unterstützen derzeit die Cloud Control API nicht und Sie können sie nicht für Ressourcenoperationen verwenden.

Eine Liste der AWS öffentlichen Ressourcentypen, die derzeit Cloud Control API-Ressourcenoperationen unterstützen, finden Sie unterRessourcentypen, die die Cloud Control API unterstützen.

Sie können das AWS Command Line Interface (AWS CLI) auch verwenden, um eine Liste der unterstützten Ressourcentypen zu generieren oder um festzustellen, ob ein bestimmter Ressourcentyp die Cloud Control API unterstützt.

Schemas für Ressourcentypen anzeigen

Bei Vorgängen zum Erstellen und Aktualisieren von Ressourcen geben Sie an, welche Ressourceneigenschaften festgelegt werden sollen und welche Werte sie haben. Die Eigenschaften einer Ressource sind in ihrem Ressourcentypschema definiert. Dazu gehören der Datentyp, ob die Eigenschaft erforderlich ist, gültige Werte und andere Eigenschaftseinschränkungen.

Sie können das Schema eines Ressourcentyps in der CloudFormation Konsole oder im anzeigen AWS CLI. Darüber hinaus enthält das AWS CloudFormation Benutzerhandbuch Referenzthemen für jeden verfügbaren Ressourcentyp, der AWS veröffentlicht. Ausführliche Informationen zu den Eigenschaften von Ressourcentypen sowie Anwendungsbeispiele finden Sie in den entsprechenden Themen im Referenzabschnitt zu AWS Ressourcen- und Eigenschaftstypen.

Ausführliche Informationen zum Ressourcentypdefinitionsschema, das definiert, wie ein Ressourcentypschema erstellt werden kann, finden Sie unter Ressourcentypdefinitionsschema im CloudFormation CLI User Guide for Extension Development.

Informationen darüber, wie Sie den aktuellen Status einer vorhandenen Ressource, einschließlich ihrer aktuellen Eigenschaftswerte, anzeigen können, finden Sie unter. Eine Ressource lesen mit AWS -Cloud-Control- API

Eigenschaftsattribute von Ressourcen anzeigen

Ressourcentypeigenschaften werden im properties Abschnitt des Ressourcentypschemas definiert. Dazu gehören der Eigenschaftsdatentyp, ob die Eigenschaft erforderlich ist, und alle Einschränkungen wie zulässige Werte oder erforderliche Muster.

Darüber hinaus bestimmen bestimmte auf Ressourcenebene festgelegte Attribute, wann oder ob eine Eigenschaft angegeben werden kann. Dies umfasst:

Unterstützte Ressourcenoperationen anzeigen

Sie können anhand des handlers Abschnitts seines Ressourcentypschemas ermitteln, welche Operationen ein Ressourcentyp unterstützt. Wenn der Ressourcentyp eine Operation unterstützt, ist er im handlers Abschnitt aufgeführt und enthält ein permissions Element, das die Berechtigungen auflistet, die der Handler benötigt.

Im Folgenden finden Sie beispielsweise den handlers Abschnitt des Ressourcentypschemas für den AWS::Logs::LogGroup Ressourcentyp. Dieser Abschnitt zeigt, dass dieser Ressourcentyp alle fünf Ressourcenoperationen unterstützt, und listet die Berechtigungen auf, die jeder Handler benötigt.

  "handlers": {
    "create": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:CreateLogGroup",
        "logs:PutRetentionPolicy"
      ]
    },
    "read": {
      "permissions": [
        "logs:DescribeLogGroups"
      ]
    },
    "update": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:AssociateKmsKey",
        "logs:DisassociateKmsKey",
        "logs:PutRetentionPolicy",
        "logs:DeleteRetentionPolicy"
      ]
    },
    "delete": {
      "permissions": [
        "logs:DescribeLogGroups",
        "logs:DeleteLogGroup"
      ]
    },
    "list": {
      "permissions": [
        "logs:DescribeLogGroups"
      ]
    }
  }