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',
        'lastClientRequestToken': 'string',
        'lastDeploymentAttemptedAt': datetime(2015, 1, 1),
        'lastDeploymentSucceededAt': datetime(2015, 1, 1),
        '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.

      • 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.

      • 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