Proton ****** Client ====== class Proton.Client A low-level client representing AWS Proton This is the Proton Service API Reference. It provides descriptions, syntax and usage examples for each of the actions and data types for the Proton service. The documentation for each action shows the Query API request parameters and the XML response. Alternatively, you can use the Amazon Web Services CLI to access an API. For more information, see the Amazon Web Services Command Line Interface User Guide. The Proton service is a two-pronged automation framework. Administrators create service templates to provide standardized infrastructure and deployment tooling for serverless and container based applications. Developers, in turn, select from the available service templates to automate their application or service deployments. Because administrators define the infrastructure and tooling that Proton deploys and manages, they need permissions to use all of the listed API operations. When developers select a specific infrastructure and tooling set, Proton deploys their applications. To monitor their applications that are running on Proton, developers need permissions to the service *create*, *list*, *update* and *delete* API operations and the service instance *list* and *update* API operations. To learn more about Proton, see the Proton User Guide. **Ensuring Idempotency** When you make a mutating API request, the request typically returns a result before the asynchronous workflows of the operation are complete. Operations might also time out or encounter other server issues before they're complete, even if the request already returned a result. This might make it difficult to determine whether the request succeeded. Moreover, you might need to retry the request multiple times to ensure that the operation completes successfully. However, if the original request and the subsequent retries are successful, the operation occurs multiple times. This means that you might create more resources than you intended. *Idempotency* ensures that an API request action completes no more than one time. With an idempotent request, if the original request action completes successfully, any subsequent retries complete successfully without performing any further actions. However, the result might contain updated information, such as the current creation status. The following lists of APIs are grouped according to methods that ensure idempotency. **Idempotent create APIs with a client token** The API actions in this list support idempotency with the use of a *client token*. The corresponding Amazon Web Services CLI commands also support idempotency using a client token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. To make an idempotent API request using one of these actions, specify a client token in the request. We recommend that you *don't* reuse the same client token for other API requests. If you don’t provide a client token for these APIs, a default client token is automatically provided by SDKs. Given a request action that has succeeded: If you retry the request using the same client token and the same parameters, the retry succeeds without performing any further actions other than returning the original resource detail data in the response. If you retry the request using the same client token, but one or more of the parameters are different, the retry throws a "ValidationException" with an "IdempotentParameterMismatch" error. Client tokens expire eight hours after a request is made. If you retry the request with the expired token, a new resource is created. If the original resource is deleted and you retry the request, a new resource is created. Idempotent create APIs with a client token: * CreateEnvironmentTemplateVersion * CreateServiceTemplateVersion * CreateEnvironmentAccountConnection **Idempotent create APIs** Given a request action that has succeeded: If you retry the request with an API from this group, and the original resource *hasn't* been modified, the retry succeeds without performing any further actions other than returning the original resource detail data in the response. If the original resource has been modified, the retry throws a "ConflictException". If you retry with different input parameters, the retry throws a "ValidationException" with an "IdempotentParameterMismatch" error. Idempotent create APIs: * CreateEnvironmentTemplate * CreateServiceTemplate * CreateEnvironment * CreateService **Idempotent delete APIs** Given a request action that has succeeded: When you retry the request with an API from this group and the resource was deleted, its metadata is returned in the response. If you retry and the resource doesn't exist, the response is empty. In both cases, the retry succeeds. Idempotent delete APIs: * DeleteEnvironmentTemplate * DeleteEnvironmentTemplateVersion * DeleteServiceTemplate * DeleteServiceTemplateVersion * DeleteEnvironmentAccountConnection **Asynchronous idempotent delete APIs** Given a request action that has succeeded: If you retry the request with an API from this group, if the original request delete operation status is "DELETE_IN_PROGRESS", the retry returns the resource detail data in the response without performing any further actions. If the original request delete operation is complete, a retry returns an empty response. Asynchronous idempotent delete APIs: * DeleteEnvironment * DeleteService import boto3 client = boto3.client('proton') These are the available methods: * accept_environment_account_connection * can_paginate * cancel_component_deployment * cancel_environment_deployment * cancel_service_instance_deployment * cancel_service_pipeline_deployment * close * create_component * create_environment * create_environment_account_connection * create_environment_template * create_environment_template_version * create_repository * create_service * create_service_instance * create_service_sync_config * create_service_template * create_service_template_version * create_template_sync_config * delete_component * delete_deployment * delete_environment * delete_environment_account_connection * delete_environment_template * delete_environment_template_version * delete_repository * delete_service * delete_service_sync_config * delete_service_template * delete_service_template_version * delete_template_sync_config * get_account_settings * get_component * get_deployment * get_environment * get_environment_account_connection * get_environment_template * get_environment_template_version * get_paginator * get_repository * get_repository_sync_status * get_resources_summary * get_service * get_service_instance * get_service_instance_sync_status * get_service_sync_blocker_summary * get_service_sync_config * get_service_template * get_service_template_version * get_template_sync_config * get_template_sync_status * get_waiter * list_component_outputs * list_component_provisioned_resources * list_components * list_deployments * list_environment_account_connections * list_environment_outputs * list_environment_provisioned_resources * list_environment_template_versions * list_environment_templates * list_environments * list_repositories * list_repository_sync_definitions * list_service_instance_outputs * list_service_instance_provisioned_resources * list_service_instances * list_service_pipeline_outputs * list_service_pipeline_provisioned_resources * list_service_template_versions * list_service_templates * list_services * list_tags_for_resource * notify_resource_deployment_status_change * reject_environment_account_connection * tag_resource * untag_resource * update_account_settings * update_component * update_environment * update_environment_account_connection * update_environment_template * update_environment_template_version * update_service * update_service_instance * update_service_pipeline * update_service_sync_blocker * update_service_sync_config * update_service_template * update_service_template_version * update_template_sync_config Paginators ========== Paginators are available on a client instance via the "get_paginator" method. For more detailed instructions and examples on the usage of paginators, see the paginators user guide. The available paginators are: * ListComponentOutputs * ListComponentProvisionedResources * ListComponents * ListDeployments * ListEnvironmentAccountConnections * ListEnvironmentOutputs * ListEnvironmentProvisionedResources * ListEnvironmentTemplateVersions * ListEnvironmentTemplates * ListEnvironments * ListRepositories * ListRepositorySyncDefinitions * ListServiceInstanceOutputs * ListServiceInstanceProvisionedResources * ListServiceInstances * ListServicePipelineOutputs * ListServicePipelineProvisionedResources * ListServiceTemplateVersions * ListServiceTemplates * ListServices * ListTagsForResource Waiters ======= Waiters are available on a client instance via the "get_waiter" method. For more detailed instructions and examples on the usage or waiters, see the waiters user guide. The available waiters are: * ComponentDeleted * ComponentDeployed * EnvironmentDeployed * EnvironmentTemplateVersionRegistered * ServiceCreated * ServiceDeleted * ServiceInstanceDeployed * ServicePipelineDeployed * ServiceTemplateVersionRegistered * ServiceUpdated Proton / Waiter / ServiceUpdated ServiceUpdated ************** class Proton.Waiter.ServiceUpdated waiter = client.get_waiter('service_updated') wait(**kwargs) Polls "Proton.Client.get_service()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the service that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / EnvironmentDeployed EnvironmentDeployed ******************* class Proton.Waiter.EnvironmentDeployed waiter = client.get_waiter('environment_deployed') wait(**kwargs) Polls "Proton.Client.get_environment()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the environment that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / ComponentDeleted ComponentDeleted **************** class Proton.Waiter.ComponentDeleted waiter = client.get_waiter('component_deleted') wait(**kwargs) Polls "Proton.Client.get_component()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the component that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / EnvironmentTemplateVersionRegistered EnvironmentTemplateVersionRegistered ************************************ class Proton.Waiter.EnvironmentTemplateVersionRegistered waiter = client.get_waiter('environment_template_version_registered') wait(**kwargs) Polls "Proton.Client.get_environment_template_version()" every 2 seconds until a successful state is reached. An error is raised after 150 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( majorVersion='string', minorVersion='string', templateName='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** To get environment template major version detail data, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To get environment template minor version detail data, include "minorVersion". * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template a version of which you want to get detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 2 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 150 Returns: None Proton / Waiter / ServiceCreated ServiceCreated ************** class Proton.Waiter.ServiceCreated waiter = client.get_waiter('service_created') wait(**kwargs) Polls "Proton.Client.get_service()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the service that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / ServicePipelineDeployed ServicePipelineDeployed *********************** class Proton.Waiter.ServicePipelineDeployed waiter = client.get_waiter('service_pipeline_deployed') wait(**kwargs) Polls "Proton.Client.get_service()" every 10 seconds until a successful state is reached. An error is raised after 360 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the service that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 10 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 360 Returns: None Proton / Waiter / ServiceInstanceDeployed ServiceInstanceDeployed *********************** class Proton.Waiter.ServiceInstanceDeployed waiter = client.get_waiter('service_instance_deployed') wait(**kwargs) Polls "Proton.Client.get_service_instance()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', serviceName='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of a service instance that you want to get the detailed data for. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that you want the service instance input for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / ServiceTemplateVersionRegistered ServiceTemplateVersionRegistered ******************************** class Proton.Waiter.ServiceTemplateVersionRegistered waiter = client.get_waiter('service_template_version_registered') wait(**kwargs) Polls "Proton.Client.get_service_template_version()" every 2 seconds until a successful state is reached. An error is raised after 150 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( majorVersion='string', minorVersion='string', templateName='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** To get service template major version detail data, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To get service template minor version detail data, include "minorVersion". * **templateName** (*string*) -- **[REQUIRED]** The name of the service template a version of which you want to get detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 2 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 150 Returns: None Proton / Waiter / ComponentDeployed ComponentDeployed ***************** class Proton.Waiter.ComponentDeployed waiter = client.get_waiter('component_deployed') wait(**kwargs) Polls "Proton.Client.get_component()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the component that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Waiter / ServiceDeleted ServiceDeleted ************** class Proton.Waiter.ServiceDeleted waiter = client.get_waiter('service_deleted') wait(**kwargs) Polls "Proton.Client.get_service()" every 5 seconds until a successful state is reached. An error is raised after 999 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( name='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the service that you want to get the detailed data for. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 5 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 999 Returns: None Proton / Paginator / ListServicePipelineProvisionedResources ListServicePipelineProvisionedResources *************************************** class Proton.Paginator.ListServicePipelineProvisionedResources paginator = client.get_paginator('list_service_pipeline_provisioned_resources') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_pipeline_provisioned_resources()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( serviceName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **serviceName** (*string*) -- **[REQUIRED]** The name of the service whose pipeline's provisioned resources you want. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **provisionedResources** *(list) --* An array of provisioned resources for a service and pipeline. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListTagsForResource ListTagsForResource ******************* class Proton.Paginator.ListTagsForResource paginator = client.get_paginator('list_tags_for_resource') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_tags_for_resource()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( resourceArn='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **resourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource for the listed tags. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'tags': [ { 'key': 'string', 'value': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **tags** *(list) --* A list of resource tags with detail data. * *(dict) --* A description of a resource tag. * **key** *(string) --* The key of the resource tag. * **value** *(string) --* The value of the resource tag. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServiceInstanceProvisionedResources ListServiceInstanceProvisionedResources *************************************** class Proton.Paginator.ListServiceInstanceProvisionedResources paginator = client.get_paginator('list_service_instance_provisioned_resources') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_instance_provisioned_resources()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( serviceInstanceName='string', serviceName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance whose provisioned resources you want. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that "serviceInstanceName" is associated to. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **provisionedResources** *(list) --* An array of provisioned resources for a service instance. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListComponentOutputs ListComponentOutputs ******************** class Proton.Paginator.ListComponentOutputs paginator = client.get_paginator('list_component_outputs') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_component_outputs()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( componentName='string', deploymentId='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **componentName** (*string*) -- **[REQUIRED]** The name of the component whose outputs you want. * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **outputs** *(list) --* An array of component Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListComponents ListComponents ************** class Proton.Paginator.ListComponents paginator = client.get_paginator('list_components') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_components()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( environmentName='string', serviceInstanceName='string', serviceName='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **environmentName** (*string*) -- The name of an environment for result list filtering. Proton returns components associated with the environment or attached to service instances running in it. * **serviceInstanceName** (*string*) -- The name of a service instance for result list filtering. Proton returns the component attached to the service instance, if any. * **serviceName** (*string*) -- The name of a service for result list filtering. Proton returns components attached to service instances of the service. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'components': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **components** *(list) --* An array of components with summary data. * *(dict) --* Summary data of an Proton component resource. For more information about components, see Proton components in the *Proton User Guide*. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironmentTemplateVersions ListEnvironmentTemplateVersions ******************************* class Proton.Paginator.ListEnvironmentTemplateVersions paginator = client.get_paginator('list_environment_template_versions') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environment_template_versions()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( majorVersion='string', templateName='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **majorVersion** (*string*) -- To view a list of minor of versions under a major version of an environment template, include "major Version". To view a list of major versions of an environment template, *exclude* "major Version". * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'templateVersions': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **templateVersions** *(list) --* An array of major or minor versions of an environment template detail data. * *(dict) --* A summary of the version of an environment template detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the environment template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListComponentProvisionedResources ListComponentProvisionedResources ********************************* class Proton.Paginator.ListComponentProvisionedResources paginator = client.get_paginator('list_component_provisioned_resources') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_component_provisioned_resources()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( componentName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **componentName** (*string*) -- **[REQUIRED]** The name of the component whose provisioned resources you want. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **provisionedResources** *(list) --* An array of provisioned resources for a component. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServices ListServices ************ class Proton.Paginator.ListServices paginator = client.get_paginator('list_services') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_services()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'services': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **services** *(list) --* An array of services with summaries of detail data. * *(dict) --* Summary data of an Proton service resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServicePipelineOutputs ListServicePipelineOutputs ************************** class Proton.Paginator.ListServicePipelineOutputs paginator = client.get_paginator('list_service_pipeline_outputs') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_pipeline_outputs()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( deploymentId='string', serviceName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment you want the outputs for. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service whose pipeline's outputs you want. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **outputs** *(list) --* An array of service pipeline Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServiceTemplateVersions ListServiceTemplateVersions *************************** class Proton.Paginator.ListServiceTemplateVersions paginator = client.get_paginator('list_service_template_versions') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_template_versions()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( majorVersion='string', templateName='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **majorVersion** (*string*) -- To view a list of minor of versions under a major version of a service template, include "major Version". To view a list of major versions of a service template, *exclude* "major Version". * **templateName** (*string*) -- **[REQUIRED]** The name of the service template. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'templateVersions': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **templateVersions** *(list) --* An array of major or minor versions of a service template with detail data. * *(dict) --* Summary data of an Proton service template version resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **status** *(string) --* The service template minor version status. * **statusMessage** *(string) --* A service template minor version status message. * **templateName** *(string) --* The name of the service template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServiceInstances ListServiceInstances ******************** class Proton.Paginator.ListServiceInstances paginator = client.get_paginator('list_service_instances') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_instances()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( filters=[ { 'key': 'name'|'deploymentStatus'|'templateName'|'serviceName'|'deployedTemplateVersionStatus'|'environmentName'|'lastDeploymentAttemptedAtBefore'|'lastDeploymentAttemptedAtAfter'|'createdAtBefore'|'createdAtAfter', 'value': 'string' }, ], serviceName='string', sortBy='name'|'deploymentStatus'|'templateName'|'serviceName'|'environmentName'|'lastDeploymentAttemptedAt'|'createdAt', sortOrder='ASCENDING'|'DESCENDING', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **filters** (*list*) -- An array of filtering criteria that scope down the result list. By default, all service instances in the Amazon Web Services account are returned. * *(dict) --* A filtering criterion to scope down the result list of the ListServiceInstances action. * **key** *(string) --* The name of a filtering criterion. * **value** *(string) --* A value to filter by. With the date/time keys ( "*At{Before,After}"), the value is a valid RFC 3339 string with no UTC offset and with an optional fractional precision (for example, "1985-04-12T23:20:50.52Z"). * **serviceName** (*string*) -- The name of the service that the service instance belongs to. * **sortBy** (*string*) -- The field that the result list is sorted by. When you choose to sort by "serviceName", service instances within each service are sorted by service instance name. Default: "serviceName" * **sortOrder** (*string*) -- Result list sort order. Default: "ASCENDING" * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'serviceInstances': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **serviceInstances** *(list) --* An array of service instances with summary data. * *(dict) --* Summary data of an Proton service instance resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* A service instance deployment status message. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **templateMajorVersion** *(string) --* The service instance template major version. * **templateMinorVersion** *(string) --* The service instance template minor version. * **templateName** *(string) --* The name of the service template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironmentAccountConnections ListEnvironmentAccountConnections ********************************* class Proton.Paginator.ListEnvironmentAccountConnections paginator = client.get_paginator('list_environment_account_connections') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environment_account_connections()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( environmentName='string', requestedBy='MANAGEMENT_ACCOUNT'|'ENVIRONMENT_ACCOUNT', statuses=[ 'PENDING'|'CONNECTED'|'REJECTED', ], PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **environmentName** (*string*) -- The environment name that's associated with each listed environment account connection. * **requestedBy** (*string*) -- **[REQUIRED]** The type of account making the "ListEnvironmentAccountConnections" request. * **statuses** (*list*) -- The status details for each listed environment account connection. * *(string) --* * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnections': [ { 'arn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **environmentAccountConnections** *(list) --* An array of environment account connections with details that's returned by Proton. * *(dict) --* Summary data of an Proton environment account connection resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The ID of the environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListDeployments ListDeployments *************** class Proton.Paginator.ListDeployments paginator = client.get_paginator('list_deployments') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_deployments()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( componentName='string', environmentName='string', serviceInstanceName='string', serviceName='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **componentName** (*string*) -- The name of a component for result list filtering. Proton returns deployments associated with that component. * **environmentName** (*string*) -- The name of an environment for result list filtering. Proton returns deployments associated with the environment. * **serviceInstanceName** (*string*) -- The name of a service instance for result list filtering. Proton returns the deployments associated with the service instance. * **serviceName** (*string*) -- The name of a service for result list filtering. Proton returns deployments associated with service instances of the service. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'deployments': [ { 'arn': 'string', 'completedAt': datetime(2015, 1, 1), 'componentName': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'environmentName': 'string', 'id': 'string', 'lastAttemptedDeploymentId': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'targetArn': 'string', 'targetResourceCreatedAt': datetime(2015, 1, 1), 'targetResourceType': 'ENVIRONMENT'|'SERVICE_PIPELINE'|'SERVICE_INSTANCE'|'COMPONENT' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **deployments** *(list) --* An array of deployment with summary data. * *(dict) --* Summary data of the deployment. * **arn** *(string) --* The Amazon Resource Name (ARN) of the deployment. * **completedAt** *(datetime) --* The date and time the deployment was completed. * **componentName** *(string) --* The name of the component associated with the deployment. * **createdAt** *(datetime) --* The date and time the deployment was created. * **deploymentStatus** *(string) --* The current status of the deployment. * **environmentName** *(string) --* The name of the environment associated with the deployment. * **id** *(string) --* The ID of the deployment. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment. * **lastModifiedAt** *(datetime) --* The date and time the deployment was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment. * **serviceInstanceName** *(string) --* The name of the service instance associated with the deployment. * **serviceName** *(string) --* The name of the service associated with the deployment. * **targetArn** *(string) --* The Amazon Resource Name (ARN) of the target of the deployment. * **targetResourceCreatedAt** *(datetime) --* The date and time the target resource was created. * **targetResourceType** *(string) --* The resource type of the deployment target. It can be an environment, service, service instance, or component. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironmentTemplates ListEnvironmentTemplates ************************ class Proton.Paginator.ListEnvironmentTemplates paginator = client.get_paginator('list_environment_templates') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environment_templates()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'templates': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **templates** *(list) --* An array of environment templates with detail data. * *(dict) --* The environment template data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The recommended version of the environment template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListRepositorySyncDefinitions ListRepositorySyncDefinitions ***************************** class Proton.Paginator.ListRepositorySyncDefinitions paginator = client.get_paginator('list_repository_sync_definitions') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_repository_sync_definitions()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', syncType='TEMPLATE_SYNC'|'SERVICE_SYNC', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **repositoryName** (*string*) -- **[REQUIRED]** The repository name. * **repositoryProvider** (*string*) -- **[REQUIRED]** The repository provider. * **syncType** (*string*) -- **[REQUIRED]** The sync type. The only supported value is "TEMPLATE_SYNC". * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'syncDefinitions': [ { 'branch': 'string', 'directory': 'string', 'parent': 'string', 'target': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **syncDefinitions** *(list) --* An array of repository sync definitions. * *(dict) --* A repository sync definition. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The directory in the repository. * **parent** *(string) --* The resource that is synced from. * **target** *(string) --* The resource that is synced to. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironmentOutputs ListEnvironmentOutputs ********************** class Proton.Paginator.ListEnvironmentOutputs paginator = client.get_paginator('list_environment_outputs') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environment_outputs()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( deploymentId='string', environmentName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **environmentName** (*string*) -- **[REQUIRED]** The environment name. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **outputs** *(list) --* An array of environment outputs with detail data. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServiceInstanceOutputs ListServiceInstanceOutputs ************************** class Proton.Paginator.ListServiceInstanceOutputs paginator = client.get_paginator('list_service_instance_outputs') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_instance_outputs()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( deploymentId='string', serviceInstanceName='string', serviceName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance whose outputs you want. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that "serviceInstanceName" is associated to. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **outputs** *(list) --* An array of service instance Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironments ListEnvironments **************** class Proton.Paginator.ListEnvironments paginator = client.get_paginator('list_environments') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environments()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( environmentTemplates=[ { 'majorVersion': 'string', 'templateName': 'string' }, ], PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **environmentTemplates** (*list*) -- An array of the versions of the environment template. * *(dict) --* A search filter for environment templates. * **majorVersion** *(string) --* **[REQUIRED]** Include "majorVersion" to filter search for a major version. * **templateName** *(string) --* **[REQUIRED]** Include "templateName" to filter search for a template name. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'environments': [ { 'arn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **environments** *(list) --* An array of environment detail data summaries. * *(dict) --* Summary data of an Proton environment resource. An Proton environment is a set of resources shared across Proton services. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that the environment is associated with. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The name of the environment template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListServiceTemplates ListServiceTemplates ******************** class Proton.Paginator.ListServiceTemplates paginator = client.get_paginator('list_service_templates') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_service_templates()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'templates': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **templates** *(list) --* An array of service templates with detail data. * *(dict) --* Summary data of an Proton service template resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template, otherwise a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListRepositories ListRepositories **************** class Proton.Paginator.ListRepositories paginator = client.get_paginator('list_repositories') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_repositories()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'repositories': [ { 'arn': 'string', 'connectionArn': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **repositories** *(list) --* An array of repository links. * *(dict) --* Summary data of a linked repository—a repository that has been registered with Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **connectionArn** *(string) --* The Amazon Resource Name (ARN) of the of your connection that connects Proton to your repository. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **NextToken** *(string) --* A token to resume pagination. Proton / Paginator / ListEnvironmentProvisionedResources ListEnvironmentProvisionedResources *********************************** class Proton.Paginator.ListEnvironmentProvisionedResources paginator = client.get_paginator('list_environment_provisioned_resources') paginate(**kwargs) Creates an iterator that will paginate through responses from "Proton.Client.list_environment_provisioned_resources()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( environmentName='string', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **environmentName** (*string*) -- **[REQUIRED]** The environment name. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **provisionedResources** *(list) --* An array of environment provisioned resources. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. * **NextToken** *(string) --* A token to resume pagination. Proton / Client / get_environment get_environment *************** Proton.Client.get_environment(**kwargs) Get detailed data for an environment. See also: AWS API Documentation **Request Syntax** response = client.get_environment( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the environment that you want to get the detailed data for. Return type: dict Returns: **Response Syntax** { 'environment': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'provisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environment** *(dict) --* The detailed data of the requested environment. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that's used to provision infrastructure resources in an environment account. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **provisioningRepository** *(dict) --* The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **spec** *(string) --* The environment spec. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The Amazon Resource Name (ARN) of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_environment_template update_environment_template *************************** Proton.Client.update_environment_template(**kwargs) Update an environment template. See also: AWS API Documentation **Request Syntax** response = client.update_environment_template( description='string', displayName='string', name='string' ) Parameters: * **description** (*string*) -- A description of the environment template update. * **displayName** (*string*) -- The name of the environment template to update as displayed in the developer interface. * **name** (*string*) -- **[REQUIRED]** The name of the environment template to update. Return type: dict Returns: **Response Syntax** { 'environmentTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplate** *(dict) --* The environment template detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided encryption key for the environment template. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The ID of the recommended version of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_component delete_component **************** Proton.Client.delete_component(**kwargs) Delete an Proton component resource. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.delete_component( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the component to delete. Return type: dict Returns: **Response Syntax** { 'component': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string' } } **Response Structure** * *(dict) --* * **component** *(dict) --* The detailed data of the component being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **description** *(string) --* A description of the component. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastClientRequestToken** *(string) --* The last token the client requested. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_paginator get_paginator ************* Proton.Client.get_paginator(operation_name) Create a paginator for an operation. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Raises: **OperationNotPageableError** -- Raised if the operation is not pageable. You can use the "client.can_paginate" method to check if an operation is pageable. Return type: "botocore.paginate.Paginator" Returns: A paginator object. Proton / Client / list_components list_components *************** Proton.Client.list_components(**kwargs) List components with summary data. You can filter the result list by environment, service, or a single service instance. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.list_components( environmentName='string', maxResults=123, nextToken='string', serviceInstanceName='string', serviceName='string' ) Parameters: * **environmentName** (*string*) -- The name of an environment for result list filtering. Proton returns components associated with the environment or attached to service instances running in it. * **maxResults** (*integer*) -- The maximum number of components to list. * **nextToken** (*string*) -- A token that indicates the location of the next component in the array of components, after the list of components that was previously requested. * **serviceInstanceName** (*string*) -- The name of a service instance for result list filtering. Proton returns the component attached to the service instance, if any. * **serviceName** (*string*) -- The name of a service for result list filtering. Proton returns components attached to service instances of the service. Return type: dict Returns: **Response Syntax** { 'components': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **components** *(list) --* An array of components with summary data. * *(dict) --* Summary data of an Proton component resource. For more information about components, see Proton components in the *Proton User Guide*. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **nextToken** *(string) --* A token that indicates the location of the next component in the array of components, after the current requested list of components. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_environment_template delete_environment_template *************************** Proton.Client.delete_environment_template(**kwargs) If no other major or minor versions of an environment template exist, delete the environment template. See also: AWS API Documentation **Request Syntax** response = client.delete_environment_template( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the environment template to delete. Return type: dict Returns: **Response Syntax** { 'environmentTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplate** *(dict) --* The detailed data of the environment template being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided encryption key for the environment template. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The ID of the recommended version of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environment_outputs list_environment_outputs ************************ Proton.Client.list_environment_outputs(**kwargs) List the infrastructure as code outputs for your environment. See also: AWS API Documentation **Request Syntax** response = client.list_environment_outputs( deploymentId='string', environmentName='string', nextToken='string' ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **environmentName** (*string*) -- **[REQUIRED]** The environment name. * **nextToken** (*string*) -- A token that indicates the location of the next environment output in the array of environment outputs, after the list of environment outputs that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next environment output in the array of environment outputs, after the current requested list of environment outputs. * **outputs** *(list) --* An array of environment outputs with detail data. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environment_templates list_environment_templates ************************** Proton.Client.list_environment_templates(**kwargs) List environment templates. See also: AWS API Documentation **Request Syntax** response = client.list_environment_templates( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of environment templates to list. * **nextToken** (*string*) -- A token that indicates the location of the next environment template in the array of environment templates, after the list of environment templates that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'templates': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next environment template in the array of environment templates, after the current requested list of environment templates. * **templates** *(list) --* An array of environment templates with detail data. * *(dict) --* The environment template data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The recommended version of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_environment delete_environment ****************** Proton.Client.delete_environment(**kwargs) Delete an environment. See also: AWS API Documentation **Request Syntax** response = client.delete_environment( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the environment to delete. Return type: dict Returns: **Response Syntax** { 'environment': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'provisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environment** *(dict) --* The detailed data of the environment being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that's used to provision infrastructure resources in an environment account. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **provisioningRepository** *(dict) --* The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **spec** *(string) --* The environment spec. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The Amazon Resource Name (ARN) of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_environment_template create_environment_template *************************** Proton.Client.create_environment_template(**kwargs) Create an environment template for Proton. For more information, see Environment Templates in the *Proton User Guide*. You can create an environment template in one of the two following ways: * Register and publish a *standard* environment template that instructs Proton to deploy and manage environment infrastructure. * Register and publish a *customer managed* environment template that connects Proton to your existing provisioned infrastructure that you manage. Proton *doesn't* manage your existing provisioned infrastructure. To create an environment template for customer provisioned and managed infrastructure, include the "provisioning" parameter and set the value to "CUSTOMER_MANAGED". For more information, see Register and publish an environment template in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_environment_template( description='string', displayName='string', encryptionKey='string', name='string', provisioning='CUSTOMER_MANAGED', tags=[ { 'key': 'string', 'value': 'string' }, ] ) Parameters: * **description** (*string*) -- A description of the environment template. * **displayName** (*string*) -- The environment template name as displayed in the developer interface. * **encryptionKey** (*string*) -- A customer provided encryption key that Proton uses to encrypt data. * **name** (*string*) -- **[REQUIRED]** The name of the environment template. * **provisioning** (*string*) -- When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton environment template. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. Return type: dict Returns: **Response Syntax** { 'environmentTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplate** *(dict) --* The environment template detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided encryption key for the environment template. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The ID of the recommended version of the environment template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / can_paginate can_paginate ************ Proton.Client.can_paginate(operation_name) Check if an operation can be paginated. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Returns: "True" if the operation can be paginated, "False" otherwise. Proton / Client / create_environment create_environment ****************** Proton.Client.create_environment(**kwargs) Deploy a new environment. An Proton environment is created from an environment template that defines infrastructure and resources that can be shared across services. **You can provision environments using the following methods:** * Amazon Web Services-managed provisioning: Proton makes direct calls to provision your resources. * Self-managed provisioning: Proton makes pull requests on your repository to provide compiled infrastructure as code (IaC) files that your IaC engine uses to provision resources. For more information, see Environments and Provisioning methods in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_environment( codebuildRoleArn='string', componentRoleArn='string', description='string', environmentAccountConnectionId='string', name='string', protonServiceRoleArn='string', provisioningRepository={ 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, spec='string', tags=[ { 'key': 'string', 'value': 'string' }, ], templateMajorVersion='string', templateMinorVersion='string', templateName='string' ) Parameters: * **codebuildRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild- based provisioning on your behalf. To use CodeBuild-based provisioning for the environment or for any service instance running in the environment, specify either the "environmentAccountConnectionId" or "codebuildRoleArn" parameter. * **componentRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. You must specify "componentRoleArn" to allow directly defined components to be associated with this environment. For more information about components, see Proton components in the *Proton User Guide*. * **description** (*string*) -- A description of the environment that's being created and deployed. * **environmentAccountConnectionId** (*string*) -- The ID of the environment account connection that you provide if you're provisioning your environment infrastructure resources to an environment account. For more information, see Environment account connections in the *Proton User guide*. To use Amazon Web Services-managed provisioning for the environment, specify either the "environmentAccountConnectionId" or "protonServiceRoleArn" parameter and omit the "provisioningRepository" parameter. * **name** (*string*) -- **[REQUIRED]** The name of the environment. * **protonServiceRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. To use Amazon Web Services-managed provisioning for the environment, specify either the "environmentAccountConnectionId" or "protonServiceRoleArn" parameter and omit the "provisioningRepository" parameter. * **provisioningRepository** (*dict*) -- The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. To use self-managed provisioning for the environment, specify this parameter and omit the "environmentAccountConnectionId" and "protonServiceRoleArn" parameters. * **branch** *(string) --* **[REQUIRED]** The repository branch. * **name** *(string) --* **[REQUIRED]** The repository name. * **provider** *(string) --* **[REQUIRED]** The repository provider. * **spec** (*string*) -- **[REQUIRED]** A YAML formatted string that provides inputs as defined in the environment template bundle schema file. For more information, see Environments in the *Proton User Guide*. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton environment. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateMajorVersion** (*string*) -- **[REQUIRED]** The major version of the environment template. * **templateMinorVersion** (*string*) -- The minor version of the environment template. * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. For more information, see Environment Templates in the *Proton User Guide*. Return type: dict Returns: **Response Syntax** { 'environment': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'provisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environment** *(dict) --* The environment detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that's used to provision infrastructure resources in an environment account. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **provisioningRepository** *(dict) --* The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **spec** *(string) --* The environment spec. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The Amazon Resource Name (ARN) of the environment template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_deployment delete_deployment ***************** Proton.Client.delete_deployment(**kwargs) Delete the deployment. See also: AWS API Documentation **Request Syntax** response = client.delete_deployment( id='string' ) Parameters: **id** (*string*) -- **[REQUIRED]** The ID of the deployment to delete. Return type: dict Returns: **Response Syntax** { 'deployment': { 'arn': 'string', 'completedAt': datetime(2015, 1, 1), 'componentName': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'id': 'string', 'initialState': { 'component': { 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string', 'templateFile': 'string' }, 'environment': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'serviceInstance': { 'lastSuccessfulComponentDeploymentIds': [ 'string', ], 'lastSuccessfulEnvironmentDeploymentId': 'string', 'lastSuccessfulServicePipelineDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'servicePipeline': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } }, 'lastAttemptedDeploymentId': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'targetArn': 'string', 'targetResourceCreatedAt': datetime(2015, 1, 1), 'targetResourceType': 'ENVIRONMENT'|'SERVICE_PIPELINE'|'SERVICE_INSTANCE'|'COMPONENT', 'targetState': { 'component': { 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string', 'templateFile': 'string' }, 'environment': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'serviceInstance': { 'lastSuccessfulComponentDeploymentIds': [ 'string', ], 'lastSuccessfulEnvironmentDeploymentId': 'string', 'lastSuccessfulServicePipelineDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'servicePipeline': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } } } **Response Structure** * *(dict) --* * **deployment** *(dict) --* The detailed data of the deployment being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the deployment. * **completedAt** *(datetime) --* The date and time the deployment was completed. * **componentName** *(string) --* The name of the component associated with this deployment. * **createdAt** *(datetime) --* The date and time the deployment was created. * **deploymentStatus** *(string) --* The status of the deployment. * **deploymentStatusMessage** *(string) --* The deployment status message. * **environmentName** *(string) --* The name of the environment associated with this deployment. * **id** *(string) --* The ID of the deployment. * **initialState** *(dict) --* The initial state of the target resource at the time of the deployment. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "component", "environment", "serviceInstance", "servicePipeline". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **component** *(dict) --* The state of the component associated with the deployment. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. * **templateFile** *(string) --* The template file used. * **environment** *(dict) --* The state of the environment associated with the deployment. * **spec** *(string) --* The environment spec that was used to create the environment. * **templateMajorVersion** *(string) --* The major version of the environment template that was used to create the environment. * **templateMinorVersion** *(string) --* The minor version of the environment template that was used to create the environment. * **templateName** *(string) --* The name of the environment template that was used to create the environment. * **serviceInstance** *(dict) --* The state of the service instance associated with the deployment. * **lastSuccessfulComponentDeploymentIds** *(list) --* The IDs for the last successful components deployed for this service instance. * *(string) --* * **lastSuccessfulEnvironmentDeploymentId** *(string) --* The ID for the last successful environment deployed for this service instance. * **lastSuccessfulServicePipelineDeploymentId** *(string) --* The ID for the last successful service pipeline deployed for this service instance. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service instance. * **servicePipeline** *(dict) --* The state of the service pipeline associated with the deployment. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment. * **lastModifiedAt** *(datetime) --* The date and time the deployment was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment. * **serviceInstanceName** *(string) --* The name of the deployment's service instance. * **serviceName** *(string) --* The name of the service in this deployment. * **targetArn** *(string) --* The Amazon Resource Name (ARN) of the target of the deployment. * **targetResourceCreatedAt** *(datetime) --* The date and time the depoyment target was created. * **targetResourceType** *(string) --* The resource type of the deployment target. It can be an environment, service, service instance, or component. * **targetState** *(dict) --* The target state of the target resource at the time of the deployment. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "component", "environment", "serviceInstance", "servicePipeline". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **component** *(dict) --* The state of the component associated with the deployment. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. * **templateFile** *(string) --* The template file used. * **environment** *(dict) --* The state of the environment associated with the deployment. * **spec** *(string) --* The environment spec that was used to create the environment. * **templateMajorVersion** *(string) --* The major version of the environment template that was used to create the environment. * **templateMinorVersion** *(string) --* The minor version of the environment template that was used to create the environment. * **templateName** *(string) --* The name of the environment template that was used to create the environment. * **serviceInstance** *(dict) --* The state of the service instance associated with the deployment. * **lastSuccessfulComponentDeploymentIds** *(list) --* The IDs for the last successful components deployed for this service instance. * *(string) --* * **lastSuccessfulEnvironmentDeploymentId** *(string) --* The ID for the last successful environment deployed for this service instance. * **lastSuccessfulServicePipelineDeploymentId** *(string) --* The ID for the last successful service pipeline deployed for this service instance. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service instance. * **servicePipeline** *(dict) --* The state of the service pipeline associated with the deployment. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service_template get_service_template ******************** Proton.Client.get_service_template(**kwargs) Get detailed data for a service template. See also: AWS API Documentation **Request Syntax** response = client.get_service_template( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the service template that you want to get detailed data for. Return type: dict Returns: **Response Syntax** { 'serviceTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplate** *(dict) --* The detailed data of the requested service template. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided service template encryption key that's used to encrypt data. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template. Otherwise, a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_service_template delete_service_template *********************** Proton.Client.delete_service_template(**kwargs) If no other major or minor versions of the service template exist, delete the service template. See also: AWS API Documentation **Request Syntax** response = client.delete_service_template( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the service template to delete. Return type: dict Returns: **Response Syntax** { 'serviceTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplate** *(dict) --* The detailed data of the service template being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided service template encryption key that's used to encrypt data. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template. Otherwise, a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service update_service ************** Proton.Client.update_service(**kwargs) Edit a service description or use a spec to add and delete service instances. Note: Existing service instances and the service pipeline *can't* be edited using this API. They can only be deleted. Use the "description" parameter to modify the description. Edit the "spec" parameter to add or delete instances. Note: You can't delete a service instance (remove it from the spec) if it has an attached component.For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.update_service( description='string', name='string', spec='string' ) Parameters: * **description** (*string*) -- The edited service description. * **name** (*string*) -- **[REQUIRED]** The name of the service to edit. * **spec** (*string*) -- Lists the service instances to add and the existing service instances to remain. Omit the existing service instances to delete from the list. *Don't* include edits to the existing service instances or pipeline. For more information, see Edit a service in the *Proton User Guide*. Return type: dict Returns: **Response Syntax** { 'service': { 'arn': 'string', 'branchName': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'repositoryConnectionArn': 'string', 'repositoryId': 'string', 'spec': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **service** *(dict) --* The service detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **branchName** *(string) --* The name of the code repository branch that holds the code that's deployed in Proton. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **pipeline** *(dict) --* The service pipeline detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **repositoryConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the *Proton User Guide*. * **repositoryId** *(string) --* The ID of the source code repository. * **spec** *(string) --* The formatted specification that defines the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_instance_provisioned_resources list_service_instance_provisioned_resources ******************************************* Proton.Client.list_service_instance_provisioned_resources(**kwargs) List provisioned resources for a service instance with details. See also: AWS API Documentation **Request Syntax** response = client.list_service_instance_provisioned_resources( nextToken='string', serviceInstanceName='string', serviceName='string' ) Parameters: * **nextToken** (*string*) -- A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested. * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance whose provisioned resources you want. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that "serviceInstanceName" is associated to. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources. * **provisionedResources** *(list) --* An array of provisioned resources for a service instance. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_repositories list_repositories ***************** Proton.Client.list_repositories(**kwargs) List linked repositories with detail data. See also: AWS API Documentation **Request Syntax** response = client.list_repositories( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of repositories to list. * **nextToken** (*string*) -- A token that indicates the location of the next repository in the array of repositories, after the list of repositories previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'repositories': [ { 'arn': 'string', 'connectionArn': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next repository in the array of repositories, after the current requested list of repositories. * **repositories** *(list) --* An array of repository links. * *(dict) --* Summary data of a linked repository—a repository that has been registered with Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **connectionArn** *(string) --* The Amazon Resource Name (ARN) of the of your connection that connects Proton to your repository. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environments list_environments ***************** Proton.Client.list_environments(**kwargs) List environments with detail data summaries. See also: AWS API Documentation **Request Syntax** response = client.list_environments( environmentTemplates=[ { 'majorVersion': 'string', 'templateName': 'string' }, ], maxResults=123, nextToken='string' ) Parameters: * **environmentTemplates** (*list*) -- An array of the versions of the environment template. * *(dict) --* A search filter for environment templates. * **majorVersion** *(string) --* **[REQUIRED]** Include "majorVersion" to filter search for a major version. * **templateName** *(string) --* **[REQUIRED]** Include "templateName" to filter search for a template name. * **maxResults** (*integer*) -- The maximum number of environments to list. * **nextToken** (*string*) -- A token that indicates the location of the next environment in the array of environments, after the list of environments that was previously requested. Return type: dict Returns: **Response Syntax** { 'environments': [ { 'arn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **environments** *(list) --* An array of environment detail data summaries. * *(dict) --* Summary data of an Proton environment resource. An Proton environment is a set of resources shared across Proton services. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that the environment is associated with. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The name of the environment template. * **nextToken** *(string) --* A token that indicates the location of the next environment in the array of environments, after the current requested list of environments. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_account_settings get_account_settings ******************** Proton.Client.get_account_settings() Get detail data for Proton account-wide settings. See also: AWS API Documentation **Request Syntax** response = client.get_account_settings() Return type: dict Returns: **Response Syntax** { 'accountSettings': { 'pipelineCodebuildRoleArn': 'string', 'pipelineProvisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'pipelineServiceRoleArn': 'string' } } **Response Structure** * *(dict) --* * **accountSettings** *(dict) --* The Proton pipeline service role detail data that's returned by Proton. * **pipelineCodebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the service role that Proton uses for provisioning pipelines. Proton assumes this role for CodeBuild-based provisioning. * **pipelineProvisioningRepository** *(dict) --* The linked repository for pipeline provisioning. Required if you have environments configured for self-managed provisioning with services that include pipelines. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **pipelineServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_repository delete_repository ***************** Proton.Client.delete_repository(**kwargs) De-register and unlink your repository. See also: AWS API Documentation **Request Syntax** response = client.delete_repository( name='string', provider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The repository name. * **provider** (*string*) -- **[REQUIRED]** The repository provider. Return type: dict Returns: **Response Syntax** { 'repository': { 'arn': 'string', 'connectionArn': 'string', 'encryptionKey': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' } } **Response Structure** * *(dict) --* * **repository** *(dict) --* The deleted repository link's detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **connectionArn** *(string) --* The Amazon Resource Name (ARN) of your AWS CodeStar connection that connects Proton to your repository provider account. * **encryptionKey** *(string) --* Your customer Amazon Web Services KMS encryption key. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_sync_blocker update_service_sync_blocker *************************** Proton.Client.update_service_sync_blocker(**kwargs) Update the service sync blocker by resolving it. See also: AWS API Documentation **Request Syntax** response = client.update_service_sync_blocker( id='string', resolvedReason='string' ) Parameters: * **id** (*string*) -- **[REQUIRED]** The ID of the service sync blocker. * **resolvedReason** (*string*) -- **[REQUIRED]** The reason the service sync blocker was resolved. Return type: dict Returns: **Response Syntax** { 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSyncBlocker': { 'contexts': [ { 'key': 'string', 'value': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'createdReason': 'string', 'id': 'string', 'resolvedAt': datetime(2015, 1, 1), 'resolvedReason': 'string', 'status': 'ACTIVE'|'RESOLVED', 'type': 'AUTOMATED' } } **Response Structure** * *(dict) --* * **serviceInstanceName** *(string) --* The name of the service instance that you want to update the service sync blocker for. * **serviceName** *(string) --* The name of the service that you want to update the service sync blocker for. * **serviceSyncBlocker** *(dict) --* The detailed data on the service sync blocker that was updated. * **contexts** *(list) --* The contexts for the sync blocker. * *(dict) --* Detailed data of the context of the sync blocker. * **key** *(string) --* The key for the sync blocker context. * **value** *(string) --* The value of the sync blocker context. * **createdAt** *(datetime) --* The time when the sync blocker was created. * **createdReason** *(string) --* The reason why the sync blocker was created. * **id** *(string) --* The ID of the sync blocker. * **resolvedAt** *(datetime) --* The time the sync blocker was resolved. * **resolvedReason** *(string) --* The reason the sync blocker was resolved. * **status** *(string) --* The status of the sync blocker. * **type** *(string) --* The type of the sync blocker. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_pipeline update_service_pipeline *********************** Proton.Client.update_service_pipeline(**kwargs) Update the service pipeline. There are four modes for updating a service pipeline. The "deploymentType" field defines the mode. "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. "CURRENT_VERSION" In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. *Don’t* include major or minor version parameters when you use this "deployment-type". "MINOR_VERSION" In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can specify a different minor version of the current major version in use. "MAJOR_VERSION" In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template by default. You can specify a different major version that's higher than the major version in use and a minor version. See also: AWS API Documentation **Request Syntax** response = client.update_service_pipeline( deploymentType='NONE'|'CURRENT_VERSION'|'MINOR_VERSION'|'MAJOR_VERSION', serviceName='string', spec='string', templateMajorVersion='string', templateMinorVersion='string' ) Parameters: * **deploymentType** (*string*) -- **[REQUIRED]** The deployment type. There are four modes for updating a service pipeline. The "deploymentType" field defines the mode. "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. "CURRENT_VERSION" In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. *Don’t* include major or minor version parameters when you use this "deployment-type". "MINOR_VERSION" In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can specify a different minor version of the current major version in use. "MAJOR_VERSION" In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can specify a different major version that's higher than the major version in use and a minor version. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service to that the pipeline is associated with. * **spec** (*string*) -- **[REQUIRED]** The spec for the service pipeline to update. * **templateMajorVersion** (*string*) -- The major version of the service template that was used to create the service that the pipeline is associated with. * **templateMinorVersion** (*string*) -- The minor version of the service template that was used to create the service that the pipeline is associated with. Return type: dict Returns: **Response Syntax** { 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **pipeline** *(dict) --* The pipeline details that are returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service_template_version get_service_template_version **************************** Proton.Client.get_service_template_version(**kwargs) Get detailed data for a major or minor version of a service template. See also: AWS API Documentation **Request Syntax** response = client.get_service_template_version( majorVersion='string', minorVersion='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** To get service template major version detail data, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To get service template minor version detail data, include "minorVersion". * **templateName** (*string*) -- **[REQUIRED]** The name of the service template a version of which you want to get detailed data for. Return type: dict Returns: **Response Syntax** { 'serviceTemplateVersion': { 'arn': 'string', 'compatibleEnvironmentTemplates': [ { 'majorVersion': 'string', 'templateName': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'supportedComponentSources': [ 'DIRECTLY_DEFINED', ], 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplateVersion** *(dict) --* The detailed data of the requested service template version. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **compatibleEnvironmentTemplates** *(list) --* An array of compatible environment template names for the major version of a service template. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* The major version of the compatible environment template. * **templateName** *(string) --* The compatible environment template name. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **schema** *(string) --* The schema of the version of a service template. * **status** *(string) --* The service template version status. * **statusMessage** *(string) --* A service template version status message. * **supportedComponentSources** *(list) --* An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **templateName** *(string) --* The name of the version of a service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_environment_template_version get_environment_template_version ******************************** Proton.Client.get_environment_template_version(**kwargs) Get detailed data for a major or minor version of an environment template. See also: AWS API Documentation **Request Syntax** response = client.get_environment_template_version( majorVersion='string', minorVersion='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** To get environment template major version detail data, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To get environment template minor version detail data, include "minorVersion". * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template a version of which you want to get detailed data for. Return type: dict Returns: **Response Syntax** { 'environmentTemplateVersion': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplateVersion** *(dict) --* The detailed data of the requested environment template version. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the minor version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The minor version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **schema** *(string) --* The schema of the version of an environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the version of an environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_services list_services ************* Proton.Client.list_services(**kwargs) List services with summaries of detail data. See also: AWS API Documentation **Request Syntax** response = client.list_services( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of services to list. * **nextToken** (*string*) -- A token that indicates the location of the next service in the array of services, after the list of services that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'services': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next service in the array of services, after the current requested list of services. * **services** *(list) --* An array of services with summaries of detail data. * *(dict) --* Summary data of an Proton service resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / cancel_component_deployment cancel_component_deployment *************************** Proton.Client.cancel_component_deployment(**kwargs) Attempts to cancel a component deployment (for a component that is in the "IN_PROGRESS" deployment status). For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.cancel_component_deployment( componentName='string' ) Parameters: **componentName** (*string*) -- **[REQUIRED]** The name of the component with the deployment to cancel. Return type: dict Returns: **Response Syntax** { 'component': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string' } } **Response Structure** * *(dict) --* * **component** *(dict) --* The detailed data of the component with the deployment that is being canceled. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **description** *(string) --* A description of the component. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastClientRequestToken** *(string) --* The last token the client requested. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_template_versions list_service_template_versions ****************************** Proton.Client.list_service_template_versions(**kwargs) List major or minor versions of a service template with detail data. See also: AWS API Documentation **Request Syntax** response = client.list_service_template_versions( majorVersion='string', maxResults=123, nextToken='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- To view a list of minor of versions under a major version of a service template, include "major Version". To view a list of major versions of a service template, *exclude* "major Version". * **maxResults** (*integer*) -- The maximum number of major or minor versions of a service template to list. * **nextToken** (*string*) -- A token that indicates the location of the next major or minor version in the array of major or minor versions of a service template, after the list of major or minor versions that was previously requested. * **templateName** (*string*) -- **[REQUIRED]** The name of the service template. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'templateVersions': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next major or minor version in the array of major or minor versions of a service template, after the current requested list of service major or minor versions. * **templateVersions** *(list) --* An array of major or minor versions of a service template with detail data. * *(dict) --* Summary data of an Proton service template version resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **status** *(string) --* The service template minor version status. * **statusMessage** *(string) --* A service template minor version status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_service delete_service ************** Proton.Client.delete_service(**kwargs) Delete a service, with its instances and pipeline. Note: You can't delete a service if it has any service instances that have components attached to them.For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.delete_service( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the service to delete. Return type: dict Returns: **Response Syntax** { 'service': { 'arn': 'string', 'branchName': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'repositoryConnectionArn': 'string', 'repositoryId': 'string', 'spec': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **service** *(dict) --* The detailed data of the service being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **branchName** *(string) --* The name of the code repository branch that holds the code that's deployed in Proton. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **pipeline** *(dict) --* The service pipeline detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **repositoryConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the *Proton User Guide*. * **repositoryId** *(string) --* The ID of the source code repository. * **spec** *(string) --* The formatted specification that defines the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_account_settings update_account_settings *********************** Proton.Client.update_account_settings(**kwargs) Update Proton settings that are used for multiple services in the Amazon Web Services account. See also: AWS API Documentation **Request Syntax** response = client.update_account_settings( deletePipelineProvisioningRepository=True|False, pipelineCodebuildRoleArn='string', pipelineProvisioningRepository={ 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, pipelineServiceRoleArn='string' ) Parameters: * **deletePipelineProvisioningRepository** (*boolean*) -- Set to "true" to remove a configured pipeline repository from the account settings. Don't set this field if you are updating the configured pipeline repository. * **pipelineCodebuildRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Proton assumes this role for CodeBuild-based provisioning. * **pipelineProvisioningRepository** (*dict*) -- A linked repository for pipeline provisioning. Specify it if you have environments configured for self-managed provisioning with services that include pipelines. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. To remove a previously configured repository, set "deletePipelineProvisioningRepository" to "true", and don't set "pipelineProvisioningRepository". * **branch** *(string) --* **[REQUIRED]** The repository branch. * **name** *(string) --* **[REQUIRED]** The repository name. * **provider** *(string) --* **[REQUIRED]** The repository provider. * **pipelineServiceRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning. To remove a previously configured ARN, specify an empty string. Return type: dict Returns: **Response Syntax** { 'accountSettings': { 'pipelineCodebuildRoleArn': 'string', 'pipelineProvisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'pipelineServiceRoleArn': 'string' } } **Response Structure** * *(dict) --* * **accountSettings** *(dict) --* The Proton pipeline service role and repository data shared across the Amazon Web Services account. * **pipelineCodebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the service role that Proton uses for provisioning pipelines. Proton assumes this role for CodeBuild-based provisioning. * **pipelineProvisioningRepository** *(dict) --* The linked repository for pipeline provisioning. Required if you have environments configured for self-managed provisioning with services that include pipelines. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **pipelineServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_service_template_version delete_service_template_version ******************************* Proton.Client.delete_service_template_version(**kwargs) If no other minor versions of a service template exist, delete a major version of the service template if it's not the "Recommended" version. Delete the "Recommended" version of the service template if no other major versions or minor versions of the service template exist. A major version of a service template is a version that *isn't* backwards compatible. Delete a minor version of a service template if it's not the "Recommended" version. Delete a "Recommended" minor version of the service template if no other minor versions of the service template exist. A minor version of a service template is a version that's backwards compatible. See also: AWS API Documentation **Request Syntax** response = client.delete_service_template_version( majorVersion='string', minorVersion='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** The service template major version to delete. * **minorVersion** (*string*) -- **[REQUIRED]** The service template minor version to delete. * **templateName** (*string*) -- **[REQUIRED]** The name of the service template. Return type: dict Returns: **Response Syntax** { 'serviceTemplateVersion': { 'arn': 'string', 'compatibleEnvironmentTemplates': [ { 'majorVersion': 'string', 'templateName': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'supportedComponentSources': [ 'DIRECTLY_DEFINED', ], 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplateVersion** *(dict) --* The detailed data of the service template version being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **compatibleEnvironmentTemplates** *(list) --* An array of compatible environment template names for the major version of a service template. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* The major version of the compatible environment template. * **templateName** *(string) --* The compatible environment template name. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **schema** *(string) --* The schema of the version of a service template. * **status** *(string) --* The service template version status. * **statusMessage** *(string) --* A service template version status message. * **supportedComponentSources** *(list) --* An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **templateName** *(string) --* The name of the version of a service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_tags_for_resource list_tags_for_resource ********************** Proton.Client.list_tags_for_resource(**kwargs) List tags for a resource. For more information, see Proton resources and tagging in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.list_tags_for_resource( maxResults=123, nextToken='string', resourceArn='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of tags to list. * **nextToken** (*string*) -- A token that indicates the location of the next resource tag in the array of resource tags, after the list of resource tags that was previously requested. * **resourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource for the listed tags. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'tags': [ { 'key': 'string', 'value': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next resource tag in the array of resource tags, after the current requested list of resource tags. * **tags** *(list) --* A list of resource tags with detail data. * *(dict) --* A description of a resource tag. * **key** *(string) --* The key of the resource tag. * **value** *(string) --* The value of the resource tag. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service_sync_config get_service_sync_config *********************** Proton.Client.get_service_sync_config(**kwargs) Get detailed information for the service sync configuration. See also: AWS API Documentation **Request Syntax** response = client.get_service_sync_config( serviceName='string' ) Parameters: **serviceName** (*string*) -- **[REQUIRED]** The name of the service that you want to get the service sync configuration for. Return type: dict Returns: **Response Syntax** { 'serviceSyncConfig': { 'branch': 'string', 'filePath': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'serviceName': 'string' } } **Response Structure** * *(dict) --* * **serviceSyncConfig** *(dict) --* The detailed data of the requested service sync configuration. * **branch** *(string) --* The name of the code repository branch that holds the service code Proton will sync with. * **filePath** *(string) --* The file path to the service sync configuration file. * **repositoryName** *(string) --* The name of the code repository that holds the service code Proton will sync with. * **repositoryProvider** *(string) --* The name of the repository provider that holds the repository Proton will sync with. * **serviceName** *(string) --* The name of the service that the service instance is added to. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_service create_service ************** Proton.Client.create_service(**kwargs) Create an Proton service. An Proton service is an instantiation of a service template and often includes several service instances and pipeline. For more information, see Services in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_service( branchName='string', description='string', name='string', repositoryConnectionArn='string', repositoryId='string', spec='string', tags=[ { 'key': 'string', 'value': 'string' }, ], templateMajorVersion='string', templateMinorVersion='string', templateName='string' ) Parameters: * **branchName** (*string*) -- The name of the code repository branch that holds the code that's deployed in Proton. *Don't* include this parameter if your service template *doesn't* include a service pipeline. * **description** (*string*) -- A description of the Proton service. * **name** (*string*) -- **[REQUIRED]** The service name. * **repositoryConnectionArn** (*string*) -- The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the *Proton User Guide*. *Don't* include this parameter if your service template *doesn't* include a service pipeline. * **repositoryId** (*string*) -- The ID of the code repository. *Don't* include this parameter if your service template *doesn't* include a service pipeline. * **spec** (*string*) -- **[REQUIRED]** A link to a spec file that provides inputs as defined in the service template bundle schema file. The spec file is in YAML format. *Don’t* include pipeline inputs in the spec if your service template *doesn’t* include a service pipeline. For more information, see Create a service in the *Proton User Guide*. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton service. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateMajorVersion** (*string*) -- **[REQUIRED]** The major version of the service template that was used to create the service. * **templateMinorVersion** (*string*) -- The minor version of the service template that was used to create the service. * **templateName** (*string*) -- **[REQUIRED]** The name of the service template that's used to create the service. Return type: dict Returns: **Response Syntax** { 'service': { 'arn': 'string', 'branchName': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'repositoryConnectionArn': 'string', 'repositoryId': 'string', 'spec': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **service** *(dict) --* The service detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **branchName** *(string) --* The name of the code repository branch that holds the code that's deployed in Proton. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **pipeline** *(dict) --* The service pipeline detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **repositoryConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the *Proton User Guide*. * **repositoryId** *(string) --* The ID of the source code repository. * **spec** *(string) --* The formatted specification that defines the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_environment_template_version create_environment_template_version *********************************** Proton.Client.create_environment_template_version(**kwargs) Create a new major or minor version of an environment template. A major version of an environment template is a version that *isn't* backwards compatible. A minor version of an environment template is a version that's backwards compatible within its major version. See also: AWS API Documentation **Request Syntax** response = client.create_environment_template_version( clientToken='string', description='string', majorVersion='string', source={ 's3': { 'bucket': 'string', 'key': 'string' } }, tags=[ { 'key': 'string', 'value': 'string' }, ], templateName='string' ) Parameters: * **clientToken** (*string*) -- When included, if two identical requests are made with the same client token, Proton returns the environment template version that the first request created. This field is autopopulated if not provided. * **description** (*string*) -- A description of the new version of an environment template. * **majorVersion** (*string*) -- To create a new minor version of the environment template, include "major Version". To create a new major and minor version of the environment template, exclude "major Version". * **source** (*dict*) -- **[REQUIRED]** An object that includes the template bundle S3 bucket path and name for the new version of an template. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3". * **s3** *(dict) --* An S3 source object that includes the template bundle S3 path and name for a template minor version. * **bucket** *(string) --* **[REQUIRED]** The name of the S3 bucket that contains a template bundle. * **key** *(string) --* **[REQUIRED]** The path to the S3 bucket that contains a template bundle. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton environment template version. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. Return type: dict Returns: **Response Syntax** { 'environmentTemplateVersion': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplateVersion** *(dict) --* The environment template detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the minor version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The minor version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **schema** *(string) --* The schema of the version of an environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the version of an environment template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_template_sync_config get_template_sync_config ************************ Proton.Client.get_template_sync_config(**kwargs) Get detail data for a template sync configuration. See also: AWS API Documentation **Request Syntax** response = client.get_template_sync_config( templateName='string', templateType='ENVIRONMENT'|'SERVICE' ) Parameters: * **templateName** (*string*) -- **[REQUIRED]** The template name. * **templateType** (*string*) -- **[REQUIRED]** The template type. Return type: dict Returns: **Response Syntax** { 'templateSyncConfig': { 'branch': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'subdirectory': 'string', 'templateName': 'string', 'templateType': 'ENVIRONMENT'|'SERVICE' } } **Response Structure** * *(dict) --* * **templateSyncConfig** *(dict) --* The template sync configuration detail data that's returned by Proton. * **branch** *(string) --* The repository branch. * **repositoryName** *(string) --* The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** *(string) --* The repository provider. * **subdirectory** *(string) --* A subdirectory path to your template bundle version. * **templateName** *(string) --* The template name. * **templateType** *(string) --* The template type. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_environment update_environment ****************** Proton.Client.update_environment(**kwargs) Update an environment. If the environment is associated with an environment account connection, *don't* update or include the "protonServiceRoleArn" and "provisioningRepository" parameter to update or connect to an environment account connection. You can only update to a new environment account connection if that connection was created in the same environment account that the current environment account connection was created in. The account connection must also be associated with the current environment. If the environment *isn't* associated with an environment account connection, *don't* update or include the "environmentAccountConnectionId" parameter. You *can't* update or connect the environment to an environment account connection if it *isn't* already associated with an environment connection. You can update either the "environmentAccountConnectionId" or "protonServiceRoleArn" parameter and value. You can’t update both. If the environment was configured for Amazon Web Services-managed provisioning, omit the "provisioningRepository" parameter. If the environment was configured for self-managed provisioning, specify the "provisioningRepository" parameter and omit the "protonServiceRoleArn" and "environmentAccountConnectionId" parameters. For more information, see Environments and Provisioning methods in the *Proton User Guide*. There are four modes for updating an environment. The "deploymentType" field defines the mode. "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. "CURRENT_VERSION" In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. *Don’t* include minor or major version parameters when you use this "deployment-type". "MINOR_VERSION" In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use. "MAJOR_VERSION" In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that's higher than the major version in use and a minor version. See also: AWS API Documentation **Request Syntax** response = client.update_environment( codebuildRoleArn='string', componentRoleArn='string', deploymentType='NONE'|'CURRENT_VERSION'|'MINOR_VERSION'|'MAJOR_VERSION', description='string', environmentAccountConnectionId='string', name='string', protonServiceRoleArn='string', provisioningRepository={ 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, spec='string', templateMajorVersion='string', templateMinorVersion='string' ) Parameters: * **codebuildRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **deploymentType** (*string*) -- **[REQUIRED]** There are four modes for updating an environment. The "deploymentType" field defines the mode. "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. "CURRENT_VERSION" In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. *Don’t* include major or minor version parameters when you use this "deployment-type". "MINOR_VERSION" In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use. "MAJOR_VERSION" In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional). * **description** (*string*) -- A description of the environment update. * **environmentAccountConnectionId** (*string*) -- The ID of the environment account connection. You can only update to a new environment account connection if it was created in the same environment account that the current environment account connection was created in and is associated with the current environment. * **name** (*string*) -- **[REQUIRED]** The name of the environment to update. * **protonServiceRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make API calls to other services your behalf. * **provisioningRepository** (*dict*) -- The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **branch** *(string) --* **[REQUIRED]** The repository branch. * **name** *(string) --* **[REQUIRED]** The repository name. * **provider** *(string) --* **[REQUIRED]** The repository provider. * **spec** (*string*) -- The formatted specification that defines the update. * **templateMajorVersion** (*string*) -- The major version of the environment to update. * **templateMinorVersion** (*string*) -- The minor version of the environment to update. Return type: dict Returns: **Response Syntax** { 'environment': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'provisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environment** *(dict) --* The environment detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that's used to provision infrastructure resources in an environment account. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **provisioningRepository** *(dict) --* The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **spec** *(string) --* The environment spec. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The Amazon Resource Name (ARN) of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_service_template create_service_template *********************** Proton.Client.create_service_template(**kwargs) Create a service template. The administrator creates a service template to define standardized infrastructure and an optional CI/CD service pipeline. Developers, in turn, select the service template from Proton. If the selected service template includes a service pipeline definition, they provide a link to their source code repository. Proton then deploys and manages the infrastructure defined by the selected service template. For more information, see Proton templates in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_service_template( description='string', displayName='string', encryptionKey='string', name='string', pipelineProvisioning='CUSTOMER_MANAGED', tags=[ { 'key': 'string', 'value': 'string' }, ] ) Parameters: * **description** (*string*) -- A description of the service template. * **displayName** (*string*) -- The name of the service template as displayed in the developer interface. * **encryptionKey** (*string*) -- A customer provided encryption key that's used to encrypt data. * **name** (*string*) -- **[REQUIRED]** The name of the service template. * **pipelineProvisioning** (*string*) -- By default, Proton provides a service pipeline for your service. When this parameter is included, it indicates that an Proton service pipeline *isn't* provided for your service. After it's included, it *can't* be changed. For more information, see Template bundles in the *Proton User Guide*. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton service template. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. Return type: dict Returns: **Response Syntax** { 'serviceTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplate** *(dict) --* The service template detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided service template encryption key that's used to encrypt data. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template. Otherwise, a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_template_version update_service_template_version ******************************* Proton.Client.update_service_template_version(**kwargs) Update a major or minor version of a service template. See also: AWS API Documentation **Request Syntax** response = client.update_service_template_version( compatibleEnvironmentTemplates=[ { 'majorVersion': 'string', 'templateName': 'string' }, ], description='string', majorVersion='string', minorVersion='string', status='REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', supportedComponentSources=[ 'DIRECTLY_DEFINED', ], templateName='string' ) Parameters: * **compatibleEnvironmentTemplates** (*list*) -- An array of environment template objects that are compatible with this service template version. A service instance based on this service template version can run in environments based on compatible templates. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* **[REQUIRED]** The major version of the compatible environment template. * **templateName** *(string) --* **[REQUIRED]** The compatible environment template name. * **description** (*string*) -- A description of a service template version to update. * **majorVersion** (*string*) -- **[REQUIRED]** To update a major version of a service template, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To update a minor version of a service template, include "minorVersion". * **status** (*string*) -- The status of the service template minor version to update. * **supportedComponentSources** (*list*) -- An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. Note: A change to "supportedComponentSources" doesn't impact existing component attachments to instances based on this template version. A change only affects later associations. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **templateName** (*string*) -- **[REQUIRED]** The name of the service template. Return type: dict Returns: **Response Syntax** { 'serviceTemplateVersion': { 'arn': 'string', 'compatibleEnvironmentTemplates': [ { 'majorVersion': 'string', 'templateName': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'supportedComponentSources': [ 'DIRECTLY_DEFINED', ], 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplateVersion** *(dict) --* The service template version detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **compatibleEnvironmentTemplates** *(list) --* An array of compatible environment template names for the major version of a service template. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* The major version of the compatible environment template. * **templateName** *(string) --* The compatible environment template name. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **schema** *(string) --* The schema of the version of a service template. * **status** *(string) --* The service template version status. * **statusMessage** *(string) --* A service template version status message. * **supportedComponentSources** *(list) --* An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **templateName** *(string) --* The name of the version of a service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_template update_service_template *********************** Proton.Client.update_service_template(**kwargs) Update a service template. See also: AWS API Documentation **Request Syntax** response = client.update_service_template( description='string', displayName='string', name='string' ) Parameters: * **description** (*string*) -- A description of the service template update. * **displayName** (*string*) -- The name of the service template to update that's displayed in the developer interface. * **name** (*string*) -- **[REQUIRED]** The name of the service template to update. Return type: dict Returns: **Response Syntax** { 'serviceTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplate** *(dict) --* The service template detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided service template encryption key that's used to encrypt data. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template. Otherwise, a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / untag_resource untag_resource ************** Proton.Client.untag_resource(**kwargs) Remove a customer tag from a resource. A tag is a key-value pair of metadata associated with an Proton resource. For more information, see Proton resources and tagging in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.untag_resource( resourceArn='string', tagKeys=[ 'string', ] ) Parameters: * **resourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the resource to remove customer tags from. * **tagKeys** (*list*) -- **[REQUIRED]** A list of customer tag keys that indicate the customer tags to be removed from the resource. * *(string) --* Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service_sync_blocker_summary get_service_sync_blocker_summary ******************************** Proton.Client.get_service_sync_blocker_summary(**kwargs) Get detailed data for the service sync blocker summary. See also: AWS API Documentation **Request Syntax** response = client.get_service_sync_blocker_summary( serviceInstanceName='string', serviceName='string' ) Parameters: * **serviceInstanceName** (*string*) -- The name of the service instance that you want to get the service sync blocker summary for. If given bothe the instance name and the service name, only the instance is blocked. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that you want to get the service sync blocker summary for. If given only the service name, all instances are blocked. Return type: dict Returns: **Response Syntax** { 'serviceSyncBlockerSummary': { 'latestBlockers': [ { 'contexts': [ { 'key': 'string', 'value': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'createdReason': 'string', 'id': 'string', 'resolvedAt': datetime(2015, 1, 1), 'resolvedReason': 'string', 'status': 'ACTIVE'|'RESOLVED', 'type': 'AUTOMATED' }, ], 'serviceInstanceName': 'string', 'serviceName': 'string' } } **Response Structure** * *(dict) --* * **serviceSyncBlockerSummary** *(dict) --* The detailed data of the requested service sync blocker summary. * **latestBlockers** *(list) --* The latest active blockers for the synced service. * *(dict) --* Detailed data of the sync blocker. * **contexts** *(list) --* The contexts for the sync blocker. * *(dict) --* Detailed data of the context of the sync blocker. * **key** *(string) --* The key for the sync blocker context. * **value** *(string) --* The value of the sync blocker context. * **createdAt** *(datetime) --* The time when the sync blocker was created. * **createdReason** *(string) --* The reason why the sync blocker was created. * **id** *(string) --* The ID of the sync blocker. * **resolvedAt** *(datetime) --* The time the sync blocker was resolved. * **resolvedReason** *(string) --* The reason the sync blocker was resolved. * **status** *(string) --* The status of the sync blocker. * **type** *(string) --* The type of the sync blocker. * **serviceInstanceName** *(string) --* The name of the service instance that you want sync your service configuration with. * **serviceName** *(string) --* The name of the service that you want to get the sync blocker summary for. If given a service instance name and a service name, it will return the blockers only applying to the instance that is blocked. If given only a service name, it will return the blockers that apply to all of the instances. In order to get the blockers for a single instance, you will need to make two distinct calls, one to get the sync blocker summary for the service and the other to get the sync blocker for the service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_waiter get_waiter ********** Proton.Client.get_waiter(waiter_name) Returns an object that can wait for some condition. Parameters: **waiter_name** (*str*) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters. Returns: The specified waiter object. Return type: "botocore.waiter.Waiter" Proton / Client / get_service_instance_sync_status get_service_instance_sync_status ******************************** Proton.Client.get_service_instance_sync_status(**kwargs) Get the status of the synced service instance. See also: AWS API Documentation **Request Syntax** response = client.get_service_instance_sync_status( serviceInstanceName='string', serviceName='string' ) Parameters: * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance that you want the sync status input for. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that the service instance belongs to. Return type: dict Returns: **Response Syntax** { 'desiredState': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'latestSuccessfulSync': { 'events': [ { 'event': 'string', 'externalId': 'string', 'time': datetime(2015, 1, 1), 'type': 'string' }, ], 'initialRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'startedAt': datetime(2015, 1, 1), 'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'target': 'string', 'targetRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' } }, 'latestSync': { 'events': [ { 'event': 'string', 'externalId': 'string', 'time': datetime(2015, 1, 1), 'type': 'string' }, ], 'initialRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'startedAt': datetime(2015, 1, 1), 'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'target': 'string', 'targetRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' } } } **Response Structure** * *(dict) --* * **desiredState** *(dict) --* The service instance sync desired state that's returned by Proton * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **latestSuccessfulSync** *(dict) --* The detailed data of the latest successful sync with the service instance. * **events** *(list) --* An array of events with detail data. * *(dict) --* Detail data for a resource sync event. * **event** *(string) --* A resource sync event. * **externalId** *(string) --* The external ID for the event. * **time** *(datetime) --* The time when the event occurred. * **type** *(string) --* The type of event. * **initialRevision** *(dict) --* Detail data for the initial repository commit, path and push. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **startedAt** *(datetime) --* The time when the sync attempt started. * **status** *(string) --* The status of the sync attempt. * **target** *(string) --* The resource that is synced to. * **targetRevision** *(dict) --* Detail data for the target revision. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **latestSync** *(dict) --* The detailed data of the latest sync with the service instance. * **events** *(list) --* An array of events with detail data. * *(dict) --* Detail data for a resource sync event. * **event** *(string) --* A resource sync event. * **externalId** *(string) --* The external ID for the event. * **time** *(datetime) --* The time when the event occurred. * **type** *(string) --* The type of event. * **initialRevision** *(dict) --* Detail data for the initial repository commit, path and push. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **startedAt** *(datetime) --* The time when the sync attempt started. * **status** *(string) --* The status of the sync attempt. * **target** *(string) --* The resource that is synced to. * **targetRevision** *(dict) --* Detail data for the target revision. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / notify_resource_deployment_status_change notify_resource_deployment_status_change **************************************** Proton.Client.notify_resource_deployment_status_change(**kwargs) Notify Proton of status changes to a provisioned resource when you use self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.notify_resource_deployment_status_change( deploymentId='string', outputs=[ { 'key': 'string', 'valueString': 'string' }, ], resourceArn='string', status='IN_PROGRESS'|'FAILED'|'SUCCEEDED', statusMessage='string' ) Parameters: * **deploymentId** (*string*) -- The deployment ID for your provisioned resource. * **outputs** (*list*) -- The provisioned resource state change detail data that's returned by Proton. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. * **resourceArn** (*string*) -- **[REQUIRED]** The provisioned resource Amazon Resource Name (ARN). * **status** (*string*) -- The status of your provisioned resource. * **statusMessage** (*string*) -- The deployment status message for your provisioned resource. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_component create_component **************** Proton.Client.create_component(**kwargs) Create an Proton component. A component is an infrastructure extension for a service instance. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_component( clientToken='string', description='string', environmentName='string', manifest='string', name='string', serviceInstanceName='string', serviceName='string', serviceSpec='string', tags=[ { 'key': 'string', 'value': 'string' }, ], templateFile='string' ) Parameters: * **clientToken** (*string*) -- The client token for the created component. This field is autopopulated if not provided. * **description** (*string*) -- An optional customer-provided description of the component. * **environmentName** (*string*) -- The name of the Proton environment that you want to associate this component with. You must specify this when you don't specify "serviceInstanceName" and "serviceName". * **manifest** (*string*) -- **[REQUIRED]** A path to a manifest file that lists the Infrastructure as Code (IaC) file, template language, and rendering engine for infrastructure that a custom component provisions. * **name** (*string*) -- **[REQUIRED]** The customer-provided name of the component. * **serviceInstanceName** (*string*) -- The name of the service instance that you want to attach this component to. If you don't specify this, the component isn't attached to any service instance. Specify both "serviceInstanceName" and "serviceName" or neither of them. * **serviceName** (*string*) -- The name of the service that "serviceInstanceName" is associated with. If you don't specify this, the component isn't attached to any service instance. Specify both "serviceInstanceName" and "serviceName" or neither of them. * **serviceSpec** (*string*) -- The service spec that you want the component to use to access service inputs. Set this only when you attach the component to a service instance. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton component. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateFile** (*string*) -- **[REQUIRED]** A path to the Infrastructure as Code (IaC) file describing infrastructure that a custom component provisions. Note: Components support a single IaC file, even if you use Terraform as your template language. Return type: dict Returns: **Response Syntax** { 'component': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string' } } **Response Structure** * *(dict) --* * **component** *(dict) --* The detailed data of the created component. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **description** *(string) --* A description of the component. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastClientRequestToken** *(string) --* The last token the client requested. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_environment_account_connection update_environment_account_connection ************************************* Proton.Client.update_environment_account_connection(**kwargs) In an environment account, update an environment account connection to use a new IAM role. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.update_environment_account_connection( codebuildRoleArn='string', componentRoleArn='string', id='string', roleArn='string' ) Parameters: * **codebuildRoleArn** (*string*) -- The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **id** (*string*) -- **[REQUIRED]** The ID of the environment account connection to update. * **roleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that's associated with the environment account connection to update. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The environment account connection detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_service_sync_config delete_service_sync_config ************************** Proton.Client.delete_service_sync_config(**kwargs) Delete the Proton Ops file. See also: AWS API Documentation **Request Syntax** response = client.delete_service_sync_config( serviceName='string' ) Parameters: **serviceName** (*string*) -- **[REQUIRED]** The name of the service that you want to delete the service sync configuration for. Return type: dict Returns: **Response Syntax** { 'serviceSyncConfig': { 'branch': 'string', 'filePath': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'serviceName': 'string' } } **Response Structure** * *(dict) --* * **serviceSyncConfig** *(dict) --* The detailed data for the service sync config. * **branch** *(string) --* The name of the code repository branch that holds the service code Proton will sync with. * **filePath** *(string) --* The file path to the service sync configuration file. * **repositoryName** *(string) --* The name of the code repository that holds the service code Proton will sync with. * **repositoryProvider** *(string) --* The name of the repository provider that holds the repository Proton will sync with. * **serviceName** *(string) --* The name of the service that the service instance is added to. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_repository_sync_status get_repository_sync_status ************************** Proton.Client.get_repository_sync_status(**kwargs) Get the sync status of a repository used for Proton template sync. For more information about template sync, see . Note: A repository sync status isn't tied to the Proton Repository resource (or any other Proton resource). Therefore, tags on an Proton Repository resource have no effect on this action. Specifically, you can't use these tags to control access to this action using Attribute-based access control (ABAC).For more information about ABAC, see ABAC in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.get_repository_sync_status( branch='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', syncType='TEMPLATE_SYNC'|'SERVICE_SYNC' ) Parameters: * **branch** (*string*) -- **[REQUIRED]** The repository branch. * **repositoryName** (*string*) -- **[REQUIRED]** The repository name. * **repositoryProvider** (*string*) -- **[REQUIRED]** The repository provider. * **syncType** (*string*) -- **[REQUIRED]** The repository sync type. Return type: dict Returns: **Response Syntax** { 'latestSync': { 'events': [ { 'event': 'string', 'externalId': 'string', 'time': datetime(2015, 1, 1), 'type': 'string' }, ], 'startedAt': datetime(2015, 1, 1), 'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED'|'QUEUED' } } **Response Structure** * *(dict) --* * **latestSync** *(dict) --* The repository sync status detail data that's returned by Proton. * **events** *(list) --* Detail data for sync attempt events. * *(dict) --* Repository sync event detail data for a sync attempt. * **event** *(string) --* Event detail for a repository sync attempt. * **externalId** *(string) --* The external ID of the sync event. * **time** *(datetime) --* The time that the sync event occurred. * **type** *(string) --* The type of event. * **startedAt** *(datetime) --* The time when the sync attempt started. * **status** *(string) --* The sync attempt status. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_deployments list_deployments **************** Proton.Client.list_deployments(**kwargs) List deployments. You can filter the result list by environment, service, or a single service instance. See also: AWS API Documentation **Request Syntax** response = client.list_deployments( componentName='string', environmentName='string', maxResults=123, nextToken='string', serviceInstanceName='string', serviceName='string' ) Parameters: * **componentName** (*string*) -- The name of a component for result list filtering. Proton returns deployments associated with that component. * **environmentName** (*string*) -- The name of an environment for result list filtering. Proton returns deployments associated with the environment. * **maxResults** (*integer*) -- The maximum number of deployments to list. * **nextToken** (*string*) -- A token that indicates the location of the next deployment in the array of deployment, after the list of deployment that was previously requested. * **serviceInstanceName** (*string*) -- The name of a service instance for result list filtering. Proton returns the deployments associated with the service instance. * **serviceName** (*string*) -- The name of a service for result list filtering. Proton returns deployments associated with service instances of the service. Return type: dict Returns: **Response Syntax** { 'deployments': [ { 'arn': 'string', 'completedAt': datetime(2015, 1, 1), 'componentName': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'environmentName': 'string', 'id': 'string', 'lastAttemptedDeploymentId': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'targetArn': 'string', 'targetResourceCreatedAt': datetime(2015, 1, 1), 'targetResourceType': 'ENVIRONMENT'|'SERVICE_PIPELINE'|'SERVICE_INSTANCE'|'COMPONENT' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **deployments** *(list) --* An array of deployment with summary data. * *(dict) --* Summary data of the deployment. * **arn** *(string) --* The Amazon Resource Name (ARN) of the deployment. * **completedAt** *(datetime) --* The date and time the deployment was completed. * **componentName** *(string) --* The name of the component associated with the deployment. * **createdAt** *(datetime) --* The date and time the deployment was created. * **deploymentStatus** *(string) --* The current status of the deployment. * **environmentName** *(string) --* The name of the environment associated with the deployment. * **id** *(string) --* The ID of the deployment. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment. * **lastModifiedAt** *(datetime) --* The date and time the deployment was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment. * **serviceInstanceName** *(string) --* The name of the service instance associated with the deployment. * **serviceName** *(string) --* The name of the service associated with the deployment. * **targetArn** *(string) --* The Amazon Resource Name (ARN) of the target of the deployment. * **targetResourceCreatedAt** *(datetime) --* The date and time the target resource was created. * **targetResourceType** *(string) --* The resource type of the deployment target. It can be an environment, service, service instance, or component. * **nextToken** *(string) --* A token that indicates the location of the next deployment in the array of deployment, after the current requested list of deployment. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_environment_template_version delete_environment_template_version *********************************** Proton.Client.delete_environment_template_version(**kwargs) If no other minor versions of an environment template exist, delete a major version of the environment template if it's not the "Recommended" version. Delete the "Recommended" version of the environment template if no other major versions or minor versions of the environment template exist. A major version of an environment template is a version that's not backward compatible. Delete a minor version of an environment template if it *isn't* the "Recommended" version. Delete a "Recommended" minor version of the environment template if no other minor versions of the environment template exist. A minor version of an environment template is a version that's backward compatible. See also: AWS API Documentation **Request Syntax** response = client.delete_environment_template_version( majorVersion='string', minorVersion='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- **[REQUIRED]** The environment template major version to delete. * **minorVersion** (*string*) -- **[REQUIRED]** The environment template minor version to delete. * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. Return type: dict Returns: **Response Syntax** { 'environmentTemplateVersion': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplateVersion** *(dict) --* The detailed data of the environment template version being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the minor version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The minor version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **schema** *(string) --* The schema of the version of an environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the version of an environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_repository_sync_definitions list_repository_sync_definitions ******************************** Proton.Client.list_repository_sync_definitions(**kwargs) List repository sync definitions with detail data. See also: AWS API Documentation **Request Syntax** response = client.list_repository_sync_definitions( nextToken='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', syncType='TEMPLATE_SYNC'|'SERVICE_SYNC' ) Parameters: * **nextToken** (*string*) -- A token that indicates the location of the next repository sync definition in the array of repository sync definitions, after the list of repository sync definitions previously requested. * **repositoryName** (*string*) -- **[REQUIRED]** The repository name. * **repositoryProvider** (*string*) -- **[REQUIRED]** The repository provider. * **syncType** (*string*) -- **[REQUIRED]** The sync type. The only supported value is "TEMPLATE_SYNC". Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'syncDefinitions': [ { 'branch': 'string', 'directory': 'string', 'parent': 'string', 'target': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next repository sync definition in the array of repository sync definitions, after the current requested list of repository sync definitions. * **syncDefinitions** *(list) --* An array of repository sync definitions. * *(dict) --* A repository sync definition. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The directory in the repository. * **parent** *(string) --* The resource that is synced from. * **target** *(string) --* The resource that is synced to. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_service_template_version create_service_template_version ******************************* Proton.Client.create_service_template_version(**kwargs) Create a new major or minor version of a service template. A major version of a service template is a version that *isn't* backward compatible. A minor version of a service template is a version that's backward compatible within its major version. See also: AWS API Documentation **Request Syntax** response = client.create_service_template_version( clientToken='string', compatibleEnvironmentTemplates=[ { 'majorVersion': 'string', 'templateName': 'string' }, ], description='string', majorVersion='string', source={ 's3': { 'bucket': 'string', 'key': 'string' } }, supportedComponentSources=[ 'DIRECTLY_DEFINED', ], tags=[ { 'key': 'string', 'value': 'string' }, ], templateName='string' ) Parameters: * **clientToken** (*string*) -- When included, if two identical requests are made with the same client token, Proton returns the service template version that the first request created. This field is autopopulated if not provided. * **compatibleEnvironmentTemplates** (*list*) -- **[REQUIRED]** An array of environment template objects that are compatible with the new service template version. A service instance based on this service template version can run in environments based on compatible templates. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* **[REQUIRED]** The major version of the compatible environment template. * **templateName** *(string) --* **[REQUIRED]** The compatible environment template name. * **description** (*string*) -- A description of the new version of a service template. * **majorVersion** (*string*) -- To create a new minor version of the service template, include a "major Version". To create a new major and minor version of the service template, *exclude* "major Version". * **source** (*dict*) -- **[REQUIRED]** An object that includes the template bundle S3 bucket path and name for the new version of a service template. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3". * **s3** *(dict) --* An S3 source object that includes the template bundle S3 path and name for a template minor version. * **bucket** *(string) --* **[REQUIRED]** The name of the S3 bucket that contains a template bundle. * **key** *(string) --* **[REQUIRED]** The path to the S3 bucket that contains a template bundle. * **supportedComponentSources** (*list*) -- An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton service template version. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateName** (*string*) -- **[REQUIRED]** The name of the service template. Return type: dict Returns: **Response Syntax** { 'serviceTemplateVersion': { 'arn': 'string', 'compatibleEnvironmentTemplates': [ { 'majorVersion': 'string', 'templateName': 'string' }, ], 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'supportedComponentSources': [ 'DIRECTLY_DEFINED', ], 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceTemplateVersion** *(dict) --* The service template version summary of detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of a service template. * **compatibleEnvironmentTemplates** *(list) --* An array of compatible environment template names for the major version of a service template. * *(dict) --* Compatible environment template data. * **majorVersion** *(string) --* The major version of the compatible environment template. * **templateName** *(string) --* The compatible environment template name. * **createdAt** *(datetime) --* The time when the version of a service template was created. * **description** *(string) --* A description of the version of a service template. * **lastModifiedAt** *(datetime) --* The time when the version of a service template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of a service template. * **minorVersion** *(string) --* The minor version of a service template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the service template. * **schema** *(string) --* The schema of the version of a service template. * **status** *(string) --* The service template version status. * **statusMessage** *(string) --* A service template version status message. * **supportedComponentSources** *(list) --* An array of supported component sources. Components with supported sources can be attached to service instances based on this service template version. For more information about components, see Proton components in the *Proton User Guide*. * *(string) --* * **templateName** *(string) --* The name of the version of a service template. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / reject_environment_account_connection reject_environment_account_connection ************************************* Proton.Client.reject_environment_account_connection(**kwargs) In a management account, reject an environment account connection from another environment account. After you reject an environment account connection request, you *can't* accept or use the rejected environment account connection. You *can’t* reject an environment account connection that's connected to an environment. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.reject_environment_account_connection( id='string' ) Parameters: **id** (*string*) -- **[REQUIRED]** The ID of the environment account connection to reject. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The environment connection account detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_deployment get_deployment ************** Proton.Client.get_deployment(**kwargs) Get detailed data for a deployment. See also: AWS API Documentation **Request Syntax** response = client.get_deployment( componentName='string', environmentName='string', id='string', serviceInstanceName='string', serviceName='string' ) Parameters: * **componentName** (*string*) -- The name of a component that you want to get the detailed data for. * **environmentName** (*string*) -- The name of a environment that you want to get the detailed data for. * **id** (*string*) -- **[REQUIRED]** The ID of the deployment that you want to get the detailed data for. * **serviceInstanceName** (*string*) -- The name of the service instance associated with the given deployment ID. "serviceName" must be specified to identify the service instance. * **serviceName** (*string*) -- The name of the service associated with the given deployment ID. Return type: dict Returns: **Response Syntax** { 'deployment': { 'arn': 'string', 'completedAt': datetime(2015, 1, 1), 'componentName': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'id': 'string', 'initialState': { 'component': { 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string', 'templateFile': 'string' }, 'environment': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'serviceInstance': { 'lastSuccessfulComponentDeploymentIds': [ 'string', ], 'lastSuccessfulEnvironmentDeploymentId': 'string', 'lastSuccessfulServicePipelineDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'servicePipeline': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } }, 'lastAttemptedDeploymentId': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'targetArn': 'string', 'targetResourceCreatedAt': datetime(2015, 1, 1), 'targetResourceType': 'ENVIRONMENT'|'SERVICE_PIPELINE'|'SERVICE_INSTANCE'|'COMPONENT', 'targetState': { 'component': { 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string', 'templateFile': 'string' }, 'environment': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'serviceInstance': { 'lastSuccessfulComponentDeploymentIds': [ 'string', ], 'lastSuccessfulEnvironmentDeploymentId': 'string', 'lastSuccessfulServicePipelineDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'servicePipeline': { 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } } } **Response Structure** * *(dict) --* * **deployment** *(dict) --* The detailed data of the requested deployment. * **arn** *(string) --* The Amazon Resource Name (ARN) of the deployment. * **completedAt** *(datetime) --* The date and time the deployment was completed. * **componentName** *(string) --* The name of the component associated with this deployment. * **createdAt** *(datetime) --* The date and time the deployment was created. * **deploymentStatus** *(string) --* The status of the deployment. * **deploymentStatusMessage** *(string) --* The deployment status message. * **environmentName** *(string) --* The name of the environment associated with this deployment. * **id** *(string) --* The ID of the deployment. * **initialState** *(dict) --* The initial state of the target resource at the time of the deployment. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "component", "environment", "serviceInstance", "servicePipeline". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **component** *(dict) --* The state of the component associated with the deployment. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. * **templateFile** *(string) --* The template file used. * **environment** *(dict) --* The state of the environment associated with the deployment. * **spec** *(string) --* The environment spec that was used to create the environment. * **templateMajorVersion** *(string) --* The major version of the environment template that was used to create the environment. * **templateMinorVersion** *(string) --* The minor version of the environment template that was used to create the environment. * **templateName** *(string) --* The name of the environment template that was used to create the environment. * **serviceInstance** *(dict) --* The state of the service instance associated with the deployment. * **lastSuccessfulComponentDeploymentIds** *(list) --* The IDs for the last successful components deployed for this service instance. * *(string) --* * **lastSuccessfulEnvironmentDeploymentId** *(string) --* The ID for the last successful environment deployed for this service instance. * **lastSuccessfulServicePipelineDeploymentId** *(string) --* The ID for the last successful service pipeline deployed for this service instance. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service instance. * **servicePipeline** *(dict) --* The state of the service pipeline associated with the deployment. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment. * **lastModifiedAt** *(datetime) --* The date and time the deployment was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment. * **serviceInstanceName** *(string) --* The name of the deployment's service instance. * **serviceName** *(string) --* The name of the service in this deployment. * **targetArn** *(string) --* The Amazon Resource Name (ARN) of the target of the deployment. * **targetResourceCreatedAt** *(datetime) --* The date and time the depoyment target was created. * **targetResourceType** *(string) --* The resource type of the deployment target. It can be an environment, service, service instance, or component. * **targetState** *(dict) --* The target state of the target resource at the time of the deployment. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "component", "environment", "serviceInstance", "servicePipeline". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **component** *(dict) --* The state of the component associated with the deployment. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. * **templateFile** *(string) --* The template file used. * **environment** *(dict) --* The state of the environment associated with the deployment. * **spec** *(string) --* The environment spec that was used to create the environment. * **templateMajorVersion** *(string) --* The major version of the environment template that was used to create the environment. * **templateMinorVersion** *(string) --* The minor version of the environment template that was used to create the environment. * **templateName** *(string) --* The name of the environment template that was used to create the environment. * **serviceInstance** *(dict) --* The state of the service instance associated with the deployment. * **lastSuccessfulComponentDeploymentIds** *(list) --* The IDs for the last successful components deployed for this service instance. * *(string) --* * **lastSuccessfulEnvironmentDeploymentId** *(string) --* The ID for the last successful environment deployed for this service instance. * **lastSuccessfulServicePipelineDeploymentId** *(string) --* The ID for the last successful service pipeline deployed for this service instance. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service instance. * **servicePipeline** *(dict) --* The state of the service pipeline associated with the deployment. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / cancel_service_pipeline_deployment cancel_service_pipeline_deployment ********************************** Proton.Client.cancel_service_pipeline_deployment(**kwargs) Attempts to cancel a service pipeline deployment on an UpdateServicePipeline action, if the deployment is "IN_PROGRESS". For more information, see Update a service pipeline in the *Proton User guide*. The following list includes potential cancellation scenarios. * If the cancellation attempt succeeds, the resulting deployment state is "CANCELLED". * If the cancellation attempt fails, the resulting deployment state is "FAILED". * If the current UpdateServicePipeline action succeeds before the cancellation attempt starts, the resulting deployment state is "SUCCEEDED" and the cancellation attempt has no effect. See also: AWS API Documentation **Request Syntax** response = client.cancel_service_pipeline_deployment( serviceName='string' ) Parameters: **serviceName** (*string*) -- **[REQUIRED]** The name of the service with the service pipeline deployment to cancel. Return type: dict Returns: **Response Syntax** { 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **pipeline** *(dict) --* The service pipeline detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environment_provisioned_resources list_environment_provisioned_resources ************************************** Proton.Client.list_environment_provisioned_resources(**kwargs) List the provisioned resources for your environment. See also: AWS API Documentation **Request Syntax** response = client.list_environment_provisioned_resources( environmentName='string', nextToken='string' ) Parameters: * **environmentName** (*string*) -- **[REQUIRED]** The environment name. * **nextToken** (*string*) -- A token that indicates the location of the next environment provisioned resource in the array of environment provisioned resources, after the list of environment provisioned resources that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next environment provisioned resource in the array of provisioned resources, after the current requested list of environment provisioned resources. * **provisionedResources** *(list) --* An array of environment provisioned resources. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_service_sync_config create_service_sync_config ************************** Proton.Client.create_service_sync_config(**kwargs) Create the Proton Ops configuration file. See also: AWS API Documentation **Request Syntax** response = client.create_service_sync_config( branch='string', filePath='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', serviceName='string' ) Parameters: * **branch** (*string*) -- **[REQUIRED]** The repository branch for your Proton Ops file. * **filePath** (*string*) -- **[REQUIRED]** The path to the Proton Ops file. * **repositoryName** (*string*) -- **[REQUIRED]** The repository name. * **repositoryProvider** (*string*) -- **[REQUIRED]** The provider type for your repository. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service the Proton Ops file is for. Return type: dict Returns: **Response Syntax** { 'serviceSyncConfig': { 'branch': 'string', 'filePath': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'serviceName': 'string' } } **Response Structure** * *(dict) --* * **serviceSyncConfig** *(dict) --* The detailed data of the Proton Ops file. * **branch** *(string) --* The name of the code repository branch that holds the service code Proton will sync with. * **filePath** *(string) --* The file path to the service sync configuration file. * **repositoryName** *(string) --* The name of the code repository that holds the service code Proton will sync with. * **repositoryProvider** *(string) --* The name of the repository provider that holds the repository Proton will sync with. * **serviceName** *(string) --* The name of the service that the service instance is added to. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service get_service *********** Proton.Client.get_service(**kwargs) Get detailed data for a service. See also: AWS API Documentation **Request Syntax** response = client.get_service( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the service that you want to get the detailed data for. Return type: dict Returns: **Response Syntax** { 'service': { 'arn': 'string', 'branchName': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipeline': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, 'repositoryConnectionArn': 'string', 'repositoryId': 'string', 'spec': 'string', 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_IN_PROGRESS'|'CREATE_FAILED_CLEANUP_COMPLETE'|'CREATE_FAILED_CLEANUP_FAILED'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_IN_PROGRESS'|'UPDATE_FAILED_CLEANUP_COMPLETE'|'UPDATE_FAILED_CLEANUP_FAILED'|'UPDATE_FAILED'|'UPDATE_COMPLETE_CLEANUP_FAILED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **service** *(dict) --* The detailed data of the requested service. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service. * **branchName** *(string) --* The name of the code repository branch that holds the code that's deployed in Proton. * **createdAt** *(datetime) --* The time when the service was created. * **description** *(string) --* A description of the service. * **lastModifiedAt** *(datetime) --* The time when the service was last modified. * **name** *(string) --* The name of the service. * **pipeline** *(dict) --* The service pipeline detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service pipeline. * **createdAt** *(datetime) --* The time when the service pipeline was created. * **deploymentStatus** *(string) --* The deployment status of the service pipeline. * **deploymentStatusMessage** *(string) --* A service pipeline deployment status message. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service pipeline. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service pipeline was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service pipeline was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service pipeline. * **spec** *(string) --* The service spec that was used to create the service pipeline. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service pipeline. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service pipeline. * **templateName** *(string) --* The name of the service template that was used to create the service pipeline. * **repositoryConnectionArn** *(string) --* The Amazon Resource Name (ARN) of the repository connection. For more information, see Setting up an AWS CodeStar connection in the *Proton User Guide*. * **repositoryId** *(string) --* The ID of the source code repository. * **spec** *(string) --* The formatted specification that defines the service. * **status** *(string) --* The status of the service. * **statusMessage** *(string) --* A service status message. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_repository get_repository ************** Proton.Client.get_repository(**kwargs) Get detail data for a linked repository. See also: AWS API Documentation **Request Syntax** response = client.get_repository( name='string', provider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The repository name, for example "myrepos/myrepo". * **provider** (*string*) -- **[REQUIRED]** The repository provider. Return type: dict Returns: **Response Syntax** { 'repository': { 'arn': 'string', 'connectionArn': 'string', 'encryptionKey': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' } } **Response Structure** * *(dict) --* * **repository** *(dict) --* The repository link's detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **connectionArn** *(string) --* The Amazon Resource Name (ARN) of your AWS CodeStar connection that connects Proton to your repository provider account. * **encryptionKey** *(string) --* Your customer Amazon Web Services KMS encryption key. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_component update_component **************** Proton.Client.update_component(**kwargs) Update a component. There are a few modes for updating a component. The "deploymentType" field defines the mode. Note: You can't update a component while its deployment status, or the deployment status of a service instance attached to it, is "IN_PROGRESS". For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.update_component( clientToken='string', deploymentType='NONE'|'CURRENT_VERSION', description='string', name='string', serviceInstanceName='string', serviceName='string', serviceSpec='string', templateFile='string' ) Parameters: * **clientToken** (*string*) -- The client token for the updated component. This field is autopopulated if not provided. * **deploymentType** (*string*) -- **[REQUIRED]** The deployment type. It defines the mode for updating a component, as follows: "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. You can only specify "description" in this mode. "CURRENT_VERSION" In this mode, the component is deployed and updated with the new "serviceSpec", "templateSource", and/or "type" that you provide. Only requested parameters are updated. * **description** (*string*) -- An optional customer-provided description of the component. * **name** (*string*) -- **[REQUIRED]** The name of the component to update. * **serviceInstanceName** (*string*) -- The name of the service instance that you want to attach this component to. Don't specify to keep the component's current service instance attachment. Specify an empty string to detach the component from the service instance it's attached to. Specify non-empty values for both "serviceInstanceName" and "serviceName" or for neither of them. * **serviceName** (*string*) -- The name of the service that "serviceInstanceName" is associated with. Don't specify to keep the component's current service instance attachment. Specify an empty string to detach the component from the service instance it's attached to. Specify non-empty values for both "serviceInstanceName" and "serviceName" or for neither of them. * **serviceSpec** (*string*) -- The service spec that you want the component to use to access service inputs. Set this only when the component is attached to a service instance. * **templateFile** (*string*) -- A path to the Infrastructure as Code (IaC) file describing infrastructure that a custom component provisions. Note: Components support a single IaC file, even if you use Terraform as your template language. Return type: dict Returns: **Response Syntax** { 'component': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string' } } **Response Structure** * *(dict) --* * **component** *(dict) --* The detailed data of the updated component. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **description** *(string) --* A description of the component. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastClientRequestToken** *(string) --* The last token the client requested. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environment_account_connections list_environment_account_connections ************************************ Proton.Client.list_environment_account_connections(**kwargs) View a list of environment account connections. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.list_environment_account_connections( environmentName='string', maxResults=123, nextToken='string', requestedBy='MANAGEMENT_ACCOUNT'|'ENVIRONMENT_ACCOUNT', statuses=[ 'PENDING'|'CONNECTED'|'REJECTED', ] ) Parameters: * **environmentName** (*string*) -- The environment name that's associated with each listed environment account connection. * **maxResults** (*integer*) -- The maximum number of environment account connections to list. * **nextToken** (*string*) -- A token that indicates the location of the next environment account connection in the array of environment account connections, after the list of environment account connections that was previously requested. * **requestedBy** (*string*) -- **[REQUIRED]** The type of account making the "ListEnvironmentAccountConnections" request. * **statuses** (*list*) -- The status details for each listed environment account connection. * *(string) --* Return type: dict Returns: **Response Syntax** { 'environmentAccountConnections': [ { 'arn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **environmentAccountConnections** *(list) --* An array of environment account connections with details that's returned by Proton. * *(dict) --* Summary data of an Proton environment account connection resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The ID of the environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. * **nextToken** *(string) --* A token that indicates the location of the next environment account connection in the array of environment account connections, after the current requested list of environment account connections. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / cancel_environment_deployment cancel_environment_deployment ***************************** Proton.Client.cancel_environment_deployment(**kwargs) Attempts to cancel an environment deployment on an UpdateEnvironment action, if the deployment is "IN_PROGRESS". For more information, see Update an environment in the *Proton User guide*. The following list includes potential cancellation scenarios. * If the cancellation attempt succeeds, the resulting deployment state is "CANCELLED". * If the cancellation attempt fails, the resulting deployment state is "FAILED". * If the current UpdateEnvironment action succeeds before the cancellation attempt starts, the resulting deployment state is "SUCCEEDED" and the cancellation attempt has no effect. See also: AWS API Documentation **Request Syntax** response = client.cancel_environment_deployment( environmentName='string' ) Parameters: **environmentName** (*string*) -- **[REQUIRED]** The name of the environment with the deployment to cancel. Return type: dict Returns: **Response Syntax** { 'environment': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentAccountConnectionId': 'string', 'environmentAccountId': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'protonServiceRoleArn': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'provisioningRepository': { 'arn': 'string', 'branch': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' }, 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environment** *(dict) --* The environment summary data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that allows Proton to provision infrastructure using CodeBuild-based provisioning on your behalf. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in this environment. It determines the scope of infrastructure that a component can provision. The environment must have a "componentRoleArn" to allow directly defined components to be associated with the environment. For more information about components, see Proton components in the *Proton User Guide*. * **createdAt** *(datetime) --* The time when the environment was created. * **deploymentStatus** *(string) --* The environment deployment status. * **deploymentStatusMessage** *(string) --* An environment deployment status message. * **description** *(string) --* The description of the environment. * **environmentAccountConnectionId** *(string) --* The ID of the environment account connection that's used to provision infrastructure resources in an environment account. * **environmentAccountId** *(string) --* The ID of the environment account that the environment infrastructure resources are provisioned in. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this environment. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the environment was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the environment was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this environment. * **name** *(string) --* The name of the environment. * **protonServiceRoleArn** *(string) --* The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **provisioningRepository** *(dict) --* The linked repository that you use to host your rendered infrastructure templates for self-managed provisioning. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **branch** *(string) --* The repository branch. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. * **spec** *(string) --* The environment spec. * **templateMajorVersion** *(string) --* The major version of the environment template. * **templateMinorVersion** *(string) --* The minor version of the environment template. * **templateName** *(string) --* The Amazon Resource Name (ARN) of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_service_instance create_service_instance *********************** Proton.Client.create_service_instance(**kwargs) Create a service instance. See also: AWS API Documentation **Request Syntax** response = client.create_service_instance( clientToken='string', name='string', serviceName='string', spec='string', tags=[ { 'key': 'string', 'value': 'string' }, ], templateMajorVersion='string', templateMinorVersion='string' ) Parameters: * **clientToken** (*string*) -- The client token of the service instance to create. This field is autopopulated if not provided. * **name** (*string*) -- **[REQUIRED]** The name of the service instance to create. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service the service instance is added to. * **spec** (*string*) -- **[REQUIRED]** The spec for the service instance you want to create. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton service instance. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. * **templateMajorVersion** (*string*) -- To create a new major and minor version of the service template, *exclude* "major Version". * **templateMinorVersion** (*string*) -- To create a new minor version of the service template, include a "major Version". Return type: dict Returns: **Response Syntax** { 'serviceInstance': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceInstance** *(dict) --* The detailed data of the service instance being created. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the service instance deployment status. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastClientRequestToken** *(string) --* The last client request token received. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service instance was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service instance was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service instance. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service instance. * **templateName** *(string) --* The name of the service template that was used to create the service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_instance update_service_instance *********************** Proton.Client.update_service_instance(**kwargs) Update a service instance. There are a few modes for updating a service instance. The "deploymentType" field defines the mode. Note: You can't update a service instance while its deployment status, or the deployment status of a component attached to it, is "IN_PROGRESS".For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.update_service_instance( clientToken='string', deploymentType='NONE'|'CURRENT_VERSION'|'MINOR_VERSION'|'MAJOR_VERSION', name='string', serviceName='string', spec='string', templateMajorVersion='string', templateMinorVersion='string' ) Parameters: * **clientToken** (*string*) -- The client token of the service instance to update. This field is autopopulated if not provided. * **deploymentType** (*string*) -- **[REQUIRED]** The deployment type. It defines the mode for updating a service instance, as follows: "NONE" In this mode, a deployment *doesn't* occur. Only the requested metadata parameters are updated. "CURRENT_VERSION" In this mode, the service instance is deployed and updated with the new spec that you provide. Only requested parameters are updated. *Don’t* include major or minor version parameters when you use this deployment type. "MINOR_VERSION" In this mode, the service instance is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use. "MAJOR_VERSION" In this mode, the service instance is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can specify a different major version that's higher than the major version in use and a minor version. * **name** (*string*) -- **[REQUIRED]** The name of the service instance to update. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that the service instance belongs to. * **spec** (*string*) -- The formatted specification that defines the service instance update. * **templateMajorVersion** (*string*) -- The major version of the service template to update. * **templateMinorVersion** (*string*) -- The minor version of the service template to update. Return type: dict Returns: **Response Syntax** { 'serviceInstance': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceInstance** *(dict) --* The service instance summary data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the service instance deployment status. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastClientRequestToken** *(string) --* The last client request token received. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service instance was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service instance was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service instance. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service instance. * **templateName** *(string) --* The name of the service template that was used to create the service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / cancel_service_instance_deployment cancel_service_instance_deployment ********************************** Proton.Client.cancel_service_instance_deployment(**kwargs) Attempts to cancel a service instance deployment on an UpdateServiceInstance action, if the deployment is "IN_PROGRESS". For more information, see Update a service instance in the *Proton User guide*. The following list includes potential cancellation scenarios. * If the cancellation attempt succeeds, the resulting deployment state is "CANCELLED". * If the cancellation attempt fails, the resulting deployment state is "FAILED". * If the current UpdateServiceInstance action succeeds before the cancellation attempt starts, the resulting deployment state is "SUCCEEDED" and the cancellation attempt has no effect. See also: AWS API Documentation **Request Syntax** response = client.cancel_service_instance_deployment( serviceInstanceName='string', serviceName='string' ) Parameters: * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance with the deployment to cancel. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service with the service instance deployment to cancel. Return type: dict Returns: **Response Syntax** { 'serviceInstance': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceInstance** *(dict) --* The service instance summary data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the service instance deployment status. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastClientRequestToken** *(string) --* The last client request token received. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service instance was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service instance was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service instance. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service instance. * **templateName** *(string) --* The name of the service template that was used to create the service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_instance_outputs list_service_instance_outputs ***************************** Proton.Client.list_service_instance_outputs(**kwargs) Get a list service of instance Infrastructure as Code (IaC) outputs. See also: AWS API Documentation **Request Syntax** response = client.list_service_instance_outputs( deploymentId='string', nextToken='string', serviceInstanceName='string', serviceName='string' ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **nextToken** (*string*) -- A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested. * **serviceInstanceName** (*string*) -- **[REQUIRED]** The name of the service instance whose outputs you want. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that "serviceInstanceName" is associated to. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next output in the array of outputs, after the current requested list of outputs. * **outputs** *(list) --* An array of service instance Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_environment_template_version update_environment_template_version *********************************** Proton.Client.update_environment_template_version(**kwargs) Update a major or minor version of an environment template. See also: AWS API Documentation **Request Syntax** response = client.update_environment_template_version( description='string', majorVersion='string', minorVersion='string', status='REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', templateName='string' ) Parameters: * **description** (*string*) -- A description of environment template version to update. * **majorVersion** (*string*) -- **[REQUIRED]** To update a major version of an environment template, include "major Version". * **minorVersion** (*string*) -- **[REQUIRED]** To update a minor version of an environment template, include "minorVersion". * **status** (*string*) -- The status of the environment template minor version to update. * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. Return type: dict Returns: **Response Syntax** { 'environmentTemplateVersion': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'schema': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplateVersion** *(dict) --* The environment template version detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the minor version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The minor version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **schema** *(string) --* The schema of the version of an environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the version of an environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_component get_component ************* Proton.Client.get_component(**kwargs) Get detailed data for a component. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.get_component( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the component that you want to get the detailed data for. Return type: dict Returns: **Response Syntax** { 'component': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'description': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastModifiedAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceInstanceName': 'string', 'serviceName': 'string', 'serviceSpec': 'string' } } **Response Structure** * *(dict) --* * **component** *(dict) --* The detailed data of the requested component. * **arn** *(string) --* The Amazon Resource Name (ARN) of the component. * **createdAt** *(datetime) --* The time when the component was created. * **deploymentStatus** *(string) --* The component deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the component deployment status. * **description** *(string) --* A description of the component. * **environmentName** *(string) --* The name of the Proton environment that this component is associated with. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this component. * **lastClientRequestToken** *(string) --* The last token the client requested. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the component was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the component was last deployed successfully. * **lastModifiedAt** *(datetime) --* The time when the component was last modified. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this component. * **name** *(string) --* The name of the component. * **serviceInstanceName** *(string) --* The name of the service instance that this component is attached to. Provided when a component is attached to a service instance. * **serviceName** *(string) --* The name of the service that "serviceInstanceName" is associated with. Provided when a component is attached to a service instance. * **serviceSpec** *(string) --* The service spec that the component uses to access service inputs. Provided when a component is attached to a service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_environment_template get_environment_template ************************ Proton.Client.get_environment_template(**kwargs) Get detailed data for an environment template. See also: AWS API Documentation **Request Syntax** response = client.get_environment_template( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the environment template that you want to get the detailed data for. Return type: dict Returns: **Response Syntax** { 'environmentTemplate': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'encryptionKey': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'provisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' } } **Response Structure** * *(dict) --* * **environmentTemplate** *(dict) --* The detailed data of the requested environment template. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment template. * **createdAt** *(datetime) --* The time when the environment template was created. * **description** *(string) --* A description of the environment template. * **displayName** *(string) --* The name of the environment template as displayed in the developer interface. * **encryptionKey** *(string) --* The customer provided encryption key for the environment template. * **lastModifiedAt** *(datetime) --* The time when the environment template was last modified. * **name** *(string) --* The name of the environment template. * **provisioning** *(string) --* When included, indicates that the environment template is for customer provisioned and managed infrastructure. * **recommendedVersion** *(string) --* The ID of the recommended version of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_component_provisioned_resources list_component_provisioned_resources ************************************ Proton.Client.list_component_provisioned_resources(**kwargs) List provisioned resources for a component with details. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.list_component_provisioned_resources( componentName='string', nextToken='string' ) Parameters: * **componentName** (*string*) -- **[REQUIRED]** The name of the component whose provisioned resources you want. * **nextToken** (*string*) -- A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources. * **provisionedResources** *(list) --* An array of provisioned resources for a component. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_pipeline_outputs list_service_pipeline_outputs ***************************** Proton.Client.list_service_pipeline_outputs(**kwargs) Get a list of service pipeline Infrastructure as Code (IaC) outputs. See also: AWS API Documentation **Request Syntax** response = client.list_service_pipeline_outputs( deploymentId='string', nextToken='string', serviceName='string' ) Parameters: * **deploymentId** (*string*) -- The ID of the deployment you want the outputs for. * **nextToken** (*string*) -- A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service whose pipeline's outputs you want. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next output in the array of outputs, after the current requested list of outputs. * **outputs** *(list) --* An array of service pipeline Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / close close ***** Proton.Client.close() Closes underlying endpoint connections. Proton / Client / list_service_templates list_service_templates ********************** Proton.Client.list_service_templates(**kwargs) List service templates with detail data. See also: AWS API Documentation **Request Syntax** response = client.list_service_templates( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of service templates to list. * **nextToken** (*string*) -- A token that indicates the location of the next service template in the array of service templates, after the list of service templates previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'templates': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'displayName': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'name': 'string', 'pipelineProvisioning': 'CUSTOMER_MANAGED', 'recommendedVersion': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next service template in the array of service templates, after the current requested list of service templates. * **templates** *(list) --* An array of service templates with detail data. * *(dict) --* Summary data of an Proton service template resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service template. * **createdAt** *(datetime) --* The time when the service template was created. * **description** *(string) --* A description of the service template. * **displayName** *(string) --* The service template name as displayed in the developer interface. * **lastModifiedAt** *(datetime) --* The time when the service template was last modified. * **name** *(string) --* The name of the service template. * **pipelineProvisioning** *(string) --* If "pipelineProvisioning" is "true", a service pipeline is included in the service template, otherwise a service pipeline *isn't* included in the service template. * **recommendedVersion** *(string) --* The recommended version of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_template_sync_status get_template_sync_status ************************ Proton.Client.get_template_sync_status(**kwargs) Get the status of a template sync. See also: AWS API Documentation **Request Syntax** response = client.get_template_sync_status( templateName='string', templateType='ENVIRONMENT'|'SERVICE', templateVersion='string' ) Parameters: * **templateName** (*string*) -- **[REQUIRED]** The template name. * **templateType** (*string*) -- **[REQUIRED]** The template type. * **templateVersion** (*string*) -- **[REQUIRED]** The template major version. Return type: dict Returns: **Response Syntax** { 'desiredState': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'latestSuccessfulSync': { 'events': [ { 'event': 'string', 'externalId': 'string', 'time': datetime(2015, 1, 1), 'type': 'string' }, ], 'initialRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'startedAt': datetime(2015, 1, 1), 'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'target': 'string', 'targetRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' } }, 'latestSync': { 'events': [ { 'event': 'string', 'externalId': 'string', 'time': datetime(2015, 1, 1), 'type': 'string' }, ], 'initialRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' }, 'startedAt': datetime(2015, 1, 1), 'status': 'INITIATED'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'target': 'string', 'targetRevision': { 'branch': 'string', 'directory': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'sha': 'string' } } } **Response Structure** * *(dict) --* * **desiredState** *(dict) --* The template sync desired state that's returned by Proton. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **latestSuccessfulSync** *(dict) --* The details of the last successful sync that's returned by Proton. * **events** *(list) --* An array of events with detail data. * *(dict) --* Detail data for a resource sync event. * **event** *(string) --* A resource sync event. * **externalId** *(string) --* The external ID for the event. * **time** *(datetime) --* The time when the event occurred. * **type** *(string) --* The type of event. * **initialRevision** *(dict) --* Detail data for the initial repository commit, path and push. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **startedAt** *(datetime) --* The time when the sync attempt started. * **status** *(string) --* The status of the sync attempt. * **target** *(string) --* The resource that is synced to. * **targetRevision** *(dict) --* Detail data for the target revision. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **latestSync** *(dict) --* The details of the last sync that's returned by Proton. * **events** *(list) --* An array of events with detail data. * *(dict) --* Detail data for a resource sync event. * **event** *(string) --* A resource sync event. * **externalId** *(string) --* The external ID for the event. * **time** *(datetime) --* The time when the event occurred. * **type** *(string) --* The type of event. * **initialRevision** *(dict) --* Detail data for the initial repository commit, path and push. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. * **startedAt** *(datetime) --* The time when the sync attempt started. * **status** *(string) --* The status of the sync attempt. * **target** *(string) --* The resource that is synced to. * **targetRevision** *(dict) --* Detail data for the target revision. * **branch** *(string) --* The repository branch. * **directory** *(string) --* The repository directory changed by a commit and push that activated the sync attempt. * **repositoryName** *(string) --* The repository name. * **repositoryProvider** *(string) --* The repository provider. * **sha** *(string) --* The secure hash algorithm (SHA) hash for the revision. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / accept_environment_account_connection accept_environment_account_connection ************************************* Proton.Client.accept_environment_account_connection(**kwargs) In a management account, an environment account connection request is accepted. When the environment account connection request is accepted, Proton can use the associated IAM role to provision environment infrastructure resources in the associated environment account. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.accept_environment_account_connection( id='string' ) Parameters: **id** (*string*) -- **[REQUIRED]** The ID of the environment account connection. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The environment account connection data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_resources_summary get_resources_summary ********************* Proton.Client.get_resources_summary() Get counts of Proton resources. For infrastructure-provisioning resources (environments, services, service instances, pipelines), the action returns staleness counts. A resource is stale when it's behind the recommended version of the Proton template that it uses and it needs an update to become current. The action returns staleness counts (counts of resources that are up-to-date, behind a template major version, or behind a template minor version), the total number of resources, and the number of resources that are in a failed state, grouped by resource type. Components, environments, and service templates return less information - see the "components", "environments", and "serviceTemplates" field descriptions. For context, the action also returns the total number of each type of Proton template in the Amazon Web Services account. For more information, see Proton dashboard in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.get_resources_summary() Return type: dict Returns: **Response Syntax** { 'counts': { 'components': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'environmentTemplates': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'environments': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'pipelines': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'serviceInstances': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'serviceTemplates': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 }, 'services': { 'behindMajor': 123, 'behindMinor': 123, 'failed': 123, 'total': 123, 'upToDate': 123 } } } **Response Structure** * *(dict) --* * **counts** *(dict) --* Summary counts of each Proton resource type. * **components** *(dict) --* The total number of components in the Amazon Web Services account. The semantics of the "components" field are different from the semantics of results for other infrastructure- provisioning resources. That's because at this time components don't have associated templates, therefore they don't have the concept of staleness. The "components" object will only contain "total" and "failed" members. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **environmentTemplates** *(dict) --* The total number of environment templates in the Amazon Web Services account. The "environmentTemplates" object will only contain "total" members. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **environments** *(dict) --* The staleness counts for Proton environments in the Amazon Web Services account. The "environments" object will only contain "total" members. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **pipelines** *(dict) --* The staleness counts for Proton pipelines in the Amazon Web Services account. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **serviceInstances** *(dict) --* The staleness counts for Proton service instances in the Amazon Web Services account. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **serviceTemplates** *(dict) --* The total number of service templates in the Amazon Web Services account. The "serviceTemplates" object will only contain "total" members. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. * **services** *(dict) --* The staleness counts for Proton services in the Amazon Web Services account. * **behindMajor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a major template version update. * **behindMinor** *(integer) --* The number of resources of this type in the Amazon Web Services account that need a minor template version update. * **failed** *(integer) --* The number of resources of this type in the Amazon Web Services account that failed to deploy. * **total** *(integer) --* The total number of resources of this type in the Amazon Web Services account. * **upToDate** *(integer) --* The number of resources of this type in the Amazon Web Services account that are up-to-date with their template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_repository create_repository ***************** Proton.Client.create_repository(**kwargs) Create and register a link to a repository. Proton uses the link to repeatedly access the repository, to either push to it (self- managed provisioning) or pull from it (template sync). You can share a linked repository across multiple resources (like environments using self-managed provisioning, or synced templates). When you create a repository link, Proton creates a service-linked role for you. For more information, see Self-managed provisioning, Template bundles, and Template sync configurations in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_repository( connectionArn='string', encryptionKey='string', name='string', provider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', tags=[ { 'key': 'string', 'value': 'string' }, ] ) Parameters: * **connectionArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of your AWS CodeStar connection that connects Proton to your repository provider account. For more information, see Setting up for Proton in the *Proton User Guide*. * **encryptionKey** (*string*) -- The ARN of your customer Amazon Web Services Key Management Service (Amazon Web Services KMS) key. * **name** (*string*) -- **[REQUIRED]** The repository name (for example, "myrepos/myrepo"). * **provider** (*string*) -- **[REQUIRED]** The repository provider. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton repository. A tag is a key-value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. Return type: dict Returns: **Response Syntax** { 'repository': { 'arn': 'string', 'connectionArn': 'string', 'encryptionKey': 'string', 'name': 'string', 'provider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET' } } **Response Structure** * *(dict) --* * **repository** *(dict) --* The repository link's detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the linked repository. * **connectionArn** *(string) --* The Amazon Resource Name (ARN) of your AWS CodeStar connection that connects Proton to your repository provider account. * **encryptionKey** *(string) --* Your customer Amazon Web Services KMS encryption key. * **name** *(string) --* The repository name. * **provider** *(string) --* The repository provider. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_template_sync_config create_template_sync_config *************************** Proton.Client.create_template_sync_config(**kwargs) Set up a template to create new template versions automatically by tracking a linked repository. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. When a commit is pushed to your linked repository, Proton checks for changes to your repository template bundles. If it detects a template bundle change, a new major or minor version of its template is created, if the version doesn’t already exist. For more information, see Template sync configurations in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.create_template_sync_config( branch='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', subdirectory='string', templateName='string', templateType='ENVIRONMENT'|'SERVICE' ) Parameters: * **branch** (*string*) -- **[REQUIRED]** The repository branch for your template. * **repositoryName** (*string*) -- **[REQUIRED]** The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** (*string*) -- **[REQUIRED]** The provider type for your repository. * **subdirectory** (*string*) -- A repository subdirectory path to your template bundle directory. When included, Proton limits the template bundle search to this repository directory. * **templateName** (*string*) -- **[REQUIRED]** The name of your registered template. * **templateType** (*string*) -- **[REQUIRED]** The type of the registered template. Return type: dict Returns: **Response Syntax** { 'templateSyncConfig': { 'branch': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'subdirectory': 'string', 'templateName': 'string', 'templateType': 'ENVIRONMENT'|'SERVICE' } } **Response Structure** * *(dict) --* * **templateSyncConfig** *(dict) --* The template sync configuration detail data that's returned by Proton. * **branch** *(string) --* The repository branch. * **repositoryName** *(string) --* The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** *(string) --* The repository provider. * **subdirectory** *(string) --* A subdirectory path to your template bundle version. * **templateName** *(string) --* The template name. * **templateType** *(string) --* The template type. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_environment_account_connection get_environment_account_connection ********************************** Proton.Client.get_environment_account_connection(**kwargs) In an environment account, get the detailed data for an environment account connection. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.get_environment_account_connection( id='string' ) Parameters: **id** (*string*) -- **[REQUIRED]** The ID of the environment account connection that you want to get the detailed data for. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The detailed data of the requested environment account connection. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_pipeline_provisioned_resources list_service_pipeline_provisioned_resources ******************************************* Proton.Client.list_service_pipeline_provisioned_resources(**kwargs) List provisioned resources for a service and pipeline with details. See also: AWS API Documentation **Request Syntax** response = client.list_service_pipeline_provisioned_resources( nextToken='string', serviceName='string' ) Parameters: * **nextToken** (*string*) -- A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service whose pipeline's provisioned resources you want. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'provisionedResources': [ { 'identifier': 'string', 'name': 'string', 'provisioningEngine': 'CLOUDFORMATION'|'TERRAFORM' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources. * **provisionedResources** *(list) --* An array of provisioned resources for a service and pipeline. * *(dict) --* Detail data for a provisioned resource. * **identifier** *(string) --* The provisioned resource identifier. * **name** *(string) --* The provisioned resource name. * **provisioningEngine** *(string) --* The resource provisioning engine. At this time, "CLOUDFORMATION" can be used for Amazon Web Services- managed provisioning, and "TERRAFORM" can be used for self-managed provisioning. For more information, see Self-managed provisioning in the *Proton User Guide*. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_service_instances list_service_instances ********************** Proton.Client.list_service_instances(**kwargs) List service instances with summary data. This action lists service instances of all services in the Amazon Web Services account. See also: AWS API Documentation **Request Syntax** response = client.list_service_instances( filters=[ { 'key': 'name'|'deploymentStatus'|'templateName'|'serviceName'|'deployedTemplateVersionStatus'|'environmentName'|'lastDeploymentAttemptedAtBefore'|'lastDeploymentAttemptedAtAfter'|'createdAtBefore'|'createdAtAfter', 'value': 'string' }, ], maxResults=123, nextToken='string', serviceName='string', sortBy='name'|'deploymentStatus'|'templateName'|'serviceName'|'environmentName'|'lastDeploymentAttemptedAt'|'createdAt', sortOrder='ASCENDING'|'DESCENDING' ) Parameters: * **filters** (*list*) -- An array of filtering criteria that scope down the result list. By default, all service instances in the Amazon Web Services account are returned. * *(dict) --* A filtering criterion to scope down the result list of the ListServiceInstances action. * **key** *(string) --* The name of a filtering criterion. * **value** *(string) --* A value to filter by. With the date/time keys ( "*At{Before,After}"), the value is a valid RFC 3339 string with no UTC offset and with an optional fractional precision (for example, "1985-04-12T23:20:50.52Z"). * **maxResults** (*integer*) -- The maximum number of service instances to list. * **nextToken** (*string*) -- A token that indicates the location of the next service in the array of service instances, after the list of service instances that was previously requested. * **serviceName** (*string*) -- The name of the service that the service instance belongs to. * **sortBy** (*string*) -- The field that the result list is sorted by. When you choose to sort by "serviceName", service instances within each service are sorted by service instance name. Default: "serviceName" * **sortOrder** (*string*) -- Result list sort order. Default: "ASCENDING" Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'serviceInstances': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next service instance in the array of service instances, after the current requested list of service instances. * **serviceInstances** *(list) --* An array of service instances with summary data. * *(dict) --* Summary data of an Proton service instance resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* A service instance deployment status message. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **templateMajorVersion** *(string) --* The service instance template major version. * **templateMinorVersion** *(string) --* The service instance template minor version. * **templateName** *(string) --* The name of the service template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_template_sync_config delete_template_sync_config *************************** Proton.Client.delete_template_sync_config(**kwargs) Delete a template sync configuration. See also: AWS API Documentation **Request Syntax** response = client.delete_template_sync_config( templateName='string', templateType='ENVIRONMENT'|'SERVICE' ) Parameters: * **templateName** (*string*) -- **[REQUIRED]** The template name. * **templateType** (*string*) -- **[REQUIRED]** The template type. Return type: dict Returns: **Response Syntax** { 'templateSyncConfig': { 'branch': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'subdirectory': 'string', 'templateName': 'string', 'templateType': 'ENVIRONMENT'|'SERVICE' } } **Response Structure** * *(dict) --* * **templateSyncConfig** *(dict) --* The template sync configuration detail data that's returned by Proton. * **branch** *(string) --* The repository branch. * **repositoryName** *(string) --* The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** *(string) --* The repository provider. * **subdirectory** *(string) --* A subdirectory path to your template bundle version. * **templateName** *(string) --* The template name. * **templateType** *(string) --* The template type. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / tag_resource tag_resource ************ Proton.Client.tag_resource(**kwargs) Tag a resource. A tag is a key-value pair of metadata that you associate with an Proton resource. For more information, see Proton resources and tagging in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.tag_resource( resourceArn='string', tags=[ { 'key': 'string', 'value': 'string' }, ] ) Parameters: * **resourceArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the Proton resource to apply customer tags to. * **tags** (*list*) -- **[REQUIRED]** A list of customer tags to apply to the Proton resource. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_service_sync_config update_service_sync_config ************************** Proton.Client.update_service_sync_config(**kwargs) Update the Proton Ops config file. See also: AWS API Documentation **Request Syntax** response = client.update_service_sync_config( branch='string', filePath='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', serviceName='string' ) Parameters: * **branch** (*string*) -- **[REQUIRED]** The name of the code repository branch where the Proton Ops file is found. * **filePath** (*string*) -- **[REQUIRED]** The path to the Proton Ops file. * **repositoryName** (*string*) -- **[REQUIRED]** The name of the repository where the Proton Ops file is found. * **repositoryProvider** (*string*) -- **[REQUIRED]** The name of the repository provider where the Proton Ops file is found. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service the Proton Ops file is for. Return type: dict Returns: **Response Syntax** { 'serviceSyncConfig': { 'branch': 'string', 'filePath': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'serviceName': 'string' } } **Response Structure** * *(dict) --* * **serviceSyncConfig** *(dict) --* The detailed data of the Proton Ops file. * **branch** *(string) --* The name of the code repository branch that holds the service code Proton will sync with. * **filePath** *(string) --* The file path to the service sync configuration file. * **repositoryName** *(string) --* The name of the code repository that holds the service code Proton will sync with. * **repositoryProvider** *(string) --* The name of the repository provider that holds the repository Proton will sync with. * **serviceName** *(string) --* The name of the service that the service instance is added to. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_environment_template_versions list_environment_template_versions ********************************** Proton.Client.list_environment_template_versions(**kwargs) List major or minor versions of an environment template with detail data. See also: AWS API Documentation **Request Syntax** response = client.list_environment_template_versions( majorVersion='string', maxResults=123, nextToken='string', templateName='string' ) Parameters: * **majorVersion** (*string*) -- To view a list of minor of versions under a major version of an environment template, include "major Version". To view a list of major versions of an environment template, *exclude* "major Version". * **maxResults** (*integer*) -- The maximum number of major or minor versions of an environment template to list. * **nextToken** (*string*) -- A token that indicates the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested. * **templateName** (*string*) -- **[REQUIRED]** The name of the environment template. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'templateVersions': [ { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'description': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'majorVersion': 'string', 'minorVersion': 'string', 'recommendedMinorVersion': 'string', 'status': 'REGISTRATION_IN_PROGRESS'|'REGISTRATION_FAILED'|'DRAFT'|'PUBLISHED', 'statusMessage': 'string', 'templateName': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested. * **templateVersions** *(list) --* An array of major or minor versions of an environment template detail data. * *(dict) --* A summary of the version of an environment template detail data. * **arn** *(string) --* The Amazon Resource Name (ARN) of the version of an environment template. * **createdAt** *(datetime) --* The time when the version of an environment template was created. * **description** *(string) --* A description of the version of an environment template. * **lastModifiedAt** *(datetime) --* The time when the version of an environment template was last modified. * **majorVersion** *(string) --* The latest major version that's associated with the version of an environment template. * **minorVersion** *(string) --* The version of an environment template. * **recommendedMinorVersion** *(string) --* The recommended minor version of the environment template. * **status** *(string) --* The status of the version of an environment template. * **statusMessage** *(string) --* The status message of the version of an environment template. * **templateName** *(string) --* The name of the environment template. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / create_environment_account_connection create_environment_account_connection ************************************* Proton.Client.create_environment_account_connection(**kwargs) Create an environment account connection in an environment account so that environment infrastructure resources can be provisioned in the environment account from a management account. An environment account connection is a secure bi-directional connection between a *management account* and an *environment account* that maintains authorization and permissions. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.create_environment_account_connection( clientToken='string', codebuildRoleArn='string', componentRoleArn='string', environmentName='string', managementAccountId='string', roleArn='string', tags=[ { 'key': 'string', 'value': 'string' }, ] ) Parameters: * **clientToken** (*string*) -- When included, if two identical requests are made with the same client token, Proton returns the environment account connection that the first request created. This field is autopopulated if not provided. * **codebuildRoleArn** (*string*) -- The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. You must specify "componentRoleArn" to allow directly defined components to be associated with any environments running in this account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentName** (*string*) -- **[REQUIRED]** The name of the Proton environment that's created in the associated management account. * **managementAccountId** (*string*) -- **[REQUIRED]** The ID of the management account that accepts or rejects the environment account connection. You create and manage the Proton environment in this account. If the management account accepts the environment account connection, Proton can use the associated IAM role to provision environment infrastructure resources in the associated environment account. * **roleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM service role that's created in the environment account. Proton uses this role to provision infrastructure resources in the associated environment account. * **tags** (*list*) -- An optional list of metadata items that you can associate with the Proton environment account connection. A tag is a key- value pair. For more information, see Proton resources and tagging in the *Proton User Guide*. * *(dict) --* A description of a resource tag. * **key** *(string) --* **[REQUIRED]** The key of the resource tag. * **value** *(string) --* **[REQUIRED]** The value of the resource tag. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The environment account connection detail data that's returned by Proton. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ServiceQuotaExceededException" * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / list_component_outputs list_component_outputs ********************** Proton.Client.list_component_outputs(**kwargs) Get a list of component Infrastructure as Code (IaC) outputs. For more information about components, see Proton components in the *Proton User Guide*. See also: AWS API Documentation **Request Syntax** response = client.list_component_outputs( componentName='string', deploymentId='string', nextToken='string' ) Parameters: * **componentName** (*string*) -- **[REQUIRED]** The name of the component whose outputs you want. * **deploymentId** (*string*) -- The ID of the deployment whose outputs you want. * **nextToken** (*string*) -- A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested. Return type: dict Returns: **Response Syntax** { 'nextToken': 'string', 'outputs': [ { 'key': 'string', 'valueString': 'string' }, ] } **Response Structure** * *(dict) --* * **nextToken** *(string) --* A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested. * **outputs** *(list) --* An array of component Infrastructure as Code (IaC) outputs. * *(dict) --* An infrastructure as code defined resource output. * **key** *(string) --* The output key. * **valueString** *(string) --* The output value. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / get_service_instance get_service_instance ******************** Proton.Client.get_service_instance(**kwargs) Get detailed data for a service instance. A service instance is an instantiation of service template and it runs in a specific environment. See also: AWS API Documentation **Request Syntax** response = client.get_service_instance( name='string', serviceName='string' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of a service instance that you want to get the detailed data for. * **serviceName** (*string*) -- **[REQUIRED]** The name of the service that you want the service instance input for. Return type: dict Returns: **Response Syntax** { 'serviceInstance': { 'arn': 'string', 'createdAt': datetime(2015, 1, 1), 'deploymentStatus': 'IN_PROGRESS'|'FAILED'|'SUCCEEDED'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETE_COMPLETE'|'CANCELLING'|'CANCELLED', 'deploymentStatusMessage': 'string', 'environmentName': 'string', 'lastAttemptedDeploymentId': 'string', 'lastClientRequestToken': 'string', 'lastDeploymentAttemptedAt': datetime(2015, 1, 1), 'lastDeploymentSucceededAt': datetime(2015, 1, 1), 'lastSucceededDeploymentId': 'string', 'name': 'string', 'serviceName': 'string', 'spec': 'string', 'templateMajorVersion': 'string', 'templateMinorVersion': 'string', 'templateName': 'string' } } **Response Structure** * *(dict) --* * **serviceInstance** *(dict) --* The detailed data of the requested service instance. * **arn** *(string) --* The Amazon Resource Name (ARN) of the service instance. * **createdAt** *(datetime) --* The time when the service instance was created. * **deploymentStatus** *(string) --* The service instance deployment status. * **deploymentStatusMessage** *(string) --* The message associated with the service instance deployment status. * **environmentName** *(string) --* The name of the environment that the service instance was deployed into. * **lastAttemptedDeploymentId** *(string) --* The ID of the last attempted deployment of this service instance. * **lastClientRequestToken** *(string) --* The last client request token received. * **lastDeploymentAttemptedAt** *(datetime) --* The time when a deployment of the service instance was last attempted. * **lastDeploymentSucceededAt** *(datetime) --* The time when the service instance was last deployed successfully. * **lastSucceededDeploymentId** *(string) --* The ID of the last successful deployment of this service instance. * **name** *(string) --* The name of the service instance. * **serviceName** *(string) --* The name of the service that the service instance belongs to. * **spec** *(string) --* The service spec that was used to create the service instance. * **templateMajorVersion** *(string) --* The major version of the service template that was used to create the service instance. * **templateMinorVersion** *(string) --* The minor version of the service template that was used to create the service instance. * **templateName** *(string) --* The name of the service template that was used to create the service instance. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / update_template_sync_config update_template_sync_config *************************** Proton.Client.update_template_sync_config(**kwargs) Update template sync configuration parameters, except for the "templateName" and "templateType". Repository details (branch, name, and provider) should be of a linked repository. A linked repository is a repository that has been registered with Proton. For more information, see CreateRepository. See also: AWS API Documentation **Request Syntax** response = client.update_template_sync_config( branch='string', repositoryName='string', repositoryProvider='GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', subdirectory='string', templateName='string', templateType='ENVIRONMENT'|'SERVICE' ) Parameters: * **branch** (*string*) -- **[REQUIRED]** The repository branch for your template. * **repositoryName** (*string*) -- **[REQUIRED]** The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** (*string*) -- **[REQUIRED]** The repository provider. * **subdirectory** (*string*) -- A subdirectory path to your template bundle version. When included, limits the template bundle search to this repository directory. * **templateName** (*string*) -- **[REQUIRED]** The synced template name. * **templateType** (*string*) -- **[REQUIRED]** The synced template type. Return type: dict Returns: **Response Syntax** { 'templateSyncConfig': { 'branch': 'string', 'repositoryName': 'string', 'repositoryProvider': 'GITHUB'|'GITHUB_ENTERPRISE'|'BITBUCKET', 'subdirectory': 'string', 'templateName': 'string', 'templateType': 'ENVIRONMENT'|'SERVICE' } } **Response Structure** * *(dict) --* * **templateSyncConfig** *(dict) --* The template sync configuration detail data that's returned by Proton. * **branch** *(string) --* The repository branch. * **repositoryName** *(string) --* The repository name (for example, "myrepos/myrepo"). * **repositoryProvider** *(string) --* The repository provider. * **subdirectory** *(string) --* A subdirectory path to your template bundle version. * **templateName** *(string) --* The template name. * **templateType** *(string) --* The template type. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException" Proton / Client / delete_environment_account_connection delete_environment_account_connection ************************************* Proton.Client.delete_environment_account_connection(**kwargs) In an environment account, delete an environment account connection. After you delete an environment account connection that’s in use by an Proton environment, Proton *can’t* manage the environment infrastructure resources until a new environment account connection is accepted for the environment account and associated environment. You're responsible for cleaning up provisioned resources that remain without an environment connection. For more information, see Environment account connections in the *Proton User guide*. See also: AWS API Documentation **Request Syntax** response = client.delete_environment_account_connection( id='string' ) Parameters: **id** (*string*) -- **[REQUIRED]** The ID of the environment account connection to delete. Return type: dict Returns: **Response Syntax** { 'environmentAccountConnection': { 'arn': 'string', 'codebuildRoleArn': 'string', 'componentRoleArn': 'string', 'environmentAccountId': 'string', 'environmentName': 'string', 'id': 'string', 'lastModifiedAt': datetime(2015, 1, 1), 'managementAccountId': 'string', 'requestedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'status': 'PENDING'|'CONNECTED'|'REJECTED' } } **Response Structure** * *(dict) --* * **environmentAccountConnection** *(dict) --* The detailed data of the environment account connection being deleted. * **arn** *(string) --* The Amazon Resource Name (ARN) of the environment account connection. * **codebuildRoleArn** *(string) --* The Amazon Resource Name (ARN) of an IAM service role in the environment account. Proton uses this role to provision infrastructure resources using CodeBuild-based provisioning in the associated environment account. * **componentRoleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM service role that Proton uses when provisioning directly defined components in the associated environment account. It determines the scope of infrastructure that a component can provision in the account. The environment account connection must have a "componentRoleArn" to allow directly defined components to be associated with any environments running in the account. For more information about components, see Proton components in the *Proton User Guide*. * **environmentAccountId** *(string) --* The environment account that's connected to the environment account connection. * **environmentName** *(string) --* The name of the environment that's associated with the environment account connection. * **id** *(string) --* The ID of the environment account connection. * **lastModifiedAt** *(datetime) --* The time when the environment account connection was last modified. * **managementAccountId** *(string) --* The ID of the management account that's connected to the environment account connection. * **requestedAt** *(datetime) --* The time when the environment account connection request was made. * **roleArn** *(string) --* The IAM service role that's associated with the environment account connection. * **status** *(string) --* The status of the environment account connection. **Exceptions** * "Proton.Client.exceptions.ValidationException" * "Proton.Client.exceptions.AccessDeniedException" * "Proton.Client.exceptions.ThrottlingException" * "Proton.Client.exceptions.ConflictException" * "Proton.Client.exceptions.ResourceNotFoundException" * "Proton.Client.exceptions.InternalServerException"