ServiceCatalog

Table of Contents

Client

class ServiceCatalog.Client

A low-level client representing AWS Service Catalog:

client = session.create_client('servicecatalog')

These are the available methods:

accept_portfolio_share(**kwargs)

Accepts an offer to share a portfolio.

See also: AWS API Documentation

Request Syntax

response = client.accept_portfolio_share(
    AcceptLanguage='string',
    PortfolioId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

associate_principal_with_portfolio(**kwargs)

Associates the specified principal ARN with the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.associate_principal_with_portfolio(
    AcceptLanguage='string',
    PortfolioId='string',
    PrincipalARN='string',
    PrincipalType='IAM'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • PrincipalARN (string) --

    [REQUIRED]

    The ARN representing the principal (IAM user, role, or group).

  • PrincipalType (string) --

    [REQUIRED]

    The principal type. Must be IAM

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

associate_product_with_portfolio(**kwargs)

Associates a product with a portfolio.

See also: AWS API Documentation

Request Syntax

response = client.associate_product_with_portfolio(
    AcceptLanguage='string',
    ProductId='string',
    PortfolioId='string',
    SourcePortfolioId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • SourcePortfolioId (string) -- The identifier of the source portfolio to use with this association.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

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.
create_constraint(**kwargs)

Creates a new constraint.

See also: AWS API Documentation

Request Syntax

response = client.create_constraint(
    AcceptLanguage='string',
    PortfolioId='string',
    ProductId='string',
    Parameters='string',
    Type='string',
    Description='string',
    IdempotencyToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • Parameters (string) --

    [REQUIRED]

    The constraint parameters.

  • Type (string) --

    [REQUIRED]

    The type of the constraint.

  • Description (string) -- The text description of the constraint.
  • IdempotencyToken (string) --

    [REQUIRED]

    A token to disambiguate duplicate requests. You can create multiple resources using the same input in multiple requests, provided that you also specify a different idempotency token for each request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'ConstraintDetail': {
        'ConstraintId': 'string',
        'Type': 'string',
        'Description': 'string',
        'Owner': 'string'
    },
    'ConstraintParameters': 'string',
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ConstraintDetail (dict) --

      The resulting detailed constraint information.

      • ConstraintId (string) --

        The identifier of the constraint.

      • Type (string) --

        The type of the constraint.

      • Description (string) --

        The text description of the constraint.

      • Owner (string) --

        The owner of the constraint.

    • ConstraintParameters (string) --

      The resulting constraint parameters.

    • Status (string) --

      The status of the current request.

create_portfolio(**kwargs)

Creates a new portfolio.

See also: AWS API Documentation

Request Syntax

response = client.create_portfolio(
    AcceptLanguage='string',
    DisplayName='string',
    Description='string',
    ProviderName='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    IdempotencyToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • DisplayName (string) --

    [REQUIRED]

    The name to use for display purposes.

  • Description (string) -- The text description of the portfolio.
  • ProviderName (string) --

    [REQUIRED]

    The name of the portfolio provider.

  • Tags (list) --

    Tags to associate with the new portfolio.

    • (dict) --

      Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

      • Key (string) -- [REQUIRED]

        The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

      • Value (string) -- [REQUIRED]

        The esired value for this key.

  • IdempotencyToken (string) --

    [REQUIRED]

    A token to disambiguate duplicate requests. You can create multiple resources using the same input in multiple requests, provided that you also specify a different idempotency token for each request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'PortfolioDetail': {
        'Id': 'string',
        'ARN': 'string',
        'DisplayName': 'string',
        'Description': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'ProviderName': 'string'
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PortfolioDetail (dict) --

      The resulting detailed portfolio information.

      • Id (string) --

        The identifier for the portfolio.

      • ARN (string) --

        The ARN assigned to the portfolio.

      • DisplayName (string) --

        The name to use for display purposes.

      • Description (string) --

        The text description of the portfolio.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • ProviderName (string) --

        The name of the portfolio provider.

    • Tags (list) --

      Tags successfully associated with the new portfolio.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

create_portfolio_share(**kwargs)

Creates a new portfolio share.

See also: AWS API Documentation

Request Syntax

response = client.create_portfolio_share(
    AcceptLanguage='string',
    PortfolioId='string',
    AccountId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • AccountId (string) --

    [REQUIRED]

    The account ID with which to share the portfolio.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

create_product(**kwargs)

Creates a new product.

See also: AWS API Documentation

Request Syntax

response = client.create_product(
    AcceptLanguage='string',
    Name='string',
    Owner='string',
    Description='string',
    Distributor='string',
    SupportDescription='string',
    SupportEmail='string',
    SupportUrl='string',
    ProductType='CLOUD_FORMATION_TEMPLATE',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    ProvisioningArtifactParameters={
        'Name': 'string',
        'Description': 'string',
        'Info': {
            'string': 'string'
        },
        'Type': 'CLOUD_FORMATION_TEMPLATE'
    },
    IdempotencyToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Name (string) --

    [REQUIRED]

    The name of the product.

  • Owner (string) --

    [REQUIRED]

    The owner of the product.

  • Description (string) -- The text description of the product.
  • Distributor (string) -- The distributor of the product.
  • SupportDescription (string) -- Support information about the product.
  • SupportEmail (string) -- Contact email for product support.
  • SupportUrl (string) -- Contact URL for product support.
  • ProductType (string) --

    [REQUIRED]

    The type of the product to create.

  • Tags (list) --

    Tags to associate with the new product.

    • (dict) --

      Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

      • Key (string) -- [REQUIRED]

        The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

      • Value (string) -- [REQUIRED]

        The esired value for this key.

  • ProvisioningArtifactParameters (dict) --

    [REQUIRED]

    Parameters for the provisioning artifact.

    • Name (string) --

      The name assigned to the provisioning artifact properties.

    • Description (string) --

      The text description of the provisioning artifact properties.

    • Info (dict) -- [REQUIRED]

      Additional information about the provisioning artifact properties.

      • (string) --
        • (string) --
    • Type (string) --

      The type of the provisioning artifact properties.

  • IdempotencyToken (string) --

    [REQUIRED]

    A token to disambiguate duplicate requests. You can create multiple resources using the same input in multiple requests, provided that you also specify a different idempotency token for each request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'ProductViewDetail': {
        'ProductViewSummary': {
            'Id': 'string',
            'ProductId': 'string',
            'Name': 'string',
            'Owner': 'string',
            'ShortDescription': 'string',
            'Type': 'CLOUD_FORMATION_TEMPLATE',
            'Distributor': 'string',
            'HasDefaultPath': True|False,
            'SupportEmail': 'string',
            'SupportDescription': 'string',
            'SupportUrl': 'string'
        },
        'Status': 'AVAILABLE'|'CREATING'|'FAILED',
        'ProductARN': 'string',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'ProvisioningArtifactDetail': {
        'Id': 'string',
        'Name': 'string',
        'Description': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ProductViewDetail (dict) --

      The resulting detailed product view information.

      • ProductViewSummary (dict) --

        The summary metadata about the specified product view.

        • Id (string) --

          The product view identifier.

        • ProductId (string) --

          The product identifier.

        • Name (string) --

          The name of the product.

        • Owner (string) --

          The owner of the product. Contact the product administrator for the significance of this value.

        • ShortDescription (string) --

          Short description of the product.

        • Type (string) --

          The product type. Contact the product administrator for the significance of this value.

        • Distributor (string) --

          The distributor of the product. Contact the product administrator for the significance of this value.

        • HasDefaultPath (boolean) --

          A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

        • SupportEmail (string) --

          The email contact information to obtain support for this Product.

        • SupportDescription (string) --

          The description of the support for this Product.

        • SupportUrl (string) --

          The URL information to obtain support for this Product.

      • Status (string) --

        Current status of the product.

      • ProductARN (string) --

        The ARN associated with the product.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • ProvisioningArtifactDetail (dict) --

      The resulting detailed provisioning artifact information.

      • Id (string) --

        The identifier of the provisioning artifact.

      • Name (string) --

        The name assigned to the provisioning artifact.

      • Description (string) --

        The text description of the provisioning artifact.

      • Type (string) --

        The type of the provisioning artifact.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Tags (list) --

      Tags successfully associated with the new product.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

create_provisioning_artifact(**kwargs)

Create a new provisioning artifact for the specified product. This operation will not work with a product that has been shared with you.

See also: AWS API Documentation

Request Syntax

response = client.create_provisioning_artifact(
    AcceptLanguage='string',
    ProductId='string',
    Parameters={
        'Name': 'string',
        'Description': 'string',
        'Info': {
            'string': 'string'
        },
        'Type': 'CLOUD_FORMATION_TEMPLATE'
    },
    IdempotencyToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • Parameters (dict) --

    [REQUIRED]

    The parameters to use when creating the new provisioning artifact.

    • Name (string) --

      The name assigned to the provisioning artifact properties.

    • Description (string) --

      The text description of the provisioning artifact properties.

    • Info (dict) -- [REQUIRED]

      Additional information about the provisioning artifact properties.

      • (string) --
        • (string) --
    • Type (string) --

      The type of the provisioning artifact properties.

  • IdempotencyToken (string) --

    [REQUIRED]

    A token to disambiguate duplicate requests. You can create multiple resources using the same input in multiple requests, provided that you also specify a different idempotency token for each request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'ProvisioningArtifactDetail': {
        'Id': 'string',
        'Name': 'string',
        'Description': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Info': {
        'string': 'string'
    },
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ProvisioningArtifactDetail (dict) --

      The resulting detailed provisioning artifact information.

      • Id (string) --

        The identifier of the provisioning artifact.

      • Name (string) --

        The name assigned to the provisioning artifact.

      • Description (string) --

        The text description of the provisioning artifact.

      • Type (string) --

        The type of the provisioning artifact.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Info (dict) --

      Additional information about the provisioning artifact create request.

      • (string) --
        • (string) --
    • Status (string) --

      The status of the current request.

delete_constraint(**kwargs)

Deletes the specified constraint.

See also: AWS API Documentation

Request Syntax

response = client.delete_constraint(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the constraint to delete.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

delete_portfolio(**kwargs)

Deletes the specified portfolio. This operation will not work with a portfolio that has been shared with you or if it has products, users, constraints, or shared accounts associated with it.

See also: AWS API Documentation

Request Syntax

response = client.delete_portfolio(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the portfolio for the delete request.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

delete_portfolio_share(**kwargs)

Deletes the specified portfolio share.

See also: AWS API Documentation

Request Syntax

response = client.delete_portfolio_share(
    AcceptLanguage='string',
    PortfolioId='string',
    AccountId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • AccountId (string) --

    [REQUIRED]

    The account ID associated with the share to delete.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

delete_product(**kwargs)

Deletes the specified product. This operation will not work with a product that has been shared with you or is associated with a portfolio.

See also: AWS API Documentation

Request Syntax

response = client.delete_product(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the product for the delete request.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

delete_provisioning_artifact(**kwargs)

Deletes the specified provisioning artifact. This operation will not work on a provisioning artifact associated with a product that has been shared with you, or on the last provisioning artifact associated with a product (a product must have at least one provisioning artifact).

See also: AWS API Documentation

Request Syntax

response = client.delete_provisioning_artifact(
    AcceptLanguage='string',
    ProductId='string',
    ProvisioningArtifactId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • ProvisioningArtifactId (string) --

    [REQUIRED]

    The identifier of the provisioning artifact for the delete request.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

describe_constraint(**kwargs)

Retrieves detailed information for a specified constraint.

See also: AWS API Documentation

Request Syntax

response = client.describe_constraint(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the constraint.

Return type

dict

Returns

Response Syntax

{
    'ConstraintDetail': {
        'ConstraintId': 'string',
        'Type': 'string',
        'Description': 'string',
        'Owner': 'string'
    },
    'ConstraintParameters': 'string',
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ConstraintDetail (dict) --

      Detailed constraint information.

      • ConstraintId (string) --

        The identifier of the constraint.

      • Type (string) --

        The type of the constraint.

      • Description (string) --

        The text description of the constraint.

      • Owner (string) --

        The owner of the constraint.

    • ConstraintParameters (string) --

      The current parameters associated with the specified constraint.

    • Status (string) --

      The status of the current request.

describe_portfolio(**kwargs)

Retrieves detailed information and any tags associated with the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.describe_portfolio(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the portfolio for which to retrieve information.

Return type

dict

Returns

Response Syntax

{
    'PortfolioDetail': {
        'Id': 'string',
        'ARN': 'string',
        'DisplayName': 'string',
        'Description': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'ProviderName': 'string'
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PortfolioDetail (dict) --

      Detailed portfolio information.

      • Id (string) --

        The identifier for the portfolio.

      • ARN (string) --

        The ARN assigned to the portfolio.

      • DisplayName (string) --

        The name to use for display purposes.

      • Description (string) --

        The text description of the portfolio.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • ProviderName (string) --

        The name of the portfolio provider.

    • Tags (list) --

      Tags associated with the portfolio.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

describe_product(**kwargs)

Retrieves information about a specified product.

This operation is functionally identical to DescribeProductView except that it takes as input ProductId instead of ProductViewId .

See also: AWS API Documentation

Request Syntax

response = client.describe_product(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The ProductId of the product to describe.

Return type

dict

Returns

Response Syntax

{
    'ProductViewSummary': {
        'Id': 'string',
        'ProductId': 'string',
        'Name': 'string',
        'Owner': 'string',
        'ShortDescription': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'Distributor': 'string',
        'HasDefaultPath': True|False,
        'SupportEmail': 'string',
        'SupportDescription': 'string',
        'SupportUrl': 'string'
    },
    'ProvisioningArtifacts': [
        {
            'Id': 'string',
            'Name': 'string',
            'Description': 'string',
            'CreatedTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • ProductViewSummary (dict) --

      The summary metadata about the specified product.

      • Id (string) --

        The product view identifier.

      • ProductId (string) --

        The product identifier.

      • Name (string) --

        The name of the product.

      • Owner (string) --

        The owner of the product. Contact the product administrator for the significance of this value.

      • ShortDescription (string) --

        Short description of the product.

      • Type (string) --

        The product type. Contact the product administrator for the significance of this value.

      • Distributor (string) --

        The distributor of the product. Contact the product administrator for the significance of this value.

      • HasDefaultPath (boolean) --

        A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

      • SupportEmail (string) --

        The email contact information to obtain support for this Product.

      • SupportDescription (string) --

        The description of the support for this Product.

      • SupportUrl (string) --

        The URL information to obtain support for this Product.

    • ProvisioningArtifacts (list) --

      A list of provisioning artifact objects for the specified product. The ProvisioningArtifacts parameter represent the ways the specified product can be provisioned.

      • (dict) --

        Contains information indicating the ways in which a product can be provisioned.

        • Id (string) --

          The identifier for the artifact.

        • Name (string) --

          The name of the artifact.

        • Description (string) --

          The text description of the artifact.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

describe_product_as_admin(**kwargs)

Retrieves information about a specified product, run with administrator access.

See also: AWS API Documentation

Request Syntax

response = client.describe_product_as_admin(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the product for which to retrieve information.

Return type

dict

Returns

Response Syntax

{
    'ProductViewDetail': {
        'ProductViewSummary': {
            'Id': 'string',
            'ProductId': 'string',
            'Name': 'string',
            'Owner': 'string',
            'ShortDescription': 'string',
            'Type': 'CLOUD_FORMATION_TEMPLATE',
            'Distributor': 'string',
            'HasDefaultPath': True|False,
            'SupportEmail': 'string',
            'SupportDescription': 'string',
            'SupportUrl': 'string'
        },
        'Status': 'AVAILABLE'|'CREATING'|'FAILED',
        'ProductARN': 'string',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ProductViewDetail (dict) --

      Detailed product view information.

      • ProductViewSummary (dict) --

        The summary metadata about the specified product view.

        • Id (string) --

          The product view identifier.

        • ProductId (string) --

          The product identifier.

        • Name (string) --

          The name of the product.

        • Owner (string) --

          The owner of the product. Contact the product administrator for the significance of this value.

        • ShortDescription (string) --

          Short description of the product.

        • Type (string) --

          The product type. Contact the product administrator for the significance of this value.

        • Distributor (string) --

          The distributor of the product. Contact the product administrator for the significance of this value.

        • HasDefaultPath (boolean) --

          A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

        • SupportEmail (string) --

          The email contact information to obtain support for this Product.

        • SupportDescription (string) --

          The description of the support for this Product.

        • SupportUrl (string) --

          The URL information to obtain support for this Product.

      • Status (string) --

        Current status of the product.

      • ProductARN (string) --

        The ARN associated with the product.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Tags (list) --

      Tags associated with the product.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

describe_product_view(**kwargs)

Retrieves information about a specified product.

This operation is functionally identical to DescribeProduct except that it takes as input ProductViewId instead of ProductId .

See also: AWS API Documentation

Request Syntax

response = client.describe_product_view(
    AcceptLanguage='string',
    Id='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The ProductViewId of the product to describe.

Return type

dict

Returns

Response Syntax

{
    'ProductViewSummary': {
        'Id': 'string',
        'ProductId': 'string',
        'Name': 'string',
        'Owner': 'string',
        'ShortDescription': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'Distributor': 'string',
        'HasDefaultPath': True|False,
        'SupportEmail': 'string',
        'SupportDescription': 'string',
        'SupportUrl': 'string'
    },
    'ProvisioningArtifacts': [
        {
            'Id': 'string',
            'Name': 'string',
            'Description': 'string',
            'CreatedTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • ProductViewSummary (dict) --

      The summary metadata about the specified product.

      • Id (string) --

        The product view identifier.

      • ProductId (string) --

        The product identifier.

      • Name (string) --

        The name of the product.

      • Owner (string) --

        The owner of the product. Contact the product administrator for the significance of this value.

      • ShortDescription (string) --

        Short description of the product.

      • Type (string) --

        The product type. Contact the product administrator for the significance of this value.

      • Distributor (string) --

        The distributor of the product. Contact the product administrator for the significance of this value.

      • HasDefaultPath (boolean) --

        A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

      • SupportEmail (string) --

        The email contact information to obtain support for this Product.

      • SupportDescription (string) --

        The description of the support for this Product.

      • SupportUrl (string) --

        The URL information to obtain support for this Product.

    • ProvisioningArtifacts (list) --

      A list of provisioning artifact objects for the specified product. The ProvisioningArtifacts represent the ways in which the specified product can be provisioned.

      • (dict) --

        Contains information indicating the ways in which a product can be provisioned.

        • Id (string) --

          The identifier for the artifact.

        • Name (string) --

          The name of the artifact.

        • Description (string) --

          The text description of the artifact.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

describe_provisioning_artifact(**kwargs)

Retrieves detailed information about the specified provisioning artifact.

See also: AWS API Documentation

Request Syntax

response = client.describe_provisioning_artifact(
    AcceptLanguage='string',
    ProvisioningArtifactId='string',
    ProductId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProvisioningArtifactId (string) --

    [REQUIRED]

    The identifier of the provisioning artifact.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

Return type

dict

Returns

Response Syntax

{
    'ProvisioningArtifactDetail': {
        'Id': 'string',
        'Name': 'string',
        'Description': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Info': {
        'string': 'string'
    },
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ProvisioningArtifactDetail (dict) --

      Detailed provisioning artifact information.

      • Id (string) --

        The identifier of the provisioning artifact.

      • Name (string) --

        The name assigned to the provisioning artifact.

      • Description (string) --

        The text description of the provisioning artifact.

      • Type (string) --

        The type of the provisioning artifact.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Info (dict) --

      Additional information about the provisioning artifact.

      • (string) --
        • (string) --
    • Status (string) --

      The status of the current request.

describe_provisioning_parameters(**kwargs)

Provides information about parameters required to provision a specified product in a specified manner. Use this operation to obtain the list of ProvisioningArtifactParameters parameters available to call the ProvisionProduct operation for the specified product.

See also: AWS API Documentation

Request Syntax

response = client.describe_provisioning_parameters(
    AcceptLanguage='string',
    ProductId='string',
    ProvisioningArtifactId='string',
    PathId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • ProvisioningArtifactId (string) --

    [REQUIRED]

    The provisioning artifact identifier for this product.

  • PathId (string) -- The identifier of the path for this product's provisioning. This value is optional if the product has a default path, and is required if there is more than one path for the specified product.
Return type

dict

Returns

Response Syntax

{
    'ProvisioningArtifactParameters': [
        {
            'ParameterKey': 'string',
            'DefaultValue': 'string',
            'ParameterType': 'string',
            'IsNoEcho': True|False,
            'Description': 'string',
            'ParameterConstraints': {
                'AllowedValues': [
                    'string',
                ]
            }
        },
    ],
    'ConstraintSummaries': [
        {
            'Type': 'string',
            'Description': 'string'
        },
    ],
    'UsageInstructions': [
        {
            'Type': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ProvisioningArtifactParameters (list) --

      The list of parameters used to successfully provision the product. Each parameter includes a list of allowable values and additional metadata about each parameter.

      • (dict) --

        A parameter used to successfully provision the product. This value includes a list of allowable values and additional metadata.

        • ParameterKey (string) --

          The parameter key.

        • DefaultValue (string) --

          The default value for this parameter.

        • ParameterType (string) --

          The parameter type.

        • IsNoEcho (boolean) --

          If this value is true, the value for this parameter is obfuscated from view when the parameter is retrieved. This parameter is used to hide sensitive information.

        • Description (string) --

          The text description of the parameter.

        • ParameterConstraints (dict) --

          The list of constraints that the administrator has put on the parameter.

          • AllowedValues (list) --

            The values that the administrator has allowed for the parameter.

            • (string) --
    • ConstraintSummaries (list) --

      The list of constraint summaries that apply to provisioning this product.

      • (dict) --

        An administrator-specified constraint to apply when provisioning a product.

        • Type (string) --

          The type of the constraint.

        • Description (string) --

          The text description of the constraint.

    • UsageInstructions (list) --

      Any additional metadata specifically related to the provisioning of the product. For example, see the Version field of the CloudFormation template.

      • (dict) --

        Additional information provided by the administrator.

        • Type (string) --

          The usage instruction type for the value.

        • Value (string) --

          The usage instruction value for this type.

describe_record(**kwargs)

Retrieves a paginated list of the full details of a specific request. Use this operation after calling a request operation ( ProvisionProduct , TerminateProvisionedProduct , or UpdateProvisionedProduct ).

See also: AWS API Documentation

Request Syntax

response = client.describe_record(
    AcceptLanguage='string',
    Id='string',
    PageToken='string',
    PageSize=123
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The record identifier of the ProvisionedProduct object for which to retrieve output information. This is the RecordDetail.RecordId obtained from the request operation's response.

  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
Return type

dict

Returns

Response Syntax

{
    'RecordDetail': {
        'RecordId': 'string',
        'ProvisionedProductName': 'string',
        'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
        'CreatedTime': datetime(2015, 1, 1),
        'UpdatedTime': datetime(2015, 1, 1),
        'ProvisionedProductType': 'string',
        'RecordType': 'string',
        'ProvisionedProductId': 'string',
        'ProductId': 'string',
        'ProvisioningArtifactId': 'string',
        'PathId': 'string',
        'RecordErrors': [
            {
                'Code': 'string',
                'Description': 'string'
            },
        ],
        'RecordTags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    },
    'RecordOutputs': [
        {
            'OutputKey': 'string',
            'OutputValue': 'string',
            'Description': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • RecordDetail (dict) --

      Detailed record information for the specified product.

      • RecordId (string) --

        The identifier of the ProvisionedProduct object record.

      • ProvisionedProductName (string) --

        The user-friendly name of the ProvisionedProduct object.

      • Status (string) --

        The status of the ProvisionedProduct object.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • UpdatedTime (datetime) --

        The time when the record for the ProvisionedProduct object was last updated.

      • ProvisionedProductType (string) --

        The type of the ProvisionedProduct object.

      • RecordType (string) --

        The record type for this record.

      • ProvisionedProductId (string) --

        The identifier of the ProvisionedProduct object.

      • ProductId (string) --

        The product identifier.

      • ProvisioningArtifactId (string) --

        The provisioning artifact identifier for this product.

      • PathId (string) --

        The identifier of the path for this product's provisioning.

      • RecordErrors (list) --

        A list of errors that occurred while processing the request.

        • (dict) --

          The error code and description resulting from an operation.

          • Code (string) --

            The numeric value of the error.

          • Description (string) --

            The text description of the error.

      • RecordTags (list) --

        List of tags associated with this record.

        • (dict) --

          A tag associated with the record, stored as a key-value pair.

          • Key (string) --

            The key for this tag.

          • Value (string) --

            The value for this tag.

    • RecordOutputs (list) --

      A list of outputs for the specified Product object created as the result of a request. For example, a CloudFormation-backed product that creates an S3 bucket would have an output for the S3 bucket URL.

      • (dict) --

        An output for the specified Product object created as the result of a request. For example, a CloudFormation-backed product that creates an S3 bucket would have an output for the S3 bucket URL.

        • OutputKey (string) --

          The output key.

        • OutputValue (string) --

          The output value.

        • Description (string) --

          The text description of the output.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

disassociate_principal_from_portfolio(**kwargs)

Disassociates a previously associated principal ARN from a specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_principal_from_portfolio(
    AcceptLanguage='string',
    PortfolioId='string',
    PrincipalARN='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • PrincipalARN (string) --

    [REQUIRED]

    The ARN representing the principal (IAM user, role, or group).

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

disassociate_product_from_portfolio(**kwargs)

Disassociates the specified product from the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_product_from_portfolio(
    AcceptLanguage='string',
    ProductId='string',
    PortfolioId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

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
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)
list_accepted_portfolio_shares(**kwargs)

Lists details of all portfolios for which sharing was accepted by this account.

See also: AWS API Documentation

Request Syntax

response = client.list_accepted_portfolio_shares(
    AcceptLanguage='string',
    PageToken='string',
    PageSize=123
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
Return type

dict

Returns

Response Syntax

{
    'PortfolioDetails': [
        {
            'Id': 'string',
            'ARN': 'string',
            'DisplayName': 'string',
            'Description': 'string',
            'CreatedTime': datetime(2015, 1, 1),
            'ProviderName': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • PortfolioDetails (list) --

      List of detailed portfolio information objects.

      • (dict) --

        Detailed portfolio information.

        • Id (string) --

          The identifier for the portfolio.

        • ARN (string) --

          The ARN assigned to the portfolio.

        • DisplayName (string) --

          The name to use for display purposes.

        • Description (string) --

          The text description of the portfolio.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

        • ProviderName (string) --

          The name of the portfolio provider.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_constraints_for_portfolio(**kwargs)

Retrieves detailed constraint information for the specified portfolio and product.

See also: AWS API Documentation

Request Syntax

response = client.list_constraints_for_portfolio(
    AcceptLanguage='string',
    PortfolioId='string',
    ProductId='string',
    PageSize=123,
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • ProductId (string) -- The product identifier.
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'ConstraintDetails': [
        {
            'ConstraintId': 'string',
            'Type': 'string',
            'Description': 'string',
            'Owner': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • ConstraintDetails (list) --

      List of detailed constraint information objects.

      • (dict) --

        Detailed constraint information.

        • ConstraintId (string) --

          The identifier of the constraint.

        • Type (string) --

          The type of the constraint.

        • Description (string) --

          The text description of the constraint.

        • Owner (string) --

          The owner of the constraint.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_launch_paths(**kwargs)

Returns a paginated list of all paths to a specified product. A path is how the user has access to a specified product, and is necessary when provisioning a product. A path also determines the constraints put on the product.

See also: AWS API Documentation

Request Syntax

response = client.list_launch_paths(
    AcceptLanguage='string',
    ProductId='string',
    PageSize=123,
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.. Identifies the product for which to retrieve LaunchPathSummaries information.

  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'LaunchPathSummaries': [
        {
            'Id': 'string',
            'ConstraintSummaries': [
                {
                    'Type': 'string',
                    'Description': 'string'
                },
            ],
            'Tags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ],
            'Name': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • LaunchPathSummaries (list) --

      List of launch path information summaries for the specified PageToken .

      • (dict) --

        Summary information about a path for a user to have access to a specified product.

        • Id (string) --

          The unique identifier of the product path.

        • ConstraintSummaries (list) --

          List of constraints on the portfolio-product relationship.

          • (dict) --

            An administrator-specified constraint to apply when provisioning a product.

            • Type (string) --

              The type of the constraint.

            • Description (string) --

              The text description of the constraint.

        • Tags (list) --

          List of tags used by this launch path.

          • (dict) --

            Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

            • Key (string) --

              The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

            • Value (string) --

              The esired value for this key.

        • Name (string) --

          Corresponds to the name of the portfolio to which the user was assigned.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_portfolio_access(**kwargs)

Lists the account IDs that have been authorized sharing of the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.list_portfolio_access(
    AcceptLanguage='string',
    PortfolioId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

Return type

dict

Returns

Response Syntax

{
    'AccountIds': [
        'string',
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • AccountIds (list) --

      List of account IDs associated with access to the portfolio.

      • (string) --
    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_portfolios(**kwargs)

Lists all portfolios in the catalog.

See also: AWS API Documentation

Request Syntax

response = client.list_portfolios(
    AcceptLanguage='string',
    PageToken='string',
    PageSize=123
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
Return type

dict

Returns

Response Syntax

{
    'PortfolioDetails': [
        {
            'Id': 'string',
            'ARN': 'string',
            'DisplayName': 'string',
            'Description': 'string',
            'CreatedTime': datetime(2015, 1, 1),
            'ProviderName': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • PortfolioDetails (list) --

      List of detailed portfolio information objects.

      • (dict) --

        Detailed portfolio information.

        • Id (string) --

          The identifier for the portfolio.

        • ARN (string) --

          The ARN assigned to the portfolio.

        • DisplayName (string) --

          The name to use for display purposes.

        • Description (string) --

          The text description of the portfolio.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

        • ProviderName (string) --

          The name of the portfolio provider.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_portfolios_for_product(**kwargs)

Lists all portfolios that the specified product is associated with.

See also: AWS API Documentation

Request Syntax

response = client.list_portfolios_for_product(
    AcceptLanguage='string',
    ProductId='string',
    PageToken='string',
    PageSize=123
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
Return type

dict

Returns

Response Syntax

{
    'PortfolioDetails': [
        {
            'Id': 'string',
            'ARN': 'string',
            'DisplayName': 'string',
            'Description': 'string',
            'CreatedTime': datetime(2015, 1, 1),
            'ProviderName': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • PortfolioDetails (list) --

      List of detailed portfolio information objects.

      • (dict) --

        Detailed portfolio information.

        • Id (string) --

          The identifier for the portfolio.

        • ARN (string) --

          The ARN assigned to the portfolio.

        • DisplayName (string) --

          The name to use for display purposes.

        • Description (string) --

          The text description of the portfolio.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

        • ProviderName (string) --

          The name of the portfolio provider.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_principals_for_portfolio(**kwargs)

Lists all principal ARNs associated with the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.list_principals_for_portfolio(
    AcceptLanguage='string',
    PortfolioId='string',
    PageSize=123,
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'Principals': [
        {
            'PrincipalARN': 'string',
            'PrincipalType': 'IAM'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • Principals (list) --

      The IAM principals (users or roles) associated with the portfolio.

      • (dict) --

        A principal's ARN and type.

        • PrincipalARN (string) --

          The ARN representing the principal (IAM user, role, or group).

        • PrincipalType (string) --

          The principal type. Must be IAM

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_provisioning_artifacts(**kwargs)

Lists all provisioning artifacts associated with the specified product.

See also: AWS API Documentation

Request Syntax

response = client.list_provisioning_artifacts(
    AcceptLanguage='string',
    ProductId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

Return type

dict

Returns

Response Syntax

{
    'ProvisioningArtifactDetails': [
        {
            'Id': 'string',
            'Name': 'string',
            'Description': 'string',
            'Type': 'CLOUD_FORMATION_TEMPLATE',
            'CreatedTime': datetime(2015, 1, 1)
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • ProvisioningArtifactDetails (list) --

      List of detailed provisioning artifact information objects.

      • (dict) --

        Detailed provisioning artifact information.

        • Id (string) --

          The identifier of the provisioning artifact.

        • Name (string) --

          The name assigned to the provisioning artifact.

        • Description (string) --

          The text description of the provisioning artifact.

        • Type (string) --

          The type of the provisioning artifact.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

list_record_history(**kwargs)

Returns a paginated list of all performed requests, in the form of RecordDetails objects that are filtered as specified.

See also: AWS API Documentation

Request Syntax

response = client.list_record_history(
    AcceptLanguage='string',
    AccessLevelFilter={
        'Key': 'Account'|'Role'|'User',
        'Value': 'string'
    },
    SearchFilter={
        'Key': 'string',
        'Value': 'string'
    },
    PageSize=123,
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • AccessLevelFilter (dict) --

    The access level for obtaining results. If left unspecified, User level access is used.

    • Key (string) --

      Specifies the access level.

      Account allows results at the account level.

      Role allows results based on the federated role of the specified user.

      User allows results limited to the specified user.

    • Value (string) --

      Specifies the user to which the access level applies. A value of Self is currently supported.

  • SearchFilter (dict) --

    The filter to limit search results.

    • Key (string) --

      The filter key.

    • Value (string) --

      The filter value for Key .

  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'RecordDetails': [
        {
            'RecordId': 'string',
            'ProvisionedProductName': 'string',
            'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
            'CreatedTime': datetime(2015, 1, 1),
            'UpdatedTime': datetime(2015, 1, 1),
            'ProvisionedProductType': 'string',
            'RecordType': 'string',
            'ProvisionedProductId': 'string',
            'ProductId': 'string',
            'ProvisioningArtifactId': 'string',
            'PathId': 'string',
            'RecordErrors': [
                {
                    'Code': 'string',
                    'Description': 'string'
                },
            ],
            'RecordTags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • RecordDetails (list) --

      A list of record detail objects, listed in reverse chronological order.

      • (dict) --

        The full details of a specific ProvisionedProduct object.

        • RecordId (string) --

          The identifier of the ProvisionedProduct object record.

        • ProvisionedProductName (string) --

          The user-friendly name of the ProvisionedProduct object.

        • Status (string) --

          The status of the ProvisionedProduct object.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

        • UpdatedTime (datetime) --

          The time when the record for the ProvisionedProduct object was last updated.

        • ProvisionedProductType (string) --

          The type of the ProvisionedProduct object.

        • RecordType (string) --

          The record type for this record.

        • ProvisionedProductId (string) --

          The identifier of the ProvisionedProduct object.

        • ProductId (string) --

          The product identifier.

        • ProvisioningArtifactId (string) --

          The provisioning artifact identifier for this product.

        • PathId (string) --

          The identifier of the path for this product's provisioning.

        • RecordErrors (list) --

          A list of errors that occurred while processing the request.

          • (dict) --

            The error code and description resulting from an operation.

            • Code (string) --

              The numeric value of the error.

            • Description (string) --

              The text description of the error.

        • RecordTags (list) --

          List of tags associated with this record.

          • (dict) --

            A tag associated with the record, stored as a key-value pair.

            • Key (string) --

              The key for this tag.

            • Value (string) --

              The value for this tag.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

provision_product(**kwargs)

Requests a Provision of a specified product. A ProvisionedProduct is a resourced instance for a product. For example, provisioning a CloudFormation-template-backed product results in launching a CloudFormation stack and all the underlying resources that come with it.

You can check the status of this request using the DescribeRecord operation.

See also: AWS API Documentation

Request Syntax

response = client.provision_product(
    AcceptLanguage='string',
    ProductId='string',
    ProvisioningArtifactId='string',
    PathId='string',
    ProvisionedProductName='string',
    ProvisioningParameters=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    NotificationArns=[
        'string',
    ],
    ProvisionToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • ProvisioningArtifactId (string) --

    [REQUIRED]

    The provisioning artifact identifier for this product.

  • PathId (string) -- The identifier of the path for this product's provisioning. This value is optional if the product has a default path, and is required if there is more than one path for the specified product.
  • ProvisionedProductName (string) --

    [REQUIRED]

    A user-friendly name to identify the ProvisionedProduct object. This value must be unique for the AWS account and cannot be updated after the product is provisioned.

  • ProvisioningParameters (list) --

    Parameters specified by the administrator that are required for provisioning the product.

    • (dict) --

      The arameter key/value pairs used to provision a product.

      • Key (string) --

        The ProvisioningArtifactParameter.ParameterKey parameter from DescribeProvisioningParameters .

      • Value (string) --

        The value to use for provisioning. Any constraints on this value can be found in ProvisioningArtifactParameter for Key .

  • Tags (list) --

    A list of tags to use as provisioning options.

    • (dict) --

      Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

      • Key (string) -- [REQUIRED]

        The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

      • Value (string) -- [REQUIRED]

        The esired value for this key.

  • NotificationArns (list) --

    Passed to CloudFormation. The SNS topic ARNs to which to publish stack-related events.

    • (string) --
  • ProvisionToken (string) --

    [REQUIRED]

    An idempotency token that uniquely identifies the provisioning request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'RecordDetail': {
        'RecordId': 'string',
        'ProvisionedProductName': 'string',
        'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
        'CreatedTime': datetime(2015, 1, 1),
        'UpdatedTime': datetime(2015, 1, 1),
        'ProvisionedProductType': 'string',
        'RecordType': 'string',
        'ProvisionedProductId': 'string',
        'ProductId': 'string',
        'ProvisioningArtifactId': 'string',
        'PathId': 'string',
        'RecordErrors': [
            {
                'Code': 'string',
                'Description': 'string'
            },
        ],
        'RecordTags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • RecordDetail (dict) --

      The detailed result of the ProvisionProduct request, containing the inputs made to that request, the current state of the request, a pointer to the ProvisionedProduct object of the request, and a list of any errors that the request encountered.

      • RecordId (string) --

        The identifier of the ProvisionedProduct object record.

      • ProvisionedProductName (string) --

        The user-friendly name of the ProvisionedProduct object.

      • Status (string) --

        The status of the ProvisionedProduct object.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • UpdatedTime (datetime) --

        The time when the record for the ProvisionedProduct object was last updated.

      • ProvisionedProductType (string) --

        The type of the ProvisionedProduct object.

      • RecordType (string) --

        The record type for this record.

      • ProvisionedProductId (string) --

        The identifier of the ProvisionedProduct object.

      • ProductId (string) --

        The product identifier.

      • ProvisioningArtifactId (string) --

        The provisioning artifact identifier for this product.

      • PathId (string) --

        The identifier of the path for this product's provisioning.

      • RecordErrors (list) --

        A list of errors that occurred while processing the request.

        • (dict) --

          The error code and description resulting from an operation.

          • Code (string) --

            The numeric value of the error.

          • Description (string) --

            The text description of the error.

      • RecordTags (list) --

        List of tags associated with this record.

        • (dict) --

          A tag associated with the record, stored as a key-value pair.

          • Key (string) --

            The key for this tag.

          • Value (string) --

            The value for this tag.

reject_portfolio_share(**kwargs)

Rejects an offer to share a portfolio.

See also: AWS API Documentation

Request Syntax

response = client.reject_portfolio_share(
    AcceptLanguage='string',
    PortfolioId='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) --

    [REQUIRED]

    The portfolio identifier.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

scan_provisioned_products(**kwargs)

Returns a paginated list of all the ProvisionedProduct objects that are currently available (not terminated).

See also: AWS API Documentation

Request Syntax

response = client.scan_provisioned_products(
    AcceptLanguage='string',
    AccessLevelFilter={
        'Key': 'Account'|'Role'|'User',
        'Value': 'string'
    },
    PageSize=123,
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • AccessLevelFilter (dict) --

    The access level for obtaining results. If left unspecified, User level access is used.

    • Key (string) --

      Specifies the access level.

      Account allows results at the account level.

      Role allows results based on the federated role of the specified user.

      User allows results limited to the specified user.

    • Value (string) --

      Specifies the user to which the access level applies. A value of Self is currently supported.

  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'ProvisionedProducts': [
        {
            'Name': 'string',
            'Arn': 'string',
            'Type': 'string',
            'Id': 'string',
            'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
            'StatusMessage': 'string',
            'CreatedTime': datetime(2015, 1, 1),
            'IdempotencyToken': 'string',
            'LastRecordId': 'string'
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • ProvisionedProducts (list) --

      A list of ProvisionedProduct detail objects.

      • (dict) --

        Detailed information about a ProvisionedProduct object.

        • Name (string) --

          The user-friendly name of the ProvisionedProduct object.

        • Arn (string) --

          The ARN associated with the ProvisionedProduct object.

        • Type (string) --

          The type of the ProvisionedProduct object.

        • Id (string) --

          The identifier of the ProvisionedProduct object.

        • Status (string) --

          The current status of the ProvisionedProduct.

        • StatusMessage (string) --

          The current status message of the ProvisionedProduct.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

        • IdempotencyToken (string) --

          A token to disambiguate duplicate requests. You can create multiple resources using the same input in multiple requests, provided that you also specify a different idempotency token for each request.

        • LastRecordId (string) --

          The record identifier of the last request performed on this ProvisionedProduct object.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

search_products(**kwargs)

Returns a paginated list all of the Products objects to which the caller has access.

The output of this operation can be used as input for other operations, such as DescribeProductView .

See also: AWS API Documentation

Request Syntax

response = client.search_products(
    AcceptLanguage='string',
    Filters={
        'string': [
            'string',
        ]
    },
    PageSize=123,
    SortBy='Title'|'VersionCount'|'CreationDate',
    SortOrder='ASCENDING'|'DESCENDING',
    PageToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Filters (dict) --

    The list of filters with which to limit search results. If no search filters are specified, the output is all the products to which the calling user has access.

    • (string) --
      • (list) --
        • (string) --
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • SortBy (string) -- The sort field specifier. If no value is specified, results are not sorted.
  • SortOrder (string) -- The sort order specifier. If no value is specified, results are not sorted.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
Return type

dict

Returns

Response Syntax

{
    'ProductViewSummaries': [
        {
            'Id': 'string',
            'ProductId': 'string',
            'Name': 'string',
            'Owner': 'string',
            'ShortDescription': 'string',
            'Type': 'CLOUD_FORMATION_TEMPLATE',
            'Distributor': 'string',
            'HasDefaultPath': True|False,
            'SupportEmail': 'string',
            'SupportDescription': 'string',
            'SupportUrl': 'string'
        },
    ],
    'ProductViewAggregations': {
        'string': [
            {
                'Value': 'string',
                'ApproximateCount': 123
            },
        ]
    },
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • ProductViewSummaries (list) --

      A list of the product view summary objects.

      • (dict) --

        The summary metadata about the specified product.

        • Id (string) --

          The product view identifier.

        • ProductId (string) --

          The product identifier.

        • Name (string) --

          The name of the product.

        • Owner (string) --

          The owner of the product. Contact the product administrator for the significance of this value.

        • ShortDescription (string) --

          Short description of the product.

        • Type (string) --

          The product type. Contact the product administrator for the significance of this value.

        • Distributor (string) --

          The distributor of the product. Contact the product administrator for the significance of this value.

        • HasDefaultPath (boolean) --

          A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

        • SupportEmail (string) --

          The email contact information to obtain support for this Product.

        • SupportDescription (string) --

          The description of the support for this Product.

        • SupportUrl (string) --

          The URL information to obtain support for this Product.

    • ProductViewAggregations (dict) --

      A list of the product view aggregation value objects.

      • (string) --

        • (list) --

          • (dict) --

            A single product view aggregation value/count pair, containing metadata about each product to which the calling user has access.

            • Value (string) --

              The value of the product view aggregation.

            • ApproximateCount (integer) --

              An approximate count of the products that match the value.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

search_products_as_admin(**kwargs)

Retrieves summary and status information about all products created within the caller's account. If a portfolio ID is provided, this operation retrieves information for only those products that are associated with the specified portfolio.

See also: AWS API Documentation

Request Syntax

response = client.search_products_as_admin(
    AcceptLanguage='string',
    PortfolioId='string',
    Filters={
        'string': [
            'string',
        ]
    },
    SortBy='Title'|'VersionCount'|'CreationDate',
    SortOrder='ASCENDING'|'DESCENDING',
    PageToken='string',
    PageSize=123,
    ProductSource='ACCOUNT'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • PortfolioId (string) -- The portfolio identifier.
  • Filters (dict) --

    The list of filters with which to limit search results. If no search filters are specified, the output is all the products to which the administrator has access.

    • (string) --
      • (list) --
        • (string) --
  • SortBy (string) -- The sort field specifier. If no value is specified, results are not sorted.
  • SortOrder (string) -- The sort order specifier. If no value is specified, results are not sorted.
  • PageToken (string) -- The page token of the first page retrieved. If null, this retrieves the first page of size PageSize .
  • PageSize (integer) -- The maximum number of items to return in the results. If more results exist than fit in the specified PageSize , the value of NextPageToken in the response is non-null.
  • ProductSource (string) -- Access level of the source of the product.
Return type

dict

Returns

Response Syntax

{
    'ProductViewDetails': [
        {
            'ProductViewSummary': {
                'Id': 'string',
                'ProductId': 'string',
                'Name': 'string',
                'Owner': 'string',
                'ShortDescription': 'string',
                'Type': 'CLOUD_FORMATION_TEMPLATE',
                'Distributor': 'string',
                'HasDefaultPath': True|False,
                'SupportEmail': 'string',
                'SupportDescription': 'string',
                'SupportUrl': 'string'
            },
            'Status': 'AVAILABLE'|'CREATING'|'FAILED',
            'ProductARN': 'string',
            'CreatedTime': datetime(2015, 1, 1)
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

  • (dict) --

    • ProductViewDetails (list) --

      List of detailed product view information objects.

      • (dict) --

        Detailed product view information.

        • ProductViewSummary (dict) --

          The summary metadata about the specified product view.

          • Id (string) --

            The product view identifier.

          • ProductId (string) --

            The product identifier.

          • Name (string) --

            The name of the product.

          • Owner (string) --

            The owner of the product. Contact the product administrator for the significance of this value.

          • ShortDescription (string) --

            Short description of the product.

          • Type (string) --

            The product type. Contact the product administrator for the significance of this value.

          • Distributor (string) --

            The distributor of the product. Contact the product administrator for the significance of this value.

          • HasDefaultPath (boolean) --

            A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

          • SupportEmail (string) --

            The email contact information to obtain support for this Product.

          • SupportDescription (string) --

            The description of the support for this Product.

          • SupportUrl (string) --

            The URL information to obtain support for this Product.

        • Status (string) --

          Current status of the product.

        • ProductARN (string) --

          The ARN associated with the product.

        • CreatedTime (datetime) --

          The UTC timestamp of the creation time.

    • NextPageToken (string) --

      The page token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

terminate_provisioned_product(**kwargs)

Requests termination of an existing ProvisionedProduct object. If there are Tags associated with the object, they are terminated when the ProvisionedProduct object is terminated.

This operation does not delete any records associated with the ProvisionedProduct object.

You can check the status of this request using the DescribeRecord operation.

See also: AWS API Documentation

Request Syntax

response = client.terminate_provisioned_product(
    ProvisionedProductName='string',
    ProvisionedProductId='string',
    TerminateToken='string',
    IgnoreErrors=True|False,
    AcceptLanguage='string'
)
Parameters
  • ProvisionedProductName (string) -- The name of the ProvisionedProduct object to terminate. You must specify either ProvisionedProductName or ProvisionedProductId , but not both.
  • ProvisionedProductId (string) -- The identifier of the ProvisionedProduct object to terminate. You must specify either ProvisionedProductName or ProvisionedProductId , but not both.
  • TerminateToken (string) --

    [REQUIRED]

    An idempotency token that uniquely identifies the termination request. This token is only valid during the termination process. After the ProvisionedProduct object is terminated, further requests to terminate the same ProvisionedProduct object always return ResourceNotFound regardless of the value of TerminateToken .

    This field is autopopulated if not provided.

  • IgnoreErrors (boolean) -- If set to true, AWS Service Catalog stops managing the specified ProvisionedProduct object even if it cannot delete the underlying resources.
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

Return type

dict

Returns

Response Syntax

{
    'RecordDetail': {
        'RecordId': 'string',
        'ProvisionedProductName': 'string',
        'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
        'CreatedTime': datetime(2015, 1, 1),
        'UpdatedTime': datetime(2015, 1, 1),
        'ProvisionedProductType': 'string',
        'RecordType': 'string',
        'ProvisionedProductId': 'string',
        'ProductId': 'string',
        'ProvisioningArtifactId': 'string',
        'PathId': 'string',
        'RecordErrors': [
            {
                'Code': 'string',
                'Description': 'string'
            },
        ],
        'RecordTags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • RecordDetail (dict) --

      The detailed result of the TerminateProvisionedProduct request, containing the inputs made to that request, the current state of the request, a pointer to the ProvisionedProduct object that the request is modifying, and a list of any errors that the request encountered.

      • RecordId (string) --

        The identifier of the ProvisionedProduct object record.

      • ProvisionedProductName (string) --

        The user-friendly name of the ProvisionedProduct object.

      • Status (string) --

        The status of the ProvisionedProduct object.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • UpdatedTime (datetime) --

        The time when the record for the ProvisionedProduct object was last updated.

      • ProvisionedProductType (string) --

        The type of the ProvisionedProduct object.

      • RecordType (string) --

        The record type for this record.

      • ProvisionedProductId (string) --

        The identifier of the ProvisionedProduct object.

      • ProductId (string) --

        The product identifier.

      • ProvisioningArtifactId (string) --

        The provisioning artifact identifier for this product.

      • PathId (string) --

        The identifier of the path for this product's provisioning.

      • RecordErrors (list) --

        A list of errors that occurred while processing the request.

        • (dict) --

          The error code and description resulting from an operation.

          • Code (string) --

            The numeric value of the error.

          • Description (string) --

            The text description of the error.

      • RecordTags (list) --

        List of tags associated with this record.

        • (dict) --

          A tag associated with the record, stored as a key-value pair.

          • Key (string) --

            The key for this tag.

          • Value (string) --

            The value for this tag.

update_constraint(**kwargs)

Updates an existing constraint.

See also: AWS API Documentation

Request Syntax

response = client.update_constraint(
    AcceptLanguage='string',
    Id='string',
    Description='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the constraint to update.

  • Description (string) -- The updated text description of the constraint.
Return type

dict

Returns

Response Syntax

{
    'ConstraintDetail': {
        'ConstraintId': 'string',
        'Type': 'string',
        'Description': 'string',
        'Owner': 'string'
    },
    'ConstraintParameters': 'string',
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ConstraintDetail (dict) --

      The resulting detailed constraint information.

      • ConstraintId (string) --

        The identifier of the constraint.

      • Type (string) --

        The type of the constraint.

      • Description (string) --

        The text description of the constraint.

      • Owner (string) --

        The owner of the constraint.

    • ConstraintParameters (string) --

      The resulting updated constraint parameters.

    • Status (string) --

      The status of the current request.

update_portfolio(**kwargs)

Updates the specified portfolio's details. This operation will not work with a product that has been shared with you.

See also: AWS API Documentation

Request Syntax

response = client.update_portfolio(
    AcceptLanguage='string',
    Id='string',
    DisplayName='string',
    Description='string',
    ProviderName='string',
    AddTags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    RemoveTags=[
        'string',
    ]
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the portfolio for the update request.

  • DisplayName (string) -- The name to use for display purposes.
  • Description (string) -- The updated text description of the portfolio.
  • ProviderName (string) -- The updated name of the portfolio provider.
  • AddTags (list) --

    Tags to add to the existing list of tags associated with the portfolio.

    • (dict) --

      Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

      • Key (string) -- [REQUIRED]

        The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

      • Value (string) -- [REQUIRED]

        The esired value for this key.

  • RemoveTags (list) --

    Tags to remove from the existing list of tags associated with the portfolio.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'PortfolioDetail': {
        'Id': 'string',
        'ARN': 'string',
        'DisplayName': 'string',
        'Description': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'ProviderName': 'string'
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • PortfolioDetail (dict) --

      The resulting detailed portfolio information.

      • Id (string) --

        The identifier for the portfolio.

      • ARN (string) --

        The ARN assigned to the portfolio.

      • DisplayName (string) --

        The name to use for display purposes.

      • Description (string) --

        The text description of the portfolio.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • ProviderName (string) --

        The name of the portfolio provider.

    • Tags (list) --

      Tags associated with the portfolio.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

update_product(**kwargs)

Updates an existing product.

See also: AWS API Documentation

Request Syntax

response = client.update_product(
    AcceptLanguage='string',
    Id='string',
    Name='string',
    Owner='string',
    Description='string',
    Distributor='string',
    SupportDescription='string',
    SupportEmail='string',
    SupportUrl='string',
    AddTags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    RemoveTags=[
        'string',
    ]
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • Id (string) --

    [REQUIRED]

    The identifier of the product for the update request.

  • Name (string) -- The updated product name.
  • Owner (string) -- The updated owner of the product.
  • Description (string) -- The updated text description of the product.
  • Distributor (string) -- The updated distributor of the product.
  • SupportDescription (string) -- The updated support description for the product.
  • SupportEmail (string) -- The updated support email for the product.
  • SupportUrl (string) -- The updated support URL for the product.
  • AddTags (list) --

    Tags to add to the existing list of tags associated with the product.

    • (dict) --

      Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

      • Key (string) -- [REQUIRED]

        The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

      • Value (string) -- [REQUIRED]

        The esired value for this key.

  • RemoveTags (list) --

    Tags to remove from the existing list of tags associated with the product.

    • (string) --
Return type

dict

Returns

Response Syntax

{
    'ProductViewDetail': {
        'ProductViewSummary': {
            'Id': 'string',
            'ProductId': 'string',
            'Name': 'string',
            'Owner': 'string',
            'ShortDescription': 'string',
            'Type': 'CLOUD_FORMATION_TEMPLATE',
            'Distributor': 'string',
            'HasDefaultPath': True|False,
            'SupportEmail': 'string',
            'SupportDescription': 'string',
            'SupportUrl': 'string'
        },
        'Status': 'AVAILABLE'|'CREATING'|'FAILED',
        'ProductARN': 'string',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • ProductViewDetail (dict) --

      The resulting detailed product view information.

      • ProductViewSummary (dict) --

        The summary metadata about the specified product view.

        • Id (string) --

          The product view identifier.

        • ProductId (string) --

          The product identifier.

        • Name (string) --

          The name of the product.

        • Owner (string) --

          The owner of the product. Contact the product administrator for the significance of this value.

        • ShortDescription (string) --

          Short description of the product.

        • Type (string) --

          The product type. Contact the product administrator for the significance of this value.

        • Distributor (string) --

          The distributor of the product. Contact the product administrator for the significance of this value.

        • HasDefaultPath (boolean) --

          A value of false indicates that the product does not have a default path, while a value of true indicates that it does. If it's false, call ListLaunchPaths to disambiguate between paths. If true, ListLaunchPaths is not required, and the output of the ProductViewSummary operation can be used directly with DescribeProvisioningParameters .

        • SupportEmail (string) --

          The email contact information to obtain support for this Product.

        • SupportDescription (string) --

          The description of the support for this Product.

        • SupportUrl (string) --

          The URL information to obtain support for this Product.

      • Status (string) --

        Current status of the product.

      • ProductARN (string) --

        The ARN associated with the product.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Tags (list) --

      Tags associated with the product.

      • (dict) --

        Key/value pairs to associate with this provisioning. These tags are entirely discretionary and are propagated to the resources created in the provisioning.

        • Key (string) --

          The ProvisioningArtifactParameter.TagKey parameter from DescribeProvisioningParameters .

        • Value (string) --

          The esired value for this key.

update_provisioned_product(**kwargs)

Requests updates to the configuration of an existing ProvisionedProduct object. If there are tags associated with the object, they cannot be updated or added with this operation. Depending on the specific updates requested, this operation may update with no interruption, with some interruption, or replace the ProvisionedProduct object entirely.

You can check the status of this request using the DescribeRecord operation.

See also: AWS API Documentation

Request Syntax

response = client.update_provisioned_product(
    AcceptLanguage='string',
    ProvisionedProductName='string',
    ProvisionedProductId='string',
    ProductId='string',
    ProvisioningArtifactId='string',
    PathId='string',
    ProvisioningParameters=[
        {
            'Key': 'string',
            'Value': 'string',
            'UsePreviousValue': True|False
        },
    ],
    UpdateToken='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProvisionedProductName (string) -- The updated name of the ProvisionedProduct object . You must specify either ProvisionedProductName or ProvisionedProductId , but not both.
  • ProvisionedProductId (string) -- The identifier of the ProvisionedProduct object to update. You must specify either ProvisionedProductName or ProvisionedProductId , but not both.
  • ProductId (string) -- The identifier of the ProvisionedProduct object.
  • ProvisioningArtifactId (string) -- The provisioning artifact identifier for this product.
  • PathId (string) -- The identifier of the path to use in the updated ProvisionedProduct object. This value is optional if the product has a default path, and is required if there is more than one path for the specified product.
  • ProvisioningParameters (list) --

    A list of ProvisioningParameter objects used to update the ProvisionedProduct object.

    • (dict) --

      The parameter key/value pair used to update a ProvisionedProduct object. If UsePreviousValue is set to true, Value is ignored and the value for Key is kept as previously set (current value).

      • Key (string) --

        The ProvisioningArtifactParameter.ParameterKey parameter from DescribeProvisioningParameters .

      • Value (string) --

        The value to use for updating the product provisioning. Any constraints on this value can be found in the ProvisioningArtifactParameter parameter for Key .

      • UsePreviousValue (boolean) --

        If true, uses the currently set value for Key , ignoring UpdateProvisioningParameter.Value .

  • UpdateToken (string) --

    [REQUIRED]

    The idempotency token that uniquely identifies the provisioning update request.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'RecordDetail': {
        'RecordId': 'string',
        'ProvisionedProductName': 'string',
        'Status': 'IN_PROGRESS'|'SUCCEEDED'|'ERROR',
        'CreatedTime': datetime(2015, 1, 1),
        'UpdatedTime': datetime(2015, 1, 1),
        'ProvisionedProductType': 'string',
        'RecordType': 'string',
        'ProvisionedProductId': 'string',
        'ProductId': 'string',
        'ProvisioningArtifactId': 'string',
        'PathId': 'string',
        'RecordErrors': [
            {
                'Code': 'string',
                'Description': 'string'
            },
        ],
        'RecordTags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • RecordDetail (dict) --

      The detailed result of the UpdateProvisionedProduct request, containing the inputs made to that request, the current state of the request, a pointer to the ProvisionedProduct object that the request is modifying, and a list of any errors that the request encountered.

      • RecordId (string) --

        The identifier of the ProvisionedProduct object record.

      • ProvisionedProductName (string) --

        The user-friendly name of the ProvisionedProduct object.

      • Status (string) --

        The status of the ProvisionedProduct object.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

      • UpdatedTime (datetime) --

        The time when the record for the ProvisionedProduct object was last updated.

      • ProvisionedProductType (string) --

        The type of the ProvisionedProduct object.

      • RecordType (string) --

        The record type for this record.

      • ProvisionedProductId (string) --

        The identifier of the ProvisionedProduct object.

      • ProductId (string) --

        The product identifier.

      • ProvisioningArtifactId (string) --

        The provisioning artifact identifier for this product.

      • PathId (string) --

        The identifier of the path for this product's provisioning.

      • RecordErrors (list) --

        A list of errors that occurred while processing the request.

        • (dict) --

          The error code and description resulting from an operation.

          • Code (string) --

            The numeric value of the error.

          • Description (string) --

            The text description of the error.

      • RecordTags (list) --

        List of tags associated with this record.

        • (dict) --

          A tag associated with the record, stored as a key-value pair.

          • Key (string) --

            The key for this tag.

          • Value (string) --

            The value for this tag.

update_provisioning_artifact(**kwargs)

Updates an existing provisioning artifact's information. This operation will not work on a provisioning artifact associated with a product that has been shared with you.

See also: AWS API Documentation

Request Syntax

response = client.update_provisioning_artifact(
    AcceptLanguage='string',
    ProductId='string',
    ProvisioningArtifactId='string',
    Name='string',
    Description='string'
)
Parameters
  • AcceptLanguage (string) --

    The language code to use for this operation. Supported language codes are as follows:

    "en" (English)

    "jp" (Japanese)

    "zh" (Chinese)

    If no code is specified, "en" is used as the default.

  • ProductId (string) --

    [REQUIRED]

    The product identifier.

  • ProvisioningArtifactId (string) --

    [REQUIRED]

    The identifier of the provisioning artifact for the update request.

  • Name (string) -- The updated name of the provisioning artifact.
  • Description (string) -- The updated text description of the provisioning artifact.
Return type

dict

Returns

Response Syntax

{
    'ProvisioningArtifactDetail': {
        'Id': 'string',
        'Name': 'string',
        'Description': 'string',
        'Type': 'CLOUD_FORMATION_TEMPLATE',
        'CreatedTime': datetime(2015, 1, 1)
    },
    'Info': {
        'string': 'string'
    },
    'Status': 'AVAILABLE'|'CREATING'|'FAILED'
}

Response Structure

  • (dict) --

    • ProvisioningArtifactDetail (dict) --

      The resulting detailed provisioning artifact information.

      • Id (string) --

        The identifier of the provisioning artifact.

      • Name (string) --

        The name assigned to the provisioning artifact.

      • Description (string) --

        The text description of the provisioning artifact.

      • Type (string) --

        The type of the provisioning artifact.

      • CreatedTime (datetime) --

        The UTC timestamp of the creation time.

    • Info (dict) --

      Additional information about the provisioning artifact update request.

      • (string) --
        • (string) --
    • Status (string) --

      The status of the current request.