start_bulk_deployment

Greengrass.Client.start_bulk_deployment(**kwargs)

Deploys multiple groups in one operation. This action starts the bulk deployment of a specified set of group versions. Each group version deployment will be triggered with an adaptive rate that has a fixed upper limit. We recommend that you include an ''X-Amzn-Client-Token'' token in every ''StartBulkDeployment'' request. These requests are idempotent with respect to the token and the request parameters.

See also: AWS API Documentation

Request Syntax

response = client.start_bulk_deployment(
    AmznClientToken='string',
    ExecutionRoleArn='string',
    InputFileUri='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • AmznClientToken (string) -- A client token used to correlate requests and responses.
  • ExecutionRoleArn (string) -- [REQUIRED] The ARN of the execution role to associate with the bulk deployment operation. This IAM role must allow the ''greengrass:CreateDeployment'' action for all group versions that are listed in the input file. This IAM role must have access to the S3 bucket containing the input file.
  • InputFileUri (string) -- [REQUIRED] The URI of the input file contained in the S3 bucket. The execution role must have ''getObject'' permissions on this bucket to access the input file. The input file is a JSON-serialized, line delimited file with UTF-8 encoding that provides a list of group and version IDs and the deployment type. This file must be less than 100 MB. Currently, AWS IoT Greengrass supports only ''NewDeployment'' deployment types.
  • tags (dict) --

    Tag(s) to add to the new resource.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'BulkDeploymentArn': 'string',
    'BulkDeploymentId': 'string'
}

Response Structure

  • (dict) -- success
    • BulkDeploymentArn (string) -- The ARN of the bulk deployment.
    • BulkDeploymentId (string) -- The ID of the bulk deployment.

Exceptions

  • Greengrass.Client.exceptions.BadRequestException