Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de los tipos de API recursos de Cloud Control

Para usar un tipo de recurso con AWS Cloud Control API, ese tipo de recurso debe estar presente y activado en tu Cuenta de AWS. Los tipos AWS de recursos admitidos son públicos y están siempre activados. También puede optar por activar los tipos de recursos públicos que ofrecen editores externos a través del registro de AWS CloudFormation extensiones.

El registro de extensiones es una función AWS CloudFormation que contiene información detallada sobre los tipos de recursos disponibles para su uso en la cuenta. Estos pueden incluir tipos de recursos publicados por terceros, además de los que publica AWS. Con el registro, puede administrar los tipos de recursos de su cuenta, incluidos los siguientes:

También puedes usar el AWS CloudFormation registro para ver el esquema de un tipo de recurso, que contiene información importante sobre cómo usar el recurso con Cloud ControlAPI, como las definiciones de propiedades y los requisitos de permiso. Para obtener más información, consulte Visualización de esquemas de tipos de recursos.

El registro está disponible a través de la CloudFormation consola, además de CloudFormationAPI.

Para obtener más información sobre las opciones de administración de los tipos de recursos, consulta Cómo usar el CloudFormation registro en la Guía del AWS CloudFormation usuario.

Administrar los tipos de recursos mediante AWS CloudFormation API

Además de acceder al registro de extensiones a través de la AWS CloudFormation consola, puede utilizar las operaciones incluidas en el AWS CloudFormation API para identificar y administrar los tipos de recursos de su cuenta. En la siguiente tabla se enumeran las API operaciones que puede utilizar para descubrir, activar y configurar los tipos de recursos disponibles en su cuenta.

Determinar si un tipo de recurso es compatible con Cloud Control API

De forma predeterminada, los tipos de recursos publicados en el CloudFormation registro admiten automáticamente las operaciones de API recursos de Cloud Control. Esto incluye los tipos de recursos privados, además de los tipos de recursos públicos de terceros. Sin embargo, el AWS CloudFormation registro también contiene tipos de recursos heredados, clasificados como no aprovisionables. Actualmente, estos tipos de recursos no son compatibles con Cloud Control API y no puedes usarlos en las operaciones de recursos.

Para ver una lista de los tipos de recursos AWS públicos que actualmente admiten las operaciones de API recursos de Cloud Control, consultaTipos de recursos compatibles con Cloud Control API.

También puedes usar AWS Command Line Interface (AWS CLI) para generar una lista de los tipos de recursos compatibles o para determinar si un tipo de recurso específico es compatible con Cloud ControlAPI.

Visualización de esquemas de tipos de recursos

Durante las operaciones de creación y actualización de recursos, se especifican las propiedades de los recursos que se van a establecer y sus valores. Las propiedades de un recurso se definen en su esquema de tipos de recursos. Esto incluye el tipo de datos, si la propiedad es obligatoria, los valores válidos y otras restricciones de propiedad.

Puedes ver el esquema de un tipo de recurso mediante la CloudFormation consola o el AWS CLI. Además, la Guía del usuario de AWS CloudFormation contiene temas de referencia de cada tipo de recurso disponible que publica AWS . Para obtener información detallada sobre las propiedades de los tipos de recursos, además de ejemplos de uso, consulte los temas correspondientes en la sección Referencia de tipos de recursos y propiedades de AWS.

Para obtener información detallada sobre el esquema de definición del tipo de recurso, que define cómo se puede crear un esquema de tipo de recurso, consulte el esquema de definición del tipo de recurso en la Guía del CloudFormation CLI usuario para el desarrollo de extensiones.

Para obtener información sobre cómo ver el estado actual de un recurso existente, que incluye sus valores de propiedad actuales, consulteLeer un recurso con AWS Cloud Control API.

Visualización de los atributos de propiedad del recurso

Las propiedades de un tipo de recurso se definen en la sección properties del esquema de tipos de recursos. Esto incluye el tipo de datos de la propiedad, si la propiedad es obligatoria y cualquier restricción, como los valores permitidos o los patrones obligatorios.

Además, determinados atributos establecidos en el recurso determinan cuándo se puede especificar una propiedad o si se puede especificar. Esto incluye:

Visualización de las operaciones de recursos compatibles

Puede determinar qué operaciones admiten un tipo de recurso consultando la sección handlers de su esquema de tipos de recursos. Si el tipo de recurso admite una operación, aparece en la sección handlers y contiene un elemento permissions que enumera los permisos que requiere el controlador.

Por ejemplo, a continuación se muestra la sección handlers del esquema del tipo de recurso correspondiente al tipo de recurso AWS::Logs::LogGroup. En esta sección se muestra que este tipo de recurso admite las cinco operaciones de recursos y se enumeran los permisos que requiere cada controlador.

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