libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.CloudFormation.DescribeType

Description

Returns detailed information about an extension that has been registered.

If you specify a VersionId, DescribeType returns information about that specific extension version. Otherwise, it returns information about the default extension version.

Synopsis

Creating a Request

data DescribeType Source #

See: newDescribeType smart constructor.

Constructors

DescribeType' 

Fields

  • versionId :: Maybe Text

    The ID of a specific version of the extension. The version ID is the value at the end of the Amazon Resource Name (ARN) assigned to the extension version when it is registered.

    If you specify a VersionId, DescribeType returns information about that specific extension version. Otherwise, it returns information about the default extension version.

  • typeName :: Maybe Text

    The name of the extension.

    Conditional: You must specify either TypeName and Type, or Arn.

  • arn :: Maybe Text

    The Amazon Resource Name (ARN) of the extension.

    Conditional: You must specify either TypeName and Type, or Arn.

  • publicVersionNumber :: Maybe Text

    The version number of a public third-party extension.

  • type' :: Maybe RegistryType

    The kind of extension.

    Conditional: You must specify either TypeName and Type, or Arn.

  • publisherId :: Maybe Text

    The publisher ID of the extension publisher.

    Extensions provided by Amazon are not assigned a publisher ID.

Instances

Instances details
Eq DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Read DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Show DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Generic DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Associated Types

type Rep DescribeType :: Type -> Type #

NFData DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Methods

rnf :: DescribeType -> () #

Hashable DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

AWSRequest DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Associated Types

type AWSResponse DescribeType #

ToHeaders DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

ToPath DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

ToQuery DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

type Rep DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

