CodePipeline / Client / get_action_type

get_action_type#

CodePipeline.Client.get_action_type(**kwargs)#

Returns information about an action type created for an external provider, where the action is to be used by customers of the external provider. The action can be created with any supported integration model.

See also: AWS API Documentation

Request Syntax

response = client.get_action_type(
    category='Source'|'Build'|'Deploy'|'Test'|'Invoke'|'Approval'|'Compute',
    owner='string',
    provider='string',
    version='string'
)
Parameters:
  • category (string) –

    [REQUIRED]

    Defines what kind of action can be taken in the stage. The following are the valid values:

    • Source

    • Build

    • Test

    • Deploy

    • Approval

    • Invoke

  • owner (string) –

    [REQUIRED]

    The creator of an action type that was created with any supported integration model. There are two valid values: AWS and ThirdParty.

  • provider (string) –

    [REQUIRED]

    The provider of the action type being called. The provider name is specified when the action type is created.

  • version (string) –

    [REQUIRED]

    A string that describes the action type version.

Return type:

dict

Returns:

Response Syntax

{
    'actionType': {
        'description': 'string',
        'executor': {
            'configuration': {
                'lambdaExecutorConfiguration': {
                    'lambdaFunctionArn': 'string'
                },
                'jobWorkerExecutorConfiguration': {
                    'pollingAccounts': [
                        'string',
                    ],
                    'pollingServicePrincipals': [
                        'string',
                    ]
                }
            },
            'type': 'JobWorker'|'Lambda',
            'policyStatementsTemplate': 'string',
            'jobTimeout': 123
        },
        'id': {
            'category': 'Source'|'Build'|'Deploy'|'Test'|'Invoke'|'Approval'|'Compute',
            'owner': 'string',
            'provider': 'string',
            'version': 'string'
        },
        'inputArtifactDetails': {
            'minimumCount': 123,
            'maximumCount': 123
        },
        'outputArtifactDetails': {
            'minimumCount': 123,
            'maximumCount': 123
        },
        'permissions': {
            'allowedAccounts': [
                'string',
            ]
        },
        'properties': [
            {
                'name': 'string',
                'optional': True|False,
                'key': True|False,
                'noEcho': True|False,
                'queryable': True|False,
                'description': 'string'
            },
        ],
        'urls': {
            'configurationUrl': 'string',
            'entityUrlTemplate': 'string',
            'executionUrlTemplate': 'string',
            'revisionUrlTemplate': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • actionType (dict) –

      The action type information for the requested action type, such as the action type ID.

      • description (string) –

        The description for the action type to be updated.

      • executor (dict) –

        Information about the executor for an action type that was created with any supported integration model.

        • configuration (dict) –

          The action configuration properties for the action type. These properties are specified in the action definition when the action type is created.

          • lambdaExecutorConfiguration (dict) –

            Details about the Lambda executor of the action type.

            • lambdaFunctionArn (string) –

              The ARN of the Lambda function used by the action engine.

          • jobWorkerExecutorConfiguration (dict) –

            Details about the JobWorker executor of the action type.

            • pollingAccounts (list) –

              The accounts in which the job worker is configured and might poll for jobs as part of the action execution.

              • (string) –

            • pollingServicePrincipals (list) –

              The service Principals in which the job worker is configured and might poll for jobs as part of the action execution.

              • (string) –

        • type (string) –

          The integration model used to create and update the action type, Lambda or JobWorker.

        • policyStatementsTemplate (string) –

          The policy statement that specifies the permissions in the CodePipeline customer account that are needed to successfully run an action.

          To grant permission to another account, specify the account ID as the Principal, a domain-style identifier defined by the service, for example codepipeline.amazonaws.com.

          Note

          The size of the passed JSON policy document cannot exceed 2048 characters.

        • jobTimeout (integer) –

          The timeout in seconds for the job. An action execution can have multiple jobs. This is the timeout for a single job, not the entire action execution.

      • id (dict) –

        The action category, owner, provider, and version of the action type to be updated.

        • category (string) –

          Defines what kind of action can be taken in the stage, one of the following:

          • Source

          • Build

          • Test

          • Deploy

          • Approval

          • Invoke

        • owner (string) –

          The creator of the action type being called: AWS or ThirdParty.

        • provider (string) –

          The provider of the action type being called. The provider name is supplied when the action type is created.

        • version (string) –

          A string that describes the action type version.

      • inputArtifactDetails (dict) –

        Details for the artifacts, such as application files, to be worked on by the action. For example, the minimum and maximum number of input artifacts allowed.

        • minimumCount (integer) –

          The minimum number of artifacts that can be used with the action type. For example, you should specify a minimum and maximum of zero input artifacts for an action type with a category of source.

        • maximumCount (integer) –

          The maximum number of artifacts that can be used with the actiontype. For example, you should specify a minimum and maximum of zero input artifacts for an action type with a category of source.

      • outputArtifactDetails (dict) –

        Details for the output artifacts, such as a built application, that are the result of the action. For example, the minimum and maximum number of output artifacts allowed.

        • minimumCount (integer) –

          The minimum number of artifacts that can be used with the action type. For example, you should specify a minimum and maximum of zero input artifacts for an action type with a category of source.

        • maximumCount (integer) –

          The maximum number of artifacts that can be used with the actiontype. For example, you should specify a minimum and maximum of zero input artifacts for an action type with a category of source.

      • permissions (dict) –

        Details identifying the accounts with permissions to use the action type.

        • allowedAccounts (list) –

          A list of Amazon Web Services account IDs with access to use the action type in their pipelines.

          • (string) –

      • properties (list) –

        The properties of the action type to be updated.

        • (dict) –

          Represents information about each property specified in the action configuration, such as the description and key name that display for the customer using the action type.

          • name (string) –

            The property name that is displayed to users.

          • optional (boolean) –

            Whether the configuration property is an optional value.

          • key (boolean) –

            Whether the configuration property is a key.

          • noEcho (boolean) –

            Whether to omit the field value entered by the customer in the log. If true, the value is not saved in CloudTrail logs for the action execution.

          • queryable (boolean) –

            Indicates that the property is used with polling. An action type can have up to one queryable property. If it has one, that property must be both required and not secret.

          • description (string) –

            The description of the property that is displayed to users.

      • urls (dict) –

        The links associated with the action type to be updated.

        • configurationUrl (string) –

          The URL returned to the CodePipeline console that contains a link to the page where customers can configure the external action.

        • entityUrlTemplate (string) –

          The URL returned to the CodePipeline console that provides a deep link to the resources of the external system, such as a status page. This link is provided as part of the action display in the pipeline.

        • executionUrlTemplate (string) –

          The link to an execution page for the action type in progress. For example, for a CodeDeploy action, this link is shown on the pipeline view page in the CodePipeline console, and it links to a CodeDeploy status page.

        • revisionUrlTemplate (string) –

          The URL returned to the CodePipeline console that contains a link to the page where customers can update or change the configuration of the external action.

Exceptions