Greengrass / Client / create_core_definition_version

create_core_definition_version#

Greengrass.Client.create_core_definition_version(**kwargs)#

Creates a version of a core definition that has already been defined. Greengrass groups must each contain exactly one Greengrass core.

See also: AWS API Documentation

Request Syntax

response = client.create_core_definition_version(
    AmznClientToken='string',
    CoreDefinitionId='string',
    Cores=[
        {
            'CertificateArn': 'string',
            'Id': 'string',
            'SyncShadow': True|False,
            'ThingArn': 'string'
        },
    ]
)
Parameters:
  • AmznClientToken (string) – A client token used to correlate requests and responses.

  • CoreDefinitionId (string) – [REQUIRED] The ID of the core definition.

  • Cores (list) –

    A list of cores in the core definition version.

    • (dict) – Information about a core.

      • CertificateArn (string) – [REQUIRED] The ARN of the certificate associated with the core.

      • Id (string) – [REQUIRED] A descriptive or arbitrary ID for the core. This value must be unique within the core definition version. Max length is 128 characters with pattern ‘’[a-zA-Z0-9:_-]+’’.

      • SyncShadow (boolean) – If true, the core’s local shadow is automatically synced with the cloud.

      • ThingArn (string) – [REQUIRED] The ARN of the thing which is the core.

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTimestamp': 'string',
    'Id': 'string',
    'Version': 'string'
}

Response Structure

  • (dict) –

    • Arn (string) – The ARN of the version.

    • CreationTimestamp (string) – The time, in milliseconds since the epoch, when the version was created.

    • Id (string) – The ID of the parent definition that the version is associated with.

    • Version (string) – The ID of the version.

Exceptions

  • Greengrass.Client.exceptions.BadRequestException