:doc:`SageMaker <../../sagemaker>` / Client / create_edge_deployment_stage

****************************
create_edge_deployment_stage
****************************



.. py:method:: SageMaker.Client.create_edge_deployment_stage(**kwargs)

  

  Creates a new stage in an existing edge deployment plan.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateEdgeDeploymentStage>`_  


  **Request Syntax**
  ::

    response = client.create_edge_deployment_stage(
        EdgeDeploymentPlanName='string',
        Stages=[
            {
                'StageName': 'string',
                'DeviceSelectionConfig': {
                    'DeviceSubsetType': 'PERCENTAGE'|'SELECTION'|'NAMECONTAINS',
                    'Percentage': 123,
                    'DeviceNames': [
                        'string',
                    ],
                    'DeviceNameContains': 'string'
                },
                'DeploymentConfig': {
                    'FailureHandlingPolicy': 'ROLLBACK_ON_FAILURE'|'DO_NOTHING'
                }
            },
        ]
    )
    
  :type EdgeDeploymentPlanName: string
  :param EdgeDeploymentPlanName: **[REQUIRED]** 

    The name of the edge deployment plan.

    

  
  :type Stages: list
  :param Stages: **[REQUIRED]** 

    List of stages to be added to the edge deployment plan.

    

  
    - *(dict) --* 

      Contains information about a stage in an edge deployment plan.

      

    
      - **StageName** *(string) --* **[REQUIRED]** 

        The name of the stage.

        

      
      - **DeviceSelectionConfig** *(dict) --* **[REQUIRED]** 

        Configuration of the devices in the stage.

        

      
        - **DeviceSubsetType** *(string) --* **[REQUIRED]** 

          Type of device subsets to deploy to the current stage.

          

        
        - **Percentage** *(integer) --* 

          Percentage of devices in the fleet to deploy to the current stage.

          

        
        - **DeviceNames** *(list) --* 

          List of devices chosen to deploy.

          

        
          - *(string) --* 

          
      
        - **DeviceNameContains** *(string) --* 

          A filter to select devices with names containing this name.

          

        
      
      - **DeploymentConfig** *(dict) --* 

        Configuration of the deployment details.

        

      
        - **FailureHandlingPolicy** *(string) --* **[REQUIRED]** 

          Toggle that determines whether to rollback to previous configuration if the current deployment fails. By default this is turned on. You may turn this off if you want to investigate the errors yourself.

          

        
      
    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`SageMaker.Client.exceptions.ResourceLimitExceeded`

  