Skip to content

create_portfolio

create_portfolio(
    display_name: PortfolioDisplayName,
    provider_name: ProviderName,
    idempotency_token: IdempotencyToken,
    *,
    config_overrides: Optional[ServiceCatalogClientConfig] = None,
    accept_language: Optional[AcceptLanguage] = None,
    description: Optional[PortfolioDescription] = None,
    tags: Optional[AddTags] = None,
) -> CreatePortfolioOutput

Creates a portfolio.

A delegated admin is authorized to invoke this command.

Parameters:

  • accept_language (Optional[AcceptLanguage], default: None ) –

    The language code.

    • jp - Japanese

    • zh - Chinese

  • display_name (PortfolioDisplayName) –

    The name to use for display purposes.

  • description (Optional[PortfolioDescription], default: None ) –

    The description of the portfolio.

  • provider_name (ProviderName) –

    The name of the portfolio provider.

  • tags (Optional[AddTags], default: None ) –

    One or more tags.

  • idempotency_token (IdempotencyToken) –

    A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

Raises:

  • InvalidParametersException –

    One or more parameters provided to the operation are not valid.

  • LimitExceededException –

    The current limits of the service would have been exceeded by this operation. Decrease your resource use or increase your service limits and retry the operation.

  • TagOptionNotMigratedException –

    An operation requiring TagOptions failed because the TagOptions migration process has not been performed for this account. Use the Amazon Web Services Management Console to perform the migration process before retrying the operation.

  • UnknownServiceError –

    The service returned an error code this client does not model.

Source code in docs_src/capo_service_catalog/_services/service_catalog.py
def create_portfolio(
    self,
    display_name: "capo_service_catalog.types.portfolio_display_name.PortfolioDisplayName",
    provider_name: "capo_service_catalog.types.provider_name.ProviderName",
    idempotency_token: "capo_service_catalog.types.idempotency_token.IdempotencyToken",
    *,
    config_overrides: Optional[ServiceCatalogClientConfig] = None,
    accept_language: Optional[
        "capo_service_catalog.types.accept_language.AcceptLanguage"
    ] = None,
    description: Optional[
        "capo_service_catalog.types.portfolio_description.PortfolioDescription"
    ] = None,
    tags: Optional["capo_service_catalog.types.add_tags.AddTags"] = None,
) -> "capo_service_catalog.types.create_portfolio_output.CreatePortfolioOutput":
    """<p>Creates a portfolio.</p> <p>A delegated admin is authorized to invoke this command.</p>

    Args:
        accept_language: <p>The language code.</p> <ul> <li> <p> <code>jp</code> - Japanese</p> </li> <li> <p> <code>zh</code> - Chinese</p> </li> </ul>
        display_name: <p>The name to use for display purposes.</p>
        description: <p>The description of the portfolio.</p>
        provider_name: <p>The name of the portfolio provider.</p>
        tags: <p>One or more tags.</p>
        idempotency_token: <p>A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.</p>

    Raises:
        capo_service_catalog.errors.invalid_parameters_exception.InvalidParametersException: <p>One or more parameters provided to the operation are not valid.</p>
        capo_service_catalog.errors.limit_exceeded_exception.LimitExceededException: <p>The current limits of the service would have been exceeded by this operation. Decrease your resource use or increase your service limits and retry the operation.</p>
        capo_service_catalog.errors.tag_option_not_migrated_exception.TagOptionNotMigratedException: <p>An operation requiring TagOptions failed because the TagOptions migration process has not been performed for this account. Use the Amazon Web Services Management Console to perform the migration process before retrying the operation.</p>
        capo_service_catalog.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_service_catalog.types.create_portfolio_input.CreatePortfolioInput]",
    ) -> OperationResponse[
        "capo_service_catalog.types.create_portfolio_output.CreatePortfolioOutput"
    ]:
        import capo_service_catalog._operations.aws242_service_catalog_service.create_portfolio

        output, http_response = (
            capo_service_catalog._operations.aws242_service_catalog_service.create_portfolio.create_portfolio(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreatePortfolio")
    )
    input_: capo_service_catalog.types.create_portfolio_input.CreatePortfolioInput = {
        "display_name": display_name,
        "provider_name": provider_name,
        "idempotency_token": idempotency_token,
    }
    if accept_language is not None:
        input_["accept_language"] = accept_language
    if description is not None:
        input_["description"] = description
    if tags is not None:
        input_["tags"] = tags

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output