type Rep DescribeType = D1 ('MetaData "DescribeType" "Amazonka.CloudFormation.DescribeType" "libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation" 'False) (C1 ('MetaCons "DescribeType'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "versionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "typeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: (S1 ('MetaSel ('Just "publicVersionNumber") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "type'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RegistryType)) :*: S1 ('MetaSel ('Just "publisherId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))
type AWSResponse DescribeType Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

newDescribeType :: DescribeType Source #

Create a value of DescribeType with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:versionId:DescribeType', describeType_versionId - The ID of a specific version of the extension. The version ID is the value at the end of the Amazon Resource Name (ARN) assigned to the extension version when it is registered.

If you specify a VersionId, DescribeType returns information about that specific extension version. Otherwise, it returns information about the default extension version.

$sel:typeName:DescribeType', describeType_typeName - The name of the extension.

Conditional: You must specify either TypeName and Type, or Arn.

$sel:arn:DescribeType', describeType_arn - The Amazon Resource Name (ARN) of the extension.

Conditional: You must specify either TypeName and Type, or Arn.

$sel:publicVersionNumber:DescribeType', describeType_publicVersionNumber - The version number of a public third-party extension.

$sel:type':DescribeType', describeType_type - The kind of extension.

Conditional: You must specify either TypeName and Type, or Arn.

$sel:publisherId:DescribeType', describeType_publisherId - The publisher ID of the extension publisher.

Extensions provided by Amazon are not assigned a publisher ID.

Request Lenses

describeType_versionId :: Lens' DescribeType (Maybe Text) Source #

The ID of a specific version of the extension. The version ID is the value at the end of the Amazon Resource Name (ARN) assigned to the extension version when it is registered.

If you specify a VersionId, DescribeType returns information about that specific extension version. Otherwise, it returns information about the default extension version.

describeType_typeName :: Lens' DescribeType (Maybe Text) Source #

The name of the extension.

Conditional: You must specify either TypeName and Type, or Arn.

describeType_arn :: Lens' DescribeType (Maybe Text) Source #

The Amazon Resource Name (ARN) of the extension.

Conditional: You must specify either TypeName and Type, or Arn.

describeType_publicVersionNumber :: Lens' DescribeType (Maybe Text) Source #

The version number of a public third-party extension.

describeType_type :: Lens' DescribeType (Maybe RegistryType) Source #

The kind of extension.

Conditional: You must specify either TypeName and Type, or Arn.

describeType_publisherId :: Lens' DescribeType (Maybe Text) Source #

The publisher ID of the extension publisher.

Extensions provided by Amazon are not assigned a publisher ID.

Destructuring the Response

data DescribeTypeResponse Source #

See: newDescribeTypeResponse smart constructor.

Constructors

DescribeTypeResponse' 

Fields

  • typeTestsStatusDescription :: Maybe Text

    The description of the test status. To return the extension test status of a specifc extension version, you must specify VersionId.

    This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

  • lastUpdated :: Maybe ISO8601

    When the specified extension version was registered. This applies only to:

    • Private extensions you have registered in your account. For more information, see RegisterType.
    • Public extensions you have activated in your account with auto-update specified. For more information, see ActivateType.
  • typeName :: Maybe Text

    The name of the extension.

    If the extension is a public third-party type you have activated with a type name alias, CloudFormation returns the type name alias. For more information, see ActivateType.

  • arn :: Maybe Text

    The Amazon Resource Name (ARN) of the extension.

  • publicVersionNumber :: Maybe Text

    The version number of a public third-party extension.

    This applies only if you specify a public extension you have activated in your account, or specify a public extension without specifying a version. For all other extensions, CloudFormation returns null.

  • executionRoleArn :: Maybe Text

    The Amazon Resource Name (ARN) of the IAM execution role used to register the extension. This applies only to private extensions you have registered in your account. For more information, see RegisterType.

    If the registered extension calls any Amazon Web Services APIs, you must create an <https:docs.aws.amazon.comIAMlatestUserGuideid_roles.html IAM execution role> that includes the necessary permissions to call those Amazon Web Services APIs, and provision that execution role in your account. CloudFormation then assumes that execution role to provide your extension with the appropriate credentials.

  • autoUpdate :: Maybe Bool

    Whether CloudFormation automatically updates the extension in this account and region when a new minor version is published by the extension publisher. Major versions released by the publisher must be manually updated. For more information, see Activating public extensions for use in your account in the CloudFormation User Guide.

  • originalTypeName :: Maybe Text

    For public extensions that have been activated for this account and region, the type name of the public extension.

    If you specified a TypeNameAlias when enabling the extension in this account and region, CloudFormation treats that alias as the extension's type name within the account and region, not the type name of the public extension. For more information, see Specifying aliases to refer to extensions in the CloudFormation User Guide.

  • visibility :: Maybe Visibility

    The scope at which the extension is visible and usable in CloudFormation operations.

    Valid values include:

    • PRIVATE: The extension is only visible and usable within the account in which it is registered. CloudFormation marks any extensions you register as PRIVATE.
    • PUBLIC: The extension is publically visible and usable within any Amazon account.
  • schema :: Maybe Text

    The schema that defines the extension.

    For more information on extension schemas, see Resource Provider Schema in the CloudFormation CLI User Guide.

  • originalTypeArn :: Maybe Text

    For public extensions that have been activated for this account and region, the Amazon Resource Name (ARN) of the public extension.

  • defaultVersionId :: Maybe Text

    The ID of the default version of the extension. The default version is used when the extension version is not specified.

    This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.

    To set the default version of an extension, use SetTypeDefaultVersion .

  • isActivated :: Maybe Bool

    Whether or not the extension is activated in the account and region.

    This only applies to public third-party extensions. For all other extensions, CloudFormation returns null.

  • requiredActivatedTypes :: Maybe [RequiredActivatedType]

    For extensions that are modules, the public third-party extensions that must be activated in your account in order for the module itself to be activated.

  • deprecatedStatus :: Maybe DeprecatedStatus

    The deprecation status of the extension version.

    Valid values include:

    • LIVE: The extension is activated or registered and can be used in CloudFormation operations, dependent on its provisioning behavior and visibility scope.
    • DEPRECATED: The extension has been deactivated or deregistered and can no longer be used in CloudFormation operations.

    For public third-party extensions, CloudFormation returns null.

  • timeCreated :: Maybe ISO8601

    When the specified private extension version was registered or activated in your account.

  • type' :: Maybe RegistryType

    The kind of extension.

  • latestPublicVersion :: Maybe Text

    The latest version of a public extension that is available for use.

    This only applies if you specify a public extension, and you do not specify a version. For all other requests, CloudFormation returns null.

  • publisherId :: Maybe Text

    The publisher ID of the extension publisher.

    This applies only to public third-party extensions. For private registered extensions, and extensions provided by Amazon, CloudFormation returns null.

  • isDefaultVersion :: Maybe Bool

    Whether the specified extension version is set as the default version.

    This applies only to private extensions you have registered in your account, and extensions published by Amazon. For public third-party extensions, whether or not they are activated in your account, CloudFormation returns null.

  • description :: Maybe Text

    The description of the extension.

  • sourceUrl :: Maybe Text

    The URL of the source code for the extension.

  • documentationUrl :: Maybe Text

    The URL of a page providing detailed documentation for this extension.

  • configurationSchema :: Maybe Text

    A JSON string that represent the current configuration data for the extension in this account and region.

    To set the configuration data for an extension, use SetTypeConfiguration. For more information, see Configuring extensions at the account level in the CloudFormation User Guide.

  • provisioningType :: Maybe ProvisioningType

    For resource type extensions, the provisioning behavior of the resource type. CloudFormation determines the provisioning type during registration, based on the types of handlers in the schema handler package submitted.

    Valid values include:

    • FULLY_MUTABLE: The resource type includes an update handler to process updates to the type during stack update operations.
    • IMMUTABLE: The resource type does not include an update handler, so the type cannot be updated and must instead be replaced during stack update operations.
    • NON_PROVISIONABLE: The resource type does not include all of the following handlers, and therefore cannot actually be provisioned.

      • create
      • read
      • delete
  • typeTestsStatus :: Maybe TypeTestsStatus

    The contract test status of the registered extension version. To return the extension test status of a specifc extension version, you must specify VersionId.

    This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

    • PASSED: The extension has passed all its contract tests.

      An extension must have a test status of PASSED before it can be published. For more information, see Publishing extensions to make them available for public use in the CloudFormation Command Line Interface User Guide.

    • FAILED: The extension has failed one or more contract tests.
    • IN_PROGRESS: Contract tests are currently being performed on the extension.
    • NOT_TESTED: Contract tests have not been performed on the extension.
  • loggingConfig :: Maybe LoggingConfig

    Contains logging configuration information for private extensions. This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Read DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Show DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Generic DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Associated Types

type Rep DescribeTypeResponse :: Type -> Type #

NFData DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

Methods

rnf :: DescribeTypeResponse -> () #

type Rep DescribeTypeResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeType

type Rep DescribeTypeResponse = D1 ('MetaData "DescribeTypeResponse" "Amazonka.CloudFormation.DescribeType" "libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation" 'False) (C1 ('MetaCons "DescribeTypeResponse'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "typeTestsStatusDescription") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "lastUpdated") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)) :*: S1 ('MetaSel ('Just "typeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "publicVersionNumber") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "executionRoleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "autoUpdate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))))) :*: ((S1 ('MetaSel ('Just "originalTypeName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "visibility") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Visibility)) :*: S1 ('MetaSel ('Just "schema") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "originalTypeArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "defaultVersionId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "isActivated") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "requiredActivatedTypes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [RequiredActivatedType])))))) :*: (((S1 ('MetaSel ('Just "deprecatedStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DeprecatedStatus)) :*: (S1 ('MetaSel ('Just "timeCreated") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)) :*: S1 ('MetaSel ('Just "type'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RegistryType)))) :*: ((S1 ('MetaSel ('Just "latestPublicVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "publisherId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "isDefaultVersion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :*: ((S1 ('MetaSel ('Just "sourceUrl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "documentationUrl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "configurationSchema") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "provisioningType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ProvisioningType)) :*: S1 ('MetaSel ('Just "typeTestsStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe TypeTestsStatus))) :*: (S1 ('MetaSel ('Just "loggingConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LoggingConfig)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))))

newDescribeTypeResponse Source #

Create a value of DescribeTypeResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:typeTestsStatusDescription:DescribeTypeResponse', describeTypeResponse_typeTestsStatusDescription - The description of the test status. To return the extension test status of a specifc extension version, you must specify VersionId.

This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

$sel:lastUpdated:DescribeTypeResponse', describeTypeResponse_lastUpdated - When the specified extension version was registered. This applies only to:

  • Private extensions you have registered in your account. For more information, see RegisterType.
  • Public extensions you have activated in your account with auto-update specified. For more information, see ActivateType.

$sel:typeName:DescribeType', describeTypeResponse_typeName - The name of the extension.

If the extension is a public third-party type you have activated with a type name alias, CloudFormation returns the type name alias. For more information, see ActivateType.

$sel:arn:DescribeType', describeTypeResponse_arn - The Amazon Resource Name (ARN) of the extension.

$sel:publicVersionNumber:DescribeType', describeTypeResponse_publicVersionNumber - The version number of a public third-party extension.

This applies only if you specify a public extension you have activated in your account, or specify a public extension without specifying a version. For all other extensions, CloudFormation returns null.

$sel:executionRoleArn:DescribeTypeResponse', describeTypeResponse_executionRoleArn - The Amazon Resource Name (ARN) of the IAM execution role used to register the extension. This applies only to private extensions you have registered in your account. For more information, see RegisterType.

If the registered extension calls any Amazon Web Services APIs, you must create an <https:docs.aws.amazon.comIAMlatestUserGuideid_roles.html IAM execution role> that includes the necessary permissions to call those Amazon Web Services APIs, and provision that execution role in your account. CloudFormation then assumes that execution role to provide your extension with the appropriate credentials.

$sel:autoUpdate:DescribeTypeResponse', describeTypeResponse_autoUpdate - Whether CloudFormation automatically updates the extension in this account and region when a new minor version is published by the extension publisher. Major versions released by the publisher must be manually updated. For more information, see Activating public extensions for use in your account in the CloudFormation User Guide.

$sel:originalTypeName:DescribeTypeResponse', describeTypeResponse_originalTypeName - For public extensions that have been activated for this account and region, the type name of the public extension.

If you specified a TypeNameAlias when enabling the extension in this account and region, CloudFormation treats that alias as the extension's type name within the account and region, not the type name of the public extension. For more information, see Specifying aliases to refer to extensions in the CloudFormation User Guide.

$sel:visibility:DescribeTypeResponse', describeTypeResponse_visibility - The scope at which the extension is visible and usable in CloudFormation operations.

Valid values include:

  • PRIVATE: The extension is only visible and usable within the account in which it is registered. CloudFormation marks any extensions you register as PRIVATE.
  • PUBLIC: The extension is publically visible and usable within any Amazon account.

$sel:schema:DescribeTypeResponse', describeTypeResponse_schema - The schema that defines the extension.

For more information on extension schemas, see Resource Provider Schema in the CloudFormation CLI User Guide.

$sel:originalTypeArn:DescribeTypeResponse', describeTypeResponse_originalTypeArn - For public extensions that have been activated for this account and region, the Amazon Resource Name (ARN) of the public extension.

$sel:defaultVersionId:DescribeTypeResponse', describeTypeResponse_defaultVersionId - The ID of the default version of the extension. The default version is used when the extension version is not specified.

This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.

To set the default version of an extension, use SetTypeDefaultVersion .

$sel:isActivated:DescribeTypeResponse', describeTypeResponse_isActivated - Whether or not the extension is activated in the account and region.

This only applies to public third-party extensions. For all other extensions, CloudFormation returns null.

$sel:requiredActivatedTypes:DescribeTypeResponse', describeTypeResponse_requiredActivatedTypes - For extensions that are modules, the public third-party extensions that must be activated in your account in order for the module itself to be activated.

$sel:deprecatedStatus:DescribeTypeResponse', describeTypeResponse_deprecatedStatus - The deprecation status of the extension version.

Valid values include:

  • LIVE: The extension is activated or registered and can be used in CloudFormation operations, dependent on its provisioning behavior and visibility scope.
  • DEPRECATED: The extension has been deactivated or deregistered and can no longer be used in CloudFormation operations.

For public third-party extensions, CloudFormation returns null.

$sel:timeCreated:DescribeTypeResponse', describeTypeResponse_timeCreated - When the specified private extension version was registered or activated in your account.

$sel:type':DescribeType', describeTypeResponse_type - The kind of extension.

$sel:latestPublicVersion:DescribeTypeResponse', describeTypeResponse_latestPublicVersion - The latest version of a public extension that is available for use.

This only applies if you specify a public extension, and you do not specify a version. For all other requests, CloudFormation returns null.

$sel:publisherId:DescribeType', describeTypeResponse_publisherId - The publisher ID of the extension publisher.

This applies only to public third-party extensions. For private registered extensions, and extensions provided by Amazon, CloudFormation returns null.

$sel:isDefaultVersion:DescribeTypeResponse', describeTypeResponse_isDefaultVersion - Whether the specified extension version is set as the default version.

This applies only to private extensions you have registered in your account, and extensions published by Amazon. For public third-party extensions, whether or not they are activated in your account, CloudFormation returns null.

$sel:description:DescribeTypeResponse', describeTypeResponse_description - The description of the extension.

$sel:sourceUrl:DescribeTypeResponse', describeTypeResponse_sourceUrl - The URL of the source code for the extension.

$sel:documentationUrl:DescribeTypeResponse', describeTypeResponse_documentationUrl - The URL of a page providing detailed documentation for this extension.

$sel:configurationSchema:DescribeTypeResponse', describeTypeResponse_configurationSchema - A JSON string that represent the current configuration data for the extension in this account and region.

To set the configuration data for an extension, use SetTypeConfiguration. For more information, see Configuring extensions at the account level in the CloudFormation User Guide.

$sel:provisioningType:DescribeTypeResponse', describeTypeResponse_provisioningType - For resource type extensions, the provisioning behavior of the resource type. CloudFormation determines the provisioning type during registration, based on the types of handlers in the schema handler package submitted.

Valid values include:

  • FULLY_MUTABLE: The resource type includes an update handler to process updates to the type during stack update operations.
  • IMMUTABLE: The resource type does not include an update handler, so the type cannot be updated and must instead be replaced during stack update operations.
  • NON_PROVISIONABLE: The resource type does not include all of the following handlers, and therefore cannot actually be provisioned.

    • create
    • read
    • delete

$sel:typeTestsStatus:DescribeTypeResponse', describeTypeResponse_typeTestsStatus - The contract test status of the registered extension version. To return the extension test status of a specifc extension version, you must specify VersionId.

This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

  • PASSED: The extension has passed all its contract tests.

    An extension must have a test status of PASSED before it can be published. For more information, see Publishing extensions to make them available for public use in the CloudFormation Command Line Interface User Guide.

  • FAILED: The extension has failed one or more contract tests.
  • IN_PROGRESS: Contract tests are currently being performed on the extension.
  • NOT_TESTED: Contract tests have not been performed on the extension.

$sel:loggingConfig:DescribeTypeResponse', describeTypeResponse_loggingConfig - Contains logging configuration information for private extensions. This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.

$sel:httpStatus:DescribeTypeResponse', describeTypeResponse_httpStatus - The response's http status code.

Response Lenses

describeTypeResponse_typeTestsStatusDescription :: Lens' DescribeTypeResponse (Maybe Text) Source #

The description of the test status. To return the extension test status of a specifc extension version, you must specify VersionId.

This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

describeTypeResponse_lastUpdated :: Lens' DescribeTypeResponse (Maybe UTCTime) Source #

When the specified extension version was registered. This applies only to:

  • Private extensions you have registered in your account. For more information, see RegisterType.
  • Public extensions you have activated in your account with auto-update specified. For more information, see ActivateType.

describeTypeResponse_typeName :: Lens' DescribeTypeResponse (Maybe Text) Source #

The name of the extension.

If the extension is a public third-party type you have activated with a type name alias, CloudFormation returns the type name alias. For more information, see ActivateType.

describeTypeResponse_arn :: Lens' DescribeTypeResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the extension.

describeTypeResponse_publicVersionNumber :: Lens' DescribeTypeResponse (Maybe Text) Source #

The version number of a public third-party extension.

This applies only if you specify a public extension you have activated in your account, or specify a public extension without specifying a version. For all other extensions, CloudFormation returns null.

describeTypeResponse_executionRoleArn :: Lens' DescribeTypeResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the IAM execution role used to register the extension. This applies only to private extensions you have registered in your account. For more information, see RegisterType.

If the registered extension calls any Amazon Web Services APIs, you must create an <https:docs.aws.amazon.comIAMlatestUserGuideid_roles.html IAM execution role> that includes the necessary permissions to call those Amazon Web Services APIs, and provision that execution role in your account. CloudFormation then assumes that execution role to provide your extension with the appropriate credentials.

describeTypeResponse_autoUpdate :: Lens' DescribeTypeResponse (Maybe Bool) Source #

Whether CloudFormation automatically updates the extension in this account and region when a new minor version is published by the extension publisher. Major versions released by the publisher must be manually updated. For more information, see Activating public extensions for use in your account in the CloudFormation User Guide.

describeTypeResponse_originalTypeName :: Lens' DescribeTypeResponse (Maybe Text) Source #

For public extensions that have been activated for this account and region, the type name of the public extension.

If you specified a TypeNameAlias when enabling the extension in this account and region, CloudFormation treats that alias as the extension's type name within the account and region, not the type name of the public extension. For more information, see Specifying aliases to refer to extensions in the CloudFormation User Guide.

describeTypeResponse_visibility :: Lens' DescribeTypeResponse (Maybe Visibility) Source #

The scope at which the extension is visible and usable in CloudFormation operations.

Valid values include:

  • PRIVATE: The extension is only visible and usable within the account in which it is registered. CloudFormation marks any extensions you register as PRIVATE.
  • PUBLIC: The extension is publically visible and usable within any Amazon account.

describeTypeResponse_schema :: Lens' DescribeTypeResponse (Maybe Text) Source #

The schema that defines the extension.

For more information on extension schemas, see Resource Provider Schema in the CloudFormation CLI User Guide.

describeTypeResponse_originalTypeArn :: Lens' DescribeTypeResponse (Maybe Text) Source #

For public extensions that have been activated for this account and region, the Amazon Resource Name (ARN) of the public extension.

describeTypeResponse_defaultVersionId :: Lens' DescribeTypeResponse (Maybe Text) Source #

The ID of the default version of the extension. The default version is used when the extension version is not specified.

This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.

To set the default version of an extension, use SetTypeDefaultVersion .

describeTypeResponse_isActivated :: Lens' DescribeTypeResponse (Maybe Bool) Source #

Whether or not the extension is activated in the account and region.

This only applies to public third-party extensions. For all other extensions, CloudFormation returns null.

describeTypeResponse_requiredActivatedTypes :: Lens' DescribeTypeResponse (Maybe [RequiredActivatedType]) Source #

For extensions that are modules, the public third-party extensions that must be activated in your account in order for the module itself to be activated.

describeTypeResponse_deprecatedStatus :: Lens' DescribeTypeResponse (Maybe DeprecatedStatus) Source #

The deprecation status of the extension version.

Valid values include:

  • LIVE: The extension is activated or registered and can be used in CloudFormation operations, dependent on its provisioning behavior and visibility scope.
  • DEPRECATED: The extension has been deactivated or deregistered and can no longer be used in CloudFormation operations.

For public third-party extensions, CloudFormation returns null.

describeTypeResponse_timeCreated :: Lens' DescribeTypeResponse (Maybe UTCTime) Source #

When the specified private extension version was registered or activated in your account.

describeTypeResponse_latestPublicVersion :: Lens' DescribeTypeResponse (Maybe Text) Source #

The latest version of a public extension that is available for use.

This only applies if you specify a public extension, and you do not specify a version. For all other requests, CloudFormation returns null.

describeTypeResponse_publisherId :: Lens' DescribeTypeResponse (Maybe Text) Source #

The publisher ID of the extension publisher.

This applies only to public third-party extensions. For private registered extensions, and extensions provided by Amazon, CloudFormation returns null.

describeTypeResponse_isDefaultVersion :: Lens' DescribeTypeResponse (Maybe Bool) Source #

Whether the specified extension version is set as the default version.

This applies only to private extensions you have registered in your account, and extensions published by Amazon. For public third-party extensions, whether or not they are activated in your account, CloudFormation returns null.

describeTypeResponse_sourceUrl :: Lens' DescribeTypeResponse (Maybe Text) Source #

The URL of the source code for the extension.

describeTypeResponse_documentationUrl :: Lens' DescribeTypeResponse (Maybe Text) Source #

The URL of a page providing detailed documentation for this extension.

describeTypeResponse_configurationSchema :: Lens' DescribeTypeResponse (Maybe Text) Source #

A JSON string that represent the current configuration data for the extension in this account and region.

To set the configuration data for an extension, use SetTypeConfiguration. For more information, see Configuring extensions at the account level in the CloudFormation User Guide.

describeTypeResponse_provisioningType :: Lens' DescribeTypeResponse (Maybe ProvisioningType) Source #

For resource type extensions, the provisioning behavior of the resource type. CloudFormation determines the provisioning type during registration, based on the types of handlers in the schema handler package submitted.

Valid values include:

  • FULLY_MUTABLE: The resource type includes an update handler to process updates to the type during stack update operations.
  • IMMUTABLE: The resource type does not include an update handler, so the type cannot be updated and must instead be replaced during stack update operations.
  • NON_PROVISIONABLE: The resource type does not include all of the following handlers, and therefore cannot actually be provisioned.

    • create
    • read
    • delete

describeTypeResponse_typeTestsStatus :: Lens' DescribeTypeResponse (Maybe TypeTestsStatus) Source #

The contract test status of the registered extension version. To return the extension test status of a specifc extension version, you must specify VersionId.

This applies only to registered private extension versions. CloudFormation does not return this information for public extensions, whether or not they are activated in your account.

  • PASSED: The extension has passed all its contract tests.

    An extension must have a test status of PASSED before it can be published. For more information, see Publishing extensions to make them available for public use in the CloudFormation Command Line Interface User Guide.

  • FAILED: The extension has failed one or more contract tests.
  • IN_PROGRESS: Contract tests are currently being performed on the extension.
  • NOT_TESTED: Contract tests have not been performed on the extension.

describeTypeResponse_loggingConfig :: Lens' DescribeTypeResponse (Maybe LoggingConfig) Source #

Contains logging configuration information for private extensions. This applies only to private extensions you have registered in your account. For public extensions, both those provided by Amazon and published by third parties, CloudFormation returns null. For more information, see RegisterType.