Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dei tipi di API risorse Cloud Control

Per utilizzare un tipo di risorsa con AWS Cloud Control API, quel tipo di risorsa deve essere presente e attivato nel tuo. Account AWS I tipi di AWS risorse supportati sono pubblici e sempre attivati. Puoi scegliere di attivare i tipi di risorse pubbliche offerti da editori di terze parti anche tramite il registro delle AWS CloudFormation estensioni.

Il registro delle estensioni è una funzionalità AWS CloudFormation che contiene informazioni dettagliate sui tipi di risorse disponibili per l'uso nel tuo account. Questi possono includere tipi di risorse pubblicati da terze parti, oltre a quelli pubblicati da AWS. Utilizzando il registro, puoi gestire i tipi di risorse del tuo account, tra cui:

Puoi anche utilizzare il AWS CloudFormation registro per visualizzare lo schema di un tipo di risorsa, che contiene informazioni importanti su come utilizzare la risorsa con Cloud ControlAPI, come le definizioni delle proprietà e i requisiti di autorizzazione. Per ulteriori informazioni, consulta Visualizzazione degli schemi dei tipi di risorse.

Il registro è disponibile tramite la CloudFormation console, oltre a CloudFormationAPI.

Per ulteriori informazioni sulle opzioni di gestione dei tipi di risorse, consulta Uso del CloudFormation registro nella Guida AWS CloudFormation per l'utente.

Gestione dei tipi di risorse utilizzando il AWS CloudFormation API

Oltre ad accedere al registro delle estensioni tramite la AWS CloudFormation console, puoi utilizzare le operazioni incluse in AWS CloudFormation API per identificare e gestire i tipi di risorse presenti nel tuo account. La tabella seguente elenca le API operazioni che puoi utilizzare per scoprire, attivare e configurare i tipi di risorse disponibili nel tuo account.

Determinare se un tipo di risorsa supporta Cloud Control API

Per impostazione predefinita, i tipi di risorse pubblicati nel CloudFormation registro supportano automaticamente le operazioni sulle API risorse di Cloud Control. Ciò include i tipi di risorse private, oltre ai tipi di risorse pubbliche di terze parti. Tuttavia, il AWS CloudFormation registro contiene anche tipi di risorse legacy, classificati come non fornibili. Questi tipi di risorse attualmente non supportano Cloud Control API e non è possibile utilizzarli nelle operazioni relative alle risorse.

Per un elenco dei tipi di risorse AWS pubbliche che attualmente supportano le operazioni relative alle API risorse di Cloud Control, consultaTipi di risorse che supportano Cloud Control API.

Puoi anche usare il AWS Command Line Interface (AWS CLI) per generare un elenco di tipi di risorse supportati o per determinare se un tipo di risorsa specifico supporta Cloud ControlAPI.

Visualizzazione degli schemi dei tipi di risorse

Durante le operazioni di creazione e aggiornamento delle risorse, si specificano le proprietà delle risorse da impostare e i relativi valori. Le proprietà di una risorsa sono definite nello schema del tipo di risorsa. Ciò include il tipo di dati, l'eventuale obbligatorietà della proprietà, i valori validi e altri vincoli di proprietà.

È possibile visualizzare lo schema di un tipo di risorsa utilizzando la CloudFormation console o il. AWS CLI Inoltre, la Guida per l'AWS CloudFormation utente contiene argomenti di riferimento per ogni tipo di risorsa disponibile AWS pubblicata. Per informazioni dettagliate sulle proprietà dei tipi di risorsa, oltre agli esempi di utilizzo, consultate gli argomenti corrispondenti nella sezione di riferimento per i tipi di AWS risorse e proprietà.

Per informazioni dettagliate sullo schema di definizione del tipo di risorsa, che definisce come creare lo schema del tipo di risorsa, vedere Schema di definizione del tipo di risorsa nella Guida CloudFormation CLI utente per lo sviluppo di estensioni.

Per informazioni su come visualizzare lo stato corrente di una risorsa esistente, che include i valori delle proprietà correnti, vedereLeggere una risorsa con AWS Cloud Control API.

Visualizzazione degli attributi delle proprietà delle risorse

Le proprietà del tipo di risorsa sono definite nella properties sezione dello schema del tipo di risorsa. Ciò include il tipo di dati della proprietà, se la proprietà è obbligatoria ed eventuali vincoli, come i valori consentiti o i modelli obbligatori.

Inoltre, determinati attributi impostati a livello di risorsa determinano quando o se una proprietà può essere specificata. Questo include:

Visualizzazione delle operazioni sulle risorse supportate

È possibile determinare le operazioni supportate da un tipo di risorsa facendo riferimento alla handlers sezione del relativo schema dei tipi di risorse. Se il tipo di risorsa supporta un'operazione, questa è elencata nella handlers sezione e contiene un permissions elemento che elenca le autorizzazioni richieste dal gestore.

Ad esempio, di seguito è riportata la handlers sezione dello schema del tipo di risorsa per il tipo di AWS::Logs::LogGroup risorsa. Questa sezione mostra che questo tipo di risorsa supporta tutte e cinque le operazioni relative alle risorse ed elenca le autorizzazioni richieste da ciascun gestore.

  "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"
      ]
    }
  }